[next] [prev] [prev-tail] [tail] [up]

#### 4.5.3 Mean Shift filtering

Perform mean shift filtering

##### Detailed description

This application performs mean shift fitlering (multi-threaded).

##### Parameters

This section describes in details the parameters available for this application. Table 4.29, page 396 presents a summary of these parameters and the parameters keys to be used in command-line and programming languages. Application key is MeanShiftSmoothing.

Parameter key | Parameter type | Parameter description
in | Input image | Input Image
fout | Output image | Filtered output
spatialr | Int | Spatial radius
ranger | Float | Range radius
thres | Float | Mode convergence threshold
maxiter | Int | Maximum number of iterations
modesearch | Boolean | Mode search.

Table 4.29: Parameters table for Mean Shift filtering.

- Input Image: The input image.
- Filtered output: The filtered output image.
- Spatial radius: Spatial radius of the neighborhood.
- Range radius: Range radius defining the radius (expressed in radiometry unit) in the multi-spectral space.
- Mode convergence threshold: Algorithm iterative scheme will stop if mean-shift vector is below this threshold or if iteration number reached maximum number of iterations.
- Maximum number of iterations: Algorithm iterative scheme will stop if convergence hasn’t been reached after the maximum number of iterations.
- Mode search.: If activated pixel iterative convergence is stopped if the path . Be careful, with this option, the result will slightly depend on thread number

##### Example

To run this example in command-line, use the following:

otbcli_MeanShiftSmoothing -in maur_rgb.png -fout MeanShift_FilterOutput.tif -spatialr 16 -ranger 16 -thres 0.1 -maxiter 100

To run this example from Python, use the following code snippet:

#!/usr/bin/python
# Import the otb applications package
import otbApplication
# The following line creates an instance of the MeanShiftSmoothing application
MeanShiftSmoothing = otbApplication.Registry.CreateApplication("MeanShiftSmoothing")
# The following lines set all the application parameters:
MeanShiftSmoothing.SetParameterString("in", "maur_rgb.png")
MeanShiftSmoothing.SetParameterString("fout", "MeanShift_FilterOutput.tif")
MeanShiftSmoothing.SetParameterInt("spatialr", 16)
MeanShiftSmoothing.SetParameterFloat("ranger", 16)
MeanShiftSmoothing.SetParameterFloat("thres", 0.1)
MeanShiftSmoothing.SetParameterInt("maxiter", 100)
# The following line execute the application
MeanShiftSmoothing.ExecuteAndWriteOutput()

##### Limitations

With mode search option, the result will slightly depend on thread number.

##### Authors

This application has been written by OTB-Team.

[next] [prev] [prev-tail] [front] [up]