Metadata-Version: 2.0
Name: meshio
Version: 1.10.3
Summary: I/O for various mesh formats
Home-page: https://github.com/nschloe/meshio
Author: Nico Schlömer
Author-email: nico.schloemer@gmail.com
License: License :: OSI Approved :: MIT License
Download-URL: https://pypi.python.org/pypi/meshio
Description-Content-Type: UNKNOWN
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering
Requires-Dist: numpy
Requires-Dist: pipdate
Provides-Extra: exodus
Requires-Dist: netCDF4; extra == 'exodus'
Provides-Extra: hdf5
Requires-Dist: h5py; extra == 'hdf5'

meshio
======

|Build Status| |codecov.io| |PyPi Version| |GitHub stars|

.. raw:: html

   <p align="center">

|image4|

.. raw:: html

   </p>

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

-  `ANSYS
   msh <http://www.afs.enea.it/fluent/Public/Fluent-Doc/PDF/chp03.pdf>`__
-  `DOLFIN
   XML <http://manpages.ubuntu.com/manpages/wily/man1/dolfin-convert.1.html>`__
-  `Exodus <https://cubit.sandia.gov/public/13.2/help_manual/WebHelp/finite_element_model/exodus/block_specification.htm>`__
-  `H5M <https://www.mcs.anl.gov/~fathom/moab-docs/h5mmain.html>`__
-  `Medit <https://people.sc.fsu.edu/~jburkardt/data/medit/medit.html>`__
-  `MED/Salome <http://docs.salome-platform.org/latest/dev/MEDCoupling/med-file.html>`__
-  `Gmsh <http://gmsh.info/doc/texinfo/gmsh.html#File-formats>`__
-  `OFF <http://segeval.cs.princeton.edu/public/off_format.html>`__
-  `PERMAS <http://www.intes.de>`__
-  `VTK <https://www.vtk.org/wp-content/uploads/2015/04/file-formats.pdf>`__
-  `VTU <https://www.vtk.org/Wiki/VTK_XML_Formats>`__
-  `XDMF <http://www.xdmf.org/index.php/XDMF_Model_and_Format>`__

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

.. code:: python

    points, cells, point_data, cell_data, field_data = \
        meshio.read(args.infile)

to read a mesh. To write, do

.. code:: python

    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(
        'foo.vtk',
        points,
        cells,
        # Optionally provide extra data on points, cells, etc.
        # point_data=point_data,
        # cell_data=cell_data,
        # field_data=field_data
        )

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 <https://pypi.python.org/pypi/meshio/>`__, so simply type

::

    pip install -U meshio

to install or upgrade.

Usage
~~~~~

Just

::

    import meshio

and make use of all the goodies the module provides.

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 <https://en.wikipedia.org/wiki/MIT_License>`__.

.. |Build Status| image:: https://travis-ci.org/nschloe/meshio.svg?branch=master
   :target: https://travis-ci.org/nschloe/meshio
.. |codecov.io| image:: https://codecov.io/github/nschloe/meshio/branch/master/graphs/badge.svg
   :target: https://codecov.io/github/nschloe/meshio/branch/master
.. |PyPi Version| image:: https://img.shields.io/pypi/v/meshio.svg
   :target: https://pypi.python.org/pypi/meshio
.. |GitHub stars| image:: https://img.shields.io/github/stars/nschloe/meshio.svg?style=social&label=Stars&maxAge=2592000
   :target: https://github.com/nschloe/meshio
.. |image4| image:: https://nschloe.github.io/meshio/meshio_logo.png
   :width: 20.0%


