Calculate Max Elevation Figures (Topographic Production Tools)

Summary

Calculates the maximum elevation figures (MEF) for each polygon cell or quadrangle in a polygon layer. These values are used as labels for the MEF feature layer.

To derive the highest obstruction value, the tool uses terrain data from a digital elevation model (DEM) and vertical obstruction data from a point feature class. You can calculate MEF values for a Joint Operations Graphic (JOG), Operational Navigation Chart (ONC), Tactical Pilotage Chart (TPC) grid cells, NATO STANAG-3591 Edition 6, or any other polygon grid features.

Usage

This tool will modify existing features by updating selected fields.
To label the maximum elevation figures in the MEF feature layer by applying the label expression, complete the following steps:
1. Run the Calculate Max Elevation Figures tool on the MEF feature layer.
2. Right-click the MEF feature layer in the Contents pane, and click Labeling Properties .
 
 The Label Class pane appears.
3. Ensure that the Label expression tab is active.
4. For Language, choose Python.
5. Load the expression below into the Expression window. Change all [MEF_VALUE] occurrences to the name of the mef_field.
```
def FindLabel([MEF_VALUE]):
 if len(str([MEF_VALUE]))< 3:
 label = '00'
 elif len(str([MEF_VALUE])) < 4:
 label = '0{0}'.format(str([MEF_VALUE])[-3])
 elif len(str([MEF_VALUE])) == 4:
 label = '{0}{1}'.format(str([MEF_VALUE])[0], str([MEF_VALUE])[-3])
 else:
 label = '{0}{1}'.format(str([MEF_VALUE])[0:-3], str([MEF_VALUE])[-3])
 return label
```
6. Click Verify to validate the label expression.
7. Click Apply.
8. With the MEF feature layer active, click the Labeling tab.
9. In the Layer group, click Enable Labeling .
The label appears on the maximum elevation figures in the MEF feature layer.

Label	Explanation	Data type
Target Max Elevation Figures Features	The input polygon features representing the quadrangle or cell that will be updated with MEF values.	Feature Layer
Input Terrain	The input terrain that will be used to determine elevation values in an MEF feature cell. If a point feature layer is used, elevation values are obtained from the field defined in the Terrain Elevation Field parameter.	Raster Layer; Mosaic Layer; Feature Layer
Vertical Obstruction Features	The layers that will be used to identify the highest human-made structure in a cell. This is a value table defining features, elevation fields, and elevation units. Value table columns: Features—The layers that will be used to identify the highest human-made structure in a cell. Elevation Field—The elevation field from a layer. Elevation Unit—Specifies the units of the elevation field. Centimeters—The units will be centimeters. Decimeters—The units will be decimeters. Feet—The units will be feet. Inches—The units will be inches. Kilometers—The units will be kilometers. Meters—The units will be meters. Miles—The units will be miles. Millimeters—The units will be millimeters. Nautical Miles—The units will be nautical miles. Yards—The units will be yards.	Value Table
Max Elevation Figures Field	The existing field in the Target Max Elevation Figures Features parameter value where the maximum elevation figure value will be stored.	Field
Max Vertical Obstruction Field	The field in the Target Max Elevation Figures Features parameter value where the maximum vertical obstruction value will be stored.	Field
Max Terrain Field	The field in the Target Max Elevation Figures Features parameter value where the maximum elevation values from the terrain layer will be stored.	Field
Specification	Specifies the specification that will be used to calculate maximum elevation figures. JOG-MIL-J-89100—The Joint Operations Graphic specification will be used. ONC-MIL-O-89102—The Operational Navigation Chart specification will be used. TPC-MIL-T-89101—The Tactical Pilotage Chart specification will be used. STANAG-3591-ED6—The NATO Standard Agreement specification will be used.	String
Terrain Elevation Field (Optional)	A field in the Input Terrain parameter value that represents the elevation values for each feature. If a point feature layer is used for the Input Terrain value, this parameter is required. This parameter is inactive if a raster or mosaic layer is used as input for the Input Terrain parameter.	Field
Vertical Obstruction Allowance (Optional)	A vertical allowance value that will be added to each calculated MEF value. The value accounts for nonrepresented natural or manufactured features. The default is 150 feet.	Linear Unit
Vertical Obstruction Accuracy (Optional)	The accuracy of the vertical obstruction feature layer within a specified number of units. The default is 20 meters.	Linear Unit
Terrain Accuracy (Optional)	The accuracy of the terrain layer within a specified number of units. The default is 20 meters.	Linear Unit

Derived output

Label	Explanation	Data type
Updated Max Elevation Figures Features	The Target Max Elevation Figures Features parameter value with updated MEF values.	Feature Layer

arcpy.topographic.CalculateMEF(target_mef_features, in_terrain, obstruction_features, mef_field, max_vo_field, max_terrain_field, specification, {terrain_elev_field}, {vo_allowance}, {vo_accuracy}, {terrain_accuracy})

Name	Explanation	Data type
target_mef_features	The input polygon features representing the quadrangle or cell that will be updated with MEF values.	Feature Layer
in_terrain [in_terrain,...]	The input terrain that will be used to determine elevation values in an MEF feature cell. If a point feature layer is used, elevation values are obtained from the field defined in the `terrain_elev_field` parameter.	Raster Layer; Mosaic Layer; Feature Layer
obstruction_features [obstruction_features,...]	The layers that will be used to identify the highest human-made structure in a cell. This is a value table defining features, elevation fields, and elevation units. Value table columns: `Features`—The layers that will be used to identify the highest human-made structure in a cell. `Elevation Field`—The elevation field from a layer. `Elevation Unit`—Specifies the units of the elevation field. `Centimeters`—The units will be centimeters. `Decimeters`—The units will be decimeters. `Feet`—The units will be feet. `Inches`—The units will be inches. `Kilometers`—The units will be kilometers. `Meters`—The units will be meters. `Miles`—The units will be miles. `Millimeters`—The units will be millimeters. `Nautical Miles`—The units will be nautical miles. `Yards`—The units will be yards.	Value Table
mef_field	The existing field in the `target_mef_features` parameter value where the maximum elevation figure value will be stored.	Field
max_vo_field	The field in the `target_mef_features` parameter value where the maximum vertical obstruction value will be stored.	Field
max_terrain_field	The field in the `target_mef_features` parameter value where the maximum elevation values from the terrain layer will be stored.	Field
specification	Specifies the specification that will be used to calculate maximum elevation figures. `JOG_MIL_J_89100`—The Joint Operations Graphic specification will be used. `ONC_MIL_O_89102`—The Operational Navigation Chart specification will be used. `TPC_MIL_T_89101`—The Tactical Pilotage Chart specification will be used. `STANAG_3591_ED6`—The NATO Standard Agreement specification will be used.	String
terrain_elev_field (Optional)	A field in the `in_terrain` parameter value that represents the elevation values for each feature. If a point feature layer is used for the `in_terrain` value, this parameter is required. This parameter is unavailable if a raster or mosaic layer is used as input for the `in_terrain` parameter.	Field
vo_allowance (Optional)	A vertical allowance value that will be added to each calculated MEF value. The value accounts for nonrepresented natural or manufactured features. The default is 150 feet.	Linear Unit
vo_accuracy (Optional)	The accuracy of the vertical obstruction feature layer within a specified number of units. The default is 20 meters.	Linear Unit
terrain_accuracy (Optional)	The accuracy of the terrain layer within a specified number of units. The default is 20 meters.	Linear Unit

Derived output

Name	Explanation	Data type
updated_mef_features	The `target_mef_features` parameter value with updated MEF values.	Feature Layer

Code sample

CalculateMEF example (stand-alone script)

The following code sample demonstrates how to use the CalculateMEF function in Python.

# Name: CalculateMaxElevationFigures_sample.py
# Description: Calculates maximum elevation figures values for JOG data.

# Import System Modules
import arcpy

# Setting the environment
arcpy.env.workspace = r'C:\Data\JOG.gdb\BM'
arcpy.env.overwriteOutput = True

# Make Feature Layer for Obstruction Features
arcpy.management.MakeFeatureLayer(r'VerticalObstructionPnt', 'VO_Layer')

# Setting Local Variables
target_mef_features = r'MaximumElevationSrf'
in_terrain = r'C:\Data\w120n34.dt2;C:\Data\w119n34.dt2'
obstruction_features = r'VO_Layer ZVH Meters'
mef_field = 'MEF_VALUE'
max_vo_field = 'MAX_ELEVATION'
max_terrain_field = 'MAX_TERRAIN'
specification = 'JOG_MIL_J_89100'
terrain_elev_field = ''
vo_allowance = '150 Feet'
vo_accuracy = '20 Meters'
terrain_accuracy = '20 Meters'

# Use the Calculate Max Elevation Figures GP tool to calculate maximum elevation figures values for JOG data
arcpy.topographic.CalculateMEF(target_mef_features, in_terrain, obstruction_features, mef_field, max_vo_field, max_terrain_field, specification, terrain_elev_field, vo_allowance, vo_accuracy, terrain_accuracy)

Environments

Current Workspace

Licensing information

Basic: No
Standard: Requires Topographic Mapping or Aviation Airports or Aviation Charting or Maritime or Bathymetry
Advanced: Requires Topographic Mapping or Aviation Airports or Aviation Charting or Maritime or Bathymetry

Calculate Max Elevation Figures (Topographic Production Tools)

Summary

Usage

Parameters

Derived output

Environments

Licensing information

Related topics