meshio 2.2.1

I/O for various mesh formats

meshio

There are various mesh formats available for representing unstructured meshes, e.g.,

• Abaqus
• ANSYS msh
• DOLFIN XML
• Exodus
• H5M
• Kratos/MDPA
• Medit
• MED/Salome
• Gmsh (versions 2 and 4)
• OFF
• PERMAS
• STL
• SVG (2D only, output only)
• VTK
• VTU
• XDMF

meshio can read and write all of these formats and smoothly converts between them. Simply call

meshio-convert input.msh output.vtu

with any of the supported formats.

In Python, simply call

import meshio

mesh = meshio.read(filename)
# mesh.points, mesh.cells, ...

to read a mesh. To write, do

points = numpy.array([
    [0.0, 0.0, 0.0],
    [0.0, 1.0, 0.0],
    [0.0, 0.0, 1.0],
    ])
cells = {
    "triangle": numpy.array([
        [0, 1, 2]
        ])
    }
meshio.write_points_cells(
    "foo.vtk",
    points,
    cells,
    # Optionally provide extra data on points, cells, etc.
    # point_data=point_data,
    # cell_data=cell_data,
    # field_data=field_data
    )

or explicitly create a mesh object for writing

mesh = meshio.Mesh(points, cells)
meshio.write("foo.vtk", mesh)

For both input and output, you can optionally specify the exact file_format (in case you would like to enforce binary over ASCII VTK, for example).

Installation

meshio is available from the Python Package Index, so simply type

pip install -U meshio

to install or upgrade.

Testing

To run the meshio unit tests, check out this repository and type

pytest

Distribution

To create a new release

1. bump the __version__ number,

2. tag and upload to PyPi:

   make publish
   

License

meshio is published under the MIT license.