1r.in.wms(1) Grass User's Manual r.in.wms(1)
2
3
4
6 r.in.wms - Downloads and imports data from WMS servers
7
9 wms
10
12 r.in.wms
13 r.in.wms help
14 r.in.wms [-ldockp] [output=string] mapserver=string [lay‐
15 ers=string[,string,...]] [styles=string[,string,...]] [srs=string]
16 format=string [wmsquery=string] maxcols=integer maxrows=integer
17 [tileoptions=string] [region=string] [folder=string] [wgetop‐
18 tions=string] method=string [v=integer] [--overwrite]
19
20 Flags:
21 -l List available layers and exit
22
23 -d Skip to downloading (to resume downloads faster)
24
25 -o Don't request transparent data.
26
27 -c Clean existing data out of download directory.
28
29 -k Keep band numbers instead of using band color names.
30
31 -p Don't reproject the data, just patch it.
32
33 --overwrite
34
35 Parameters:
36 output=string
37 Name for resultant raster map
38
39 mapserver=string
40 Mapserver to request data from
41
42 layers=string[,string,...]
43 Layers to request from map server
44
45 styles=string[,string,...]
46 Styles to request from map server
47
48 srs=string
49 Source projection to request from server Default: EPSG:4326
50
51 format=string
52 Image format requested from the server Options: geo‐
53 tiff,tiff,jpeg,gif,png Default: geotiff
54
55 wmsquery=string
56 Addition query options for server Default: version=1.1.1
57
58 maxcols=integer
59 Maximum columns to request at a time Default: 1024
60
61 maxrows=integer
62 Maximum rows to request at a time Default: 1024
63
64 tileoptions=string
65 Additional options for r.tileset
66
67 region=string
68 Named region to request data for. Current region used if omitted.
69
70 folder=string
71 Folder to save downloaded data to
72
73 wgetoptions=string
74 Additional options for wget Default: -c -t 5 --user-agent=MSIE5.5
75
76 method=string
77 Reprojection method to use Options: nearest,bilinear,cubic,cubic‐
78 spline Default: nearest
79
80 v=integer
81 Verbosity level Default: 1
82
84 r.in.wms handles all of downloading and importing raster data from an
85 OpenGIS "WMS" web mapping server. It need only be told the desired data
86 to collect (bounds and resolution) via a region, the server to get the
87 data from, and the layer or layers to get. It downloads the data in
88 tiles, reprojects it, imports it, and patches it back together.
89
91 By default data is downloaded to $GISDBASE/wms_download. This can be
92 changed by setting the folder= option when using r.in.wms.
93
94 To understand the data you are getting it is necessary to look at the
95 capabilities of the WMS server. This should be available via a capabil‐
96 ities request. This is an example capabilities request to NASA's
97 OnEarth server.
98
100 General Get Capabilities Request
101 A capabilities request like
102 http://wms.jpl.nasa.gov/wms.cgi?request=GetCapabilities is where you
103 should start. It tells you what data is offered, the projections it is
104 in, where to find meta data, resolutions, scales, and bounds for data,
105 etc.
106
107 NASA OnEarth server: Get Capabilities Request
108
109 r.in.wms mapserver=http://wms.jpl.nasa.gov/wms.cgi -l
110 Lists the layers available from the NASA OnEarth server. The output is
111 more reliable if xml2 is installed.
112
113 US NED Elevation from OnEarth server download (metric units)
114 Set the resolution to 30 (assuming you're in metric units):
115 g.region res=30 -ap
116 r.in.wms output=elevation_meters
117 mapserver=http://wms.jpl.nasa.gov/wms.cgi \
118 layers=us_ned styles=real -o
119 Downloads real number meter elevation from OnEarth to cover the cur‐
120 rent region. Uses -o for opaque to get smaller download.
121
122 US NED Elevation from OnEarth server download (feet units)
123 Set the resolution to 90 (assuming you're in feet units) a save this
124 region with a name; this makes resuming downloads possible or rather
125 easier:
126 g.region res=90 -ap
127 g.region save=panhandle-90ft
128 r.in.wms output=elevation_feet
129 mapserver=http://wms.jpl.nasa.gov/wms.cgi layers=us_ned
130 styles=feet_real -o region=panhandle-90ft
131 Downloads real number feet elevation from OnEarth to cover the current
132 region. Uses -o for opaque to get smaller download. Using a named
133 region lets us resume later easily.
134 r.in.wms output=elevation_feet
135 mapserver=http://wms.jpl.nasa.gov/wms.cgi \
136 layers=us_ned styles=feet_real -o region=panhandle-90ft -d
137 method=cubic
138 -d skips ahead to downloading. This could be used to try downloading
139 again (if some files failed last time) or to import the data differ‐
140 ently. Since downloaded files are remembered those already received
141 successfully are not re-requested. In this case we are reimporting the
142 data using the cubic interpolation method instead of nearest neighbor.
143
144 LANDSAT from OnEarth server download
145 Set the resolution to 30 meters for LANDSAT:
146 g.region res=30 -ap
147 r.in.wms layers=global_mosaic mapserver=http://wms.jpl.nasa.gov/wms.cgi
148 \
149 output=wms_global_mosaic
150 Downloads LANDSAT color scene.
151
152 DRG from Terraserver server download
153 Set the resolution to 1.2 meters for DRGs. Their native resolution is
154 2.4 meters, so this is some pretty hefty oversampling:
155 g.region res=1.2 -ap
156 g.region save=drg-resolution
157 r.in.wms output=terraserver-drg mapserver=http://terraserver.micro‐
158 soft.com/ogcmap6.ashx \
159 layers=DRG region=drg-resolution format=jpeg srs=EPSG:26910
160 Downloads digital raster graphics from Microsoft TerraServer. Note
161 that srs will need to be changed to a projection that is appropriate
162 for your region.
163
165 r.in.wms requires the following programs to work:
166
167 wget: An http download program
168
169 bc: A calculator program
170
171 sed, grep: Unix string processing and search programs
172
173 gdalwarp: A reprojection tool, needed only if data is
174 projected into this location.
175
176 xml2: An xml parser. Enables more accurate listing of
177 layers on the server.
178
180 r.patch
181
183 Soeren Gebbert, Jachym Cepicky, and Cedric Shock
184
185 Last changed: $Date: 2007/05/09 08:05:56 $
186
187 Full index
188
189
190
191GRASS 6.2.2 r.in.wms(1)