GDAL

FIXME Dinamica version: 1.9.0

Below, the influence of the library GDAL in the Dinamica EGO operation is presented.

File Formats

More information about each GDAL file format can be found consulting the GDAL format list in the GDAL website.

Input Formats

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

Description Extension
VRT .vrt
GTiff .tif
NITF .ntf
RPFTOC .toc
HFA .img
SAR_CEOS
CEOS
JAXAPALSAR
GFF .gff
ELAS
AIG
AAIGrid .asc
SDTS .ddf
DTED
PNG .png
JPEG .jpg
MEM
JDEM .mem
GIF .gif
BIGGIF .gif
ESAT .n1
BSB
XPM .xpm
BMP .bmp
DIMAP
AirSAR
RS2
PCIDSK .pix
PCRaster .map
ILWIS .mpr/mpl
SGI .rgb
SRTMHGT .hgt
Leveller .ter
Terragen .ter
ISIS3
ISIS2
PDS
TIL
ERS
JP2OpenJPEG .jp2
L1B
FIT
GRIB .grb
RMF .rsw
WCS
WMS
MSGN .nat
RST .rst
INGR
GSAG .grd
GSBG .grd
GS7BG .grd
COSAR
TSX
COASP .hdr
R .rda
PNM .pnm
DOQ1
DOQ2
ENVI
EHdr
GenBin
PAux
MFF .hdr
MFF2
FujiBAS
GSC
FAST
BT .bt
LAN
CPG
IDA
NDF
EIR
DIPEx
LCP .lcp
GTX .gtx
LOSLAS
NTv2 .gsb
RIK .rik
USGSDEM .dem
GXF .gxf
HTTP
NWT_GRD .grd
NWT_GRC .grc
ADRG .gen
SRP .img
BLX .blx
Rasterlite .sqlite
PostGISRaster
SAGA .sdat
KMLSUPEROVERLAY
XYZ .xyz
HF2 .hf2
PDF .pdf
OZI

Output Formats

Using GDAL, Dinamica EGO can write maps in the following file formats.

Description 1) Extension
VRT .vrt
GTiff .tif
NITF .ntf
HFA .img
ELAS* .elas
MEM* .mem
BMP .bmp
PCIDSK .pix
ILWIS .mpr/mpl
SGI .rgb
Leveller .ter
Terragen .ter
ERS* .ers
RMF .rsw
RST .rst
INGR* .ingr
GSBG .grd
PNM .pnm
ENVI* .envi
EHdr* .ehdr
PAux* .paux
MFF .hdr
MFF2* .mff2
BT .bt
IDA* .ida
GTX .gtx
NTv2 .gsb
ADRG .gen
SAGA .sdat

Some important notes:

  • 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 Limitations

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

Limitation Workaround
Some file formats do not support the storage of projections Use a VRT file 2) or an auxiliary PAM XML file 3) to keep this information.
Several file formats do not support the storage of category names. To workaround this limitations, it is possible to use a VRT file or an auxiliary PAM XML file to keep this information. The ERMapper file format has the best support to category names and colors.
Several file formats do not support the storage of category colors. To workaround this limitations, it is possible to use a VRT file or an auxiliary PAM XML file to keep this information. The ERMapper file format has the best support to category names and colors.
Several file formats do not support the storage of layer names. To workaround this limitations, it is possible to use a VRT file or an auxiliary PAM XML file to keep this information. The ERMapper file format also has support to layer names.
The categories must start from 0 and their definition must be contiguous. Unfortunately, the only way to workaround this limitation is defining dummy categories (Dinamica does this when representing non-contiguous categories in a GDAL supported format) or using the ERMapper file format.

Dinamica Limitation

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.

Workdir/folder Names

!!!FIXME

Virtual Format

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>

PAM XML Auxiliary File

!!!FIXME

File Filters

The document below provides some information about the file filters available in the open map file and save map file dialogs:

https://docs.google.com/document/pub?id=1pXhk1f8eXugA_2sQ3rqQSZV0KXPVhAtutTRD3LCh9g8

1)
File formats marked with a star (*) do not define an extension. To workaround this limitation, Dinamica EGO invents the corresponding extension using the file format description
2) , 3)
include link to file format description