ID Grid map

Command line

The ID Grid map operation can be directly executed by typing one of the following expressions on the command line of the Main window:

OUTMAP	=	PolygonMapGrid (CoordSystem, OriginX, OriginY, Width, Height, NrVertical, NrHorizontal)
OUTMAP	=	PolygonMapGrid (CoordSystem, OriginX, OriginY, Width, Height, , , OppositeX, OppositeY)
OUTMAP	=	PolygonMapGrid (CoordSystem, OriginX, OriginY, , , NrVertical, NrHorizontal, OppositeX, OppositeY)
OUTMAP	=	PolygonMapGrid (CoordSystem, OriginX, OriginY, Width, Height, NrVertical, NrHorizontal, , , [DirectionX], [DirectionY], [Table], [Label], [Order], [StartCorner], [StartNumber], [Steps], [Prefix], [Postfix])
OUTMAP	=	PolygonMapGrid (CoordSystem, OriginX, OriginY, Width, Height, , , OppositeX, OppositeY, [DirectionX], [DirectionY], [Table], [Label], [ Order], [StartCorner], [StartNumber], [Steps], [Prefix], [Postfix])
OUTMAP	=	PolygonMapGrid (CoordSystem, OriginX, OriginY, , , NrVertical, NrHorizontal, OppositeX, OppositeY, [DirectionX], [DirectionY], [Table], [Label], [Order], [StartCorner], [StartNumber], [Steps], [Prefix], [Postfix])

where:

OUTMAP	is the name of the output polygon map containing the ID grid cells.
PolygonMapGrid	is the command to start the ID Grid map operation.
CoordSystem	is the name of the coordinate system (metric or latlon).
OriginX, OriginY	are the X and Y coordinates of the origin. The origin is the lower left corner of the output polygon map.
Width, Height	are the width and height of an ID grid cell. The grid size is always expressed in the units of the coordinate system.
NrVertical, NrHorizontal	are the number of vertical and horizontal grid cells in the ID grid map.
OppositeX, OppositeY	are the X and Y coordinates of the opposite corner in the ID grid map. The opposite corner coordinate is the corner opposite the corner specified as 'origin coordinate'.
DirectionX, DirectionY	are the X and Y coordinates of the direction point. The direction point is a point on the positive Y-axis from the lower left corner (origin) of the ID grid map and is used to rotate the grids.
Table	is an existing attribute table with an ID domain. The ID to be assigned to each grid cell should be available in the domain of the table otherwise undefined values will be assigned to the grid cells during the labeling process. See ID Grid map : algorithm for more information.
Label	LabelPoints \| NoLabelPoints specify whether or not a point map with label points at the center of the each grid cell has to be created. If this parameter is omitted NoLabelPoints is assigned.
LabelPoints	create a point map with label points. The point map will obtain the same name as specified for the output polygon map and will use the same ID domain.
NoLabelPoints	do not generate a point map with label points.
Order	H \| HC \| V \| VC define the direction which should be used for labeling the grid cells. Available option are: Horizontal (H), Horizontal Continued (HC), Vertical (V) and Vertical Continued (VC). See ID Grid map : algorithm for more information about the labeling orders. When you did not specify this option Horizontal labeling (H), will be used.
StartCorner	LL \| LR \| UL \| UR. specify the corner where labeling should start. Available option are: Lower Left (LL), Lower Right (LR), Upper Left (UL) and Upper Right (UR). When you did not specify this option the Lower Left (LL) corner will be used to start labeling.
StartNumber	is an integer that will be used as an initial number to start labeling the grid cells. If the value for this parameter is omitted, 1 will be assigned.
Steps	is the step size for label point numbers. The step size is a positive or negative integer that is used to determine the increase/decrease of individual grid cell numbers during the labeling process. If the value for this parameter is omitted, 1 will be assigned.
Prefix	optional parameter to specify some characters that should be used as prefix for the IDs in the output polygon map.
Postfix	optional parameter to specify some characters that should be used as postfix/suffix for the IDs in the output polygon map.

When the definition symbol = is used, a dependent output map is created; when the assignment symbol := is used, the dependency link is immediately broken after the output map has been calculated.

Notes:

Grid cell width and grid cell height are usually the same but they could be different.
The opposite corner coordinates will be ignored when the width and height of the grid cells as well as the number of vertical and horizontal grid cells are specified.

Example 1:

The following expression:

IDGridMap

PolygonMapGrid(Coord, 1, 1, 1, 1, 3, 3, , , , , AnimalCounts, NoLabelPoints, V, UL, 1, 1, nr)

performs ID Grid map:

with coordinate system Coord as input,
using (1, 1) as origin,
using a grid cell width and a grid cell height of 1,
creating a grid map with 3 horizontal and 3 vertical cells,
using AnimalCounts as attribute table,
not creating an additional point map with label points,
creating label points in which the labels are ordered in a vertical way,
the labeling starts in the upper left corner,
with 1 as starting number,
using a step size of 1 and
using nr as prefix.

The result of the expression is

a polygon map IDGridMap containing the ID grid cells.

AnimalCounts

IDGridMap

ID	Nr. Elephants	Nr. Buffalo	Nr. Cattle	Nr....
nr1	0	53	22	....
nr2	22	50	34	....
nr3	24	80	45	....
nr4	87	0	64	....
nr5	34	50	70	....
nr6	45	20	22	....
nr7	4	15	86	....
nr8	37	29	12	....
nr9	12	15	21	....

nr1	nr4	nr7
nr2	nr5	nr8
nr3	nr6	nr9

Example 2:

The following expression:

IDGridMap2

PolygonMapGrid(Cochabamba, 803200, 8072400, 100, 100, , , 804200, 8073400, 803201, 8072402, AnimalCounts, LabelPoints, H, LL, 1, 10, P, S)

performs ID Grid map:

with coordinate system Cochabamba as input,
using (803200, 8072400) as origin,
using a grid cell width and a grid cell height of 100,
using (804200, 8073400) as opposite corner,
using (803201, 8072402) as direction point,
using AnimalCounts as attribute table,
creating an additional point map with the label points,
in which the labels are ordered in a horizontal way,
the labeling starts in the lower left corner,
with 1 as starting number,
using a step size of 10,
using P as prefix and
using S as suffix.

The results of the expression are:

a polygon map IDGridMap2 containing the ID grid cells;
an additional point map IDGridMap2 with label points.

AnimalCounts

IDGridMap2

ID	Nr. Elephants	Nr. Buffalo	Nr. Cattle	Nr....
nr1	0	53	22	....
nr2	22	50	34	....
nr3	24	80	45	....
nr4	87	0	64	....
nr5	34	50	70	....
nr6	45	20	22	....
nr7	4	15	86	....
nr8	37	29	12	....
nr9	12	15	21	....

P61S	P71S	P81S
P31S	P41S	P51S
P1S	P11S	P21S