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.
- Output layer type specifies the type of raster output that will be created. The output can be either a tiled imagery layer or a dynamic imagery layer.
- 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
- Geographic transformations
- 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
Credits
This tool consumes credits.
Use Estimate credits to calculate the number of credits that will be required to run the tool. For more information, see Understand credits for spatial analysis.
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:
- Professional or Professional Plus user type
- Publisher, Facilitator, or Administrator role, or an equivalent custom role with the Imagery Analysis privilege
Resources
Use the following resources to learn more: