Rechercher une page de manuel
r.in.wms.1grass
Langue: en
Version: 331551 (ubuntu - 24/10/10)
Section: 1 (Commandes utilisateur)
NAME
r.in.wms - Downloads and imports data from WMS servers.KEYWORDS
wmsSYNOPSIS
r.in.wmsr.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 OpenGIS "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.
Some brain-dead servers will only talk to certain web browsers. You can fool these by adding "--user-agent=MSIE5.5" to wgetoptions or for curl adding "-A "MSIE5.5" to curloptions. 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://wms.jpl.nasa.gov/wms.cgi?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.NASA OnEarth server: Get Capabilities Request
r.in.wms mapserver=http://wms.jpl.nasa.gov/wms.cgi -l
Lists the layers available from the NASA OnEarth server. The output is more reliable if xml2 is installed.
US NED Elevation from OnEarth server download (metric units)
Set the resolution to 30 (assuming you're in metric units):g.region res=30 -ap
r.in.wms output=elevation_meters mapserver=http://wms.jpl.nasa.gov/wms.cgi \
layers=us_ned styles=real -o
Downloads real number meter elevation from OnEarth to cover the current region. Uses -o for opaque to get smaller download.
US NED Elevation from OnEarth server download (feet units)
Set the resolution to 90 (assuming you're in feet units) a save this region with a name; this makes resuming downloads possible or rather easier:g.region res=90 -ap
g.region save=panhandle-90ft
r.in.wms output=elevation_feet mapserver=http://wms.jpl.nasa.gov/wms.cgi \
layers=us_ned styles=feet_real -o region=panhandle-90ft
Downloads real number feet elevation from OnEarth to cover the current region. Uses -o for opaque to get smaller download. Using a named region lets us resume later easily.
r.in.wms output=elevation_feet mapserver=http://wms.jpl.nasa.gov/wms.cgi \
layers=us_ned styles=feet_real -o region=panhandle-90ft -d method=cubic
-d skips ahead to downloading. This could be used to try downloading again (if some files failed last time) or to import the data differently. Since downloaded files are remembered those already received successfully are not re-requested. In this case we are reimporting the data using the cubic interpolation method instead of nearest neighbor.
LANDSAT from OnEarth server download
Set the resolution to 30 meters for LANDSAT:g.region res=30 -ap
r.in.wms layers=global_mosaic mapserver=http://wms.jpl.nasa.gov/wms.cgi \
output=wms_global_mosaic
Downloads LANDSAT color scene.
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.patchAUTHORS
Soeren Gebbert, Jachym Cepicky, and Cedric ShockLast changed: $Date: 2008-05-13 14:16:21 +0200 (mar, 13 mag 2008) $
Full index
© 2003-2010 GRASS Development Team
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre