```{index} single: Filters; Read Image (ITK)
```
# Read Image (ITK)

This filter directly wraps an ITK filter of the same name.

## Group (Subgroup)

ITKImageProcessing (ITKImageProcessing)

## Description

Reads images through the ITK software library [https://www.itk.org](https://www.itk.org)

The following image types are supported:

- PNG
- TIFF
- BMP
- JPG
- NRRD
- MHA

The user is required to set the origin and spacing (Length units per pixel) for the imported image. The default values are an origin
of (0,0,0) and a spacing of (1,1,1). Any values stored in the actual input file **will be overridden** by the values from the user interface


### Input Parameter(s)

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| File | FileSystemPath |  | Input image file |
| Length Unit | Choices |  | The length unit that will be set into the created image geometry |
| Set Origin | Bool |  | Specifies if the origin should be changed |
| Put Input Origin at the Center of Geometry | Bool |  | Specifies if the origin should be aligned with the corner (false) or center (true) |
| Origin (Physical Units) | Vector of Float64 Values | Order=X,Y,Z | Specifies the new origin values in physical units. |
| Set Spacing | Bool |  | Specifies if the spacing should be changed |
| Spacing (Physical Units) | Vector of Float64 Values | Order=X,Y,Z | Specifies the new spacing values in physical units. |
| Set Image Data Type | Bool |  | Set the final created image data type. |
| Output Data Type | Choices |  | Numeric Type of data to create |

### Cropping Options

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Cropping Options | CropGeometry |  | The cropping options used to crop images.  These include picking the cropping type, the cropping dimensions, and the cropping ranges for each chosen dimension. |

### Output Data Object(s)

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Created Image Geometry | DataGroupCreation |  | The path to the created Image Geometry |
| Created Cell Attribute Matrix | DataObjectName |  | The name of the created cell attribute matrix |
| Created Cell Data | DataObjectName |  | The name of the created image data array. Will be stored in the created Cell Attribute Matrix |

## Example Pipelines

+ Image Histogram

## 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](https://github.com/BlueQuartzSoftware/DREAM3DNX-Issues/discussions) GitHub site where the community of DREAM3D-NX users can help answer your questions.
