[[PageOutline]]

= Autotest Status =

Below is the list of GDAL and OGR formats with information if particular driver is covered with autotest or not.
The '''x''' indicator means a driver is equipped with corresponding test and the empty cell means there is no test, probably we do not have test data that can be freely used and published with GDAL.

Note, this is a preliminary analysis of the autotest state. It does not include any details about a set of features covered by each test.

Below, 221 drivers are listed.

 * '''x''' : A least somewhat tested
 * '''W''' (for Web) : Some optionnal tests rely on downloading datasets. This requires the environment variable GDAL_DOWNLOAD_TEST_DATA to be set to YES. Once downloaded, these datasets are cached in autotest/gdrivers/tmp/cache.
 * - : No apparent testing
 * ''n'' : Priority for adding tests (1 being highest priority)

== Raster Formats ==

||'''Driver'''||'''Status'''||'''Notes'''||
||AAIGrid||'''x'''||||
||ACE2||'''x'''||||
||ADRG||'''x'''||||
||AIG||'''x'''||
||AirSAR||-||||
||ARG||'''x'''||||
||BAG||'''x'''||||
||BPG|| - ||||
||BLX||'''x'''||||
||BMP||'''x'''||||
||BSB||'''x'''||||
||BT||'''x'''||||
||CEOS||'''x'''||||
||COASP|| - ||||
||COSAR|| - ||||
||CPG||'''x'''|| only fake dataset tested ||
||CTG||'''x'''||||
||DIMAP|| - ||||
||DIPEx||'''x'''|| only fake dataset tested ||
||DODS||'''x'''||||
||DOQ1||'''x'''|| only fake dataset tested ||
||DOQ2||'''x'''||||
||DTED||'''x'''||||
||E00GRID||'''x'''||||
||ECRGTOC||'''x'''||||
||ECW||'''x'''||||
||EHdr||'''x'''||||
||EIR||'''x'''|| only fake dataset tested ||
||ELAS||'''x'''||||
||ENVI||'''x'''||||
||EPSILON||'''x'''|| tested by rasterlite.py ||
||ERS|| '''x''' ||||
||ESAT||'''W'''||||
||FAST||'''x'''||||
||FIT||'''x'''||||
||FITS||'''x'''||||
||FujiBAS||'''x'''|| only fake dataset tested ||
||GENBIN||'''x'''||||
||GeoRaster||'''x'''||||
||GFF||'''W'''||||
||GIF||'''x'''||||
||GRASS||'''x'''||||
||GRASSASCIIGrid||'''x'''||||
||GRIB||'''x'''||||
||GSAG||'''x'''||||
||GSBG||'''x'''||||
||GSC||'''x'''|| only fake dataset tested ||
||GS7BG||'''x'''||||
||GTA||'''x'''||||
||GTiff||'''x'''||||
||GTX||'''x'''||||
||GXF||'''x'''||||
||HDF4||'''x'''||||
||HDF5||'''W'''||||
||HF2||'''x'''||||
||HFA||'''x'''||||
||HTTP|| - ||Is it a driver and should it get a test?||
||IDA||'''x'''||||
||ILWIS||'''x'''||||
||INGR|| '''x''' ||||
||IRIS|| - ||||
||ISIS2||'''x'''||||
||ISIS3||'''x'''||||
||JAXAPALSAR|| - ||||
||JDEM||'''x'''|| only fake dataset tested ||
||JP2ECW||'''x'''||||
||JP2KAK||'''x'''||||
||JP2MrSID||'''x'''||||
||JP2OpenJPEG||'''x'''||||
||JPEG|| '''x''' ||||
||JPEGLS||'''x'''||||
||JPEG2000||'''x'''||||
||JPIPKAK||'''x'''||||
||KEA||'''x'''||||
||KMLSUPEROVERLAY||'''x'''||||
||KRO||'''x'''||||
||L1B|| '''W''' ||||
||LAN||'''x'''|| only fake dataset tested ||
||LCP||'''x'''||||
||Leveller||'''x'''||||
||LOSLAS||'''W'''||||
||MBTiles|| '''x''' ||||
||MEM|| '''x''' ||||
||MFF|| '''x''' || only fake dataset tested and created by CreateCopy() ||
||MFF2|| '''x''' || only dataset tested is created by CreateCopy() ||
||MG4Lidar||'''W'''||||
||MrSID|| '''x''' ||||
||MSG|| - ||||
||MSGN|| - ||||
||NDF||'''x'''||||
||NGSGEOID||'''x'''||||
||NITF||'''x''' '''W'''||||
||NetCDF||'''x'''||||
||NTv2||'''W'''||||
||NWT_GRC||'''x'''||||
||NWT_GRD||'''x'''||||
||OGDI|| - ||||
||OZI||'''W'''||||
||PAux||'''x'''||||
||PCIDSK||'''x'''||||
||PCRaster||'''x'''||||
||PDF||'''W'''||||
||PDS||'''x'''||||
||PGCHIP||'''x'''||||
||PLMOSAIC||'''x'''||||
||PNG||'''x'''||||
||PNM||'''x'''||||
||PostgisRaster||'''x'''||||
||R||'''x'''||||
||RASDAMAN||'''x'''||||
||Rasterlite||'''x'''||||
||RIK||'''W'''||||
||RMF|| - ||||
||ROI_PAC||'''x'''||||
||RPFTOC||'''x'''||||
||RS2||'''x'''|| only fake dataset tested ||
||RST||'''x'''||||
||SAGA||'''x'''||||
||SAR_CEOS||'''W'''||||
||SDTS||'''x'''||||
||SGI||'''x'''||||
||SNODAS||'''x'''||||
||SRP||'''x'''|| (USRP only) ||
||SRTMHGT||'''x'''||||
||TERRAGEN|| - ||||
||TERRALIB|| - ||||
||TIL||'''x'''|| only fake dataset tested ||
||TSX|| - ||||
||USGSDEM||'''x'''||||
||VICAR||'''x'''||||
||VRT||'''x'''||||
||WCS||'''x'''||||
||WEBP||'''x'''||||
||WMS||'''x'''||||
||XPM||'''W'''||||
||XYZ||'''x'''||||
||ZMap||'''x'''||||

== Vector Formats ==

||'''Driver'''||'''Status'''||'''Notes'''||
||AeronavFAA|| - ||||
||ARCGEN||'''x'''||||
||ArcObjects|| - ||||
||AVCBin||'''x'''||||
||AVCE00||'''x'''||||
||BNA||'''x'''||||
||CartoDB||'''x'''||||
||Cloudant||'''x'''||||
||CouchDB||'''x'''||||
||CSV||'''x'''||||
||CSW||'''x'''||||
||DGN||'''x'''||||
||DODS||'''x'''||||
||DWG|| - || (in spike) ||
||DWG|| - || (in GDAL 1.9 trunk) ||
||DXF|| - || (in spike) ||
||DXF||'''x'''|| (in GDAL 1.7 trunk) ||
||ElasticSearch||'''x'''||||
||EDIGEO||'''W'''||||
||FileGDB||'''x'''||||
||FMEObjects|| - ||||
||Geoconcept||'''x'''||||
||GeoJSON||'''x'''||Currently, only for file-based datasources||
||Geomedia|| - ||||
||GeoRSS||'''x'''||||
||GFT||'''x'''||||
||GML||'''x'''||||
||GMT||'''x'''||||
||GPKG||'''x'''||||
||GPSBabel||'''x'''||||
||GPX||'''x'''||||
||GRASS||'''x'''||||
||GTM||'''x'''||||
||HTF||'''x'''||||
||IDB|| - ||||
||Idrisi||'''x'''||||
||Interlis 1||'''x'''||||
||Interlis 2||'''x'''||||
||JML||'''x'''||||
||LIBKML||'''x'''||||
||KML||'''x'''||||
||MapInfo||'''x'''||||
||MDB||'''x'''||||
||Memory||'''x'''||||
||MySQL||'''x'''||||
||MSSQLSpatial|| - ||||
||NAS||'''W'''||||
||NTF||'''W'''||||
||OCI||'''x'''||||
||ODBC||'''x'''||||
||ODS||'''x'''||||
||OGDI||'''W'''||||
||OpenAir||'''x'''||||
||OpenFileGDB||'''x'''||||
||OSM||'''x'''||||
||PCIDSK||'''x'''||||
||PDF||'''x'''||||
||PDS||'''x'''||||
||PG||'''x'''||||
||PGDump||'''x'''||||
||PGeo||'''W'''||||
||PLScenes||'''x'''||||
||REC|| - ||||
||S57||'''x'''||||
||SDE|| - ||||
||SDTS||'''x'''||||
||SEGUKOOA||'''x'''||||
||SEGY||'''x'''||||
||Selafin||'''x'''||||
||Shapefile||'''x'''||||
||SOSI|| - ||||
||SQLite||'''x'''||||
||SUA||'''x'''||||
||SVG||'''x'''||||
||SXF||'''x'''||||
||TIGER||'''x'''||||
||VFK||'''x'''||||
||VRT||'''x'''||||
||WFS||'''x'''||||
||XLS||'''x'''||||
||XLSX||'''x'''||||
||XPlane||'''x'''||||
||WALK|| - ||||
||WASP||'''x'''||||

If there are any formats missing, feel free to add them to the table.

Many of the read-only distribute data formats will be hard to prepare autotests for since it is hard to get small test datasets. At some point we need to add an extended test suite that operates against the bigger datasets kept at http://download.osgeo.org/gdal/data. 

= Test coverage =

You can find the [http://rawgit.com/rouault/gdalautotest-coverage-results/master/coverage_html/index.html coverage] of the Autotest suite.

You can apply the following procedure (for a Unix build) to build GDAL with coverage support :
  * checkout GDAL SVN repository
  * apply attached patch at the root at the GDAL tree : patch -p0 < coverage.patch
  * configure GDAL : ./configure --without-libtool
  * build GDAL : make
  * run any command using GDAL : LD_LIBRARY_PATH=$PWD apps/gdalinfo test.tif
  * generate a .info file from the collected data : lcov --directory . --capture --output-file gdal.info
  * remove unrelevant info with the following attached program (filter_info.c : gcc filter_info.c -o filter_info) : ./filter_info < gdal.info > gdal_filtered.info
  * generate the HTML report in the coverage_html directory : genhtml -o ./coverage_html --num-spaces 2 gdal_filtered.info

If you want to generate a new coverage report, remove all .gcda files first (find . -name *.gcda -exec rm -f {} \;) and redo the last 4 previous steps.

Note : the coverage.patch is hackish and makes GDAL makefile lose some dependency rules. So if you modify a source file, make sure to remove libgdal.so before running make.