NAME

       r.in.wms  - Downloads and imports data from WMS servers.

KEYWORDS

       wms

SYNOPSIS

       r.in.wms
       r.in.wms help
       r.in.wms   [-ldockpg]    [output=string]   mapserver=string   [layers=string[,string,...]]
       [styles=string[,string,...]]       [srs=string]      format=string       [wmsquery=string]
       maxcols=integer  maxrows=integer  [tileoptions=string]   [region=string]   [folder=string]
       [wgetoptions=string]       [curloptions=string]      method=string       [cap_file=string]
       [v=integer]   [--overwrite]  [--verbose]  [--quiet]

   Flags:
       -l
           List available layers and exit

       -d
           Skip to downloading (to resume downloads faster)

       -o
           Don't request transparent data

       -c
           Clean existing data out of download directory

       -k
           Keep band numbers instead of using band color names

       -p
           Don't reproject the data, just patch it

       -g
           Use GET method instead of POST data method
           This may be needed to connect to servers which lack POST capability

       --overwrite
           Allow output files to overwrite existing files

       --verbose
           Verbose module output

       --quiet
           Quiet module output

   Parameters:
       output=string
           Name for output raster map

       mapserver=string
           Mapserver to request data from

       layers=string[,string,...]
           Layers to request from map server

       styles=string[,string,...]
           Styles to request from map server

       srs=string
           Source projection to request from server
           Default: EPSG:4326

       format=string
           Image format requested from the server
           Options: geotiff,tiff,jpeg,gif,png
           Default: geotiff

       wmsquery=string
           Addition query options for server
           Default: version=1.1.1

       maxcols=integer
           Maximum columns to request at a time
           Default: 1024

       maxrows=integer
           Maximum rows to request at a time
           Default: 1024

       tileoptions=string
           Additional options for r.tileset

       region=string
           Named region to request data for. Current region used if omitted

       folder=string
           Folder to save downloaded data to

       wgetoptions=string
           Additional options for wget
           Default: -c -t 5 -nv

       curloptions=string
           Additional options for curl
           Default: -C - --retry 5 -s -S

       method=string
           Reprojection method to use
           Options: nearest,bilinear,cubic,cubicspline
           Default: nearest

       cap_file=string
           Filename to save capabilities XML file to
           Requires list available layers flag

       v=integer
           Verbosity level
           Default: 1

DESCRIPTION

       r.in.wms  handles all of downloading and importing raster data from an OGC WMS web mapping
       server. It need only be told the desired data to collect (bounds  and  resolution)  via  a
       region,  the server to get the data from, and the layer or layers to get. It downloads the
       data in tiles, reprojects it, imports it, and patches it back together.

NOTES

       By default data is downloaded to $GISDBASE/wms_download. This can be  changed  by  setting
       the folder option when using r.in.wms.

       To  understand the data you are getting it is necessary to look at the capabilities of the
       WMS server. This should be available via  a  capabilities  request.  This  is  an  example
       capabilities request to NASA's OnEarth server.

       Other  brain-dead servers will not accept queries in the form of POST data.  If you get an
       error try using the -g flag to force r.in.wms to send an atomic GET request instead.

EXAMPLES

   General Get Capabilities Request
       A                      capabilities                      request                      like
       http://mapserver.flightgear.org/ms?Service=WMS&Version=1.1.1&request=GetCapabilities    is
       where you should start. It tells you what data is  offered,  the  projections  it  is  in,
       where to find meta data, resolutions, scales, and bounds for data, etc.  For example lists
       the layers available from TelaScience's OSGeo/FlightGear landcover server.
       r.in.wms mapserver="http://mapserver.flightgear.org/ms" -l

   Land Cover
       In a Lat/Lon location first set the region to cover the state of North  Carolina  and  the
       resolution to 30 arc-seconds.
       g.region -p n=37N s=33N w=85W e=75W res=0:00:30
       r.in.wms output=nc_landcover mapserver="http://mapserver.flightgear.org/ms" \
                layer=LANDCOVER format=png
        North Carolina landcover map

   DRG from Terraserver server download
       Set  the resolution to 1.2 meters for DRGs. Their native resolution is 2.4 meters, so this
       is some pretty hefty oversampling:
       g.region res=1.2 -ap
       g.region save=drg-resolution
       r.in.wms output=terraserver-drg  mapserver="http://terraserver.microsoft.com/ogcmap6.ashx"
       \
                layers=DRG region=drg-resolution format=jpeg srs=EPSG:26910
         Downloads digital raster graphics from Microsoft TerraServer. Note that srs will need to
       be changed to a projection that is appropriate for your region.

REQUIRED PROGRAMS

       r.in.wms requires the following programs to work:

                     wget: An http download program, or

                     curl: Alternate http download program

                     bc: A calculator program

                     sed, grep: Unix string processing and search programs

                     gdalwarp: A reprojection tool, needed only if data is  projected  into  this
                     location.

                     xml2: An xml parser.  Enables more accurate listing of layers on the server.

SEE ALSO

        r.tileset, r.in.gdal, r.patch, r.colors, r.composite
       v.in.wfs

AUTHORS

       Soeren Gebbert, Jachym Cepicky, and Cedric Shock

       Last changed: $Date: 2013-07-18 20:23:35 +0200 (Thu, 18 Jul 2013) $

       Full index

       © 2003-2013 GRASS Development Team