meshlane 5.4.0__tar.gz

meshlane-5.4.0/CHANGELOG.md

@@ -0,0 +1,93 @@
+<!--pytest-codeblocks:skipfile-->
+# Changelog
+
+This document only describes _breaking_ changes in meshio. If you are interested in bug
+fixes, enhancements etc., best follow [the meshio project on
+GitHub](https://github.com/nschloe/meshio). meshlane-specific changes are listed at the
+top; the meshio history follows below.
+
+## meshlane 5.4.0
+
+meshlane is a fork of meshio, maintained by Simvia. Breaking changes relative to the
+meshio base it forked from:
+
+- The Python package and import name is now `meshlane` (was `meshio`), and the
+  command-line tool is `meshlane` (was `meshio`).
+- `numpy` is temporarily pinned to `<2` pending a numpy 2.x migration.
+
+Fork additions carried over (non-breaking): OpenFOAM polyMesh reader, Ansys/APDL `.inp`
+reader, and MED/Salome improvements (multi-mesh, polygon support, more robust
+Code_Aster round-trips).
+
+## v5.1.0 (Dec 11, 2021)
+
+- CellBlocks are no longer tuples, but classes. You can no longer iterate over them like
+  ```python
+  for cell_type, cell_data in cells:
+      pass
+  ```
+  Instead, use
+  ```python
+  for cell_block in cells:
+      cell_block.type
+      cell_block.data
+  ```
+
+## v5.0.0 (Aug 06, 2021)
+
+- meshio now only provides one command-line tool, `meshio`, with subcommands like
+  `info`, `convert`, etc. This replaces the former `meshio-info`, `meshio-convert` etc.
+
+## v4.4.0 (Apr 29, 2021)
+
+- Polygons are now stored as `"polygon"` cell blocks, not `"polygonN"` (where `N` is the
+  number of nodes per polygon). One can simply retrieve the number of points via
+  `cellblock.data.shape[1]`.
+
+## v4.0.0 (Feb 18, 2020)
+
+- `mesh.cells` used to be a dictionary of the form
+
+  ```python
+  {
+    "triangle": [[0, 1, 2], [0, 2, 3]],
+    "quad": [[0, 7, 1, 10], ...]
+  }
+  ```
+
+  From 4.0.0 on, `mesh.cells` is a list of tuples,
+
+  ```python
+  [
+    ("triangle", [[0, 1, 2], [0, 2, 3]]),
+    ("quad", [[0, 7, 1, 10], ...])
+  ]
+  ```
+
+  This has the advantage that multiple blocks of the same cell type can be accounted
+  for. Also, cell ordering can be preserved.
+
+  You can now use the method `mesh.get_cells_type("triangle")` to get all cells of
+  `"triangle"` type, or use `mesh.cells_dict` to build the old dictionary structure.
+
+- `mesh.cell_data` used to be a dictionary of the form
+
+  ```python
+  {
+    "triangle": {"a": [0.5, 1.3], "b": [2.17, 41.3]},
+    "quad": {"a": [1.1, -0.3, ...], "b": [3.14, 1.61, ...]},
+  }
+  ```
+
+  From 4.0.0 on, `mesh.cell_data` is a dictionary of lists,
+
+  ```python
+  {
+    "a": [[0.5, 1.3], [1.1, -0.3, ...]],
+    "b": [[2.17, 41.3], [3.14, 1.61, ...]],
+  }
+  ```
+
+  Each data list, e.g., `mesh.cell_data["a"]`, can be `zip`ped with `mesh.cells`.
+
+  An old-style `cell_data` dictionary can be retrieved via `mesh.cell_data_dict`.

meshlane-5.4.0/LICENSE.txt

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-2021 Nico Schlömer et al.
+Copyright (c) 2026 Simvia and the meshlane contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

meshlane-5.4.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include LICENSE.txt
+include CHANGELOG.md
+# Ship the test suite, but not the (heavy) test meshes — those stay in the
+# git/LFS repo. Keeps the sdist small.
+recursive-include tests *.py
+prune tests/meshes

meshlane-5.4.0/PKG-INFO

@@ -0,0 +1,261 @@
+Metadata-Version: 2.4
+Name: meshlane
+Version: 5.4.0
+Summary: I/O for many mesh formats
+Author-email: Mariam Kesba <mariam.kesba@simvia.tech>, Fatima-Zahra Noussi <fatima-zahra.noussi@simvia.tech>, Lucas Sovre <lucas.sovre@simvia.tech>
+License: The MIT License (MIT)
+        
+        Copyright (c) 2015-2021 Nico Schlömer et al.
+        Copyright (c) 2026 Simvia and the meshlane contributors
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: homepage, https://github.com/simvia-tech/meshlane
+Project-URL: code, https://github.com/simvia-tech/meshlane
+Project-URL: issues, https://github.com/simvia-tech/meshlane/issues
+Keywords: mesh,file formats,scientific,engineering,fem,finite elements
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: importlib_metadata; python_version < "3.8"
+Requires-Dist: numpy<2,>=1.20.0
+Requires-Dist: rich
+Provides-Extra: all
+Requires-Dist: netCDF4; extra == "all"
+Requires-Dist: h5py; extra == "all"
+Dynamic: license-file
+
+<h1 align="center">meshlane</h1>
+
+<p align="center"><img src="https://raw.githubusercontent.com/simvia-tech/meshlane/main/logo/meshlane.svg" width="400" style="max-width: 100%;" /></p>
+
+<p align="center">I/O for mesh files: convert smoothly between many formats.</p>
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://github.com/simvia-tech/meshlane/blob/main/LICENSE.txt)
+[![PyPI version](https://img.shields.io/pypi/v/meshlane.svg?style=flat-square)](https://pypi.org/project/meshlane/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square)](https://github.com/psf/black)
+
+> **meshlane** is an actively maintained descendant of
+> [meshio](https://github.com/nschloe/meshio) by Nico Schlömer.
+> It builds directly on meshio's codebase and history, and extends it with new
+> format support and fixes geared toward FEA/CFD interoperability
+> (code_aster, Ansys, OpenFOAM, Salome/MED). See [Relationship to meshio](#relationship-to-meshio).
+
+There are many mesh formats for representing unstructured meshes. meshlane reads
+and writes all of the following and converts smoothly between them:
+
+> [Abaqus](http://abaqus.software.polimi.it/v6.14/index.html) (`.inp`),
+> ANSYS msh (`.msh`),
+> **Ansys/APDL input** (`.inp`, `.cdb`),
+> [AVS-UCD](https://lanl.github.io/LaGriT/pages/docs/read_avs.html) (`.avs`),
+> [CGNS](https://cgns.github.io/) (`.cgns`),
+> [DOLFIN XML](https://manpages.ubuntu.com/manpages/jammy/en/man1/dolfin-convert.1.html) (`.xml`),
+> [Exodus](https://nschloe.github.io/meshio/exodus.pdf) (`.e`, `.exo`),
+> [FLAC3D](https://www.itascacg.com/software/flac3d) (`.f3grid`),
+> [H5M](https://www.mcs.anl.gov/~fathom/moab-docs/h5mmain.html) (`.h5m`),
+> [Kratos/MDPA](https://github.com/KratosMultiphysics/Kratos/wiki/Input-data) (`.mdpa`),
+> [Medit](https://people.sc.fsu.edu/~jburkardt/data/medit/medit.html) (`.mesh`, `.meshb`),
+> [MED/Salome](https://docs.salome-platform.org/latest/dev/MEDCoupling/developer/med-file.html) (`.med`),
+> [Nastran](https://help.autodesk.com/view/NSTRN/2019/ENU/?guid=GUID-42B54ACB-FBE3-47CA-B8FE-475E7AD91A00) (bulk data, `.bdf`, `.fem`, `.nas`),
+> [Netgen](https://github.com/ngsolve/netgen) (`.vol`, `.vol.gz`),
+> [Neuroglancer precomputed format](https://github.com/google/neuroglancer/tree/master/src/neuroglancer/datasource/precomputed#mesh-representation-of-segmented-object-surfaces),
+> [Gmsh](https://gmsh.info/doc/texinfo/gmsh.html#File-formats) (formats 2.2, 4.0, 4.1, `.msh`),
+> [OBJ](https://en.wikipedia.org/wiki/Wavefront_.obj_file) (`.obj`),
+> [OFF](https://segeval.cs.princeton.edu/public/off_format.html) (`.off`),
+> **OpenFOAM polyMesh** (.foam, read only),
+> [PERMAS](https://www.intes.de) (`.post`, `.post.gz`, `.dato`, `.dato.gz`),
+> [PLY](<https://en.wikipedia.org/wiki/PLY_(file_format)>) (`.ply`),
+> [STL](<https://en.wikipedia.org/wiki/STL_(file_format)>) (`.stl`),
+> [Tecplot .dat](http://paulbourke.net/dataformats/tp/),
+> [TetGen .node/.ele](https://wias-berlin.de/software/tetgen/fformats.html),
+> [SVG](https://www.w3.org/TR/SVG/) (2D output only) (`.svg`),
+> [SU2](https://su2code.github.io/docs_v7/Mesh-File/) (`.su2`),
+> [UGRID](https://www.simcenter.msstate.edu/software/documentation/ug_io/3d_grid_file_type_ugrid.html) (`.ugrid`),
+> [VTK](https://vtk.org/wp-content/uploads/2015/04/file-formats.pdf) (`.vtk`),
+> [VTU](https://vtk.org/Wiki/VTK_XML_Formats) (`.vtu`),
+> [WKT](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) ([TIN](https://en.wikipedia.org/wiki/Triangulated_irregular_network)) (`.wkt`),
+> [XDMF](https://xdmf.org/index.php/XDMF_Model_and_Format) (`.xdmf`, `.xmf`).
+
+## What meshlane adds over meshio
+
+- **OpenFOAM polyMesh reader**: ASCII and binary, arbitrary cell types (tri / quad / polyhedra).
+- **Ansys/APDL** `.inp` / `.cdb` reader & writer for FEA interoperability.
+- **MED/Salome improvements:**
+  - multi-mesh files (several meshes in one `.med`)
+  - polygon cell support, including ragged/Voronoi meshes
+  - multi-timestep result fields, with `NDT`/`NOR`/`PDT` preserved
+  - round-trip of mesh metadata, field units and component names
+  - MED 4.1 bitmask metadata and HDF5 link-creation-order, so files stay
+    readable by Salome / medfile / mdump
+  - extended field data types (float32/64, int32/64)
+  - robust handling of missing `FAS` / `NOEUD` / `GRO` sections and merged cell blocks
+- Encoding and parsing robustness fixes (Latin-1 metadata, group name parsing).
+
+## Installation
+
+meshlane is available [on PyPI](https://pypi.org/project/meshlane/):
+
+<!--pytest-codeblocks:skip-->
+
+```sh
+pip install meshlane[all]
+```
+
+(`[all]` pulls in the optional dependencies `netCDF4` and `h5py`, required for the
+CGNS, H5M, MED and XDMF formats. By default only numpy is needed.)
+
+To install from source instead:
+
+<!--pytest-codeblocks:skip-->
+
+```sh
+git clone https://github.com/simvia-tech/meshlane.git
+cd meshlane
+pip install -e .[all]
+```
+
+## Usage
+
+Command line:
+
+<!--pytest-codeblocks:skip-->
+
+```sh
+meshlane convert    input.msh output.vtk   # convert between two formats
+meshlane info       input.xdmf             # show some info about the mesh
+meshlane compress   input.vtu              # compress the mesh file
+meshlane decompress input.vtu              # decompress the mesh file
+meshlane binary     input.msh              # convert to binary format
+meshlane ascii      input.msh              # convert to ASCII format
+```
+
+In Python, read a mesh:
+
+<!--pytest-codeblocks:skip-->
+
+```python
+import meshlane
+
+mesh = meshlane.read(
+    filename,                # path, os.PathLike, or a buffer/open file
+    # file_format="stl",     # optional; inferred from the extension
+)
+# mesh.points, mesh.cells, mesh.cells_dict, ...
+```
+
+Write a mesh:
+
+```python
+import meshlane
+
+points = [
+    [0.0, 0.0], [1.0, 0.0], [0.0, 1.0],
+    [1.0, 1.0], [2.0, 0.0], [2.0, 1.0],
+]
+cells = [
+    ("triangle", [[0, 1, 2], [1, 3, 2]]),
+    ("quad", [[1, 4, 5, 3]]),
+]
+
+mesh = meshlane.Mesh(
+    points,
+    cells,
+    point_data={"T": [0.3, -1.2, 0.5, 0.7, 0.0, -3.0]},
+    cell_data={"a": [[0.1, 0.2], [0.4]]},
+)
+mesh.write("foo.vtk")
+
+# Or, equivalently:
+meshlane.write_points_cells("foo.vtk", points, cells)
+```
+
+For both reading and writing you may pass `file_format=` explicitly (e.g. to force
+ASCII over binary VTK).
+
+### Time series
+
+The [XDMF format](https://xdmf.org/index.php/XDMF_Model_and_Format) supports time
+series sharing one mesh:
+
+<!--pytest-codeblocks:skip-->
+
+```python
+with meshlane.xdmf.TimeSeriesWriter(filename) as writer:
+    writer.write_points_cells(points, cells)
+    for t in [0.0, 0.1, 0.21]:
+        writer.write_data(t, point_data={"phi": data})
+```
+
+<!--pytest-codeblocks:skip-->
+
+```python
+with meshlane.xdmf.TimeSeriesReader(filename) as reader:
+    points, cells = reader.read_points_cells()
+    for k in range(reader.num_steps):
+        t, point_data, cell_data = reader.read_data(k)
+```
+
+## Testing
+
+<!--pytest-codeblocks:skip-->
+
+```sh
+tox
+```
+
+(Some test meshes are stored with Git LFS; run `git lfs pull` after cloning.)
+
+## Relationship to meshio
+
+meshlane is a fork of [meshio](https://github.com/nschloe/meshio). We kept the full
+git history and authorship so the original work remains properly attributed. We
+started a separate project, rather than only contributing upstream, to move faster
+on the FEA/CFD interoperability features we need (code_aster, Ansys, code_saturne, OpenFOAM,
+Salome, etc.) and to maintain them under active development.
+
+meshio is no longer actively maintained. [Simvia](https://simvia.tech) is a company
+willing to commit time and people to keep this project alive and moving forward.
+
+## Contributing
+
+Everyone is welcome, individuals and companies alike. If you want to help us keep
+meshlane maintained, we would be glad to have you on board. We will do our best to
+triage issues quickly and to give timely, constructive feedback on pull requests.
+
+Huge thanks to Nico Schlömer and all meshio contributors for the foundation this
+project is built on.
+
+## License
+
+meshlane is published under the [MIT license](https://github.com/simvia-tech/meshlane/blob/main/LICENSE.txt), the same as meshio.
+Copyright is retained by the original meshio authors and the meshlane contributors.

meshlane-5.4.0/README.md

@@ -0,0 +1,204 @@
+<h1 align="center">meshlane</h1>
+
+<p align="center"><img src="https://raw.githubusercontent.com/simvia-tech/meshlane/main/logo/meshlane.svg" width="400" style="max-width: 100%;" /></p>
+
+<p align="center">I/O for mesh files: convert smoothly between many formats.</p>
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://github.com/simvia-tech/meshlane/blob/main/LICENSE.txt)
+[![PyPI version](https://img.shields.io/pypi/v/meshlane.svg?style=flat-square)](https://pypi.org/project/meshlane/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg?style=flat-square)](https://github.com/psf/black)
+
+> **meshlane** is an actively maintained descendant of
+> [meshio](https://github.com/nschloe/meshio) by Nico Schlömer.
+> It builds directly on meshio's codebase and history, and extends it with new
+> format support and fixes geared toward FEA/CFD interoperability
+> (code_aster, Ansys, OpenFOAM, Salome/MED). See [Relationship to meshio](#relationship-to-meshio).
+
+There are many mesh formats for representing unstructured meshes. meshlane reads
+and writes all of the following and converts smoothly between them:
+
+> [Abaqus](http://abaqus.software.polimi.it/v6.14/index.html) (`.inp`),
+> ANSYS msh (`.msh`),
+> **Ansys/APDL input** (`.inp`, `.cdb`),
+> [AVS-UCD](https://lanl.github.io/LaGriT/pages/docs/read_avs.html) (`.avs`),
+> [CGNS](https://cgns.github.io/) (`.cgns`),
+> [DOLFIN XML](https://manpages.ubuntu.com/manpages/jammy/en/man1/dolfin-convert.1.html) (`.xml`),
+> [Exodus](https://nschloe.github.io/meshio/exodus.pdf) (`.e`, `.exo`),
+> [FLAC3D](https://www.itascacg.com/software/flac3d) (`.f3grid`),
+> [H5M](https://www.mcs.anl.gov/~fathom/moab-docs/h5mmain.html) (`.h5m`),
+> [Kratos/MDPA](https://github.com/KratosMultiphysics/Kratos/wiki/Input-data) (`.mdpa`),
+> [Medit](https://people.sc.fsu.edu/~jburkardt/data/medit/medit.html) (`.mesh`, `.meshb`),
+> [MED/Salome](https://docs.salome-platform.org/latest/dev/MEDCoupling/developer/med-file.html) (`.med`),
+> [Nastran](https://help.autodesk.com/view/NSTRN/2019/ENU/?guid=GUID-42B54ACB-FBE3-47CA-B8FE-475E7AD91A00) (bulk data, `.bdf`, `.fem`, `.nas`),
+> [Netgen](https://github.com/ngsolve/netgen) (`.vol`, `.vol.gz`),
+> [Neuroglancer precomputed format](https://github.com/google/neuroglancer/tree/master/src/neuroglancer/datasource/precomputed#mesh-representation-of-segmented-object-surfaces),
+> [Gmsh](https://gmsh.info/doc/texinfo/gmsh.html#File-formats) (formats 2.2, 4.0, 4.1, `.msh`),
+> [OBJ](https://en.wikipedia.org/wiki/Wavefront_.obj_file) (`.obj`),
+> [OFF](https://segeval.cs.princeton.edu/public/off_format.html) (`.off`),
+> **OpenFOAM polyMesh** (.foam, read only),
+> [PERMAS](https://www.intes.de) (`.post`, `.post.gz`, `.dato`, `.dato.gz`),
+> [PLY](<https://en.wikipedia.org/wiki/PLY_(file_format)>) (`.ply`),
+> [STL](<https://en.wikipedia.org/wiki/STL_(file_format)>) (`.stl`),
+> [Tecplot .dat](http://paulbourke.net/dataformats/tp/),
+> [TetGen .node/.ele](https://wias-berlin.de/software/tetgen/fformats.html),
+> [SVG](https://www.w3.org/TR/SVG/) (2D output only) (`.svg`),
+> [SU2](https://su2code.github.io/docs_v7/Mesh-File/) (`.su2`),
+> [UGRID](https://www.simcenter.msstate.edu/software/documentation/ug_io/3d_grid_file_type_ugrid.html) (`.ugrid`),
+> [VTK](https://vtk.org/wp-content/uploads/2015/04/file-formats.pdf) (`.vtk`),
+> [VTU](https://vtk.org/Wiki/VTK_XML_Formats) (`.vtu`),
+> [WKT](https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry) ([TIN](https://en.wikipedia.org/wiki/Triangulated_irregular_network)) (`.wkt`),
+> [XDMF](https://xdmf.org/index.php/XDMF_Model_and_Format) (`.xdmf`, `.xmf`).
+
+## What meshlane adds over meshio
+
+- **OpenFOAM polyMesh reader**: ASCII and binary, arbitrary cell types (tri / quad / polyhedra).
+- **Ansys/APDL** `.inp` / `.cdb` reader & writer for FEA interoperability.
+- **MED/Salome improvements:**
+  - multi-mesh files (several meshes in one `.med`)
+  - polygon cell support, including ragged/Voronoi meshes
+  - multi-timestep result fields, with `NDT`/`NOR`/`PDT` preserved
+  - round-trip of mesh metadata, field units and component names
+  - MED 4.1 bitmask metadata and HDF5 link-creation-order, so files stay
+    readable by Salome / medfile / mdump
+  - extended field data types (float32/64, int32/64)
+  - robust handling of missing `FAS` / `NOEUD` / `GRO` sections and merged cell blocks
+- Encoding and parsing robustness fixes (Latin-1 metadata, group name parsing).
+
+## Installation
+
+meshlane is available [on PyPI](https://pypi.org/project/meshlane/):
+
+<!--pytest-codeblocks:skip-->
+
+```sh
+pip install meshlane[all]
+```
+
+(`[all]` pulls in the optional dependencies `netCDF4` and `h5py`, required for the
+CGNS, H5M, MED and XDMF formats. By default only numpy is needed.)
+
+To install from source instead:
+
+<!--pytest-codeblocks:skip-->
+
+```sh
+git clone https://github.com/simvia-tech/meshlane.git
+cd meshlane
+pip install -e .[all]
+```
+
+## Usage
+
+Command line:
+
+<!--pytest-codeblocks:skip-->
+
+```sh
+meshlane convert    input.msh output.vtk   # convert between two formats
+meshlane info       input.xdmf             # show some info about the mesh
+meshlane compress   input.vtu              # compress the mesh file
+meshlane decompress input.vtu              # decompress the mesh file
+meshlane binary     input.msh              # convert to binary format
+meshlane ascii      input.msh              # convert to ASCII format
+```
+
+In Python, read a mesh:
+
+<!--pytest-codeblocks:skip-->
+
+```python
+import meshlane
+
+mesh = meshlane.read(
+    filename,                # path, os.PathLike, or a buffer/open file
+    # file_format="stl",     # optional; inferred from the extension
+)
+# mesh.points, mesh.cells, mesh.cells_dict, ...
+```
+
+Write a mesh:
+
+```python
+import meshlane
+
+points = [
+    [0.0, 0.0], [1.0, 0.0], [0.0, 1.0],
+    [1.0, 1.0], [2.0, 0.0], [2.0, 1.0],
+]
+cells = [
+    ("triangle", [[0, 1, 2], [1, 3, 2]]),
+    ("quad", [[1, 4, 5, 3]]),
+]
+
+mesh = meshlane.Mesh(
+    points,
+    cells,
+    point_data={"T": [0.3, -1.2, 0.5, 0.7, 0.0, -3.0]},
+    cell_data={"a": [[0.1, 0.2], [0.4]]},
+)
+mesh.write("foo.vtk")
+
+# Or, equivalently:
+meshlane.write_points_cells("foo.vtk", points, cells)
+```
+
+For both reading and writing you may pass `file_format=` explicitly (e.g. to force
+ASCII over binary VTK).
+
+### Time series
+
+The [XDMF format](https://xdmf.org/index.php/XDMF_Model_and_Format) supports time
+series sharing one mesh:
+
+<!--pytest-codeblocks:skip-->
+
+```python
+with meshlane.xdmf.TimeSeriesWriter(filename) as writer:
+    writer.write_points_cells(points, cells)
+    for t in [0.0, 0.1, 0.21]:
+        writer.write_data(t, point_data={"phi": data})
+```
+
+<!--pytest-codeblocks:skip-->
+
+```python
+with meshlane.xdmf.TimeSeriesReader(filename) as reader:
+    points, cells = reader.read_points_cells()
+    for k in range(reader.num_steps):
+        t, point_data, cell_data = reader.read_data(k)
+```
+
+## Testing
+
+<!--pytest-codeblocks:skip-->
+
+```sh
+tox
+```
+
+(Some test meshes are stored with Git LFS; run `git lfs pull` after cloning.)
+
+## Relationship to meshio
+
+meshlane is a fork of [meshio](https://github.com/nschloe/meshio). We kept the full
+git history and authorship so the original work remains properly attributed. We
+started a separate project, rather than only contributing upstream, to move faster
+on the FEA/CFD interoperability features we need (code_aster, Ansys, code_saturne, OpenFOAM,
+Salome, etc.) and to maintain them under active development.
+
+meshio is no longer actively maintained. [Simvia](https://simvia.tech) is a company
+willing to commit time and people to keep this project alive and moving forward.
+
+## Contributing
+
+Everyone is welcome, individuals and companies alike. If you want to help us keep
+meshlane maintained, we would be glad to have you on board. We will do our best to
+triage issues quickly and to give timely, constructive feedback on pull requests.
+
+Huge thanks to Nico Schlömer and all meshio contributors for the foundation this
+project is built on.
+
+## License
+
+meshlane is published under the [MIT license](https://github.com/simvia-tech/meshlane/blob/main/LICENSE.txt), the same as meshio.
+Copyright is retained by the original meshio authors and the meshlane contributors.

meshlane-5.4.0/pyproject.toml

@@ -0,0 +1,69 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "meshlane"
+version = "5.4.0"
+description = "I/O for many mesh formats"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {file = "LICENSE.txt"}
+keywords = [
+  "mesh",
+  "file formats",
+  "scientific",
+  "engineering",
+  "fem",
+  "finite elements"
+]
+authors = [
+  {name = "Mariam Kesba", email = "mariam.kesba@simvia.tech"},
+  {name = "Fatima-Zahra Noussi", email = "fatima-zahra.noussi@simvia.tech"},
+  {name = "Lucas Sovre", email = "lucas.sovre@simvia.tech"},
+]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Programming Language :: Python",
+  "Intended Audience :: Science/Research",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Scientific/Engineering",
+  "Topic :: Utilities",
+]
+dependencies = [
+  "importlib_metadata; python_version<'3.8'",
+  "numpy>=1.20.0,<2",
+  "rich",
+]
+
+[project.optional-dependencies]
+all = [
+    "netCDF4",
+    "h5py"  # CGNS, H5M, MED, XDMF formats
+]
+
+[project.urls]
+homepage = "https://github.com/simvia-tech/meshlane"
+code = "https://github.com/simvia-tech/meshlane"
+issues = "https://github.com/simvia-tech/meshlane/issues"
+
+[project.entry-points.console_scripts]
+meshlane = "meshlane._cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.isort]
+profile = "black"
+
+# [options.data_files]
+# share/paraview-5.9/plugins =
+#     tools/paraview-meshlane-plugin.py

meshlane-5.4.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

meshlane-5.4.0/src/meshlane/__about__.py

@@ -0,0 +1,13 @@
+try:
+    # Python 3.8+
+    from importlib import metadata
+except ImportError:
+    try:
+        import importlib_metadata as metadata
+    except ImportError:
+        __version__ = "unknown"
+
+try:
+    __version__ = metadata.version("meshlane")
+except Exception:
+    __version__ = "unknown"