4.4 Grids

Grids in MicroCity have simple structure (3.3) but efficient time and space utilization if applying algorithms on them. Sample codes for this chapter can be found in the "grid_samples" folder of the Project Tab in ScriptEditor.

Cellular Data Manipulation

CreateGrid ("name", "Int|Float|Double", XMax, YMax [, CellSize = 1 [, xMin = 0 [, yMin = 0] [, init = 0]]]])

Returns a Grid object.

GetCellSize (Grid)

Returns the Cellsize value of a Grid.

GetGridMaxXY (Grid)

Returns XMax, YMax of a Grid.

ConvertToGridXY (Grid, x1, y1 [, x2, y2, ...])

Converts real coordinates to coordinates in a Grid. Returns X1, Y1, X2, Y2, ... .

ShapeToGrid (Grid, Shape, value)

Rasterizes a Shape in a Grid. The cell values will be set according to the covering area and the inputed value.

ShapeToGrid (Grid, Shapes, "field_name")

Rasterizes all Shape objects in a Shapes. The cell values will be set according to the covering area and the values of Shapes field.

GetValue (Grid, X1, Y1 [, X2, Y2, ...])

Returns cells' (specified by Grid coordinates) values: value1, value2, ... .

SetValue (Grid, value, X1, Y1 [, X2, Y2, ...])

Sets values for cells specified by Grid coordinates.

GetCenterXY (Grid)

Returns the center real coordinate (x, y) of a Grid.

GetCenterXY (Grid, X1, Y1 [, X2, Y2, ...])

Returns the real coordinates of cells' centers: x1, y1, x2, y2, ... .

GetExtent (Grid)

Returns the leftbottom and righttop corner of a Grid's extent: Lx, By, Rx, Ty.

GetExtent (Grid, X, Y)

Returns the leftbottom and righttop corner of a cell's extent: Lx, By, Rx, Ty.

GetFractalDim (Grid, X1, Y1, X2, Y2, fold [, MultiFractalQ = 0])

Calculates fractal dimension of the specified area in a Grid. Returns dimension, RSQ of linear regression, and the number of boxes in every fold.