Train Random Trees Regression Model

inputRasters

(Required)

A raster or a list of input rasters. The input rasters can be the Portal Item ID, Image Service URL, cloud multidimensional raster dataset or shared raster dataset. The rasters can be single-band, multidimensional, multiband raster datasets, or mosaic datasets, containing explanatory variables

An input mosaic dataset will be treated as a raster dataset, not a collection of rasters. To use a collection of rasters as input, build multidimensional info for the mosaic dataset and use the result as input.

At least one type of input needs to be provided in the JSON object. If multiple inputs are given, the itemIds takes priority.

Syntax: A JSON object describing the input raster(s).

Example for a single inputRasters item.

1
2
3
inputRasters = {"itemId": <portal item id>}
inputRasters  = {"url": <image service url>}
inputRasters = {"uri": <cloud raster uri or shared data path>}

Example for multiple inputRasters items.

1
2
3
inputRasters = {"itemIds": [<portal item id>, <portal item id>, <portal item id>]}
inputRasters  = {"urls": [<image service url>, <image service url>, <image service url>]}
inputRasters  = {"uris": [<cloud raster uri or shared data path>, <cloud raster uri or shared data path>]}

inputTargetData

(Required)

The raster or point feature class containing the target variable (dependent variable) data.

This parameter can have either a raster input or a feature input. For raster input, this parameter can be specified as a portal item ID, a URL to a raster image service layer, a cloud raster dataset, or a shared raster dataset. For feature input, this parameter can be specified as a URL to a feature service layer, shared data path or service properties.

When the target is a feature, the targetValueField value must be set to a numeric field.

If the input target feature has a date field or a field that defines a dimension, specify a value for both targetValueField and targetDimensionField .

Syntax: A JSON object that describes the input.

Example

1
2
3
inputTargetData ={"itemId": <portal item id>}
inputTargetData = {"url": <image service url or feature service url>}
inputTargetData = {"uri": <cloud raster uri or shared data path>}

targetValueField

(Optional)

The field name of the information to model in the target point feature class or raster dataset.

Syntax: String representing the targetValueField .

Example

1
"median_house"

targetDimensionField

(Optional)

A date field or numeric field in the input point feature class that defines the dimension values.

Syntax: String representing the targetDimensionField .

Example

1
"Date_Local"

rasterDimension

(Optional)

The dimension name of the input multidimensional raster (explanatory variables) that links to the dimension in the target data.

Syntax: String representing the rasterDimension .

Example

1
"StdTime"

outputImportanceTableName

(Optional)

The output table feature service name that will be created. You can specify the name, or you can create an empty service using Portal Admin Sharing API and use the returned JSON object as input to this parameter.

Syntax: A JSON object that describes the name of the output or the output table.

Example of outputImportanceTableName

1
{"serviceProperties":{"name":<service name>}}

maxNumberOfTrees

(Optional)

The maximum number of trees in the random forest. Increasing the number of trees will lead to higher accuracy rates, although this improvement will level off. The number of trees increases the processing time linearly. The default is 50.

Syntax: A long value that represents the maxNumberOfTrees .

Example

1
60

maxTreeDepth

(Optional)

The maximum depth of each tree in the random forest. Depth determines the number of rules each tree can create, resulting in a decision. Trees will not grow any deeper than this setting. The default is 30.

Syntax: A long value that represents the maxTreeDepth .

Example

1
100

maxNumberOfSamples

(Optional)

The maximum number of samples that will be used for the regression analysis. A value that is less than or equal to 0 means that the system will use all the samples from the input target raster or point feature class to train the regression model. The default value is 100,000.

Syntax: A long value that represents the maxNumberOfSamples .

Example

1
25000

averagePointsPerCell

(Optional)

Specifies whether the average will be calculated when multiple training points fall into one cell. This parameter is applicable only when the input target is a point feature class.

• KEEP_ALL_POINTS —All points will be used when multiple training points fall into a single cell. This is the default.
• AVERAGE_POINTS_PER_CELL —The average value of the training points within a cell will be calculated.

Syntax: A String value representing the averagePointsPerCell .

Example

1
“KEEP_ALL_POINTS”

outputScatterPlotsName

(Optional)

The output scatterplots in PDF or HTML format. It includes scatterplots of training data, test data, and location test data.

Syntax: A JSON object that describes the name of the output or path to the datastore.

Examples

1
2
3
4
5
//name example
{"name": "output_plot"}

//uri example
{"uri": <datastore path>}

outputSampleFeaturesName

(Optional)

Outputs a feature class containing target values and predicted values for training points, test points, and location test points. You can specify the name, or you can create an empty service using Portal Admin Sharing API and use the returned JSON object as input to this parameter.

Syntax: A JSON object that describes the output feature service name.

Example

1
{"serviceProperties": {"name": "<service name>"}}

percentSamplesForTesting

(Optional)

Defines the percentage of test points used for error checking. The tool checks for three types of errors: errors on training points, errors on test points, and errors on test location points. The default is 10.

Syntax: A double value that represents the percentSamplesForTesting .

Example:

20

context

(Optional)

Contains additional settings that affect task execution. This task has the following settings:

• Cell Size (cellSize)—The output raster will have the resolution specified by cell size.

• Extent (extent)—A bounding box that defines the analysis area.

• Output Spatial Reference (outSR)—The output raster will be projected into the output spatial reference.

• Parallel Processing Factor (parallelProcessingFactor )—The specified number or percentage of processes will be used for the analysis.

f

(Optional)

The response format. The default response format is html.

Values: html | json