Delineate Built-Up Areas (Cartography)

Summary

Creates polygons to represent built-up areas by delineating densely clustered arrangements of buildings on small-scale maps.

The boundaries—or edges—of the output polygons can be based on the location of other features such as roads or hydrology. Input buildings can be attributed to identify those that can be replaced in maps by the built-up area polygons for a more generalized depiction.

Illustration

Delineate Built-Up Areas tool example
The Delineate Built-Up Areas tool creates polygons that represent the distribution of input building features.

Usage

  • Input buildings are clustered together based on the Grouping Distance parameter to define dense arrangements of buildings that can be represented by a single built-up area polygon for smaller-scale display. Run the tool on the same input features with a different grouping distance to produce polygons representing different degrees of building grouping that can be used for display at differing scales or even shown together at a single scale.

  • Use Edge Features to align the edges of built-up area polygons to other features displayed on the same map, such as roads or administrative areas. Polygon outlines snap only to those features that are generally trending in the same direction as the polygon edge and within the grouping distance away.

  • Use Identifier Field to identify buildings that were considered in the formation of the built-up area polygons. When displaying built-up areas at midscale ranges, you can use a definition query on the building layers to draw only those buildings not represented by a built-up area.

  • To create a more simplified set of built-up area polygons for use at an even smaller scale, consider running the tool again, this time using the output built-up area polygons as the input layer. Use a larger Minimum Detail Size value to reduce the complexity of the polygons and a different Edge Features value (corresponding to features that will be drawn on the smaller-scale map), if applicable. Set the Minimum Building Count value to 1 in this case to ensure that all polygons are considered.

  • The output feature class includes a bldg_count field that indicates how many buildings are replaced by each built-up area polygon. Use this field in a layer definition query to limit the display of built-up area polygons to only those that represent a minimum number of buildings.

  • When point buildings are used as inputs, the edges of the resulting built-up area polygons may cross symbolized point buildings when drawn at scale. If this is undesirable, consider using the attributes in the identifier field to help identify buildings that fall near the edges of the built-up area polygons to filter them from display.

Parameters

LabelExplanationData Type
Input Building Layers

The layers containing buildings with density and arrangement that are used to define appropriate output built-up polygons. Multiple building layers can be assessed simultaneously. Building features can be points or polygons.

Feature Layer
Identifier Field
(Optional)

A field in the input feature classes that will hold a status code indicating whether the input feature is part of the resulting built-up area . This field must be either short or long integer type and common to all input layers if multiple input layers are used.

  • 0—The building is not represented by an output built-up area polygon.
  • 1—The building is represented by an output built-up area polygon and is within the resulting polygon.
  • 2—The building is represented by an output built-up area polygon and is outside the resulting polygon.

String
Edge Features
(Optional)

The layers that will be used to define the edges of the built-up area polygons. Typically, these are roads, but other common examples are rivers, coastlines, and administrative areas. Built-up area polygons snap to an edge feature if one is generally aligned with the trend of the polygon edge and within the grouping distance away. Edge features can be lines or polygons.

Feature Layer
Grouping Distance

Buildings closer together than the grouping distance are considered collectively as candidates for representation by an output built-up area polygon. This distance is measured from the edges of polygon buildings and the centers of point buildings.

Linear Unit
Minimum Detail Size

The relative degree of detail in the output built-up area polygons. This is approximately to the minimum allowable diameter of a hole or cavity in the built-up area polygon. The actual size and shape of holes and cavities within the polygon is determined also by the arrangement of the input buildings, the grouping distance, and the presence of edge features if they are used.

Linear Unit
Output Feature Class

The output feature class containing built-up area polygons representing clustered arrangements of input buildings.

Feature Class
Minimum Building Count
(Optional)

The minimum number of buildings that must be collectively considered for representation by an output built-up area polygon. The default value is 4. The minimum building count must be greater than or equal to 0.

Long

arcpy.cartography.DelineateBuiltUpAreas(in_buildings, {identifier_field}, {edge_features}, grouping_distance, minimum_detail_size, out_feature_class, {minimum_building_count})
NameExplanationData Type
in_buildings
[in_buildings,...]

The layers containing buildings with density and arrangement that are used to define appropriate output built-up polygons. Multiple building layers can be assessed simultaneously. Building features can be points or polygons.

Feature Layer
identifier_field
(Optional)

A field in the input feature classes that will hold a status code indicating whether the input feature is part of the resulting built-up area . This field must be either short or long integer type and common to all input layers if multiple input layers are used.

  • 0—The building is not represented by an output built-up area polygon.
  • 1—The building is represented by an output built-up area polygon and is within the resulting polygon.
  • 2—The building is represented by an output built-up area polygon and is outside the resulting polygon.

String
edge_features
[edge_features,...]
(Optional)

The layers that will be used to define the edges of the built-up area polygons. Typically, these are roads, but other common examples are rivers, coastlines, and administrative areas. Built-up area polygons snap to an edge feature if one is generally aligned with the trend of the polygon edge and within the grouping distance away. Edge features can be lines or polygons.

Feature Layer
grouping_distance

Buildings closer together than the grouping distance are considered collectively as candidates for representation by an output built-up area polygon. This distance is measured from the edges of polygon buildings and the centers of point buildings.

Linear Unit
minimum_detail_size

The relative degree of detail in the output built-up area polygons. This is approximately to the minimum allowable diameter of a hole or cavity in the built-up area polygon. The actual size and shape of holes and cavities within the polygon is determined also by the arrangement of the input buildings, the grouping distance, and the presence of edge features if they are used.

Linear Unit
out_feature_class

The output feature class containing built-up area polygons representing clustered arrangements of input buildings.

Feature Class
minimum_building_count
(Optional)

The minimum number of buildings that must be collectively considered for representation by an output built-up area polygon. The default value is 4. The minimum building count must be greater than or equal to 0.

Long

Code sample

DelineateBuiltUpAreas example (Python window)

The following Python window script demonstrates how to use the DelineateBuiltUpAreas function in immediate mode.

import arcpy
arcpy.env.workspace = "C:/data"
env.referenceScale = "50000"
arcpy.DelineateBuiltUpAreas_cartography("bldg_pnt;bldg_poly",
                                        "inBUA",
                                        "RoadNetwork",
                                        "100 Meters",
                                        "125 Meters",
                                        "BUApolypoint", 
                                        6)

Environments

Special cases

Reference Scale

The reference scale is only considered when the Grouping Distance or the Minimum Detail Size parameter value is entered in page units.

Licensing information

  • Basic: No
  • Standard: No
  • Advanced: Yes

Related topics