Load Map

This functor loads a map from a file. The filename and its path must be specified.

Input/Output

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

Dinamica 1.9 and above uses the GDAL library GDAL to read and write maps. More information about each GDAL file format can be found consulting the GDAL format list in the GDAL website.

Using GDAL, Dinamica EGO can read maps in the file formats below.

It is worth noting that only the most common file formats are listed in the Open Map dialog file filters. However, it is possible to open any of the formats below choosing “All files” in the dialog.

Using GDAL, Dinamica EGO can write maps in the file formats below. File formats whose descriptions are marked with a star (*) do not define an extension. To workaround this limitation, Dinamica EGO invents the corresponding extension using the file format description.

It is worth noting that only the most common file formats are listed in the Save Map dialog file filters. However, it is possible to open any of the formats below choosing “All files” in the dialog.

• The support to AAIGrid (.asc) in GDAL is read only. So, Dinamica EGO provides the writing capability itself. This format can read images using cell types “Signed 32 Bit Integer” and “IEEE 754 32 Bit Real”. All cell types can be written, but they are automatically converted back to one of those formats next time Dinamica reads the image again.

• The support to ERMapper (.ers) in GDAL ignores class names. To workaround this limitation, support to reading and writing this file format is provided by Dinamica EGO itself.

GDAL (and some times the underlying file format) imposes limitations on the representation of projections, layer names, category names and their corresponding colors. The limitations and their corresponding workaround are listed in the table below:

Because the ERMapper file format is handled by Dinamica itself, the PAM XML file can not be used with this format.

Dinamica only retrieves and uses category names and colors from the first layer/band when using GDAL. All the other layers/bands are supposed to use the same category names and colors.

• When the map projection is not found, the map projection is left undefined. This differs from previous Dinamica versions (Dinamica 1.8) that assumes a LOCAL projection in these cases.

• When the cell dimension is not defined, a one meter resolution [or one degree, depending on the map projection used] is assumed.

• It is only possible to load maps represented by 8, 16 or 32 bits per cell. Other cell types are not supported.

GDAL support a virtual file format called VRT. This format can be used to transform an image defining a different registration info, different classe names and a different color table. It can also be use to create mosaics from several different images. A example of a VRT file defined from a two unrelated image files can be found below.

test.vrt

<VRTDataset rasterXSize="2512" rasterYSize="2512">
  <GeoTransform>-440720.0, 60.0, 30.0, 3751320.0, 0.0, -60.0</GeoTransform>
  <VRTRasterBand dataType="Byte" band="teste">
    <ColorInterp>Palette</ColorInterp>
    <ColorTable>
      <Entry c1="255" c2="0" c3="0" c4="255"/>
      <Entry c1="145" c2="78" c3="224" c4="255"/>
      <Entry c1="145" c2="230" c3="0" c4="255"/>
      <Entry c1="145" c2="145" c3="145" c4="255"/>
      <Entry c1="100" c2="200" c3="30" c4="255"/>
      <Entry c1="10" c2="20" c3="30" c4="255"/>
    </ColorTable>
    <SimpleSource>
      <SourceFilename relativeToVRT="teste">myband.bmp</SourceFilename>
      <SourceBand>1</SourceBand>
      <SrcRect xOff="0" yOff="0" xSize="512" ySize="512"/>
      <DstRect xOff="100" yOff="100" xSize="512" ySize="512"/>
    </SimpleSource>
  <CategoryNames>
    <Category>Missing</Category>
    <Category>Non-Crop</Category>
    <Category>Wheat</Category>
    <Category>Corn</Category>
    <Category>Soybeans</Category>
  </CategoryNames>	
  </VRTRasterBand>
</VRTDataset>

LoadMap