1m.nviz.image(1)             GRASS GIS User's Manual            m.nviz.image(1)
2
3
4

NAME

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

KEYWORDS

11       miscellaneous, visualization, graphics, raster, vector, raster3d
12

SYNOPSIS

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,...]]        [trans‐
19       parency_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,...]]
37       [vpoint_position=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_trans‐
43       parency_map=name[,name,...]]                            [isosurf_trans‐
44       parency_value=value[,value,...]]                        [isosurf_shini‐
45       ness_map=name[,name,...]]   [isosurf_shininess_value=value[,value,...]]
46       [slice=volume:axis[,volume:axis,...]]                      [slice_posi‐
47       tion=x1,x2,y1,y2,z1,z2[,x1,x2,y1,y2,z1,z2,...]]           [slice_trans‐
48       parency=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]
56       [arrow_position=x,y]    [arrow_size=value]    [arrow_color=name]   out‐
57       put=name   format=string   size=width,height   [--overwrite]   [--help]
58       [--verbose]  [--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

DESCRIPTION

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

EXAMPLE

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

SEE ALSO

436        wxGUI 3D viewer
437

AUTHOR

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

SOURCE CODE

444       Available at: m.nviz.image source code (history)
445
446       Main  index  |  Miscellaneous  index  | Topics index | Keywords index |
447       Graphical index | Full index
448
449       © 2003-2020 GRASS Development Team, GRASS GIS 7.8.5 Reference Manual
450
451
452
453GRASS 7.8.5                                                    m.nviz.image(1)
Impressum