Generate Grid From Point (Defense)

Summary

Generates a Gridded Reference Graphic (GRG) as a polygon feature class over a specified area with a custom size.

Usage

  • The output grid is centered on the input start location.

  • Cell labels will be added to a Grid field in the Output Feature Class.

  • The grid cells are labeled with sequential letters or numbers.

  • The Output Feature Class is in the Web Mercator coordinate system.

Parameters

LabelExplanationData Type
Input Feature

The center point for the GRG starting point.

Feature Set
Output Feature Class

The output polygon feature class containing the GRG to be created.

Feature Class
Number of Rows
(Optional)

The number of horizontal grid cells.

Long
Number of Columns
(Optional)

The number of vertical grid cells.

Long
Cell Width
(Optional)

The width of the cells. Measurement units are specified by the Cell Units parameter.

Double
Cell Height
(Optional)

The height of the cells. Measurement units are specified by the Cell Units parameter.

Double
Cell Units
(Optional)

Specifies the measurement units for cell width and height.

  • Meters — The unit will be meters. This is the default.
  • Kilometers — The unit will be kilometers.
  • Miles —The unit will be miles.
  • Nautical miles —The unit will be nautical miles.
  • Feet —The unit will be feet.
  • US survey feet —The unit will be U.S. survey feet.
String
Label Start Position
(Optional)

Specifies the grid cell where labelling will start.

  • Upper left —The label position will be the upper left. This is the default.
  • Lower left —The label position will be the lower left.
  • Upper right —The label position will be the upper right.
  • Lower right —The label position will be in the lower right.
String
Label Format
(Optional)

Specifies the labeling type for each grid cell.

  • Alpha-numeric —The label will use an alpha character, a separator, and a number for the label. This is the default.
  • Alpha-alpha —The label will use an alpha character, a separator, and an additional alpha character for the label.
  • Numeric —The label will be numeric.
String
Label Separator
(Optional)

Specifies the separator to be used between x- and y-values when the Label Format parameter is set to Alpha-alpha, for example, A-A, A-AA, AA-A.

  • Hyphen —The label separator will be a hyphen. This is the default.
  • Comma —The label separator will be a comma.
  • Period —The label separator will be a period.
  • Forward slash —The label separator will be a forward slash.
String
Grid Rotation Angle
(Optional)

The angle used to rotate the grid.

Double
Grid Rotation Angular Units
(Optional)

The angular units for grid rotation.

  • Degrees —The angle will be degrees. This is the default.
  • Mils —The angle will be mils.
  • Radians —The angle will be radians.
  • Gradians —The angle will be gradians.
String

arcpy.defense.GenerateGRGFromPoint(in_feature, out_feature_class, {horizontal_cells}, {vertical_cells}, {cell_width}, {cell_height}, {cell_units}, {label_start_position}, {label_format}, {label_separator}, {grid_angle}, {grid_angle_units})
NameExplanationData Type
in_feature

The center point for the GRG starting point.

Feature Set
out_feature_class

The output polygon feature class containing the GRG to be created.

Feature Class
horizontal_cells
(Optional)

The number of horizontal grid cells.

Long
vertical_cells
(Optional)

The number of vertical grid cells.

Long
cell_width
(Optional)

The width of the cells. Measurement units are specified by the Cell Units parameter.

Double
cell_height
(Optional)

The height of the cells. Measurement units are specified by the Cell Units parameter.

Double
cell_units
(Optional)

Specifies the measurement units for cell width and height.

  • METERSThe unit will be meters. This is the default.
  • KILOMETERSThe unit will be kilometers.
  • MILESThe unit will be miles.
  • NAUTICAL_MILESThe unit will be nautical miles.
  • FEETThe unit will be feet.
  • US_SURVEY_FEETThe unit will be U.S. survey feet.
String
label_start_position
(Optional)

Specifies the grid cell where labelling will start.

  • UPPER_LEFTThe label position will be the upper left. This is the default.
  • LOWER_LEFTThe label position will be the lower left.
  • UPPER_RIGHTThe label position will be the upper right.
  • LOWER_RIGHTThe label position will be in the lower right.
String
label_format
(Optional)

Specifies the labeling type for each grid cell.

  • ALPHA_NUMERICThe label will use an alpha character, a separator, and a number for the label. This is the default.
  • ALPHA_ALPHAThe label will use an alpha character, a separator, and an additional alpha character for the label.
  • NUMERICThe label will be numeric.
String
label_separator
(Optional)

Specifies the separator to be used between x- and y-values when the label_format parameter is set to ALPHA_ALPHA, for example, A-A, A-AA, AA-A.

  • -The label separator will be a hyphen. This is the default.
  • ,The label separator will be a comma.
  • .The label separator will be a period.
  • /The label separator will be a forward slash.
String
grid_angle
(Optional)

The angle used to rotate the grid.

Double
grid_angle_units
(Optional)

The angular units for grid rotation.

  • DEGREESThe angle will be degrees. This is the default.
  • MILSThe angle will be mils.
  • RADSThe angle will be radians.
  • GRADSThe angle will be gradians.
String

Code sample

GenerateGRGFromPoint example 1 (Python Window)

The following Python window script demonstrates how to use the GenerateGRGFromPoint function.

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.GenerateGRGFromPoint_defense(r"Points_layer",
                                   r"GenerateGRGFromPoint",
                                   10, 10, 1000, 1000,
                                   "METERS",
                                   "UPPER_LEFT",
                                   "ALPHA_NUMERIC",
                                   "-",
                                   0,"DEGREES")
GenerateGRGFromPoint example 2 (stand-alone script)

The following example uses the GenerateGRGFromPoint function in a sample workflow script.

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.env.overwriteOutput = True

# Select the needed airport from airports layer
airports = "Airports"
whereClause = "airport_code = 'CLT'"
clt_layer = arcpy.SelectLayerByAttribute_management(airports,
                                                    "NEW_SELECTION",
                                                    whereClause)

# Create GRG
arcpy.GenerateGRGFromPoint_defense(clt_layer,"GenerateGRGFromPoint",
                                   10, 10, 1000, 1000,
                                   "METERS",
                                   "UPPER_LEFT",
                                   "ALPHA_NUMERIC",
                                   "-",
                                   0, "DEGREES")

Licensing information

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

Related topics