1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
|
<root>
<key>TrainVectorClassifier-rf</key>
<exec>otbcli_TrainVectorClassifier</exec>
<longname>TrainVectorClassifier (rf)</longname>
<group>Learning</group>
<description>Train a classifier based on labeled geometries and a list of features to consider.</description>
<parameter>
<parameter_type source_parameter_type="ParameterType_InputVectorData">ParameterVector</parameter_type>
<key>io.vd</key>
<name>Input Vector Data</name>
<description>Input geometries used for training (note : all geometries from the layer will be used)</description>
<shapetype />
<optional>False</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_InputFilename">ParameterFile</parameter_type>
<key>io.stats</key>
<name>Input XML image statistics file</name>
<description>XML file containing mean and variance of each feature.</description>
<isFolder />
<optional>True</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_OutputFilename">OutputFile</parameter_type>
<key>io.confmatout</key>
<name>Output confusion matrix</name>
<description>Output file containing the confusion matrix (.csv format).</description>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_OutputFilename">OutputFile</parameter_type>
<key>io.out</key>
<name>Output model</name>
<description>Output file containing the model estimated (.txt format).</description>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_StringList">ParameterString</parameter_type>
<key>feat</key>
<name>Field names for training features.</name>
<description>List of field names in the input vector data to be used as features for training.</description>
<options />
<default />
<optional>False</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_String">ParameterString</parameter_type>
<key>cfield</key>
<name>Field containing the class id for supervision</name>
<description>Field containing the class id for supervision. Only geometries with this field available will be taken into account.</description>
<default>class</default>
<multiline />
<optional>False</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_Int">ParameterNumber</parameter_type>
<key>layer</key>
<name>Layer Index</name>
<description>Index of the layer to use in the input vector file.</description>
<minValue />
<maxValue />
<default>0</default>
<optional>True</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_InputVectorData">ParameterVector</parameter_type>
<key>valid.vd</key>
<name>Validation Vector Data</name>
<description>Geometries used for validation (must contain the same fields used for training, all geometries from the layer will be used)</description>
<shapetype />
<optional>True</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_Int">ParameterNumber</parameter_type>
<key>valid.layer</key>
<name>Layer Index</name>
<description>Index of the layer to use in the validation vector file.</description>
<minValue />
<maxValue />
<default>0</default>
<optional>True</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_Choice">ParameterSelection</parameter_type>
<key>classifier</key>
<name>Classifier to use for the training</name>
<description>Choice of the classifier to use for the training.</description>
<options>
<choices>
<choice>rf</choice>
</choices>
</options>
<default>0</default>
<optional>False</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_Int">ParameterNumber</parameter_type>
<key>classifier.rf.max</key>
<name>Maximum depth of the tree</name>
<description>The depth of the tree. A low value will likely underfit and conversely a high value will likely overfit. The optimal value can be obtained using cross validation or other suitable methods.</description>
<minValue />
<maxValue />
<default>5</default>
<optional>False</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_Int">ParameterNumber</parameter_type>
<key>classifier.rf.min</key>
<name>Minimum number of samples in each node</name>
<description>If the number of samples in a node is smaller than this parameter, then the node will not be split. A reasonable value is a small percentage of the total data e.g. 1 percent.</description>
<minValue />
<maxValue />
<default>10</default>
<optional>False</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_Float">ParameterNumber</parameter_type>
<key>classifier.rf.ra</key>
<name>Termination Criteria for regression tree</name>
<description>If all absolute differences between an estimated value in a node and the values of the train samples in this node are smaller than this regression accuracy parameter, then the node will not be split.</description>
<minValue />
<maxValue />
<default>0</default>
<optional>False</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_Int">ParameterNumber</parameter_type>
<key>classifier.rf.cat</key>
<name>Cluster possible values of a categorical variable into K <= cat clusters to find a suboptimal split</name>
<description>Cluster possible values of a categorical variable into K <= cat clusters to find a suboptimal split.</description>
<minValue />
<maxValue />
<default>10</default>
<optional>False</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_Int">ParameterNumber</parameter_type>
<key>classifier.rf.var</key>
<name>Size of the randomly selected subset of features at each tree node</name>
<description>The size of the subset of features, randomly selected at each tree node, that are used to find the best split(s). If you set it to 0, then the size will be set to the square root of the total number of features.</description>
<minValue />
<maxValue />
<default>0</default>
<optional>False</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_Int">ParameterNumber</parameter_type>
<key>classifier.rf.nbtrees</key>
<name>Maximum number of trees in the forest</name>
<description>The maximum number of trees in the forest. Typically, the more trees you have, the better the accuracy. However, the improvement in accuracy generally diminishes and reaches an asymptote for a certain number of trees. Also to keep in mind, increasing the number of trees increases the prediction time linearly.</description>
<minValue />
<maxValue />
<default>100</default>
<optional>False</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_Float">ParameterNumber</parameter_type>
<key>classifier.rf.acc</key>
<name>Sufficient accuracy (OOB error)</name>
<description>Sufficient accuracy (OOB error).</description>
<minValue />
<maxValue />
<default>0.01</default>
<optional>False</optional>
</parameter>
<parameter>
<parameter_type source_parameter_type="ParameterType_Int">ParameterNumber</parameter_type>
<key>rand</key>
<name>set user defined seed</name>
<description>Set specific seed. with integer value.</description>
<minValue />
<maxValue />
<default>0</default>
<optional>True</optional>
</parameter>
</root>
|
