4.8.8 SOM Classification

SOM image classification.

Detailed description

Unsupervised Self Organizing Map image classification.

Parameters

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





Parameter key

Parameter type

Parameter description




in

Input image

InputImage

out

Output image

OutputImage

vm

Input image

ValidityMask

tp

Float

TrainingProbability

ts

Int

TrainingSetSize

som

Output image

SOM Map

sx

Int

SizeX

sy

Int

SizeY

nx

Int

NeighborhoodX

ny

Int

NeighborhoodY

ni

Int

NumberIteration

bi

Float

BetaInit

bf

Float

BetaFinal

iv

Float

InitialValue

ram

Int

Available RAM (Mb)

rand

Int

set user defined seed

inxml

XML input parameters file

Load otb application from xml file

outxml

XML output parameters file

Save otb application to xml file











Table 4.126: Parameters table for SOM Classification.

Example

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

otbcli_SOMClassification -in QB_1_ortho.tif -out SOMClassification.tif -tp 1.0 -ts 16384 -sx 32 -sy 32 -nx 10 -ny 10 -ni 5 -bi 1.0 -bf 0.1 -iv 0

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 SOMClassification application 
SOMClassification = otbApplication.Registry.CreateApplication("SOMClassification") 
 
# The following lines set all the application parameters: 
SOMClassification.SetParameterString("in", "QB_1_ortho.tif") 
 
SOMClassification.SetParameterString("out", "SOMClassification.tif") 
 
SOMClassification.SetParameterFloat("tp", 1.0) 
 
SOMClassification.SetParameterInt("ts", 16384) 
 
SOMClassification.SetParameterInt("sx", 32) 
 
SOMClassification.SetParameterInt("sy", 32) 
 
SOMClassification.SetParameterInt("nx", 10) 
 
SOMClassification.SetParameterInt("ny", 10) 
 
SOMClassification.SetParameterInt("ni", 5) 
 
SOMClassification.SetParameterFloat("bi", 1.0) 
 
SOMClassification.SetParameterFloat("bf", 0.1) 
 
SOMClassification.SetParameterFloat("iv", 0) 
 
# The following line execute the application 
SOMClassification.ExecuteAndWriteOutput()

Limitations

None

Authors

This application has been written by OTB-Team.