TrainImagesClassifier-rf otbcli_TrainImagesClassifier TrainImagesClassifier (rf) Learning Train a classifier from multiple pairs of images and training vector data. ParameterMultipleInput io.il Input Image List A list of input images. False ParameterMultipleInput io.vd Input Vector Data List A list of vector data to select the training samples. False ParameterFile io.imstat Input XML image statistics file Input XML file containing the mean and the standard deviation of the input images. True OutputFile io.confmatout Output confusion matrix Output file containing the confusion matrix (.csv format). OutputFile io.out Output model Output file containing the model estimated (.txt format). ParameterNumber elev.default Default elevation This parameter allows setting the default height above ellipsoid when there is no DEM available, no coverage for some points or pixels with no_data in the DEM tiles, and no geoid file has been set. This is also used by some application as an average elevation value. 0 ParameterNumber sample.mt Maximum training sample size per class Maximum size per class (in pixels) of the training sample list (default = 1000) (no limit = -1). If equal to -1, then the maximal size of the available training sample list per class will be equal to the surface area of the smallest class multiplied by the training sample ratio. 1000 ParameterNumber sample.mv Maximum validation sample size per class Maximum size per class (in pixels) of the validation sample list (default = 1000) (no limit = -1). If equal to -1, then the maximal size of the available validation sample list per class will be equal to the surface area of the smallest class multiplied by the validation sample ratio. 1000 ParameterBoolean sample.edg On edge pixel inclusion Takes pixels on polygon edge into consideration when building training and validation samples. True ParameterNumber sample.vtr Training and validation sample ratio Ratio between training and validation samples (0.0 = all training, 1.0 = all validation) (default = 0.5). 0.5 ParameterString sample.vfn Name of the discrimination field Name of the field used to discriminate class labels in the input vector data files. Class False ParameterSelection classifier Classifier to use for the training Choice of the classifier to use for the training. rf 0 ParameterNumber classifier.rf.max Maximum depth of the tree 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. 5 ParameterNumber classifier.rf.min Minimum number of samples in each node 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. 10 ParameterNumber classifier.rf.ra Termination Criteria for regression tree 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. 0 ParameterNumber classifier.rf.cat Cluster possible values of a categorical variable into K <= cat clusters to find a suboptimal split Cluster possible values of a categorical variable into K <= cat clusters to find a suboptimal split. 10 ParameterNumber classifier.rf.var Size of the randomly selected subset of features at each tree node 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. 0 ParameterNumber classifier.rf.nbtrees Maximum number of trees in the forest 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. 100 ParameterNumber classifier.rf.acc Sufficient accuracy (OOB error) Sufficient accuracy (OOB error). 0.01 ParameterNumber rand set user defined seed Set specific seed. with integer value. 0