# `sees`
<img align="left" src="https://stairlab.github.io/opensees-gallery/examples/shellframe/ShellFrame.png" width="350px" alt="SEES Logo">
**Highly efficient and portable finite element visualization framework**
<br>
<div style="align:center">
[](https://doi.org/10.5281/zenodo.13367077)
[](https://pypi.python.org/pypi/sees)
<!--
[](https://anaconda.org/conda-forge/sees)
[](https://anaconda.org/sees/sees)
-->
</div>
`sees` is a finite element rendering library that leverages modern
web technologies to produce sharable, efficient, and beautiful renderings.
<!-- Badge links -->
[pypi-d-image]: https://img.shields.io/pypi/dm/sees.svg
[license-badge]: https://img.shields.io/pypi/l/sees.svg
[pypi-d-link]: https://pypi.org/project/sees
[pypi-v-image]: https://img.shields.io/pypi/v/sees.svg
[pypi-v-link]: https://pypi.org/project/sees
--------------------------------------------------------------------
<br>
Documentation is currently under development.
## Features
- Render frames with extruded cross sections
- Detailed section rendering
- A wide selection of rendering backends and output file types, including
optimized 3D web formats like `.glb`.
- Correctly render models that treat both `y` or `z` as the
vertical coordinate.
--------------------------------------------------------------------
## Command Line Interface
To create a rendering, execute the following command from the anaconda prompt (after activating the appropriate environment):
```shell
python -m sees model.json -o model.html
```
where `model.json` is a JSON file generated from executing the following OpenSees command:
```tcl
print -JSON model.json
```
If you omit the `-o <file.html>` portion, it will plot immediately in a new
window. You can also use a `.png` extension to save a static image file, as
opposed to the interactive html.
> **Note** Printing depends on the JSON output of a model. Several materials and
> elements in the OpenSeesPy and upstream OpenSees implementations do not
> correctly print to JSON. For the most reliable results, use the
> [`opensees`](https://pypi.org/project/opensees) package.
By default, the rendering treats the $y$ coordinate as vertical.
In order to manually control this behavior, pass the option
`--vert 3` to render model $z$ vertically, or `--vert 2` to render model $y$ vertically.
If the [`opensees`](https://pypi.org/project/opensees) package is installed,
you can directly render a Tcl script without first printing to JSON,
by just passing a Tcl script instead of the JSON file:
```shell
python -m sees model.tcl -o model.html
```
To plot an elevation (`elev`) plan (`plan`) or section (`sect`) view, run:
```shell
python -m sees model.json --view elev
```
and add `-o <file.extension>` as appropriate.
To see the help page run
```shell
python -m sees --help
```
<br>
## Related Links
See also
- [`opensees`](https://github.com/claudioperez/opensees)
- [`osmg`](https://pypi.org/project/osmg)
- [`mdof`](https://pypi.org/project/mdof)
- [`sdof`](https://pypi.org/project/sdof)
The `sees` packages was used to generate figures for the following publications:
- *On nonlinear geometric transformations of finite elements* [doi: 10.1002/nme.7506](https://doi.org/10.1002/nme.7506)
<!--
Similar packages for OpenSees rendering include:
- [`vfo`](https://vfo.readthedocs.io/en/latest/)
- [`opsvis`](https://opsvis.readthedocs.io/en/latest/index.html)
Other
- [`fapp`](https://github.com/wcfrobert/fapp)
-->
## Support
<table align="center">
<tr>
<td>
<a href="https://peer.berkeley.edu">
<img src="https://raw.githubusercontent.com/claudioperez/sdof/master/docs/assets/peer-black-300.png"
alt="PEER Logo" width="200"/>
</a>
</td>
<td>
<a href="https://dot.ca.gov/">
<img src="https://raw.githubusercontent.com/claudioperez/sdof/master/docs/assets/Caltrans.svg.png"
alt="Caltrans Logo" width="200"/>
</a>
</td>
<td>
<a href="https://brace2.herokuapp.com">
<img src="https://raw.githubusercontent.com/claudioperez/sdof/master/docs/assets/stairlab.svg"
alt="STAIRlab Logo" width="200"/>
</a>
</td>
</tr>
</table>
Raw data
{
"_id": null,
"home_page": null,
"name": "cnvr",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "seismic, post-processing, finite-element-analysis, earthquake-engineering, WebGL, GLTF",
"author": null,
"author_email": "\"Claudio M. Perez\" <50180406+claudioperez@users.noreply.github.com>",
"download_url": "https://files.pythonhosted.org/packages/f5/15/d9c6a55efd7faf1e673950d4629264f7a4f393201e123161210fc07b1ee6/cnvr-0.0.0.tar.gz",
"platform": null,
"description": "# `sees`\n\n\n<img align=\"left\" src=\"https://stairlab.github.io/opensees-gallery/examples/shellframe/ShellFrame.png\" width=\"350px\" alt=\"SEES Logo\">\n\n\n**Highly efficient and portable finite element visualization framework**\n\n<br>\n\n\n<div style=\"align:center\">\n\n[](https://doi.org/10.5281/zenodo.13367077)\n[](https://pypi.python.org/pypi/sees)\n\n<!--\n[](https://anaconda.org/conda-forge/sees)\n[](https://anaconda.org/sees/sees)\n-->\n\n</div>\n\n`sees` is a finite element rendering library that leverages modern \nweb technologies to produce sharable, efficient, and beautiful renderings.\n\n\n<!-- Badge links -->\n\n[pypi-d-image]: https://img.shields.io/pypi/dm/sees.svg\n[license-badge]: https://img.shields.io/pypi/l/sees.svg\n[pypi-d-link]: https://pypi.org/project/sees\n[pypi-v-image]: https://img.shields.io/pypi/v/sees.svg\n[pypi-v-link]: https://pypi.org/project/sees\n\n\n-------------------------------------------------------------------- \n\n<br>\n\nDocumentation is currently under development.\n\n## Features\n\n- Render frames with extruded cross sections\n\n- Detailed section rendering\n\n- A wide selection of rendering backends and output file types, including \n optimized 3D web formats like `.glb`.\n\n- Correctly render models that treat both `y` or `z` as the\n vertical coordinate.\n\n-------------------------------------------------------------------- \n\n## Command Line Interface\n\nTo create a rendering, execute the following command from the anaconda prompt (after activating the appropriate environment):\n\n```shell\npython -m sees model.json -o model.html\n```\n\nwhere `model.json` is a JSON file generated from executing the following OpenSees command:\n\n```tcl\nprint -JSON model.json\n```\n\nIf you omit the `-o <file.html>` portion, it will plot immediately in a new\nwindow. You can also use a `.png` extension to save a static image file, as\nopposed to the interactive html.\n\n> **Note** Printing depends on the JSON output of a model. Several materials and\n> elements in the OpenSeesPy and upstream OpenSees implementations do not\n> correctly print to JSON. For the most reliable results, use the\n> [`opensees`](https://pypi.org/project/opensees) package.\n\nBy default, the rendering treats the $y$ coordinate as vertical.\nIn order to manually control this behavior, pass the option \n`--vert 3` to render model $z$ vertically, or `--vert 2` to render model $y$ vertically.\n\nIf the [`opensees`](https://pypi.org/project/opensees) package is installed,\nyou can directly render a Tcl script without first printing to JSON, \nby just passing a Tcl script instead of the JSON file:\n\n```shell\npython -m sees model.tcl -o model.html\n```\n\nTo plot an elevation (`elev`) plan (`plan`) or section (`sect`) view, run:\n\n```shell\npython -m sees model.json --view elev\n```\n\nand add `-o <file.extension>` as appropriate.\n\nTo see the help page run\n\n```shell\npython -m sees --help\n```\n\n\n<br>\n\n## Related Links\n\nSee also\n\n- [`opensees`](https://github.com/claudioperez/opensees)\n- [`osmg`](https://pypi.org/project/osmg)\n- [`mdof`](https://pypi.org/project/mdof)\n- [`sdof`](https://pypi.org/project/sdof)\n\n\nThe `sees` packages was used to generate figures for the following publications:\n\n- *On nonlinear geometric transformations of finite elements* [doi: 10.1002/nme.7506](https://doi.org/10.1002/nme.7506)\n\n<!-- \nSimilar packages for OpenSees rendering include:\n\n- [`vfo`](https://vfo.readthedocs.io/en/latest/)\n- [`opsvis`](https://opsvis.readthedocs.io/en/latest/index.html)\n\nOther\n\n- [`fapp`](https://github.com/wcfrobert/fapp) \n-->\n\n## Support\n\n<table align=\"center\">\n<tr>\n\n <td>\n <a href=\"https://peer.berkeley.edu\">\n <img src=\"https://raw.githubusercontent.com/claudioperez/sdof/master/docs/assets/peer-black-300.png\"\n alt=\"PEER Logo\" width=\"200\"/>\n </a>\n </td>\n\n <td>\n <a href=\"https://dot.ca.gov/\">\n <img src=\"https://raw.githubusercontent.com/claudioperez/sdof/master/docs/assets/Caltrans.svg.png\"\n alt=\"Caltrans Logo\" width=\"200\"/>\n </a>\n </td>\n\n <td>\n <a href=\"https://brace2.herokuapp.com\">\n <img src=\"https://raw.githubusercontent.com/claudioperez/sdof/master/docs/assets/stairlab.svg\"\n alt=\"STAIRlab Logo\" width=\"200\"/>\n </a>\n </td>\n \n </tr>\n</table>\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Bridge information modeling",
"version": "0.0.0",
"project_urls": null,
"split_keywords": [
"seismic",
" post-processing",
" finite-element-analysis",
" earthquake-engineering",
" webgl",
" gltf"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "957c2d11a8e9ff08b2ef585ce72693a86f2057075b482e3e611f0f44835f012a",
"md5": "42160bf8ec7c3df250438dd35b3a2ae3",
"sha256": "74652d300206cb9d1facd57d44d3e27b1c9b608ca3b4a8200ffe0f2741cc5e3a"
},
"downloads": -1,
"filename": "cnvr-0.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "42160bf8ec7c3df250438dd35b3a2ae3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 10626,
"upload_time": "2024-08-23T23:13:50",
"upload_time_iso_8601": "2024-08-23T23:13:50.045045Z",
"url": "https://files.pythonhosted.org/packages/95/7c/2d11a8e9ff08b2ef585ce72693a86f2057075b482e3e611f0f44835f012a/cnvr-0.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f515d9c6a55efd7faf1e673950d4629264f7a4f393201e123161210fc07b1ee6",
"md5": "fb9fcea8f0c52698cd1c52c5e8375dec",
"sha256": "01f1d8cf457f3b1ec62fd57956c2217fe784824ec57793e026e814e536408022"
},
"downloads": -1,
"filename": "cnvr-0.0.0.tar.gz",
"has_sig": false,
"md5_digest": "fb9fcea8f0c52698cd1c52c5e8375dec",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 14084,
"upload_time": "2024-08-23T23:13:51",
"upload_time_iso_8601": "2024-08-23T23:13:51.638898Z",
"url": "https://files.pythonhosted.org/packages/f5/15/d9c6a55efd7faf1e673950d4629264f7a4f393201e123161210fc07b1ee6/cnvr-0.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-23 23:13:51",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "cnvr"
}
JSON