The Fill tool fills sinks and peaks in a surface raster to remove small imperfections in the data.
The output is a hosted imagery layer.
Usage notes
Fill includes configurations for the input layer, analysis setting, and result layer.
Input layer
The Input layer group includes the Input surface raster parameter.
The Input surface raster is the elevation raster that will be used for calculation.
A sink is a cell with an undefined drainage direction where no adjacent cells are lower. A peak is a cell where no adjacent cells are higher. To remove peaks, the Input surface raster layer must be inverted. This can be done with the Minus tool. Specify the highest value of the surface raster as the first input to the Minus tool and the surface raster as the second input. Then use the Fill tool. Invert the results to obtain a surface that has original surface raster values with the peaks removed.
Fill setting
The Fill setting group includes the Z-limit parameter, which specifies the maximum elevation difference to be filled between the depth of a sink and its pour point.
The Z-limit value is not the maximum depth to which a sink will be filled.
Unless a value is specified for this parameter, all sinks will be filled regardless of depth.
The value for the Z-limit parameter must be greater than zero.
If the difference in z-values between a sink and its pour point is greater than the specified Z-limit value, that sink will not be filled.
The Z-limit value can be applied when filling peaks as well. If no Z-limit value is specified, all peaks will be removed. If a Z-limit value is specified and the difference in z-values between a peak and its highest adjacent neighbor is greater than the Z-limit value, that peak will not be removed.
Result layer
The Result layer group includes the following parameters:
Output raster name is the name of the output raster layer that will be created and added to the map.
The name must be unique. If a layer with the same name already exists in your organization, the tool will fail and you will be prompted to use a different name.
- Save in folder specifies the name of a folder in My content where the result will be saved.
Environments
Analysis environment settings are additional parameters that affect a tool's results. You can access the tool's analysis environment settings from the Environment settings parameter group.
This tool honors the following analysis environments:
- Output coordinate system
- Processing extent
Note:
The default processing extent is Full extent. This default is different from Map Viewer Classic in which Use current map extent is enabled by default.
- Snap raster
- Cell size
- Mask
- Parallel processing factor
Output
The Output raster name parameter stores the surface raster after sinks have been filled.
Usage requirements
This tool requires the following user type and configurations:
- Creator, Professional, or Professional Plus user type
- Publisher or Administrator role, or an equivalent custom role
- Available when the organization is configured for raster analytics with a premium capability license
Resources
Use the following resources to learn more: