Available with ArcGIS Image for ArcGIS Online.
The Locate Regions tool identifies the best regions in the input raster that meet specified size requirements and spatial constraints.
The output is a hosted imagery layer.
Learn more about how Locate Regions works
Examples
Example scenarios using a surface created from a suitability model, you can identify the best regions for the following:
- The most preferred deer habitat to conserve. Eight habitat patches (regions) are needed to maintain a viable population, and each region must be approximately 50 contiguous acres. To support breeding opportunities within the herd, the regions should be close enough to one another so that they can be feasibly connected through wildlife corridors.
- The best locations to extract timber for a logging operation. To be financially viable, the areas (regions) to be logged must be at least 250 contiguous acres and each region must be within one mile from another.
- The ideal location for a new shopping center. The shopping center requires the best 60 acres, however, for construction purposes, the area needs to be contiguous and the shape of the building site (region) should be as compact as possible.
Usage notes
Locate Regions includes configurations for input layers, locate settings, evaluation criteria, region requirements, region growth specifications, and result layer.
Input layers
The Input layers group includes the following parameters:
The Input raster is the utility raster from which the regions will be derived.
The higher the value in the input raster, the greater the utility.
The raster can be of either integer or floating-point type.
The Optional regions layer group includes the following parameter:
The Input raster or feature of existing regions identifies where regions already exist.
The input can be a raster or feature. You can choose a layer using the Layer button or use the Draw input features button to create a sketch layer to use as the input. If the input is a raster, any location in the raster with a valid value is considered already allocated. All other locations are set to NoData.
In the parameterized region-growing (PRG) algorithm, no region will grow from any location identified as an existing region. Existing regions will be used in the growth and evaluation of the Minimum distance between regions and Maximum distance between regions parameters, as described in the corresponding parameter descriptions below.
Locate settings
The Locate settings group includes the following parameters:
The Total area parameter specifies the total amount of area for all regions.
If no value is entered for this parameter, the calculation is based on 10 percent of the input cells within the processing extent.
The Area units parameter defines the area units used for the Total area, Region minimum area, and Region maximum area parameters.
The available options and their corresponding units are the following:
- Square map units—The square of the linear units of the output spatial reference. This is the default.
- Square miles
- Square kilometers
- Hectares
- Acres
- Square meters
- Square yards
- Square feet
The Number of regions parameter specifies how many regions the Total area will be distributed across.
The maximum number of regions that can be specified is 30. The default is 1.
Evaluation criteria
The Evaluation criteria group includes the following parameters:
The Shape/Utility tradeoff (%) identifies the weight for the cells when growing the candidate regions in the parameterized region-growing algorithm. The weighting is a trade-off between a cell's contribution for maintaining the region shape relative to the utility contribution of the cell's attribute value.
Higher values indicates maintaining the shape of the region is more important than selecting higher utility values. The acceptable percent values are 0 to 100, inclusively. The default is 50.
This parameter is used to identify the feasible candidate regions. The candidate regions that will be selected by the algorithm are controlled by the Evaluation method parameter.
The Evaluation method identifies the evaluation criteria to be used for determining which of the candidate regions identified in the parameterized region-growing algorithm are most preferred. The preference can be specified based on a particular statistic of the utility values, or spatial arrangement of the cells within the regions.
The available options are the following:
Highest average value—Selects regions based on the highest average value. This is the default.
Highest sum—Selects regions based on the highest sum.
Highest median value—Selects regions based on the highest median value.
Highest value—Selects regions based on the highest individual cell value contained within the region. This option ensures the best individual cells are selected.
Lowest value—Selects regions based on the highest lowest individual cell value contained within the region. This option ensures the selected regions contain cells with low utility.
Greatest core area—Selects regions based on the greatest core area. Any cell that is farther than one cell from the edge of a region is considered to be part of the core. The edge distance can be controlled by the analysis cell size. Setting a smaller cell size can increase the core area.
Highest sum of core utility values—Selects regions based on the highest cumulative sum of the utility values for the core area. The edge distance can be controlled by the analysis cell size.
Greatest edge—Selects regions based on the greatest amount of edge using the P1 ratio, which is the ratio of the perimeter of the shape to the perimeter of a circle of the same area. The P1 ratio for a circle is 1.
Region requirements
The Region requirements group includes the following parameters:
The Region shape defines the shape characteristics for the output regions.
The regions start out from seed cell locations and grow outward with preference given to the cells that maintain the desired shape.
The available shape options are the following: Circle, Ellipse, Equilateral triangle, Square, Pentagon, Hexagon, and Octagon. The default is Circle. When a shape is specified, the cells that maintain the specified shape regions will receive a greater weight.
The Region orientation parameter defines the orientation of the defined shape. Regions are grown out from the seed locations with preference given to the cells that maintain the desired orientation of the region shapes.
The orientation values are in compass degrees ranging from 0 to 360, increasing clockwise starting from north. The default is 0.
The default of 0 orients the shapes in the following manner:
- Circle—no effect.
- Ellipse—the minor axis is orientated north-south.
- Triangle and Pentagon—one point is straight up.
- Square, Hexagon, and Octagon—one flat side is oriented east-west.
If the Region shape is set to Circle, the Region orientation parameter is unavailable.
The Region minimum area identifies the minimum area allowed for each region.
The units specified by the Area units parameter will be used.
The Region maximum area identifies the minimum area allowed for each region.
The units specified by the Area units parameter will be used.
The Minimum distance between regions defines the minimum distance allowed between regions. No two regions can be within this distance.
This parameter influences the parameterized region-growing algorithm. If a cell has the potential of being added to a candidate region, but it is within this distance from any individual region in the dataset specified by the Input raster or feature of existing regions parameter, it will not be considered for the candidate region. The minimum distance setting is not applied to excluded locations (NoData cells).
The units specified by the Distance units parameter will be used.
The Maximum distance between regions defines the maximum distance allowed between regions. No region can be farther apart than this distance from at least one other region.
When sequentially selecting regions, if the next best region is farther than this distance from any of the already selected regions, it will not be considered at this time, but it may be selected later when more regions are selected.
The maximum distance is applied to the dataset specified in the Input raster or feature of existing regions parameter, in that at least one of the selected regions must be within the maximum distance from existing regions. The maximum distance setting is not applied to excluded areas (NoData cells) and has no effect on the parameterized region-growing algorithm.
The units specified by the Distance units parameter will be used.
The Distance units parameter defines the distance units that will be used for the Minimum distance between regions and Maximum distance between regions parameters.
The available options and their corresponding units are the following:
- Map units—For the linear units of the output spatial reference. This is the default.
- Miles
- Kilometers
- Meters
- Yards
- Feet
Region growth specifications
The Region growth specifications group includes the following parameters:
The Number of neighbors to use in growth parameter defines which neighboring cells to use in the growth of the regions.
The available options are the following:
- Four—Only the four direct (orthogonal) neighbors of the region cells will be considered in the region growth.
- Eight—The eight nearest neighbors (orthogonal and diagonal) will be considered in the region growth. This is the default.
The Islands not allowed in regions parameter defines whether islands will be allowed within the potential regions.
Checked—The parameterized region-growing algorithm ensures there will be no islands within a region. This is the default.
A flood field algorithm is implemented as a postprocess once the regions are created but before the regions are selected. If there are islands within a region, they will be filled in and the cells will join the region. Since the fill process occurs before the selection process, the utility of the island cells will be added to the region, and their values will be included in the selection process of the regions and in the statistics of the output regions. As a result of the fill process, it is likely that the total area allocated will exceed the target specified by the Total area parameter.
Unchecked—Islands will be allowed.
The Number of seeds to grow from parameter defines the number of seeds from which to grow the potential regions.
The available options are the following:
Based on input—The number of seeds will be based on the number of cells in the input raster. This is the default.
When the input raster has 100,000 cells or fewer, the tool uses the maximum number of seeds. When the input raster has more than 100,000 cells, it uses the small number of seeds.
- Small—The number of seeds will be equal to 10 percent of the number of cells in the input raster, after NoData cells are excluded, but not to exceed 1,600 seeds.
- Medium—The number of seeds will be equal to 20 percent of the number of cells in the input raster, after NoData cells are excluded, but not to exceed 2,500 seeds.
- Large—The number of seeds will be equal to 30 percent of the number of cells in the input raster, after NoData cells are excluded, but not to exceed 3,600 seeds.
- Maximum—The region growth will occur at each available cell within the input raster. Available cells are all cells that are not NoData and not identified as an existing region.
The Resolution of the growth parameter sets the resolution at which region growth occurs.
The input raster will be resampled to the resolution determined by the number of cells identified by this parameter. Once the regions are selected from the resampled intermediate raster, the selected regions will be resampled to the analysis cell size, either specified from the Environment settings, or calculated internally by the tool, from the inputs provided.
An adjustment to the target resolutions identified below may be implemented if the number of cells in the desired average region size is too small or too large. This adjustment makes sure there will be enough cells in each desired region or that unnecessary processing will not occur. As a result, the total cells for the intermediate resampled raster for each of the specified resolutions below can be lower or higher than the target number of cells.
If the input has fewer than 147,356 cells or Maximum is selected, no resampling will occur and the region growth will process on all cells in the input raster. If the input raster has fewer than 147,356 cells, the Low, Medium, or High options have no effect.
The available options are the following:
Based on input—The resolution will be based on the number of cells in the input raster. This is the default.
When the input raster has 500,000 cells or fewer, the tool uses the maximum resolution. When the input raster has more than 500,000 cells, it uses the low resolution.
Low—The analysis will be performed on an intermediate raster containing 147,356 (384 x 384) cells distributed in the same x and y ratio as the input raster.
Medium—The analysis will be performed on an intermediate raster containing 262,144 (512 x 512) cells distributed in the same x and y ratio as the input raster.
High—The analysis will be performed on an intermediate raster containing 589,824 (768 x 768) cells distributed in the same x and y ratio as the input raster.
Maximum—The analysis will be performed on all cells in the input raster.
The Region selection method parameter identifies how the regions will be selected.
The available options are the following:
Based on number of regions—The selection method is based on the Number of regions parameter. If the Number of regions is eight or fewer, the Combinatorial selection method is used. If the Number of regions parameter is greater than eight, the Sequential selection method is used. This is the default.
Combinatorial—Selects the best regions based on the specified evaluation method, while honoring the spatial constraints, by testing all combinations of the desired number of regions within the candidate regions from the parameterized region-growing algorithm.
Sequential—Sequentially selects the best regions based on the evaluation method and that meets the spatial constraints until the desired number of regions is reached.
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
- Processing extent
Note:
The default processing extent in Map Viewer 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 is a regions raster. Each region is uniquely numbered with values greater than zero. Cells that do not belong to any regions will be assigned zero.
The output is always an integer raster.
Licensing requirements
This tool requires the following licensing and configurations:
- Creator or GIS Professional user type
- Publisher, Facilitator, or Administrator role, or an equivalent custom role
- ArcGIS Image for ArcGIS Online
Resources
Use the following resources to learn more:
- How Locate Regions works
- Locate Regions in ArcGIS REST API
- Locate Regions in ArcGIS Pro with the Spatial Analyst extension