Main¶
- The Main tab view contains information about the content of the file (file format, image size, data type and range, color space and image comment).
genre | FileMain |
authors | Tobias Boskamp, Dirk Selle |
package | MeVisLab/Standard |
dll | MLImageFile |
definition | mlImageFile.def |
see also | ImageSave, OpenImage, SaveImage, MakeName, ImageLoadMulti, LoadBase, FileDirectory, DicomBrowser, LocalImage, MLImageFormatLoad, MLImageFormatSave, MLImageFormatFileCache, MLImageFormatInfo, DicomLUT, DicomPaletteLUT |
keywords | Open, File, Format, TIFF, DICOM, Analyze, Lumisys, Raw, PNM, PGM, PPM, JPEG, JPG, PNG, BMP |
The module ImageLoad opens an image file stored in one of the following formats:
The image file is opened by entering its path and name in the Filename field or by clicking the Browse button and selecting a file in the file open dialog. The Status field indicates, whether a file could be successfully opened. In case of an error, a more detailed error message is printed to the MeVisLab console.
When an image file could be opened, the Main tab view contains information about its content (file format, image size, data type and range and image comment).
The Close button closes the current file, the Load button can be used to re-open it.
The following file formats are recognized.
Format | Description |
---|---|
DICOM | Supports uncompressed 2D and 3D (single file multiframe) DICOM files. Some variants of compressed files are also supported. For accessing lookup tables and/or color palettes stored in the DICOM file, use the DicomLUT and DicomPaletteLUT modules. |
TIFF | Supports tile and strip organization, compression, 2D and 3D. |
DICOM/TIFF | See explanation below (Notes on the DICOM/TIFF format). |
RAW | Supports raw binary data files representing images of arbitrary size, dimension and type (see explanation in the Parameter Fields section). |
LUMISYS | Supports some variants of image files created by Lumisys scanners (experimental). |
PNM | Supports raw binary and ASCII variants of 2D PNM, PGM or PPM files. |
Analyze | Supports the Analyze 7.5 format, consisting of a header file (*.hdr) and a raw binary data file (*.img). The format supports 2D, 3D and 4D images. |
PNG | The Portable Network Graphics (PNG) format supports 2D gray and RGB images up to 16 bit per sample, with or without alpha channel, with or without lossless compression. |
JPEG | The wide-spread JPEG standard supports 8-bit 2D gray and RGB images with lossy compression. Lossless compression, 12-bit and JPEG-2000 are not supported. |
BMP | The wide-spread Windows bitmap format supports 8-bit 2D RGB and palette images. Compressed BMP images are not supported. |
MLImageFileFormat | The ML specific file format written by MLImageFormatSave and MLImageFormatFileCache. |
In order to store 3D and 4D images efficiently, MeVisLab uses pairs of TIFF and DICOM image files. Both parts of a DICOM/TIFF pair must have the same path and file name with different extensions of .dcm and .tif, resp. The TIFF file contains the image data, while the DICOM file contains all related information (e.g. patient, modality, acquisition details, image position and orientation, etc.). A DICOM/TIFF pair is automatically recognized when either of the two files is selected as input file.
If the TIFF file contains data of a datatype that is not supported by the DICOM standard (i.e. int32, uint32 and float), the datatype specified in the DICOM file is ignored. This allows to read (u)int32 or float images stored as DICOM/TIFF by the ImageSave module.
The module has one output containing the image loaded from the disk.
Auto Load: Bool | format: String | sizeX: Integer |
Byte Order: Enum | Load File: Trigger | sizeY: Integer |
C: Integer | maxValue: Float | sizeZ: Integer |
Close File: Trigger | minValue: Float | Status: String |
colorSpace: String | Page Size: String | suppressErrorLog: Bool |
comment: String | Page Size Hint: String | T: Integer |
Data Offset: Integer | Planar Config: Enum | U: Integer |
Data Type: Enum | readRaw: Bool | X: Integer |
dataType: String | sizeC: Integer | Y: Integer |
dicomIgnoreHalfVoxelShift: Bool | sizeT: Integer | Z: Integer |
Filename: String | sizeU: Integer |
Sets the file name of the image file to open it.
The file name can also be browsed by pressing the Browse button.
If checked, the image is loaded on all field changes and on loading a network.
Sets the image size in x-dimension.
Sets the image size in y-dimension.
Sets the image size in z-dimension.
Sets the image size in c-dimension.
Sets the image size in t-dimension.
Sets the image size in u-dimension.
Defines the data type.
Values:
Title | Name | Deprecated Name |
---|---|---|
unsigned int8 | unsigned int8 | UInt8 |
int8 | int8 | Int8 |
unsigned int16 | unsigned int16 | UInt16 |
int16 | int16 | Int16 |
unsigned int32 | unsigned int32 | UInt32 |
int32 | int32 | Int32 |
float | float | Float |
double | double |
Defines the color plane configuration.
Values:
Title | Name | Description |
---|---|---|
Contiguous | Contiguous | The color components are expected to be arranged like RGBRGBRGB.... |
Separate | Separate | The color components are expected to be arranged like RRRR... GGGG... BBBB....... |
Defines the byte order.
Values:
Title | Name | Description |
---|---|---|
Little Endian | LittleEndian | Values are stored in the order low-byte - high-byte. |
Big Endian | BigEndian | Values are stored in the order high-byte - low-byte. |
Native | Native | The byte order used by the CPU (little endian for Intel CPUs, big endian for 68K and PPC CPUs). |
Sets the number of leading bytes before the actual image data start.