1r.tileset(1) Grass User's Manual r.tileset(1)
2
6 r.tileset - Produces tilings of the source projection for use in the
7 destination region and projection.
8
10 raster, tiling
11
13 r.tileset
14 r.tileset help
15 r.tileset [-gw] [region=string] sourceproj=string
16 [sourcescale=string] [destproj=string] [destscale=string] [max‐
17 cols=integer] [maxrows=integer] [overlap=integer] [fs=string]
18 [v=integer] [--verbose] [--quiet]
19 Flags:
21 -g
22 Produces shell script output
23 -w
25 Produces web map server query string output
26 --verbose
28 Verbose module output
29 --quiet
31 Quiet module output
32 Parameters:
34 region=string
35 Name of region to use instead of current region for bounds and res‐
36 olution
37 sourceproj=string
39 Source projection
40 sourcescale=string
42 Conversion factor from units to meters in source projection
43 Default: 1
44 destproj=string
46 Destination projection, defaults to this location's projection
47 destscale=string
49 Conversion factor from units to meters in source projection
50 maxcols=integer
52 Maximum number of columns for a tile in the source projection
53 Default: 1024
54 maxrows=integer
56 Maximum number of rows for a tile in the source projection
57 Default: 1024
58 overlap=integer
60 Number of cells tiles should overlap in each direction
61 Default: 0
62 fs=string
64 Output field seperator
65 Default: |
66 v=integer
68 Verbosity level
69 Default: 0
70
72 r.tileset generates sets of tiles in another projection that cover a
73 region in this projection with adequate resolution. By default the cur‐
74 rent region and its resolution are used, the bounds and resolution of
75 another region can be used via the region option.
76
78 r.tileset does not make "optimal" tilings (as few tiles of the largest
79 size less than the maximums). This means that from latitude longitude
80 projection to an appropriate projection for a region, in the degenerate
81 case, it may create tiles demanding up to twice the necessary informa‐
82 tion. Furthermore, generating a tiling near a divergant point of a
83 source projection, such as the poles of a cylindrical source projec‐
84 tions, results in divergence of the tile set.
85 Not generating "optimal" tilings may have another consequence; the
87 aspect ratio of cells in the destination region will not necessarily
88 carry over to the source region and generated tiles may have cells of
89 strange aspect ratios. This might be a problem for some map request
90 services presenting data in an inappropriate projection or with strict
91 constraints on cell aspect ratio.
92
94 Each tile is listed on a seperate line in the output. The lines are
95 formatted as follows:
96 5|125|45|175|80|100
99 This is the default output format. It is the tile's minimum x
100 coordinate, minimum y coordinate, maximum x coordinate, maximum
101 y coordinate, width in cells, and height in cells seperated by
102 the "|" character. The fields can be seperated by a different
103 character by changing the fs option.
104 w=5;s=125;e=45;n=175;cols=80;rows=100;
107 This is output in a format convinent for setting variables in a
108 shell script.
109 bbox=5,125,45,175&width=80&height=100
112 This is output in a format convinent for requesting data from
113 some http services.
114
116 r.tileset sourceproj=+init=epsg:4326 maxrows=1024 maxcols=2048
118 Generates tiles in latitude longitude that cover the current
120 region, each tile will be less than 1024 cells high and 2048
121 cells across. The bounds and sizes of tiles in the output are
122 seperated by |
123 r.tileset sourceproj=+init=epsg:4326 overlap=2 -w region=ne-rio
126 Generates tiles in latitude longitude projection that cover the
128 named region "ne-rio". The tiles will have 2 cells of overlap.
129 The output format will be strings like the bbox requests for WMS
130 servers.
131 r.tileset sourceproj=`g.proj -j location=IrishGrid` maxrows=400
134 maxcols=300 overlap=3 -g
135 Generates tiles in the projection of the location "IrishGrid".
137 Each tile will be less than 300x400 cells in size, with 3 cells
138 of overlap in the top and right sides of each tile. The output
139 is in a format where each line is in shell script style. The
140 substitution `g.proj -j location=IrishGrid` will only work in a
141 unix style shell.
142
144 r.tileset requires the following programs to work:
145 cs2cs
147 The coordinate system transformation program from Proj4.
148 bc
150 A calculator program
151 sed, grep
153 Unix string processing and search programs
154
156 r.tileset does not know about meridians that "wrap-
157 around" in projections.
158
160 Cedric Shock
161 Last changed: $Date: 2006-05-02 03:49:52 +0200 (Tue, 02 May 2006) $
163 Full index
165 © 2003-2008 GRASS Development Team
167GRASS 6.3.0 r.tileset(1)