# PredictRegression

## Brief Description

Performs a prediction of the input image according to a regression model file.

## Tags

Learning

## Long Description

This application predict output values from an input image, based on a regression model file produced by the TrainRegression application. Pixels of the output image will contain the predicted values fromthe regression model (single band). The input pixels can be optionally centered and reduced according to the statistics file produced by the ComputeImagesStatistics application. An optional input mask can be provided, in which case only input image pixels whose corresponding mask value is greater than 0 will be processed. The remaining of pixels will be given the value 0 in the output image.

## Parameters

- [param] -in <string> The input image to predict.. Mandatory: True. Default Value: ""
- [param] -mask <string> The mask allow restricting classification of the input image to the area where mask pixel values are greater than 0.. Mandatory: False. Default Value: ""
- [param] -model <string> A regression model file (produced by TrainRegression application).. Mandatory: True. Default Value: ""
- [param] -imstat <string> A XML file containing mean and standard deviation to center and reduce samples before prediction (produced by ComputeImagesStatistics application). If this file containsone more band than the sample size, the last stat of last band will beapplied to expand the output predicted value. Mandatory: False. Default Value: ""
- [param] -out <string> Output image containing predicted values. Mandatory: True. Default Value: ""
- [param] -ram <int32> Available memory for processing (in MB). Mandatory: False. Default Value: "128"
- [param] -inxml <string> Load otb application from xml file. Mandatory: False. Default Value: ""
- [param] -outxml <string> Save otb application to xml file. Mandatory: False. Default Value: ""

## Limitations

The input image must contain the feature bands used for the model training (without the predicted value). If a statistics file was used during training by the TrainRegression, it is mandatory to use the same statistics file for prediction. If an input mask is used, its size must match the input image size.

## Authors

OTB-Team

## See Also

TrainRegression, ComputeImagesStatistics

## Example of use

- in: QB_1_ortho.tif

- imstat: EstimateImageStatisticsQB1.xml

- model: clsvmModelQB1.svm

- out: clLabeledImageQB1.tif