Image-based Meshing#
Images in MyMesh#
MyMesh can read from a variety of image file types, including DICOMs, tiffs, jpgs, and pngs, utilizing image file readers pydicom, tifffile, and opencv-python.
Images stored as a directory (or “z-stack”) of two dimensional images,
single-file 3D images (e.g. from the OME-TIFF format), or numpy arrays of 3D
image data can all be read by mymesh.image.read() to be obtain a numpy
array of image data [1] (or tuple of arrays for multi-channel data), or passed
directly to a mesh generator function (e.g. mymesh.image.VoxelMesh()).
Images loaded from a directory containing a stack of image slices will be read
in lexicographical order by the image file names, and the files must have the
proper file extensions. Image arrays can also be written to files using
mymesh.image.write().
Images stored in numpy arrays are assumed to be ordered such that their three
dimensions (0,1,2) correspond to (z,y,x). For example, if
mymesh.image.read() is used to read a directory containing a stack of
images and produces and array I, then I[0,:,:] will correspond
to the data contained by the first image in the stack.
Multichannel image data (RGB, RGBA) is stored in 3- or 4-element tuples, which can contain 2D or 3D image arrays for each channel.