# `sees`
<!--
<img align="left" src="https://raw.githubusercontent.com/BRACE2/OpenSeesRT/master/docs/figures/banner.png" width="150px" alt="OpenSees">
-->
<img align="left" src="https://github.com/claudioperez/opensees/blob/master/docs/figures/hockling.png?raw=true" width="350px" alt="SEES Logo">
<!--
https://github.com/claudioperez/sees/blob/master/docs/figures/hockling.png?raw=true
-->
**A modern OpenSees renderer**
<br>
<!--
--------------------------------------------------------------------
-->
<div style="align:center">
[](https://pypi.python.org/pypi/sees)
[](https://pypi.org/project/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
- Extruded deformed shape
- 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 generate 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, just 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>
See also
- [`opensees`](https://pypi.org/project/opensees)
- [`osmg`](https://pypi.org/project/osmg)
- [`mdof`](https://pypi.org/project/mdof)
- [`sdof`](https://pypi.org/project/sdof)
For OpenSees rendering
- [`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://peer.berkeley.edu">
<img src="https://raw.githubusercontent.com/claudioperez/sdof/master/docs/assets/brace2_logo-new3_ungrouped.svg"
alt="BRACE2 Logo" width="200"/>
</a>
</td>
</tr>
</table>
Raw data
{
"_id": null,
"home_page": null,
"name": "semm",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "seismic, post-processing, finite-element-analysis, earthquake-engineering",
"author": null,
"author_email": "\"Claudio M. Perez\" <50180406+claudioperez@users.noreply.github.com>, Chrystal Chern <52893467+chrystalchern@users.noreply.github.com>",
"download_url": "https://files.pythonhosted.org/packages/c8/2c/df91f74a5cd66b199168befe521b04ad87aa2bf1c558e0df50ac0d47bb67/semm-0.0.0.tar.gz",
"platform": null,
"description": "# `sees`\n\n<!--\n<img align=\"left\" src=\"https://raw.githubusercontent.com/BRACE2/OpenSeesRT/master/docs/figures/banner.png\" width=\"150px\" alt=\"OpenSees\">\n-->\n\n<img align=\"left\" src=\"https://github.com/claudioperez/opensees/blob/master/docs/figures/hockling.png?raw=true\" width=\"350px\" alt=\"SEES Logo\">\n\n<!--\nhttps://github.com/claudioperez/sees/blob/master/docs/figures/hockling.png?raw=true\n-->\n\n**A modern OpenSees renderer**\n\n<br>\n\n<!-- \n-------------------------------------------------------------------- \n-->\n\n<div style=\"align:center\">\n\n[](https://pypi.python.org/pypi/sees)\n[](https://pypi.org/project/sees)\n\n<!--\n[](https://anaconda.org/conda-forge/sees)\n[](https://anaconda.org/sees/sees)\n-->\n\n</div>\n\n<!-- \n-------------------------------------------------------------------- \n-->\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- Extruded deformed shape\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 generate 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, just 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\n<br>\n\nSee also\n\n- [`opensees`](https://pypi.org/project/opensees)\n- [`osmg`](https://pypi.org/project/osmg)\n- [`mdof`](https://pypi.org/project/mdof)\n- [`sdof`](https://pypi.org/project/sdof)\n\nFor OpenSees rendering\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## 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://peer.berkeley.edu\">\n <img src=\"https://raw.githubusercontent.com/claudioperez/sdof/master/docs/assets/brace2_logo-new3_ungrouped.svg\"\n alt=\"BRACE2 Logo\" width=\"200\"/>\n </a>\n </td>\n \n </tr>\n</table>\n\n",
"bugtrack_url": null,
"license": null,
"summary": "A modern OpenSees renderer",
"version": "0.0.0",
"project_urls": {
"repository": "http://github.com/BRACE2/sees"
},
"split_keywords": [
"seismic",
" post-processing",
" finite-element-analysis",
" earthquake-engineering"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f3d68d19940e407fc8058b9e95f0145a1f0899b3e1d3b639f2033003bb948446",
"md5": "8436136a2f9737a73b0d671ff5d96b62",
"sha256": "90c923c9e49127bb1108ab83da3048717599f03a479a0e8f23936996a5365cbb"
},
"downloads": -1,
"filename": "semm-0.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8436136a2f9737a73b0d671ff5d96b62",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 45969,
"upload_time": "2024-06-17T00:31:32",
"upload_time_iso_8601": "2024-06-17T00:31:32.497864Z",
"url": "https://files.pythonhosted.org/packages/f3/d6/8d19940e407fc8058b9e95f0145a1f0899b3e1d3b639f2033003bb948446/semm-0.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c82cdf91f74a5cd66b199168befe521b04ad87aa2bf1c558e0df50ac0d47bb67",
"md5": "0001f4c8eb82e138e2c3f744db1ae6b5",
"sha256": "1ec5e4c3a39cd45f95abf391130c2c5f08057ba43471a20febbb20950b8f62d0"
},
"downloads": -1,
"filename": "semm-0.0.0.tar.gz",
"has_sig": false,
"md5_digest": "0001f4c8eb82e138e2c3f744db1ae6b5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 41470,
"upload_time": "2024-06-17T00:31:34",
"upload_time_iso_8601": "2024-06-17T00:31:34.014539Z",
"url": "https://files.pythonhosted.org/packages/c8/2c/df91f74a5cd66b199168befe521b04ad87aa2bf1c558e0df50ac0d47bb67/semm-0.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-17 00:31:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "BRACE2",
"github_project": "sees",
"github_not_found": true,
"lcname": "semm"
}
JSON
