```{index} single: Filters; ITK Binary Projection Image Filter
```
# ITK Binary Projection Image Filter

Binary projection.

## Group (Subgroup)

ITKImageStatistics (ImageStatistics)

## Description

Image projection is a very common task in image analysis to reduce the dimension of an image. A base
filter is provided with some specialized filters which implement different projection methods.

This class was contributed to the Insight Journal by Gaetan Lehmann. The original paper can be found at <https://www.insight-journal.org/browse/publication/71>

## IMPORTANT NOTE

This filter will change the dimensionality of the Image Geometry that the data is tied to. This has the side effect of also
changing **every** Data Array that is store in the same AttributeMatrix as the input and output data array.

### Author

 Gaetan Lehmann. Biologie du Developpement et de la Reproduction, INRA de Jouy-en-Josas, France.

### Related Filters

- ProjectionImageFilter
- MedianProjectionImageFilter
- MeanProjectionImageFilter
- MeanProjectionImageFilter
- MaximumProjectionImageFilter
- MinimumProjectionImageFilter
- StandardDeviationProjectionImageFilter
- SumProjectionImageFilter


### Input Parameter(s)

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Projection Dimension | Scalar Value |UInt32 | The dimension index to project. 0=Slowest moving dimension. |
| Perform In-Place | Bool |  | Performs the projection in-place for the given Image Geometry |
| Foreground Value | Scalar Value |Float64 | Set the value in the image to consider as 'foreground'. Defaults to maximum value of PixelType. Subclasses may alias this to DilateValue or ErodeValue. |
| Background Value | Scalar Value |Float64 | Set the value used as 'background'. Any pixel value which is not DilateValue is considered background. BackgroundValue is used for defining boundary conditions. Defaults to NumericTraits<PixelType>::NonpositiveMin() . |

### Input Cell Data

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Image Geometry | Geometry Selection | Image | Select the Image Geometry Group from the DataStructure. |
| Input Cell Data | Array Selection | Allowed Types: int8, uint8, int16, uint16, int32, uint32, int64, uint64, float32, float64 | The image data that will be processed by this filter. |

### Output Data

| Parameter Name | Parameter Type | Parameter Notes | Description |
|----------------|----------------|-----------------|-------------|
| Created Image Geometry | String |  | The name of the projected geometry |
| Output Image Data Array | DataObjectName |  | The result of the processing will be stored in this Data Array. |

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