Section 1: user commands and tools
NAME gdallocationinfo – gdallocationinfo raster query tool SYNOPSIS Usage : gdallocationinfo[–help – general][-xml][-lifonly][-valonly] [-b band] * [-overview overview_level] [-l_srs srs_def][-geoloc][-wgs84] srcfile[x y] DESCRIPTION The gdallocationinfo utility provide a mechanism to query information about a pixel given it’s location in one of a variety of coordinate systems. Several reporting options are provided. -xml: The output report…
NAME gdalinfo – gdalinfo lists information about a raster dataset SYNOPSIS gdalinfo[–help – general][-mm][-stats][-hist][-nogcp][-nomd] [-norat][-noct][-nofl][-checksum][-proj4] [-listmdd][-mdd domain |`all`] * [-sd subdataset] datasetname DESCRIPTION The gdalinfo program lists various information about a GDAL supported raster dataset. -mm Force computation of the actual min/max values for each band in the dataset. -stats Read and display image statistics….
NAME gdaldem – gdaldem Tools to analyze and visualize DEMs. (since GDAL 1.7.0) SYNOPSIS – To generate a shaded relief map from any GDAL – supported elevation raster: gdaldem hillshade input_dem output_hillshade [-z ZFactor(default = 1)][-s scale * (default = 1)] ” [-az Azimuth(default = 315)][-alt Altitude(default = 45)] [-alg ZevenbergenThorne][-combined] [-compute_edges][-b Band(default = 1)][-of…
NAME gdalcompare – gdalcompare.py compare two images SYNOPSIS gdalcompare.py [-sds] golden_file new_file DESCRIPTION The gdalcompare.py script compares two GDAL supported datasets and reports the differences. In addition to reporting differences to the standard out the script will also return the difference count in it’s exit value. Image pixels, and various metadata are checked. There is…
NAME gdalbuildvrt – gdalbuildvrt Builds a VRT from a list of datasets. (compiled by default since GDAL 1.6.1) SYNOPSIS gdalbuildvrt[-tileindex field_name] [-resolution{highest | lowest | average | user}] [-te xmin ymin xmax ymax][-tr xres yres][-tap] [-separate][-b band][-sd subdataset] [-allow_projection_difference][-q] [-addalpha][-hidenodata] [-srcnodata “value [value…]”][-vrtnodata “value [value…]”] [-a_srs srs_def] [-input_file_list my_liste.txt][-overwrite] output.vrt[gdalfile] * DESCRIPTION This program builds…
NAME gdaladdo – gdaladdo builds or rebuilds overview images SYNOPSIS gdaladdo[-r{nearest, average, gauss, cubic, average_mp, average_magphase, mode}] [-b band] [-ro][-clean][–help – general] filename levels DESCRIPTION The gdaladdo utility can be used to build or rebuild overview images for most supported file formats with one of several downsampling algorithms. -r {nearest (default),average,gauss,cubic,average_mp,average_magphase,mode}: Select a resampling algorithm….
NAME gdal_utilities – GDAL Utilities The following utility programs are distributed with GDAL. • gdalinfo – report information about a file. • gdal_translate – Copy a raster file, with control of output format. • gdaladdo – Add overviews to a file. • gdalwarp – Warp an image into a new coordinate system. • gdaltindex –…
NAME gdal_translate – gdal_translate converts raster data between different formats SYNOPSIS gdal_translate[–help – general] [-ot{Byte / Int16 / UInt16 / UInt32 / Int32 / Float32 / Float64 / CInt16 / CInt32 / CFloat32 / CFloat64}][-strict] [-of format][-b band][-mask band][-expand{gray | rgb | rgba}] [-outsize xsize[%] ysize[%]] [-unscale][-scale[_bn][src_min src_max[dst_min dst_max]]] * [-exponent[_bn] exp_val] * [-srcwin xoff…
NAME gdal_sieve – gdal_sieve.py removes small raster polygons SYNOPSIS gdal_sieve.py[-q][-st threshold][-4][-8][-o name = value] srcfile[-nomask][-mask filename][-of format][dstfile] DESCRIPTION The gdal_sieve.py script removes raster polygons smaller than a provided threshold size (in pixels) and replaces replaces them with the pixel value of the largest neighbour polygon. The result can be written back to the existing raster…
NAME gdal_retile – gdal_retile.py gdal_retile.py retiles a set of tiles and/or build tiled pyramid levels SYNOPSIS gdal_retile.py[-v][-co NAME = VALUE] * [-of out_format][-ps pixelWidth pixelHeight] [-ot{Byte / Int16 / UInt16 / UInt32 / Int32 / Float32 / Float64 / CInt16 / CInt32 / CFloat32 / CFloat64}]’ [-tileIndex tileIndexName[-tileIndexField tileIndexFieldName]] [-csv fileName[-csvDelim delimiter]] [-s_srs srs_def][-pyramidOnly] [-r{near…
NAME gdal_rasterize – gdal_rasterize burns vector geometries into a raster SYNOPSIS Usage : gdal_rasterize[-b band] * [-i][-at][-burn value] * | [-a attribute_name][-3d] [-l layername] * [-where expression][-sql select_statement] [-of format][-a_srs srs_def][-co “NAME=VALUE”] * [-a_nodata value][-init value] * [-te xmin ymin xmax ymax][-tr xres yres][-tap][-ts width height] [-ot{Byte / Int16 / UInt16 / UInt32 / Int32…
NAME gdal_proximity – gdal_proximity.py produces a raster proximity map SYNOPSIS gdal_proximity.py srcfile dstfile[-srcband n][-dstband n] [-of format][-co name = value] * [-ot Byte / Int16 / Int32 / Float32 / etc] [-values n, n, n][-distunits PIXEL / GEO] [-maxdist n][-nodata n][-fixed – buf – val n] DESCRIPTION The gdal_proximity.py script generates a raster proximity map…
NAME gdal_polygonize – gdal_polygonize.py produces a polygon feature layer from a raster SYNOPSIS gdal_polygonize.py[-8][-nomask][-mask filename] raster_file[-b band] [-q][-f ogr_format] out_file[layer][fieldname] DESCRIPTION This utility creates vector polygons for all connected regions of pixels in the raster sharing a common pixel value. Each polygon is created with an attribute indicating the pixel value of that polygon. A…
NAME gdal_merge – gdal_merge.py mosaics a set of images SYNOPSIS gdal_merge.py[-o out_filename][-of out_format][-co NAME = VALUE] * [-ps pixelsize_x pixelsize_y][-tap][-separate][-v][-pct] [-ul_lr ulx uly lrx lry][-n nodata_value][-init “value [value…]”] [-ot datatype][-createonly] input_files DESCRIPTION This utility will automatically mosaic a set of images. All the images must be in the same coordinate system and have a matching…
NAME gdal_grid – gdal_grid creates regular grid from the scattered data SYNOPSIS gdal_grid[-ot{Byte / Int16 / UInt16 / UInt32 / Int32 / Float32 / Float64 / CInt16 / CInt32 / CFloat32 / CFloat64}] [-of format][-co “NAME=VALUE”] [-zfield field_name][-z_increase increase_value][-z_multiply multiply_value] [-a_srs srs_def][-spat xmin ymin xmax ymax] [-clipsrc<xmin ymin xmax ymax> | WKT | datasource |…
NAME gdal_fillnodata – gdal_fillnodata.py fill raster regions by interpolation from edges SYNOPSIS gdal_fillnodata.py[-q][-md max_distance][-si smooth_iterations] [-o name = value][-b band] srcfile[-nomask][-mask filename][-of format][dstfile] DESCRIPTION The gdal_fillnodata.py script fills selection regions (usually nodata areas) by interpolating from valid pixels around the edges of the area. Additional details on the algorithm are available in the GDALFillNodata() docs….
NAME gdal_edit – gdal_edit.py Edit in place various information of an existing GDAL dataset SYNOPSIS gdal_edit[–help – general][-ro][-a_srs srs_def][-a_ullr ulx uly lrx lry] [-tr xres yres][-unsetgt][-a_nodata value] [-gcp pixel line easting northing[elevation]] * [-mo “META-TAG=VALUE”] * datasetname DESCRIPTION The gdal_edit.py script can be used to allows to edit in place various information of an existing…
NAME gdal_contour – gdal_contour builds vector contour lines from a raster elevation model SYNOPSIS Usage : gdal_contour[-b<band>][-a<attribute_name>][-3d][-inodata] [-snodata n][-i<interval>] [-f<formatname>][[-dsco NAME = VALUE]…][[-lco NAME = VALUE]…] [-off<offset>][-fl<level><level>…] [-nln<outlayername>]<src_filename><dst_filename> DESCRIPTION This program generates a vector contour file from the input raster elevation model (DEM). Starting from version 1.7 the contour line-strings will be oriented consistently. The…
NAME gdal_calc – gdal_calc.py Command line raster calculator with numpy syntax SYNOPSIS gdal_calc.py[-A<filename>][–A_band][-B… – Z filename][other_options] Options : -h, –help show this help message and exit– calc = CALC calculation in gdalnumeric syntax using + -/* or any numpy array functions (i.e. logical_and()) -A A input gdal raster file, note you can use any letter…
NAME gdal2tiles – gdal2tiles.py generates directory with TMS tiles, KMLs and simple web viewers SYNOPSIS gdal2tiles.py[-p profile][-r resampling][-s srs][-z zoom] [-e][-a nodata][-v][-h][-k][-n][-u url] [-w webviewer][-t title][-c copyright] [-g googlekey][-b bingkey] input_file[output_dir] DESCRIPTION This utility generates a directory with small tiles and metadata, following the OSGeo Tile Map Service Specification. Simple web pages with viewers based…