1m.nviz.image(1) GRASS GIS User's Manual m.nviz.image(1)
2
3
4
6 m.nviz.image - Creates a 3D rendering of GIS data.
7 Renders surfaces (raster data), 2D/3D vector data, and volumes (3D
8 raster data) in 3D.
9
11 miscellaneous, visualization, graphics, raster, vector, raster3d
12
14 m.nviz.image
15 m.nviz.image --help
16 m.nviz.image [-anb] [elevation_map=name[,name,...]] [eleva‐
17 tion_value=value[,value,...]] [color_map=name[,name,...]]
18 [color=name[,name,...]] [mask_map=name[,name,...]] [transpar‐
19 ency_map=name[,name,...]] [transparency_value=value[,value,...]]
20 [shininess_map=name[,name,...]] [shininess_value=value[,value,...]]
21 [emission_map=name[,name,...]] [emission_value=value[,value,...]]
22 [mode=string[,string,...]] [resolution_fine=value[,value,...]]
23 [resolution_coarse=value[,value,...]] [style=string[,string,...]]
24 [shading=string[,string,...]] [wire_color=name[,name,...]] [sur‐
25 face_position=x,y,z[,x,y,z,...]] [vline=name[,name,...]]
26 [vline_layer=string[,string,...]] [vline_width=value[,value,...]]
27 [vline_width_column=name[,name,...]] [vline_color=name[,name,...]]
28 [vline_color_column=name[,name,...]] [vline_mode=string[,string,...]]
29 [vline_height=value[,value,...]] [vline_position=x,y,z[,x,y,z,...]]
30 [vpoint=name[,name,...]] [vpoint_layer=string[,string,...]]
31 [vpoint_size=value[,value,...]] [vpoint_size_column=name[,name,...]]
32 [vpoint_width=value[,value,...]] [vpoint_width_col‐
33 umn=name[,name,...]] [vpoint_color=name[,name,...]]
34 [vpoint_color_column=name[,name,...]]
35 [vpoint_marker=string[,string,...]] [vpoint_marker_col‐
36 umn=name[,name,...]] [vpoint_mode=string[,string,...]] [vpoint_po‐
37 sition=x,y,z[,x,y,z,...]] [volume=name[,name,...]] [vol‐
38 ume_mode=string[,string,...]] [volume_shading=string[,string,...]]
39 [volume_position=x,y,z[,x,y,z,...]] [volume_resolu‐
40 tion=value[,value,...]] [isosurf_level=volume:value[,vol‐
41 ume:value,...]] [isosurf_color_map=name[,name,...]] [iso‐
42 surf_color_value=name[,name,...]] [isosurf_transpar‐
43 ency_map=name[,name,...]] [isosurf_transpar‐
44 ency_value=value[,value,...]] [isosurf_shininess_map=name[,name,...]]
45 [isosurf_shininess_value=value[,value,...]] [slice=volume:axis[,vol‐
46 ume:axis,...]] [slice_posi‐
47 tion=x1,x2,y1,y2,z1,z2[,x1,x2,y1,y2,z1,z2,...]] [slice_transpar‐
48 ency=value[,value,...]] [bgcolor=name] [position=x,y]
49 [height=value] [perspective=value] [twist=value] [zexag=value]
50 [focus=x,y,z] [light_position=x,y,z] [light_color=name]
51 [light_brightness=integer] [light_ambient=integer]
52 [fringe=string[,string,...]] [fringe_color=name] [fringe_eleva‐
53 tion=integer] [cplane=value[,value,...]] [cplane_posi‐
54 tion=x,y,z[,x,y,z,...]] [cplane_rotation=value[,value,...]]
55 [cplane_tilt=value[,value,...]] [cplane_shading=string] [arrow_po‐
56 sition=x,y] [arrow_size=value] [arrow_color=name] output=name for‐
57 mat=string size=width,height [--overwrite] [--help] [--verbose]
58 [--quiet] [--ui]
59
60 Flags:
61 -a
62 Use draw mode for all loaded surfaces
63
64 -n
65 Toggles normal direction of all isosurfaces (changes light effect)
66
67 -b
68 Draw volume box
69
70 --overwrite
71 Allow output files to overwrite existing files
72
73 --help
74 Print usage summary
75
76 --verbose
77 Verbose module output
78
79 --quiet
80 Quiet module output
81
82 --ui
83 Force launching GUI dialog
84
85 Parameters:
86 elevation_map=name[,name,...]
87 Name of raster map(s) for elevation
88
89 elevation_value=value[,value,...]
90 Constant elevation value(s) to use instead of a raster DEM
91
92 color_map=name[,name,...]
93 Name of raster map(s) for color
94
95 color=name[,name,...]
96 Color value(s)
97 Either a standard color name or R:G:B triplet
98
99 mask_map=name[,name,...]
100 Name of raster map(s) for mask
101
102 transparency_map=name[,name,...]
103 Name of raster map(s) for transparency
104
105 transparency_value=value[,value,...]
106 Transparency value(s)
107 Options: 0-255
108
109 shininess_map=name[,name,...]
110 Name of raster map(s) for shininess
111
112 shininess_value=value[,value,...]
113 Shininess value(s)
114 Options: 0-255
115
116 emission_map=name[,name,...]
117 Name of raster map(s) for emission
118
119 emission_value=value[,value,...]
120 Emission value(s)
121 Options: 0-255
122
123 mode=string[,string,...]
124 Draw mode
125 Options: coarse, fine, both
126 Default: fine
127
128 resolution_fine=value[,value,...]
129 Fine resolution
130 Default: 6
131
132 resolution_coarse=value[,value,...]
133 Coarse resolution
134 Default: 9
135
136 style=string[,string,...]
137 Draw style
138 Options: wire, surface
139 Default: surface
140
141 shading=string[,string,...]
142 Shading
143 Options: flat, gouraud
144 Default: gouraud
145
146 wire_color=name[,name,...]
147 Wire color
148 Either a standard color name or R:G:B triplet
149 Default: 136:136:136
150
151 surface_position=x,y,z[,x,y,z,...]
152 Surface position
153 Default: 0,0,0
154
155 vline=name[,name,...]
156 Name of vector map
157 Name of line vector overlay map(s)
158
159 vline_layer=string[,string,...]
160 Layer number or name
161 Layer number or name for thematic mapping
162 Default: 1
163
164 vline_width=value[,value,...]
165 Vector line width
166 Options: 1-100
167 Default: 2
168
169 vline_width_column=name[,name,...]
170 Name of width definition column
171 Name of attribute column
172
173 vline_color=name[,name,...]
174 Vector line color
175 Either a standard color name or R:G:B triplet
176 Default: blue
177
178 vline_color_column=name[,name,...]
179 Name of color definition column
180 Name of attribute column
181
182 vline_mode=string[,string,...]
183 Vector line display mode
184 Options: surface, flat
185 Default: surface
186 surface: drape on raster surface
187 flat: draw at constant elevation
188
189 vline_height=value[,value,...]
190 Vector line height
191 Options: 0-1000
192 Default: 0
193
194 vline_position=x,y,z[,x,y,z,...]
195 Vector lines position
196 Default: 0,0,0
197
198 vpoint=name[,name,...]
199 Name of vector map
200 Name of point vector overlay map(s)
201
202 vpoint_layer=string[,string,...]
203 Layer number or name
204 Layer number or name for thematic mapping
205 Default: 1
206
207 vpoint_size=value[,value,...]
208 Icon size (map units)
209 Options: 0-1000
210 Default: 100
211
212 vpoint_size_column=name[,name,...]
213 Name of size definition column
214 Name of attribute column
215
216 vpoint_width=value[,value,...]
217 Icon width
218 Options: 1-1000
219 Default: 2
220
221 vpoint_width_column=name[,name,...]
222 Name of width definition column
223 Name of attribute column
224
225 vpoint_color=name[,name,...]
226 Icon color
227 Either a standard color name or R:G:B triplet
228 Default: blue
229
230 vpoint_color_column=name[,name,...]
231 Name of color definition column
232 Name of attribute column
233
234 vpoint_marker=string[,string,...]
235 Icon marker
236 Options: x, box, sphere, cube, diamond, dec_tree, con_tree, aster,
237 gyro, histogram
238 Default: sphere
239
240 vpoint_marker_column=name[,name,...]
241 Name of marker definition column
242 Name of attribute column
243
244 vpoint_mode=string[,string,...]
245 3D vector point display mode
246 Options: surface, 3D
247 Default: 3D
248 surface: drape on raster surface
249 3D: place at 3D point’s z-elevation
250
251 vpoint_position=x,y,z[,x,y,z,...]
252 Vector points position
253 Default: 0,0,0
254
255 volume=name[,name,...]
256 Name of 3D raster map(s)
257
258 volume_mode=string[,string,...]
259 Volume draw mode
260 Options: isosurface, slice
261 Default: isosurface
262
263 volume_shading=string[,string,...]
264 Volume shading
265 Options: flat, gouraud
266 Default: gouraud
267
268 volume_position=x,y,z[,x,y,z,...]
269 Volume position
270 Default: 0,0,0
271
272 volume_resolution=value[,value,...]
273 Volume resolution
274 Default: 3
275
276 isosurf_level=volume:value[,volume:value,...]
277 Isosurface level
278
279 isosurf_color_map=name[,name,...]
280 Name of volume for isosurface color
281
282 isosurf_color_value=name[,name,...]
283 Isosurface color
284 Either a standard color name or R:G:B triplet
285
286 isosurf_transparency_map=name[,name,...]
287 Name of 3D raster map(s) for isosurface transparency
288
289 isosurf_transparency_value=value[,value,...]
290 Transparency value(s)for isosurfaces
291 Options: 0-255
292
293 isosurf_shininess_map=name[,name,...]
294 Name of 3D raster map(s) for shininess
295
296 isosurf_shininess_value=value[,value,...]
297 Shininess value(s) for isosurfaces
298 Options: 0-255
299
300 slice=volume:axis[,volume:axis,...]
301 Volume slice parallel to given axis (x, y, z)
302
303 slice_position=x1,x2,y1,y2,z1,z2[,x1,x2,y1,y2,z1,z2,...]
304 Volume slice position
305 Default: 0,1,0,1,0,1
306
307 slice_transparency=value[,value,...]
308 Volume slice transparency
309 Options: 0-255
310 Default: 0
311
312 bgcolor=name
313 Background color
314 Either a standard color name or R:G:B triplet
315 Default: white
316
317 position=x,y
318 Viewpoint position (x,y model coordinates)
319 Options: 0.0-1.0
320 Default: 0.84,0.16
321
322 height=value
323 Viewpoint height (in map units)
324
325 perspective=value
326 Viewpoint field of view (in degrees)
327 Options: 1-180
328 Default: 40
329
330 twist=value
331 Viewpoint twist angle (in degrees)
332 Options: -180-180
333 Default: 0
334
335 zexag=value
336 Vertical exaggeration
337
338 focus=x,y,z
339 Focus to point on surface (from SW corner in map units)
340
341 light_position=x,y,z
342 Light position (x,y,z model coordinates)
343 Default: 0.68,-0.68,0.80
344
345 light_color=name
346 Light color
347 Either a standard color name or R:G:B triplet
348 Default: white
349
350 light_brightness=integer
351 Light brightness
352 Options: 0-100
353 Default: 80
354
355 light_ambient=integer
356 Light ambient
357 Options: 0-100
358 Default: 20
359
360 fringe=string[,string,...]
361 Fringe edges
362 Options: nw, ne, sw, se
363 nw: North-West edge
364 ne: North-East edge
365 sw: South-West edge
366 se: South-East edge
367
368 fringe_color=name
369 Fringe color
370 Either a standard color name or R:G:B triplet
371 Default: grey
372
373 fringe_elevation=integer
374 Fringe elevation
375 Default: 55
376
377 cplane=value[,value,...]
378 Cutting plane index (0-5)
379
380 cplane_position=x,y,z[,x,y,z,...]
381 Cutting plane x,y,z coordinates
382 Default: 0,0,0
383
384 cplane_rotation=value[,value,...]
385 Cutting plane rotation along the vertical axis
386 Options: 0-360
387 Default: 0
388
389 cplane_tilt=value[,value,...]
390 Cutting plane tilt
391 Options: 0-360
392 Default: 0
393
394 cplane_shading=string
395 Cutting plane color (between two surfaces)
396 Options: clear, top, bottom, blend, shaded
397 Default: clear
398
399 arrow_position=x,y
400 Place north arrow at given position    (in screen coordinates
401 from bottom left corner)
402
403 arrow_size=value
404 North arrow size (in map units)
405
406 arrow_color=name
407 North arrow color
408 Either a standard color name or R:G:B triplet
409 Default: black
410
411 output=name [required]
412 Name for output image file (without extension)
413
414 format=string [required]
415 Graphics file format
416 Options: ppm, tif
417 Default: ppm
418
419 size=width,height [required]
420 Size (width, height) of output image
421 Default: 640,480
422
424 m.nviz.image allows users to realistically render multiple surfaces
425 (raster data) in a 3D space, optionally using thematic coloring, drap‐
426 ing 2D vector data over the surfaces, displaying 3D vector data in the
427 space, and visualization of volume data (3D raster data) from the com‐
428 mand line.
429
431 Render elevation map in a 3D space.
432 g.region raster=elevation
433 m.nviz.image elevation_map=elevation output=elev perspective=15
434
436 wxGUI 3D viewer
437
439 Martin Landa, Google Summer of Code 2008 (mentor: Michael Barton) and
440 Google Summer of Code 2010 (mentor: Helena Mitasova)
441 Anna Kratochvilova, Google Summer of Code 2011 (mentor: Martin Landa)
442
444 Available at: m.nviz.image source code (history)
445
446 Accessed: Saturday Oct 28 18:18:58 2023
447
448 Main index | Miscellaneous index | Topics index | Keywords index |
449 Graphical index | Full index
450
451 © 2003-2023 GRASS Development Team, GRASS GIS 8.3.1 Reference Manual
452
453
454
455GRASS 8.3.1 m.nviz.image(1)