[![CI - build](https://img.shields.io/github/actions/workflow/status/tkarabela/ensight-reader/main.yml?branch=master)](https://github.com/tkarabela/ensight-reader/actions)
[![CI - coverage](https://img.shields.io/codecov/c/github/tkarabela/ensight-reader)](https://app.codecov.io/github/tkarabela/ensight-reader)
![MyPy checked](http://www.mypy-lang.org/static/mypy_badge.svg)
![PyPI - Version](https://img.shields.io/pypi/v/ensight-reader.svg?style=flat-square)
![PyPI - Status](https://img.shields.io/pypi/status/ensight-reader.svg?style=flat-square)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/ensight-reader.svg?style=flat-square)
![License](https://img.shields.io/pypi/l/ensight-reader.svg?style=flat-square)
# ensight-reader
This library provides a pure Python reader (with some writing capability) for the EnSight Gold data format,
a common format for results of computational fluid dynamics (CFD) simulations.
It also comes with a few CLI tools, notably `ensight_transform` which
allows you to perform in-place scaling/translation/etc. of the geometry in your case.
The library designed for efficient, selective, memory-mapped access to data from EnSight Gold case –
something that would be useful when importing the data into other systems. If you're looking for a more "batteries included" solution, look at
[`vtkEnSightGoldBinaryReader`](https://vtk.org/doc/nightly/html/classvtkEnSightGoldBinaryReader.html)
from the VTK library ([see docs for comparison](https://ensight-reader.readthedocs.io/en/latest/design-howto.html#comparison-with-vtk-library)).
### Requirements
- Python 3.9+
- NumPy 1.21+
### Installation
```sh
pip install ensight-reader
```
### Example – Python API
```python
import ensightreader
import numpy as np
case = ensightreader.read_case("example.case")
geofile = case.get_geometry_model()
part_names = geofile.get_part_names() # ["internalMesh", ...]
part = geofile.get_part_by_name(part_names[0])
N = part.number_of_nodes
with geofile.open() as fp_geo:
node_coordinates = part.read_coordinates(fp_geo) # np.ndarray((N, 3), dtype=np.float32)
variable = case.get_variable("UMean")
with variable.mmap_writable() as mm_var:
data = variable.read_node_data(mm_var, part.part_id)
data[:] = np.sqrt(data) # transform variable data in-place
```
### Example – CLI
```sh
# increment X coordinate
ensight_transform --translate 1 0 0 sphere.case
# scale by 1000 (eg. m -> mm conversion)
ensight_transform --scale 1e3 1e3 1e3 sphere.case
# rotation matrix
ensight_transform --matrix \
0 -1 0 0 \
1 0 0 0 \
0 0 1 0 \
0 0 0 1 \
sphere.case
# transform only "internalMesh" part
ensight_transform --translate 1 0 0 --only-parts internalMesh motorbike.case
```
To learn more, please [see the documentation](https://ensight-reader.readthedocs.io).
Raw data
{
"_id": null,
"home_page": "https://github.com/tkarabela/ensight-reader",
"name": "ensight-reader",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "",
"author": "Tomas Karabela",
"author_email": "tkarabela@seznam.cz",
"download_url": "https://files.pythonhosted.org/packages/fd/51/44a0083463ea833f00e473b50653861ab01cb7384c9c37a614124f872756/ensight-reader-0.11.1.tar.gz",
"platform": null,
"description": "[![CI - build](https://img.shields.io/github/actions/workflow/status/tkarabela/ensight-reader/main.yml?branch=master)](https://github.com/tkarabela/ensight-reader/actions)\n[![CI - coverage](https://img.shields.io/codecov/c/github/tkarabela/ensight-reader)](https://app.codecov.io/github/tkarabela/ensight-reader)\n![MyPy checked](http://www.mypy-lang.org/static/mypy_badge.svg)\n![PyPI - Version](https://img.shields.io/pypi/v/ensight-reader.svg?style=flat-square)\n![PyPI - Status](https://img.shields.io/pypi/status/ensight-reader.svg?style=flat-square)\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/ensight-reader.svg?style=flat-square)\n![License](https://img.shields.io/pypi/l/ensight-reader.svg?style=flat-square)\n\n# ensight-reader\n\nThis library provides a pure Python reader (with some writing capability) for the EnSight Gold data format,\na common format for results of computational fluid dynamics (CFD) simulations.\nIt also comes with a few CLI tools, notably `ensight_transform` which\nallows you to perform in-place scaling/translation/etc. of the geometry in your case.\n\nThe library designed for efficient, selective, memory-mapped access to data from EnSight Gold case \u2013\nsomething that would be useful when importing the data into other systems. If you're looking for a more \"batteries included\" solution, look at\n[`vtkEnSightGoldBinaryReader`](https://vtk.org/doc/nightly/html/classvtkEnSightGoldBinaryReader.html)\nfrom the VTK library ([see docs for comparison](https://ensight-reader.readthedocs.io/en/latest/design-howto.html#comparison-with-vtk-library)).\n\n### Requirements\n\n- Python 3.9+\n- NumPy 1.21+\n\n### Installation\n\n```sh\npip install ensight-reader\n```\n\n### Example \u2013 Python API\n\n```python\nimport ensightreader\nimport numpy as np\n\ncase = ensightreader.read_case(\"example.case\")\ngeofile = case.get_geometry_model()\n\npart_names = geofile.get_part_names() # [\"internalMesh\", ...]\npart = geofile.get_part_by_name(part_names[0])\nN = part.number_of_nodes\n\nwith geofile.open() as fp_geo:\n node_coordinates = part.read_coordinates(fp_geo) # np.ndarray((N, 3), dtype=np.float32)\n\nvariable = case.get_variable(\"UMean\")\n\nwith variable.mmap_writable() as mm_var:\n data = variable.read_node_data(mm_var, part.part_id)\n data[:] = np.sqrt(data) # transform variable data in-place\n```\n\n### Example \u2013 CLI\n\n```sh\n# increment X coordinate\nensight_transform --translate 1 0 0 sphere.case\n\n# scale by 1000 (eg. m -> mm conversion)\nensight_transform --scale 1e3 1e3 1e3 sphere.case\n\n# rotation matrix\nensight_transform --matrix \\\n 0 -1 0 0 \\\n 1 0 0 0 \\\n 0 0 1 0 \\\n 0 0 0 1 \\\n sphere.case\n\n# transform only \"internalMesh\" part\nensight_transform --translate 1 0 0 --only-parts internalMesh motorbike.case\n```\n\nTo learn more, please [see the documentation](https://ensight-reader.readthedocs.io).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A pure Python reader for the EnSight Gold format",
"version": "0.11.1",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b12e1f88c31b937314f547fc244a7463dfc4a4040e1a6b5462f4006d4c7b9524",
"md5": "05dad9bb70aea6223b6a06c5d0d002f3",
"sha256": "c364f8d38ff000e223332614b4097dc4ab0a3c1ff517cee0608a191df88b596b"
},
"downloads": -1,
"filename": "ensight_reader-0.11.1-py3-none-any.whl",
"has_sig": true,
"md5_digest": "05dad9bb70aea6223b6a06c5d0d002f3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 25641,
"upload_time": "2023-03-25T17:12:41",
"upload_time_iso_8601": "2023-03-25T17:12:41.248756Z",
"url": "https://files.pythonhosted.org/packages/b1/2e/1f88c31b937314f547fc244a7463dfc4a4040e1a6b5462f4006d4c7b9524/ensight_reader-0.11.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fd5144a0083463ea833f00e473b50653861ab01cb7384c9c37a614124f872756",
"md5": "72e8a69edc3b7763541de955727ed7e1",
"sha256": "7bfc49909f9b4aa529e1182453d8f6483c86bdf558bdc5abaaef442b2db88161"
},
"downloads": -1,
"filename": "ensight-reader-0.11.1.tar.gz",
"has_sig": true,
"md5_digest": "72e8a69edc3b7763541de955727ed7e1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 28766,
"upload_time": "2023-03-25T17:12:44",
"upload_time_iso_8601": "2023-03-25T17:12:44.287465Z",
"url": "https://files.pythonhosted.org/packages/fd/51/44a0083463ea833f00e473b50653861ab01cb7384c9c37a614124f872756/ensight-reader-0.11.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-25 17:12:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "tkarabela",
"github_project": "ensight-reader",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "ensight-reader"
}