This is an old revision of the document!

PHP's gd library is missing or unable to create PNG images

Load Categorical Map


This functor loads a map from a file whose cell identifiers represent categories. The file name and its path must be specified. If the map found at this path does not have category identifiers, this functor will automatically determine its category identifiers.


Name Type Description
Filename Map Filename Name of the file that contains the map to be loaded. Dinamica automatically determines the file format from a selected file extension.

Optional Inputs

Name Type Description Default Value
Load As Sparse Bool If true, the map is loaded as a sparse image. Sparse images have the advantage of storing only the cells containing non-null values, but they have diminshed access time. False
Define Null Value Bool This flag forces the cells with the same value of the “Null Value” parameter to be treated as a null cell. This is particularly useful for assigning a missing null value to a GeoTiff data. False
Null Value Int Value used to represent null cell. The “Define Null Value” flag must be set in order to define a null value. This is particularly useful for assigning a missing null value to a GeoTiff data. 0
Suffix Digits Non Negative Int Number of digits used to represent the image file name suffix. 0
step Non Negative Int Current step or model iteration. Files with the same name and numbered suffixes will be loaded sequentially according to the model step. None
Workdir Workdir Workdir folder path. None


Name Type Description
Map Categorical Map The map loaded by the functor.



Readable formats: ers (ERMapper raster) tiff, or tif (GeoTiff) and asc (ArcView ASCII).

Coordinate systems supported for translation in ERMapper format: Geodetic (WGS 84, SAD69, NAD27, Corrego Alegre) and UTM (WGS84, SAD 69, NAD27, Corrego Alegre).

When a coordinate system is not supported, LOCAL projection and datum WGS84 are assumed. For ASCII/ArcGIS, LOCAL projection and datum WGS84 are always assumed.

All Geotiff coordinate systems are supported if translation is not needed.

When GeoTiff cell dimension is not found, a 100 meter resolution is assumed.

See also Load Map for loading maps whose cells do not represent categories.

Internal Name