GENERATE_REGULAR_GRID

This command generates a regular grid of area, line, and/or point features. See the Create Regular Grid option in the Digitizer Tool for more details.

The following parameters are supported:

ANCHOR_TYPE – specifies how to provide the anchor for the grid. The following values are supported:

TOP_LEFT – anchors grid to ANCHOR_POINT that is top left of grid

BOX_CALC_SIZE – anchors grid to a provided bounding box with a provided number of rows and columns. The cell size is computed from that.

BOX_CALC_COUNT – anchors grid to a provided bounding box with a provided cell size. The number of rows and columns to use is calculated from that.

ANCHOR_POINT – if using ANCHOR_TYPE=”TOP_LEFT”, this provides the top-left anchor point of the grid. The XY (or longitude/latitude) coordinates are provided with a comma separating them. The default projection for the anchor point is the current display projection, but you can use a PROJ parameter to define the projection to use.

GLOBAL_BOUNDS – if using BOX_CALC_SIZE or BOX_CALC_COUNT for the ANCHOR_TYPE, specifies the grid bounds in units of the current global projection (or whatever is specified by the PROJ parameter). There should be 4 values in a comma-delimited list following the parameter name. The values should be in order of minimum x, minimum y, maximum x, maximum y.

PROJ - special Projection Specification type of parameter that specifies the projection to use for the new grid features. This also affects how the coordinates applies in ANCHOR_POINT or a bounding box are interpreted.

GRID_TYPE_CELL_SIZE - specifies the size of each grid cell in the GRID_TYPE_CELL_SIZE_UNITS value. The value should be specified as cell width,cell height. For example, if you are using a metric projection and want to tile the export into cells that are 10,000 meters wide by 5,000 meters tall, you would use GRID_TYPE_CELL_SIZE="10000.0,5000.0".

GRID_TYPE_CELL_SIZE_UNITS – specifies the units for GRID_TYPE_CELL_SIZE. If not specified, the units of the grid projection will be used. Accepted values are:

‘m’ or ‘meters’

‘ft’ or ‘feet (us survey)’

‘feet (international)’

‘chains’

‘mi’ or ‘miles’

‘km’ or ‘kilometers’

‘rods’

‘varas’

‘yds’ or ‘yards’

‘NM’ or ‘nautical miles’

‘deg’ or ‘degrees’

GRID_TYPE_ROWS_COLS - specifies the number of rows and columns of cells to create. The value should be specified as number of rows,number of columns. For example, if you want to create a grid of 8 rows each 4 cells across, you would use GRID_TYPE_ROWS_COLS="8,4".

ROTATE_ANGLE – specifies the angle (in degree) to rotate the grid clockwise relative to the top-left corner.

CREATE_AREAS – specifies whether area features should be created for each grid cell. Enabled by default, use CREATE_AREAS=”NO” to disable.

CREATE_LINES – specifies whether line features should be created along the edge of each grid cell. Use CREATE_LINES=”YES” to enable.

CREATE_POINTS_CENTER – specifies whether point features should be created at the center of each grid cell. Use CREATE_POINTS_CENTER=”YES” to enable.

CREATE_POINTS_END – specifies whether point features should be created at the endpoints of each grid cell line. Use CREATE_POINTS_END=”YES” to enable.

CREATE_POINTS_INT – specifies whether point features should be created at the intersection of each grid cell line. Use CREATE_POINTS_INT=”YES” to enable.

LAYER_DESC – specifies the description to assign to the layer the regular grid will be created in.

POLYGON_CROP_FILE - specifies the full path and filename or loaded layer description of a vector file/loaded layer containing one or more polygon features to which the operation should be cropped. If multiple polygons are found in the specified file the polygon which has the largest intersection with the data to be combined will be used as the crop polygon (see POLYGON_CROP_USE_ALL or POLYGON_CROP_USE_EACH for exceptions).

POLYGON_CROP_FILE_PROJ - specifies the projection to use for the POLYGON_CROP_FILE. Use if the file doesn't have an associated projection file. See special Projection Specification for instructions.

POLYGON_CROP_KEEP_ANY – if cropping to a polygon, keeps the feature(s) for a grid cell if any part of the cell overlaps a crop polygon rather than only keeping those whose centroid is in a crop polygon.

Grid Naming Parameters:

GRID_NAMING - specifies how to name the grid tiles. The value should be SEQUENTIAL for sequential numeric naming starting at 1, SEPARATE for separate prefix appending by row and column, or SEPARATE_COLS_FIRST for separate prefix appending by columns and rows. For the SEPARATE options, use the GRID_NAMING_COLS and GRID_NAMING_ROWS parameters to specify the details of how to name the rows and columns. The value will be appended to FILENAME specified in the EXPORT command. If no GRID_NAMING parameter is supplied, the last selected grid naming options selected in the user interface will be used.

GRID_NAMING_COLS - specifies how to name the column portion of grid cell names when using the GRID_NAMING=SEPARATE or GRID_NAMING=SEPARATE_COLS_FIRST parameter. The value of this field is a comma-delimited list with the following field values:

Naming type. Can have the following values:

NUM - name using numbers in ascending order

NUM_REVERSE - name using numbers in descending order

ALPHA - name using letters in ascending order

ALPHA_REVERSE - name using letters in descending order

Starting value for numbering or lettering (i.e. '1', or 'A'). If the naming type is numeric you can also specify %left% or %right% as the starting value to use the left or right coordinate of the cell bounding box. For row naming you can use %top% or %bottom%.

Prefix string to use before the numeric or alphabetic value.

Step value for numeric naming (default is '1')

Suffix string to use after the numeric or alphabetic value

You can leave values blank if they don't apply or you want to use the default. As an example, to do numeric naming starting at the number 100, increasing by 10 each time with a prefix of DEM, you would use GRID_NAMING_COLS="NUM,100,DEM,10".

GRID_NAMING_ROWS - specifies how to name the row portion of grid cell names when using the GRID_NAMING=SEPARATE parameter. See the documentation for the GRID_NAMING_COLS parameter above for details on the format.

GRID_NAMING_PREPEND_ZEROES - specifies whether or not to prepend zeroes to the start of grid column/row names to make them the same length when using numeric naming. Use GRID_NAMING_PREPEND_ZEROES=NO to disable the prepending of zeroes.

GRID_NAMING_PREPEND_A - specifies whether or not to prepend ‘A’s to the start of grid column/row names to make them the same length when using alphabetic naming. Use GRID_NAMING_PREPEND_AS=NO to disable the prepending of ‘A’s.

GRID_NAMING_SEPARATOR - specifies the separator string to use between pieces of a grid name. The default is an underscore (_).