1r.tileset(1) GRASS GIS 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] [separa‐
18 tor=character] [--help] [--verbose] [--quiet] [--ui]
19 Flags:
21 -g
22 Produces shell script output
23 -w
25 Produces web map server query string output
26 --help
28 Print usage summary
29 --verbose
31 Verbose module output
32 --quiet
34 Quiet module output
35 --ui
37 Force launching GUI dialog
38 Parameters:
40 region=string
41 Name of region to use instead of current region for bounds and res‐
42 olution
43 sourceproj=string [required]
45 Source projection
46 sourcescale=string
48 Conversion factor from units to meters in source projection
49 Default: 1
50 destproj=string
52 Destination projection, defaults to this location’s projection
53 destscale=string
55 Conversion factor from units to meters in source projection
56 maxcols=integer
58 Maximum number of columns for a tile in the source projection
59 Default: 1024
60 maxrows=integer
62 Maximum number of rows for a tile in the source projection
63 Default: 1024
64 overlap=integer
66 Number of cells tiles should overlap in each direction
67 Default: 0
68 separator=character
70 Field separator
71 Output field separator
72 Default: pipe
73
75 r.tileset generates sets of tiles in another projection that cover a
76 region in this projection with adequate resolution. By default the cur‐
77 rent region and its resolution are used, the bounds and resolution of
78 another region can be used via the region option.
79
81 r.tileset does not make "optimal" tilings (as few tiles of the largest
82 size less than the maximums). This means that from latitude longitude
83 projection to an appropriate projection for a region, in the degenerate
84 case, it may create tiles demanding up to twice the necessary informa‐
85 tion. Furthermore, generating a tiling near a divergant point of a
86 source projection, such as the poles of a cylindrical source projec‐
87 tions, results in divergence of the tile set.
88 Not generating "optimal" tilings may have another consequence; the as‐
90 pect ratio of cells in the destination region will not necessarily
91 carry over to the source region and generated tiles may have cells of
92 strange aspect ratios. This might be a problem for some map request
93 services presenting data in an inappropriate projection or with strict
94 constraints on cell aspect ratio.
95
97 Each tile is listed on a separate line in the output. The lines are
98 formatted as follows:
99 5|125|45|175|80|100
101 This is the default output format. It is the tile’s minimum x coor‐
102 dinate, minimum y coordinate, maximum x coordinate, maximum y coor‐
103 dinate, width in cells, and height in cells separated by the "|"
104 character. The fields can be separated by a different character by
105 changing the fs option.
106 w=5;s=125;e=45;n=175;cols=80;rows=100;
108 This is output in a format convenient for setting variables in a
109 shell script.
110 bbox=5,125,45,175&width=80&height=100
112 This is output in a format convenient for requesting data from some
113 http services.
114
116 Generates tiles in latitude longitude that cover the current region,
117 each tile will be less than 1024 cells high and 2048 cells across. The
118 bounds and sizes of tiles in the output are separated by | (pipe):
119 r.tileset sourceproj=+init=epsg:4326 maxrows=1024 maxcols=2048
121 Generates tiles in latitude longitude projection that cover the named
122 region "ne-rio". The tiles will have 2 cells of overlap. The output
123 format will be strings like the bbox requests for WMS servers:
124 r.tileset sourceproj=+init=epsg:4326 overlap=2 -w region=ne-rio
126 Generates tiles in the projection of the location "IrishGrid". Each
127 tile will be less than 300x400 cells in size, with 3 cells of overlap
128 in the top and right sides of each tile. The output is in a format
129 where each line is in shell script style. The substitution `g.proj -j
130 location=IrishGrid` will only work in a unix style shell:
131 r.tileset sourceproj="`g.proj -j location=IrishGrid`" maxrows=400 maxcols=300 overlap=3 -g
133
135 • r.tileset does not know about meridians that "wrap-around" in
136 projections.
137
139 Cedric Shock
140 Updated for GRASS 7 by Martin Landa, CTU in Prague, Czech Republic
141
143 Available at: r.tileset source code (history)
144 Accessed: Saturday Jan 21 21:17:02 2023
146 Main index | Raster index | Topics index | Keywords index | Graphical
148 index | Full index
149 © 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
151GRASS 8.2.1 r.tileset(1)