Bands From Features (Production Mapping)

Résumé

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.

Usage

Syntaxe

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})
ParamètreExplicationType de donnée
in_aoi_features

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

Feature Layer
in_elevation_features
[[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
in_bands_units

Output band distance units.

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

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

Feature Class
in_ranges_as_percent

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.
Boolean
in_bands_ranges
[[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
in_exclusion_features
[in_exclusion_features,...]
(Facultatif)

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

Feature Layer
in_rounding_option
(Facultatif)

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.
String
in_iterations_count
(Facultatif)

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

RemarqueRemarque :

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

String
in_tolerance
(Facultatif)
RemarqueRemarque :

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.

Double
in_refine_triangulation
(Facultatif)

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.
Boolean
out_triangulation_featureclass
(Facultatif)

The triangulated feature class used to generate bands from features.

Feature Class
out_interpolated_isolines_featureclass
(Facultatif)

Polyline feature class interpolated from Input Elevation Features.

Feature Class
out_topological_errors_featureclass
(Facultatif)

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

Exemple de code

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: BandsFromFeatures.py
# Description: Creates polygon bands from contour data
# Author: ESRI
# Date: March 2010

import arcpy

# area of interest feature class
arcpy.MakeFeatureLayer_management("C:/data/ElevationBands.gdb/OrangeCounty","OrangeCounty")

# 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","", "", "")

Environnements

Rubriques associées

Informations de licence

ArcView : RequiertProduction Mapping
ArcEditor : RequiertProduction Mapping
ArcInfo : RequiertProduction Mapping

9/30/2010