NAME

       r.external  - Link GDAL supported raster file to a binary raster map layer.

KEYWORDS

       raster, import

SYNOPSIS

       r.external
       r.external help
       r.external   [-oerf]    [input=name]    [source=string]    [output=name]    [band=integer]
       [title="phrase"]   [--overwrite]  [--verbose]  [--quiet]

   Flags:
       -o
           Override projection (use location's projection)

       -e
           Extend region extents based on new dataset
           Also updates the default region if in the PERMANENT mapset

       -r
           Require exact range

       -f
           List supported formats and exit

       --overwrite
           Allow output files to overwrite existing files

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       input=name
           Raster file to be linked

       source=string
           Name of non-file GDAL data source

       output=name
           Name for output raster map

       band=integer
           Band to select (default: all)

       title=
           Title for resultant raster map

DESCRIPTION

       r.external allows a user to link a GDAL supported raster  file  to  a  binary  raster  map
       layer,  from any GDAL supported raster map format, with an optional title. The file is not
       imported but just registered as GRASS raster map.

EXAMPLES

   RGB Orthophoto from GeoTIFF

       # import of all channels:
       r.external  /home/user/data/maps/059100.tif out=ortho
       g.region rast=ortho.3 -p
       d.rgb r=ortho.1 g=ortho.2 b=ortho.3
       r.composite r=ortho.1 g=ortho.2 b=ortho.3 output=ortho.rgb

SEE ALSO

        r.in.gdal, v.external

REFERENCES

       GDAL Pages: http://www.gdal.org/

AUTHOR

       Glynn Clements

       Last changed: $Date: 2011-06-03 09:42:11 -0700 (Fri, 03 Jun 2011) $

       Full index

       © 2003-2013 GRASS Development Team