.TH r.in.wms 1grass "" "GRASS 6.4.4" "Grass User's Manual"
.SH NAME
\fI\fBr.in.wms\fR\fR  - Downloads and imports data from WMS servers.
.SH KEYWORDS
wms
.SH SYNOPSIS
\fBr.in.wms\fR
.br
\fBr.in.wms help\fR
.br
\fBr.in.wms\fR [\-\fBldockpg\fR]  [\fBoutput\fR=\fIstring\fR]  \fBmapserver\fR=\fIstring\fR  [\fBlayers\fR=\fIstring\fR[,\fIstring\fR,...]]   [\fBstyles\fR=\fIstring\fR[,\fIstring\fR,...]]   [\fBsrs\fR=\fIstring\fR]  \fBformat\fR=\fIstring\fR  [\fBwmsquery\fR=\fIstring\fR]  \fBmaxcols\fR=\fIinteger\fR \fBmaxrows\fR=\fIinteger\fR  [\fBtileoptions\fR=\fIstring\fR]   [\fBregion\fR=\fIstring\fR]   [\fBfolder\fR=\fIstring\fR]   [\fBwgetoptions\fR=\fIstring\fR]   [\fBcurloptions\fR=\fIstring\fR]  \fBmethod\fR=\fIstring\fR  [\fBcap_file\fR=\fIstring\fR]   [\fBv\fR=\fIinteger\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR] 
.SS Flags:
.IP "\fB\-l\fR" 4m
.br
List available layers and exit
.IP "\fB\-d\fR" 4m
.br
Skip to downloading (to resume downloads faster)
.IP "\fB\-o\fR" 4m
.br
Don't request transparent data
.IP "\fB\-c\fR" 4m
.br
Clean existing data out of download directory
.IP "\fB\-k\fR" 4m
.br
Keep band numbers instead of using band color names
.IP "\fB\-p\fR" 4m
.br
Don't reproject the data, just patch it
.IP "\fB\-g\fR" 4m
.br
Use GET method instead of POST data method
.br
This may be needed to connect to servers which lack POST capability
.IP "\fB\-\-overwrite\fR" 4m
.br
Allow output files to overwrite existing files
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.PP
.SS Parameters:
.IP "\fBoutput\fR=\fIstring\fR" 4m
.br
Name for output raster map
.IP "\fBmapserver\fR=\fIstring\fR" 4m
.br
Mapserver to request data from
.IP "\fBlayers\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Layers to request from map server
.IP "\fBstyles\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Styles to request from map server
.IP "\fBsrs\fR=\fIstring\fR" 4m
.br
Source projection to request from server
.br
Default: \fIEPSG:4326\fR
.IP "\fBformat\fR=\fIstring\fR" 4m
.br
Image format requested from the server
.br
Options: \fIgeotiff,tiff,jpeg,gif,png\fR
.br
Default: \fIgeotiff\fR
.IP "\fBwmsquery\fR=\fIstring\fR" 4m
.br
Addition query options for server
.br
Default: \fIversion=1.1.1\fR
.IP "\fBmaxcols\fR=\fIinteger\fR" 4m
.br
Maximum columns to request at a time
.br
Default: \fI1024\fR
.IP "\fBmaxrows\fR=\fIinteger\fR" 4m
.br
Maximum rows to request at a time
.br
Default: \fI1024\fR
.IP "\fBtileoptions\fR=\fIstring\fR" 4m
.br
Additional options for r.tileset
.IP "\fBregion\fR=\fIstring\fR" 4m
.br
Named region to request data for. Current region used if omitted
.IP "\fBfolder\fR=\fIstring\fR" 4m
.br
Folder to save downloaded data to
.IP "\fBwgetoptions\fR=\fIstring\fR" 4m
.br
Additional options for wget
.br
Default: \fI-c \-t 5 \-nv\fR
.IP "\fBcurloptions\fR=\fIstring\fR" 4m
.br
Additional options for curl
.br
Default: \fI-C - \-\-retry 5 \-s -S\fR
.IP "\fBmethod\fR=\fIstring\fR" 4m
.br
Reprojection method to use
.br
Options: \fInearest,bilinear,cubic,cubicspline\fR
.br
Default: \fInearest\fR
.IP "\fBcap_file\fR=\fIstring\fR" 4m
.br
Filename to save capabilities XML file to
.br
Requires list available layers flag
.IP "\fBv\fR=\fIinteger\fR" 4m
.br
Verbosity level
.br
Default: \fI1\fR
.PP
.SH DESCRIPTION
\fIr.in.wms\fR 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.
.SH NOTES
By default data is downloaded to $GISDBASE/wms_download. This can be changed
by setting the \fBfolder\fR option when using \fIr.in.wms\fR.
.PP
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.
.PP
Other brain-dead servers will not accept queries in the form of POST data.
If you get an error try using the \fB-g\fR flag to force \fIr.in.wms\fR
to send an atomic GET request instead.
.SH EXAMPLES
.SS 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.
\fC
.DS
.br
.br
r.in.wms mapserver="http://mapserver.flightgear.org/ms" \-l
.br
.DE
\fR
.SS 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.
\fC
.DS
.br
g.region \-p n=37N s=33N w=85W e=75W res=0:00:30
.br
r.in.wms output=nc_landcover mapserver="http://mapserver.flightgear.org/ms" \(rs
.br
         layer=LANDCOVER format=png
.br
.DE
\fR
North Carolina landcover map
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.br
.SS 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:
\fC
.DS
.br
g.region res=1.2 \-ap
.br
g.region save=drg-resolution
.br
.br
r.in.wms output=terraserver-drg mapserver="http://terraserver.microsoft.com/ogcmap6.ashx" \(rs
.br
         layers=DRG region=drg-resolution format=jpeg srs=EPSG:26910
.br
.DE
\fR
Downloads digital raster graphics from Microsoft TerraServer. Note that
srs will need to be changed to a projection that is appropriate for your
region.
.SH REQUIRED PROGRAMS
\fIr.in.wms\fR requires the following programs to work:
.RS
.IP
wget: An http download program, or
.IP
curl: Alternate http download program
.IP
bc: A calculator program
.IP
sed, grep: Unix string processing and search programs
.IP
gdalwarp: A reprojection tool,
needed only if data is projected into this location.
.IP
xml2: An xml parser.
Enables more accurate listing of layers on the server.
.RE
.SH SEE ALSO
\fI
r.tileset,
r.in.gdal,
r.patch,
r.colors,
r.composite
.br
v.in.wfs
\fR
.SH AUTHORS
Soeren Gebbert, Jachym Cepicky, and Cedric Shock
.PP
\fILast changed: $Date: 2013-07-18 20:23:35 +0200 (Thu, 18 Jul 2013) $\fR
.PP
Full index
.PP
© 2003-2014 GRASS Development Team