Convert

convert translates between file formats without changing the underlying data: convert mesh translates between mesh formats (.exo, .inp, .mesh, .off, .stl, .vtu), and convert segmentation translates between segmentation formats (.npy, .spn, .vti).

automesh convert --help
Converts between mesh or segmentation file types

Usage: automesh convert [OPTIONS] <COMMAND>

Commands:
  mesh          Converts mesh file types (exo | inp | off | stl | vtu) -> (exo | inp | mesh | off | stl | vtu)
  segmentation  Converts segmentation file types (npy | spn) -> (npy | spn | vti)
  help          Print this message or the help of the given subcommand(s)

Options:
      --log <FILE>  Mirror terminal output to a log file
  -q, --quiet       Pass to quiet the terminal output
  -h, --help        Print help

Convert Mesh

convert mesh automatically detects the element type(s) present in the input file — hexahedral, tetrahedral, triangular, quadrilateral, wedge, pyramidal, or a mix of these within the same mesh — and writes them to the output format unchanged; there is no separate hex/tet/tri subcommand to choose.

.stl and .off are the exceptions: both are surface-only formats. .stl holds only 3D triangles. .off holds 3D triangles and quadrilaterals.

• An .stl or .off input can be converted to any of the other mesh formats (.exo, .inp, .mesh, .vtu); the resulting mesh is composed of whatever surface elements the input held (triangles only, for .stl; triangles and/or quadrilaterals, for .off).
• Any of the other mesh formats can be converted to .stl, provided the input mesh is itself composed exclusively of triangular elements, or to .off, provided the input mesh is composed exclusively of triangular and/or quadrilateral elements.
• A volumetric mesh (containing hexahedral, tetrahedral, wedge, or pyramidal elements) cannot be converted to .stl or .off.

automesh convert mesh --help
Converts mesh file types (exo | inp | off | stl | vtu) -> (exo | inp | mesh | off | stl | vtu)

Usage: automesh convert mesh [OPTIONS] --input <FILE> --output <FILE>

Options:
  -i, --input <FILE>   Mesh input file (exo | inp | off | stl | vtu)
  -o, --output <FILE>  Mesh output file (exo | inp | mesh | off | stl | vtu)
      --log <FILE>     Mirror terminal output to a log file
  -q, --quiet          Pass to quiet the terminal output
  -h, --help           Print help

Convert Segmentation

automesh convert segmentation --help
Converts segmentation file types (npy | spn) -> (npy | spn | vti)

Usage: automesh convert segmentation [OPTIONS] --input <FILE> --output <FILE>

Options:
  -i, --input <FILE>   Segmentation input file (npy | spn)
  -o, --output <FILE>  Segmentation output file (npy | spn | vti)
  -x, --nelx <NEL>     Number of voxels in the x-direction (spn)
  -y, --nely <NEL>     Number of voxels in the y-direction (spn)
  -z, --nelz <NEL>     Number of voxels in the z-direction (spn)
      --log <FILE>     Mirror terminal output to a log file
  -q, --quiet          Pass to quiet the terminal output
  -h, --help           Print help