.. comment out this Section (by putting '|updatedisclaimer|' on top) if file is not uptodate with release .. _`label_plugingdaltools`: GDAL Tools Plugin ================= .. _`whatsgdal`: What is GDALTools? ------------------ The GDAL Tools plugin offers a GUI to the collection of tools in the Geospatial Data Abstraction Library, http://gdal.osgeo.org . These are raster management tools to query, re-project, warp and merge a wide variety of raster formats. Also included are tools to create a contour (vector) layer, or a shaded relief from a raster DEM, and to make a vrt (Virtual Raster Tile in XML format) from a collection of one or more raster files. These tools are available when the plugin is installed and activated. The GDAL Library ................ The GDAL library consists of a set of command line programs, each with a large list of options. Users comfortable with running commands from a terminal may prefer the command line, with access to the full set of options. The GDALTools plugin offers an easy interface to the tools, exposing only the most popular options. List of GDAL tools ------------------ .. _figure_GDAL_Tools_1: .. only:: html **Figure GDAL Tools 1:** .. figure:: /static/user_manual/plugins/raster_menu.png :align: center :width: 30em The *GDALTools* menu list Projections ........... +--------------------------------------------------------+------------------------------------------------------+ | |gdal_warp| :guilabel:`Warp (Reproject)` | This utility is an image mosaicing, reprojection and | | | warping utility. The program can reproject to any | | | supported projection, and can also apply GCPs stored| | | with the image if the image is "raw" with control | | | information. For more information you can read on | | | the GDAL website http://www.gdal.org/gdalwarp.html | +--------------------------------------------------------+------------------------------------------------------+ | |gdal_assign_projection| :guilabel:`Assign projection` | This tool allows to assign projection to rasters that| | | already georeferenced but miss projection | | | information. Also with it help it is possible to | | | alter existing projection definition. Both single | | | file and batch mode are supported. For more | | | information please visit utility page at GDAL site | | | http://www.gdal.org/gdalwarp.html | +--------------------------------------------------------+------------------------------------------------------+ | |gdal_extract_projection| | This utility helps you to extract projection | | :guilabel:`Extract projection` | information from an input file. If you want to | | | extract projection from a whole directory you can use| | | the Batch mode. It creates both :file:`.prj` and | | | :file:`.wld` files. | +--------------------------------------------------------+------------------------------------------------------+ \ \ Conversion .......... +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_rasterize| :guilabel:`Rasterize` | This program burns vector geometries (points, lines | | | and polygons) into the raster band(s) of a raster | | | image. Vectors are read from OGR supported vector | | | formats. Note that the vector data must in the same | | | coordinate system as the raster data; on the fly | | | reprojection is not provided. For more information see| | | http://www.gdal.org/gdal_rasterize.html | +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_polygonize| :guilabel:`Polygonize` | 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. The | | | utility will create the output vector datasource if it| | | does not already exist, defaulting to ESRI shapefile | | | format. See also | | | http://www.gdal.org/gdal_polygonize.html | +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_translate| :guilabel:`Translate` | This utility can be used to convert raster data | | | between different formats, potentially performing some| | | operations like subsettings, resampling, and rescaling| | | pixels in the process. For more information you can | | | read on http://www.gdal.org/gdal_translate.html | +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_raster-rgb| :guilabel:`RGB to PCT` | This utility will compute an optimal pseudo-color | | | table for a given RGB image using a median cut | | | algorithm on a downsampled RGB histogram. Then it | | | converts the image into a pseudo-colored image using | | | the color table. This conversion utilizes | | | Floyd-Steinberg dithering (error diffusion) to | | | maximize output image visual quality. The utility is | | | also desribed at http://www.gdal.org/rgb2pct.html | +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_raster-rgb| :guilabel:`PCT to RGB` | This utility will convert a pseudocolor band on the | | | input file into an output RGB file of the desired | | | format. For more information see | | | http://www.gdal.org/pct2rgb.html | +--------------------------------------------------------+-------------------------------------------------------+ \ \ Extraction .......... +--------------------------------------------------------+-------------------------------------------------------+ ||gdal_contour| :guilabel:`Contour` | This program generates a vector contour file from the | | | input raster elevation model (DEM). | | | On http://www.gdal.org/gdal_contour.html you can find | | | more information. | +--------------------------------------------------------+-------------------------------------------------------+ ||gdal_raster-clip| :guilabel:`Clipper` | This utility allows to clip (extract subset) raster | | | using selected extent or based on mask layer bounds. | | | More information can be found at | | | http://www.gdal.org/gdal_translate.html. | +--------------------------------------------------------+-------------------------------------------------------+ \ \ Analysis ........ +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_sieve| :guilabel:`Sieve` | This utility removes raster polygons smaller than a | | | provided threshold size (in pixels) and replaces | | | them with the pixel value of the largest neighbor | | | polygon. The result can be written back to the | | | existing raster band, or copied into a new file. For | | | more information see | | | http://www.gdal.org/gdal_sieve.html . | +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_nearblack| :guilabel:`Near Black` | This utility will scan an image and try to set all | | | pixels that are nearly black (or nearly white) around | | | the edge to exactly black (or white). This is often | | | used to "fix up" lossy compressed aerial photos so | | | that color pixels can be treated as transparent when | | | mosaicing. See also | | | http://www.gdal.org/nearblack.html . | +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_fillnodata| :guilabel:`Fill nodata` | This utility fills selection raster regions (usually | | | nodata areas) by interpolation from valid pixels | | | around the edges of the area. On | | | http://www.gdal.org/gdal_fillnodata.html you can find | | | more information. | +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_proximity|:guilabel:`Proximity` | This utility generates a raster proximity map | | | indicating the distance from the center of each pixel | | | to the center of the nearest pixel identified as a | | | target pixel. Target pixels are those in the source | | | raster for which the raster pixel value is in the set | | | of target pixel values. For more information see | | | http://www.gdal.org/gdal_proximity.html . | +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_grid| :guilabel:`Grid` | This utility creates regular grid (raster) from the | | | scattered data read from the OGR datasource. Input | | | data will be interpolated to fill grid nodes with | | | values, you can choose from various interpolation | | | methods. The utility is also described on the GDAL | | | website http://www.gdal.org/gdal_grid.html . | +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_dem| :guilabel:`DEM terrain models` | Tools to analyze and visualize DEMs. It can create a | | | shaded relief, a slope, an aspect, a color relief, a | | | Terrain Ruggedness Index, a Topographic Position Index| | | and a roughness map from any GDAL-supported elevation | | | raster. For more information you can read on | | | http://www.gdal.org/gdaldem.html | +--------------------------------------------------------+-------------------------------------------------------+ \ \ Miscellaneous ............. +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_vrt| :guilabel:`Build Virtual Raster` | This program builds a VRT (Virtual Dataset) that is a | | | mosaic of the list of input gdal datasets. See also | | | http://www.gdal.org/gdalbuildvrt.html . | +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_merge| :guilabel:`Merge` | This utility will automatically mosaic a set of | | | images. All the images must be in the same coordinate | | | system and have a matching number of bands, but they | | | may be overlapping, and at different resolutions. In | | | areas of overlap, the last image will be copied over | | | earlier ones. The utility is also described on | | | http://www.gdal.org/gdal_merge.html . | +--------------------------------------------------------+-------------------------------------------------------+ | |raster-info| :guilabel:`Information` | This utility lists various information about a | | | GDAL supported raster dataset. | | | On http://www.gdal.org/gdalinfo.html you can find | | | more information. | +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_raster-overview| :guilabel:`Build Overviews` | The gdaladdo utility can be used to build or rebuild | | | overview images for most supported file formats with | | | one of several downsampling algorithms. For more | | | information see http://www.gdal.org/gdaladdo.html . | +--------------------------------------------------------+-------------------------------------------------------+ | |gdal_tileindex| :guilabel:`Tile Index` | This utility builds a shapefile with a record for | | | each input raster file, an attribute containing the | | | filename, and a polygon geometry outlining the raster.| | | See also http://www.gdal.org/gdaltindex.html . | +--------------------------------------------------------+-------------------------------------------------------+ .. maybe simpler rewording of the description is necessary