Bands From Features (Production Mapping)


Converts point, multipoint, polyline, or polygon elevation features within an area of interest (AOI) into polygon band features. Output band size is determined by defining ranges from an input attribute, like elevation, in the input feature class or layer. A polygon feature class or feature layer defines the AOI.



BandsFromFeatures_production (in_aoi_features, in_elevation_features, in_bands_units, out_bands_featureclass, in_ranges_as_percent, in_bands_ranges, {in_exclusion_features}, {in_rounding_option}, {in_iterations_count}, {in_tolerance}, {in_refine_triangulation}, {out_triangulation_featureclass}, {out_interpolated_isolines_featureclass}, {out_topological_errors_featureclass})
ParameterExplanationData Type

Polygon feature layer or feature class defining the area of interest.

Feature Layer
[[Feature layer, Field, Linear Unit],...]

The point, multipoint, polyline, or polygon feature layers or feature classes, their attribute fields (value fields) that contain elevation or isoline data, and distance units of those value fields.

Value Table

Output band distance units.

  • METERSOutput distance unit is meters. This is the default.
  • FEETOutput distance unit is feet.

The output feature class that contains the bands created by the tool.

Feature Class

Specifies if the tool interprets range values as values or percentiles.

  • ABSOLUTE_VALUEInterpret range values as values. This is the default.
  • PERCENTILE_VALUEInterpret range values as percentiles.
[[from_value, to_value, range_name],...]

The from-to range values for the bands that are going to be created. The list should contain space-delimited strings with a from value, to value, and a name for the range. A range from 100 to 200 feet could look like this: 100 200 low_elev.

Value Table

Polygon feature layers or feature classes used to exclude areas from processing where exclusion and AOI features overlap.

Feature Layer

Specifies whether input values round up, down, or interpolate within their range. Interpolate is the default option.

  • InterpolateEstimate values based on surrounding values. This is the default.
  • Round upRound elevation or isoline values up.
  • Round downRound elevation values down.

Number of times, from 1–5, the tool will run on a feature to narrow down the interpolated value. The default is 2.


This option is only available if PERCENTILE_VALUE is set for in_ranges_as_percent and in_rounding_option is set to Interpolate.


This option is only available if PERCENTILE_VALUE is set for in_ranges_as_percent and in_rounding_option is set to Interpolate.

Otherwise, tolerance is computed from the high and low value in the value field.


Specifies if the tool will run the refine triangulation algorithm.

  • REFINE_TRIANGULATIONRun refine triangulation processing. This is the default.
  • NO_REFINE_TRIANGULATIONDo not run refine triangulation processing.

The triangulated feature class used to generate bands from features.

Feature Class

Polyline feature class interpolated from Input Elevation Features.

Feature Class

Point feature class that contains topological error features produced during processing. Types of errors include:

  • Dangles: a line endpoint unconnected to any other feature.
  • Different elevations at a point: Multiple points with different elevations at the same location.
  • Intersections: Isoline intersection with equal elevation.
  • Intersection and Elevation: Both intersection and different elevation errors.

Feature Class

Code Sample

BandsFromFeatures example (Python window)

This ArcGIS Python window script demonstrates the use of the BandsFromFeatures function. The script uses a subset of production mapping sample data. The OrangeCounty feature class is an extract from the US_Counties data in the sample reference fGdb. The OC_ElevationBands feature class is an extract of the SoCal sample geodatabase contour data.

# Name:
# Description: Creates polygon bands from contour data
# Author: ESRI
# Date: March 2010

import arcpy

# area of interest feature class

# output bands feature class
OCBands = "C:/data/ElevationBands.gdb/OC_ElevationBands"

# set the toolbox
arcpy.ImportToolbox(r'C:\Program Files\ArcGIS\Desktop10.0\ArcToolbox\Toolboxes\Production Mapping Tools.tbx')

# path to the elevation/isoline feature class, attribute with range values, and range value units
ElevList = "C:/data/ElevationBands.gdb/OC_Elevations zv2 Meters"

# Range list used to define the bands
RangeList = "1000 1100 10-11;1100 1200 11-12;1200 1300 12-13;1300 1400 13-14;1400 1500 14-15;1500 1600 15-16"

# execute the tool - 
arcpy.BandsFromFeatures_production("OrangeCounty",ElevList,"Meters", OCBands, "ABSOLUTE_VALUE",RangeList,"","Interpolate", "2", 1, "REFINE_TRIANGULATION","", "", "")


Related Topics

Licensing Information

ArcView: No
ArcEditor: Requires Production Mapping
ArcInfo: Requires Production Mapping