Calculate Metrics

摘要

Populates metrics for features in Esri Defense Mapping data models. Metrics include length, width, area, and elevation attributes.

用法

• Certain attributes must be present in Input Features. Attributes pertain to Defense Mapping data models, including Multinational Geospatial Co-production Program (MGCP) and Vector Map Level 1 (VMap 1) and Vector Map Level 2 (VMap 2).

• Supported attributes include the following:

  • Angle of Orientation—AOO, DOF, and FEO
  • Area—ARA, ARE, and ARE_
  • Elevation—ZV2 and ZVH (must be z-enabled data)
  • Length—LEG, LEN, LEN_, LGN, and LZN
  • Width—WID, WID_, and WGP

• Input metrics types are processed based on the geometry of the feature class:

  • Points—Elevation
  • Lines—Length, Angle of Orientation, and Elevation
  • Polygons—Length, Width, Area, Angle of Orientation, and Elevation

• The Input Length Attributes, Input Width Attributes, Input Area Attributes, Input Angle of Orientation Attributes, and Input Elevation Attributes parameters reference a comma-delimited list of field names in your data model. If one or more fields exist in Input Features, the field will be calculated according to the metrics chosen in the In Metric parameter.

• If the field names listed in Input Length Attributes, Input Width Attributes, Input Area Attributes, Input Angle of Orientation Attributes, and Input Elevation Attributes are not present in the Input Features parameter, the tool will report a warning but complete its metric computations.

• You can add your own field names to the list of options in the Input Length Attributes, Input Width Attributes, Input Area Attributes, Input Angle of Orientation Attributes, and Input Elevation Attributes parameters. This tool will attempt to compute metrics in your custom field.

语法

CalculateMetrics(in_features, in_metric_types, {in_length_attributes}, {in_width_attributes}, {in_area_attributes}, {in_angle_attributes}, {in_elevation_attributes}, {in_precision})

参数	说明	数据类型
in_features [in_features,...]	Features on which metrics will be calculated.	Feature Layer
in_metric_types [in_metric_types,...]	Types of metrics to calculate include angle of orientation, area, elevation, length, and width. ANGLE_OF_ORIENTATION —Calculates angle of orientation metrics AREA —Calculates area metrics ELEVATION —Calculates elevation metrics LENGTH —Calculate length metrics WIDTH —Calculate width metrics	String
in_length_attributes (可选)	A comma-delimited string of field names from which the length metrics will be calculated. The default is LEG,LEN,LEN_,LGN,LZN. You can add the names of other length metric fields; if the fields exist in Input Features, they will be computed.	String
in_width_attributes (可选)	A comma-delimited string of field names from which the width metrics will be calculated. The default is WID,WID_,WGP. You can add the names of other width metric fields; if the fields exist in Input Features, they will be computed.	String
in_area_attributes (可选)	A comma-delimited string of field names from which the area metrics will be calculated. The default is ARA,ARE,ARE_. You can add the names of other area metric fields; if the fields exist in Input Features, they will be computed.	String
in_angle_attributes (可选)	A comma-delimited string of field names from which the angle of orientation metrics will be calculated. The default is AOO,DOF,FEO. You can add the names of other angle of orientation metric fields; if the fields exist in Input Features, they will be computed.	String
in_elevation_attributes (可选)	A comma-delimited string of field names from which the elevation metrics will be calculated. The default is ZV2,ZVH. You can add the names of other elevation metric fields; if the fields exist in Input Features, they will be computed.	String
in_precision (可选)	Precision of the metrics written to the target attributes.	Long

代码示例

CalculateMetrics example 1 (stand-alone script)

The following code sample calculates the width for the WatrcrsL features and populates the WID attribute in the attribute table.

# Importing necessary modules
from arcpy import management, defense

# Creating feature layers
management.MakeFeatureLayer(r'C:\Sample\Data.gdb\MGCP\BuildA', 'WatrcrsL')

# Calculating WIDTH attribute and taking all defaults
defense.CalculateMetrics('WatrcrsL', "WIDTH", "#", "#", "#", "#", "#", "#")

CalculateMetrics example 2 (stand-alone script)

The following code example demonstrates how to execute the CalculateMetrics tool.

# Running Calculate Metrics on all feature calsses in a database taking the defaults for optional parameters
# Importing arcpy, string, and os modules
import arcpy, string, os

# Checking out Defense extension
arcpy.CheckOutExtension('defense')

# Setting input database
input_database = r'C:\Data\TDS_6_1.gdb'

# Getting feature classes from database
arcpy.env.workspace = input_database
feature_classes = []
feature_datasets = arcpy.ListDatasets('*', 'Feature')
for dataset in feature_datasets:
    fclass = arcpy.ListFeatureClasses('*', '', dataset)
    for fc in fclass:
        feature_classes.append(os.path.join(input_database, dataset, fc))

# Converting feature classes into layers
layer_list = []
for feat_class in feature_classes:
    class_name = string.split(os.path.split(feat_class)[1], '.')[-1]
    arcpy.management.MakeFeatureLayer(feat_class, class_name)
    layer_list.append(class_name)

# Creating string for input to Calculate Representation Fields tool
feature_string = ''
for layer in layer_list:
    feature_string += '{};'.format(layer)

# Setting variables for parameters
input_features = r'C:\Data\TDS_6_1.gdb\TDS\TransportationGroundSrf;C:\Data\TDS_6_1.gdb\TDS\StructureSrf'
metric_type = 'LENGTH;WIDTH;AREA;ANGLE_OF_ORIENTATION;ELEVATION'

# Calling Calculate Metrics tool
arcpy.defense.CalculateMetrics(feature_string, metric_type, '#', '#', '#', '#', '#', '#')

# Checking in Defense extension
arcpy.CheckInExtension('defense')

环境

• 当前工作空间

许可信息

• ArcGIS Desktop Basic: 否
• ArcGIS Desktop Standard: 需要 Defense Mapping
• ArcGIS Desktop Advanced: 需要 Defense Mapping