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.

Syntax

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})
ParameterExplanationData 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")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics