MultiResolutionPyramid

Build a multi-resolution pyramid of the image.

Description

This application builds a multi-resolution pyramid of the input image. User can specified the number of levels of the pyramid and the subsampling factor. To speed up the process, you can use the fast scheme option

This application has several output images and supports “multi-writing”. Instead of computing and writing each image independently, the streamed image blocks are written in a synchronous way for each output. The output images will be computed strip by strip, using the available RAM to compute the strip size, and a user defined streaming mode can be specified using the streaming extended filenames (type, mode and value). Note that multi-writing can be disabled using the multi-write extended filename option: &multiwrite=false, in this case the output images will be written one by one. Note that multi-writing is not supported for MPI writers.

Parameters

Input Image -in image Mandatory

Output Image -out image [dtype] Mandatory
will be used to get the prefix and the extension of the images to write

Number Of Levels -level int Default value: 1
Number of levels in the pyramid (default is 1).

Subsampling factor -sfactor int Default value: 2
Subsampling factor between each level of the pyramid (default is 2).

Variance factor -vfactor float Default value: 0.6
Variance factor use in smoothing. It is multiplied by the subsampling factor of each level in the pyramid (default is 0.6).

Use Fast Scheme -fast bool Default value: false
If used, this option allows one to speed-up computation by iteratively subsampling previous level of pyramid instead of processing the full input.

Available RAM (MB) -ram int Default value: 256
Available memory for processing (in MB).

Examples

From the command-line:

otbcli_MultiResolutionPyramid -in QB_Toulouse_Ortho_XS.tif -out multiResolutionImage.tif -level 1 -sfactor 2 -vfactor 0.6 -fast false

From Python:

import otbApplication

app = otbApplication.Registry.CreateApplication("MultiResolutionPyramid")

app.SetParameterString("in", "QB_Toulouse_Ortho_XS.tif")
app.SetParameterString("out", "multiResolutionImage.tif")
app.SetParameterInt("level", 1)
app.SetParameterInt("sfactor", 2)
app.SetParameterFloat("vfactor", 0.6)
app.SetParameterString("fast","false")

app.ExecuteAndWriteOutput()