10.121. Read Zeiss TXM/TXRM Files
Group (Subgroup)
IO (Read)
Description
This filter will read the entire volume or optionally a cropped subvolume from a .txm or .txrm file. These files are Zeiss X-ray computed tomography (xCT) reconstruction files.
The volume is read into a new Image Geometry. The geometry’s spacing and origin (and the physical-length units associated with them) are read directly from the source file; the filter does not convert or override them. The voxel values are stored in a Cell Attribute Matrix (default name Cell Data) in a single-component array (default name CT_Data). The created array’s type is determined by the source file and is one of float32, uint16, or uint8.
The cropping type options in the Cropping Options section are No Cropping to read the full volume into an image geometry, Voxel Subvolume to read a subvolume into an image geometry using voxel coordinates, and Physical Subvolume to read a subvolume into an image geometry using physical coordinates. Both subvolume cropping types have checkboxes to turn on/off cropping in each of the X, Y, and Z dimensions. So for example, if the cropping type Physical Subvolume is selected, Crop Y Dimension is turned on, and Crop X Dimension and Crop Z Dimension are turned off, then the incoming volume will be cropped in the Y dimension only and the cropping bounds will be in physical units.
WARNING
Be aware of how large of data you are reading into DREAM3D-NX as these files can become quite large and will overwhelm the visualization system. It is recommended that you view the data as a “2D Slice/Image View” or “Volume Render” view.
Required Input Sources
None — this filter reads directly from a .txm or .txrm file on disk.
Input Parameter(s)
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Zeiss TXM/TXRM File |
FileSystemPath |
The input Zeiss TXM/TXRM file |
Cropping Options
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Cropping Options |
CropGeometry |
The cropping options used to crop the incoming data. These include picking the cropping type, the cropping dimensions, and the cropping ranges for each chosen dimension. |
Output Geometry
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Image Geometry |
DataGroupCreation |
Path to create the Image Geometry |
Output Cell Attribute Matrix
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
Cell Attribute Matrix |
DataObjectName |
The attribute matrix created as a child of the image geometry |
Output Data Array
Parameter Name |
Parameter Type |
Parameter Notes |
Description |
|---|---|---|---|
CT Data |
DataObjectName |
The data array created as a child of the attribute matrix |
References
This code uses the MIT licensed OLESS software library.
Example Pipelines
License & Copyright
Please see the description file distributed with this Plugin
DREAM3D-NX Help
If you need help, need to file a bug report or want to request a new feature, please head over to the DREAM3DNX-Issues GitHub site where the community of DREAM3D-NX users can help answer your questions.