Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
supported_map_formats [2012/09/13 15:46]
hermann [Map Formats Supported for Writing]
supported_map_formats [2017/05/23 00:06]
hermann [Additional Notes]
Line 1: Line 1:
 ====== Supported Map Formats ====== ====== Supported Map Formats ======
  
-Dinamica EGO 2.0 and above delegates reading and writing most map formats to the GDAL library ​[[http://​www.gdal.org|GDAL]]. This allows Dinamica EGO to handle several previously unsupported file formats.+Dinamica EGO delegates reading and writing most map formats to the [[http://​www.gdal.org|GDAL ​library]]. This allows Dinamica EGO to handle several previously unsupported file formats. 
 ===== Map Formats Supported for Reading ===== ===== Map Formats Supported for Reading =====
  
Line 10: Line 11:
 </​note>​ </​note>​
  
-^ Description ^ Extension ^ +  * AIRSAR Polarimetric - AirSAR 
-AIRSAR Polarimetric - AirSAR ​|  | +  ​* ​ASCII Gridded - XYZ 
-ASCII Gridded - XYZ | .xyz | +  ​* ​Arc/Info ASCII Grid - AAIGrid 
-Arc/Info ASCII Grid - AAIGrid ​| .asc | +  ​* ​Arc/Info Binary Grid - AIG 
-Arc/Info Binary Grid - AIG | .adf | +  ​* ​BIGGIF 
-BIGGIF ​| .gif | +  ​* ​BSB Nautical Chart Format - BSB  
-BSB Nautical Chart Format - BSB |  | +  ​* CEOS 
-| CEOS |  | +  ​* ​Convair PolGASP data  - CPG 
-Convair PolGASP data  - CPG |  | +  ​* ​DRDC COASP SAR Processor Raster - COASP 
-DRDC COASP SAR Processor Raster - COASP | .hdr | +  ​* ​Daylon Leveller Heightfield - Leveller 
-Daylon Leveller Heightfield - Leveller ​| .ter | +  ​* ​ELAS DIPEx - DIPEx 
-ELAS DIPEx - DIPEx |  | +  ​* ​ELAS DIPEx - ELAS 
-ELAS DIPEx - ELAS |  | +  ​* ​ENVI Labelled Raster - ENVI 
-ENVI Labelled Raster - ENVI | .envi | +  ​* ​EOSAT FAST Format - FAST 
-EOSAT FAST Format - FAST |  | +  * ERMapper - ERS 
-| **ERMapper - ERS** | **.ers** | +  ​* ​ESRI Labelled - EHdr 
-ESRI Labelled - EHdr | .ehdr | +  ​* ​EUMETSAT Archive native - MSGN 
-EUMETSAT Archive native - MSGN | .nat | +  ​* ​EarthWatch/​DigitalGlobe - TIL 
-EarthWatch/​DigitalGlobe - TIL |  | +  ​* ​Envisat Image Product - ESAT 
-Envisat Image Product - ESAT | .n1 | +  ​* ​Erdas 7.x - LAN 
-Erdas 7.x - LAN |  | +  ​* ​Erdas Imagine Raw - EIR 
-Erdas Imagine Raw - EIR |  | +  ​* ​Erdas Imagine - HFA 
-Erdas Imagine - HFA | .img | +  ​* ​FARSITE v.4 LCP Format - LCP 
-FARSITE v.4 LCP Format - LCP | .lcp | +  ​* ​First Generation USGS DOQ - DOQ1 
-First Generation USGS DOQ - DOQ1 |  | +  ​* ​Fuji BAS Scanner Image - FujiBAS 
-Fuji BAS Scanner Image - FujiBAS ​|  | +  ​* ​GDAL Virtual - VRT 
-GDAL Virtual - VRT | .vrt |  +  ​* ​GSC Geogrid - GSC 
-GSC Geogrid - GSC |  | +  ​* ​GSat File Format - GFF 
-GSat File Format - GFF | .gff | +  ​* ​Generic Binary - GenBin 
-Generic Binary - GenBin ​|  | +  ​* ​Geospatial PDF - PDF 
-Geospatial PDF - PDF | .pdf | +  ​* ​Golden Software ASCII Grid - GSAG 
-Golden Software ASCII Grid - GSAG | .grd | +  ​* ​Golden Software Binary Grid - GSBG 
-Golden Software Binary Grid - GSBG | .grd | +  ​* ​Golden Software Surfer 7 Binary Grid - GS7BG 
-Golden Software Surfer 7 Binary Grid - GS7BG | .grd | +  ​* ​Graphics Interchange Format - GIF 
-Graphics Interchange Format - GIF | .gif | +  ​* ​Grid eXchange File - GXF 
-Grid eXchange File - GXF | .gxf | +  ​* ​HF2/HFZ heightfield raster - HF2 
-HF2/HFZ heightfield raster - HF2 | .hf2 | +  ​* ​ILWIS Raster Map - ILWIS 
-ILWIS Raster Map - ILWIS | .mpr/mpl | +  ​* ​Idrisi Raster - RST 
-Idrisi Raster - RST | .rst | +  ​* ​Image Display and Analysis - IDA 
-Image Display and Analysis - IDA |  | +  ​* ​In Memory Raster - MEM 
-In Memory Raster - MEM |  | +  ​* ​JAXA PALSAR Product Reader - JAXAPALSAR 
-JAXA PALSAR Product Reader - JAXAPALSAR ​|  | +  ​* ​JPEG JFIF - JPEG 
-JPEG JFIF - JPEG | .jpg | +  ​* ​JPEG2000 - JP2OpenJPEG 
-JPEG2000 - JP2OpenJPEG ​| .jp2 | +  ​* ​Japanese DEM - JDEM 
-Japanese DEM - JDEM | .mem | +  ​* KMLSUPEROVERLAY 
-| KMLSUPEROVERLAY |  | +  ​* ​Magellan Topo - BLX 
-Magellan Topo - BLX | .blx | +  ​* ​Microsoft Windows Device Independent Bitmap - BMP 
-Microsoft Windows Device Independent Bitmap - BMP | .bmp | +  ​* ​Military Elevation Data - DTED 
-Military Elevation Data - DTED |  | +  ​* ​NADCON Datum Grid Shift - LOSLAS 
-NADCON Datum Grid Shift - LOSLAS ​|  | +  ​* ​NASA Planetary Data System - PDS 
-NASA Planetary Data System - PDS |  | +  ​* ​NITF 
-NITF | .ntf | +  ​* ​NLAPS Data Format - NDF 
-NLAPS Data Format - NDF |  | +  ​* ​NOAA Polar Orbiter Level 1b Data Set - L1B 
-NOAA Polar Orbiter Level 1b Data Set - L1B |  | +  ​* ​NOAA vertical datum shift - GTX 
-NOAA vertical datum shift - GTX | .gtx | +  ​* ​NTv2 Datum Grid Shift - NTv2 
-NTv2 Datum Grid Shift - NTv2 | .gsb | +  ​* ​Netpbm - PNM 
-Netpbm - PNM | .pnm | +  ​* ​New Labelled USGS DOQ - DOQ2  
-New Labelled USGS DOQ - DOQ2 |  | +  ​* ​Northwood/​VerticalMapper Classified Grid Format - NWT_GRC 
-Northwood/​VerticalMapper Classified Grid Format - NWT_GRC ​| .grc | +  ​* ​Northwood/​VerticalMapper Numeric Grid Format - NWT_GRD 
-Northwood/​VerticalMapper Numeric Grid Format - NWT_GRD ​| .grd | +  ​* ​OGC Web Coverage Service - WCS  
-OGC Web Coverage Service - WCS |  | +  ​* ​OGC Web Map Service - WMS 
-OGC Web Map Service - WMS |  | +  ​* ​OZI OZF2/OZFX3 - OZI 
-OZI OZF2/OZFX3 - OZI |  | +  ​* ​PCI Geomatics Database File - PCIDSK 
-PCI Geomatics Database File - PCIDSK ​| .pix | +  ​* ​PCI Labelled - PAux 
-PCI Labelled - PAux |  | +  ​* ​PCRaster 
-PCRaster ​| .map | +  ​* ​Portable Network Graphics - PNG 
-Portable Network Graphics - PNG | .png | +  ​* ​PostGIS Raster - PostGISRaster 
-PostGIS Raster - PostGISRaster ​|  | +  ​* ​R Object Data Store - R 
-R Object Data Store - R | .rda | +  ​* ​RadarSat2 XML - RS2 
-RadarSat2 XML - RS2 |  | +  ​* ​Raster Matrix Format - RMF 
-Raster Matrix Format - RMF | .rsw | +  ​* ​Raster Product Format/RPF - ADRG 
-Raster Product Format/RPF - ADRG | .gen | +  ​* ​Raster Product Format/RPF - RPFTOC 
-Raster Product Format/RPF - RPFTOC ​| .toc | +  ​* ​SAGA GIS Binary format - SAGA 
-SAGA GIS Binary format - SAGA | .sdat | +  ​* SAR_CEOS 
-| SAR_CEOS |  | +  ​* ​SGI Image Format - SGI 
-SGI Image Format - SGI | .rgb | +  ​* ​SRTM HGT Format - SRTMHGT 
-SRTM HGT Format - SRTMHGT ​| .hgt | +  ​* ​Spot DIMAP - DIMAP 
-Spot DIMAP - DIMAP |  | +  ​* ​Standard Raster Product - SRP 
-Standard Raster Product - SRP | .img | +  ​* ​Swedish Grid RIK - RIK 
-Swedish Grid RIK - RIK | .rik | +  ​* ​TIFF / BigTIFF / GeoTIFF - GTiff 
-TIFF / BigTIFF / GeoTIFF - GTiff | .tif | +  ​* ​TerraSAR-X Complex SAR Data Product - COSAR 
-TerraSAR-X Complex SAR Data Product - COSAR |  | +  ​* ​TerraSAR-X Product - TSX 
-TerraSAR-X Product - TSX |  | +  ​* ​Terragen Heightfield - Terragen 
-Terragen Heightfield - Terragen ​| .ter | +  ​* ​USGS ASCII DEM / CDED - USGSDEM 
-USGS ASCII DEM / CDED - USGSDEM ​| .dem | +  ​* ​USGS Astrogeology ISIS cube (Version 2) - ISIS2 
-USGS Astrogeology ISIS cube (Version 2) - ISIS2 |  | +  ​* ​USGS Astrogeology ISIS cube (Version 3) - ISIS3 
-USGS Astrogeology ISIS cube (Version 3) - ISIS3 |  | +  ​* ​USGS SDTS DEM - SDTS 
-USGS SDTS DEM - SDTS | .ddf | +  ​* ​VTP Binary Terrain Format - BT 
-VTP Binary Terrain Format - BT | .bt | +  ​* ​Vexcel MFF - MFF 
-Vexcel MFF - MFF | .hdr | +  ​* ​Vexcel MFF2 - MFF2 
-Vexcel MFF2 - MFF2 |  | +  ​* ​WMO GRIB1/GRIB2 - GRIB 
-WMO GRIB1/GRIB2 - GRIB | .grb | +  ​* ​X11 Pixmap - XPM
-X11 Pixmap - XPM | .xpm | +
 ===== Map Formats Supported for Writing ===== ===== Map Formats Supported for Writing =====
  
Line 114: Line 113:
 </​note>​ </​note>​
  
-^ Description ^ +  ​* Arc/Info ASCII Grid - AAIGrid 
-| **Arc/Info ASCII Grid - AAIGrid** | +  ​* Daylon Leveller Heightfield - Leveller 
-Daylon Leveller Heightfield - Leveller ​| +  ​* ​ELAS DIPEx - ELAS* 
-ELAS DIPEx - ELAS* | +  ​* ​ENVI Labelled Raster - ENVI* 
-ENVI Labelled Raster - ENVI* | +  * ERMapper - ERS* 
-| **ERMapper - ERS*** | +  ​* ESRI Labelled - EHdr* 
-ESRI Labelled - EHdr* | +  ​* ​Erdas Imagine - HFA 
-Erdas Imagine - HFA | +  ​* ​GDAL Virtual - VRT 
-GDAL Virtual - VRT | +  ​* ​Golden Software Binary Grid - GSBG 
-Golden Software Binary Grid - GSBG | +  ​* ​ILWIS Raster Map - ILWIS 
-ILWIS Raster Map - ILWIS | +  ​* ​Idrisi Raster - RST 
-Idrisi Raster - RST | +  ​* ​Image Display and Analysis - IDA* 
-Image Display and Analysis - IDA* | +  ​* ​In Memory Raster - MEM* 
-In Memory Raster - MEM* | +  ​* ​Microsoft Windows Device Independent Bitmap - BMP 
-Microsoft Windows Device Independent Bitmap - BMP | +  ​* ​NITF 
-NITF | +  ​* ​NOAA vertical datum shift - GTX 
-NOAA vertical datum shift - GTX | +  ​* ​NTv2 Datum Grid Shift - NTv2 
-NTv2 Datum Grid Shift - NTv2 | +  ​* ​Netpbm - PNM 
-Netpbm - PNM | +  ​* ​PCI Geomatics Database File - PCIDSK 
-PCI Geomatics Database File - PCIDSK ​| +  ​* ​PCI Labelled - PAUX* 
-PCI Labelled - PAUX* | +  ​* ​Raster Matrix Format - RMF 
-Raster Matrix Format - RMF | +  ​* ​Raster Product Format/RPF - ADRG 
-Raster Product Format/RPF - ADRG | +  ​* ​SAGA GIS Binary format - SAGA 
-SAGA GIS Binary format - SAGA | +  ​* ​SGI Image Format - SGI 
-SGI Image Format - SGI | +  ​* ​TIFF / BigTIFF / GeoTIFF - GTiff 
-TIFF / BigTIFF / GeoTIFF - GTiff | +  ​* ​Terragen Heightfield - Terragen 
-Terragen Heightfield - Terragen ​| +  ​* ​VTP Binary Terrain Format - BT 
-VTP Binary Terrain Format - BT | +  ​* ​Vexcel MFF - MFF 
-Vexcel MFF - MFF | +  ​* ​Vexcel MFF2 - MFF2*
-Vexcel MFF2 - MFF2* |+
  
-The support to **Arc/Info ASCII Grid (.asc)** in GDAL is read only. So, Dinamica EGO provides the writing capability itself. This format can read images using [[Cell Type Type|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 EGO reads the image again.+The support to Arc/Info ASCII Grid (.asc) in GDAL is read only. So, Dinamica EGO provides the writing capability itself. This format can read images using [[Cell Type Type|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 EGO reads the image again.
  
-The current ​**ERMapper (.ers)** support in GDAL ignores class names. To workaround this limitation, support to reading and writing this file format is provided by Dinamica EGO itself.+The current ERMapper (.ers) support in GDAL ignores class names. To workaround this limitation, support to reading and writing this file format is [[ermapper_format|provided by Dinamica EGO itself]].
  
 ===== GDAL Limitations ===== ===== GDAL Limitations =====
  
-The GDAL implementation (and some times the underlying file format) imposes limitations ​on the representation of projections,​ layer names, category names and their corresponding colors. Some of these limitations and their corresponding workarounds are listed in the table below:+The GDAL implementation (and some times the underlying file format) imposes limitations ​to the representation of projections,​ layer names, category names and their corresponding colors. Some of these limitations and their corresponding workarounds are listed in the table below:
  
 ^ Limitation ^ Workaround ^  ^ Limitation ^ Workaround ^ 
Line 158: Line 156:
 | Several file formats do not support storing category colors. ​ | Use a [[supported_map_formats#​Virtual Format|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 storing category colors. ​ | Use a [[supported_map_formats#​Virtual Format|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. ​ | Use a [[supported_map_formats#​Virtual Format|VRT file]] or an auxiliary PAM XML file to keep this information. The ERMapper file format also has support to layer names. ​ | | Several file formats do not support the storage of layer names. ​ | Use a [[supported_map_formats#​Virtual Format|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 EGO does this when representing non-contiguous categories in a GDAL supported format) or using the ERMapper file format. ​ | +@yellow: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 EGO does this when representing non-contiguous categories in a GDAL supported format) or using the ERMapper file format. ​ | 
- +| @yellow:​Some formats do not preserve category colors when a specified number of bits per sample is used.  | Unfortunately, ​the only way to workaround this limitation is using a different ​format ​or choosing a number of bits per sample that does not have this limitation for a given format. For example, Geotiff format only stores category colors when the cell type is 8 bits.  |  
-Because ​the ERMapper file format is handled ​by Dinamica EGO itself and not delegated to the GDAL libraryBecause of this, the PAM XML file can not be used with this format.+| @pink:​Categories represented ​by negative values are not supported | Unfortunately,​ there is no way to workaround ​this limitationexcept by avoiding ​the use of negative categories |
  
 +The ERMapper file format is handled by Dinamica EGO itself and not delegated to the GDAL library. For that reason, the PAM XML file can not be used with this format.
 ===== Dinamica EGO Limitations ===== ===== Dinamica EGO Limitations =====
  
Line 170: Line 169:
 It is important to observe some additional details concerning how map reading behaves in the current Dinamica EGO version: It is important to observe some additional details concerning how map reading behaves in the current Dinamica EGO version:
    
-When the map projection is not found, the map projection is left undefined. Previous Dinamica EGO versions (Dinamica EGO 1.8) assumes ​a LOCAL projection in these cases.+When the map projection is not found, the map projection is left undefined. Previous Dinamica EGO versions (Dinamica EGO 1.8) assume ​a LOCAL projection in these cases.
  
-The behavior concerning the omission of cell resolution is also different in the current version. So, when the cell dimension is not defined, a one meter resolution (or one degree, depending on the map projection used) is assumed. Previously, Dinamica would assume a 100 meter or a one degree resolution, depending on the map projection used.+The behavior concerning the omission of cell resolution is also different in the current version. So, when the cell dimension is not defined, a one-meter resolution (or one degree, depending on the map projection used) is assumed. Previously, Dinamica would assume a 100 meter or a one degree resolution, depending on the map projection used.
  
-It is only possible to load maps represented by 8, 16 or 32 bits per cell. Other cell types are not supported.+It is only possible to load maps represented by 8, 1632 or 64 bits per cell. Other cell types are not supported.
  
 And an additional note concerning map writing: some formats do not support natively all the informations about map projections,​ map registration,​ cell resolution, layer names, category names etc. To workaround this, the GDAL library automatically writes an additional PAM XML file containing all the informations that can not be stored in the map file itself. This PAM XML is automatically processed when the map is loaded again in Dinamica EGO. And an additional note concerning map writing: some formats do not support natively all the informations about map projections,​ map registration,​ cell resolution, layer names, category names etc. To workaround this, the GDAL library automatically writes an additional PAM XML file containing all the informations that can not be stored in the map file itself. This PAM XML is automatically processed when the map is loaded again in Dinamica EGO.