Provided by: grass-doc_6.4.3-3_all
NAME
m.nviz.image - Creates a 3D rendering of GIS data. Renders surfaces (raster data), 2D/3D vector data, and volumes (3D raster data) in 3D.
KEYWORDS
visualization, raster, vector, raster3d
SYNOPSIS
m.nviz.image m.nviz.image help m.nviz.image [-a] [elevation_map=name[,name,...]] [elevation_value=value[,value,...]] [color_map=name[,name,...]] [color=name[,name,...]] [mask_map=name[,name,...]] [transparency_map=name[,name,...]] [transparency_value=value[,value,...]] [shininess_map=name[,name,...]] [shininess_value=value[,value,...]] [emission_map=name[,name,...]] [emission_value=value[,value,...]] [mode=string[,string,...]] [resolution_fine=value[,value,...]] [resolution_coarse=value[,value,...]] [style=string[,string,...]] [shading=string[,string,...]] [wire_color=name[,name,...]] [surface_position=x,y,z[,x,y,z,...]] [vline=name[,name,...]] [vline_width=value[,value,...]] [vline_color=name[,name,...]] [vline_mode=string[,string,...]] [vline_height=value[,value,...]] [vline_position=x,y,z[,x,y,z,...]] [vpoint=name[,name,...]] [vpoint_size=value[,value,...]] [vpoint_width=value[,value,...]] [vpoint_color=name[,name,...]] [vpoint_marker=string[,string,...]] [vpoint_position=x,y,z[,x,y,z,...]] [volume=name[,name,...]] [volume_mode=string[,string,...]] [volume_shading=string[,string,...]] [volume_position=x,y,z[,x,y,z,...]] [volume_resolution=value[,value,...]] [isosurf_level=volume:value[,volume:value,...]] [isosurf_color_map=name[,name,...]] [isosurf_color_value=name[,name,...]] [isosurf_transparency_map=name[,name,...]] [isosurf_transparency_value=value[,value,...]] [isosurf_shininess_map=name[,name,...]] [isosurf_shininess_value=value[,value,...]] [slice=volume:axis[,volume:axis,...]] [slice_position=x1,x2,y1,y2,z1,z2[,x1,x2,y1,y2,z1,z2,...]] [slice_transparency=value[,value,...]] [bgcolor=name] [position=x,y] [height=value] [perspective=value] [twist=value] [zexag=value] [focus=x,y,z] [light_position=x,y,z] [light_color=name] [light_brightness=integer] [light_ambient=integer] [fringe=string[,string,...]] [fringe_color=name] [fringe_elevation=integer] [cplane=value[,value,...]] [cplane_position=x,y,z[,x,y,z,...]] [cplane_rotation=value[,value,...]] [cplane_tilt=value[,value,...]] [cplane_shading=string] [arrow_position=x,y] [arrow_size=value] [arrow_color=name] output=name format=string size=width,height [--verbose] [--quiet] Flags: -a Use draw mode for all loaded surfaces --verbose Verbose module output --quiet Quiet module output Parameters: elevation_map=name[,name,...] Name of raster map(s) for elevation elevation_value=value[,value,...] Elevation value(s) color_map=name[,name,...] Name of raster map(s) for color color=name[,name,...] Color value(s) Either a standard color name or R:G:B triplet mask_map=name[,name,...] Name of raster map(s) for mask transparency_map=name[,name,...] Name of raster map(s) for transparency transparency_value=value[,value,...] Transparency value(s) Options: 0-255 shininess_map=name[,name,...] Name of raster map(s) for shininess shininess_value=value[,value,...] Shininess value(s) Options: 0-255 emission_map=name[,name,...] Name of raster map(s) for emission emission_value=value[,value,...] Emission value(s) Options: 0-255 mode=string[,string,...] Draw mode Options: coarse,fine,both Default: fine resolution_fine=value[,value,...] Fine resolution Default: 6 resolution_coarse=value[,value,...] Coarse resolution Default: 9 style=string[,string,...] Draw style Options: wire,surface Default: surface shading=string[,string,...] Shading Options: flat,gouraud Default: gouraud wire_color=name[,name,...] Wire color Either a standard color name or R:G:B triplet Default: 136:136:136 surface_position=x,y,z[,x,y,z,...] Surface position Default: 0,0,0 vline=name[,name,...] Name of line vector overlay map(s) vline_width=value[,value,...] Vector line width Options: 1-100 Default: 2 vline_color=name[,name,...] Vector line color Either a standard color name or R:G:B triplet Default: blue vline_mode=string[,string,...] Vector line display mode Options: surface,flat Default: surface vline_height=value[,value,...] Vector line height Options: 0-1000 Default: 0 vline_position=x,y,z[,x,y,z,...] Vector lines position Default: 0,0,0 vpoint=name[,name,...] Name of point vector overlay map(s) vpoint_size=value[,value,...] Icon size Options: 1-10000 Default: 100 vpoint_width=value[,value,...] Icon width Options: 1-1000 Default: 2 vpoint_color=name[,name,...] Icon color Either a standard color name or R:G:B triplet Default: blue vpoint_marker=string[,string,...] Icon marker Options: x,sphere,diamond,cube,box,gyro,aster,histogram Default: sphere vpoint_position=x,y,z[,x,y,z,...] Vector points position Default: 0,0,0 volume=name[,name,...] Name of input raster3d map(s) volume_mode=string[,string,...] Volume draw mode Options: isosurface,slice Default: isosurface volume_shading=string[,string,...] Volume shading Options: flat,gouraud Default: gouraud volume_position=x,y,z[,x,y,z,...] Volume position Default: 0,0,0 volume_resolution=value[,value,...] Volume resolution Default: 3 isosurf_level=volume:value[,volume:value,...] Isosurface level isosurf_color_map=name[,name,...] Name of volume for isosurface color isosurf_color_value=name[,name,...] Isosurface color Either a standard color name or R:G:B triplet isosurf_transparency_map=name[,name,...] Name of 3D raster map(s) for isosurface transparency isosurf_transparency_value=value[,value,...] Transparency value(s)for isosurfaces Options: 0-255 isosurf_shininess_map=name[,name,...] Name of 3D raster map(s) for shininess isosurf_shininess_value=value[,value,...] Shininess value(s) for isosurfaces Options: 0-255 slice=volume:axis[,volume:axis,...] Volume slice parallel to given axis (x, y, z) slice_position=x1,x2,y1,y2,z1,z2[,x1,x2,y1,y2,z1,z2,...] Volume slice position Default: 0,1,0,1,0,1 slice_transparency=value[,value,...] Volume slice transparency Options: 0-255 Default: 0 bgcolor=name Background color Either a standard GRASS color, R:G:B triplet, or "none" Default: white position=x,y Viewpoint position (x,y model coordinates) Default: 0.84,0.16 height=value Viewpoint height (in map units) perspective=value Viewpoint field of view (in degrees) Options: 1-100 Default: 40 twist=value Viewpoint twist angle (in degrees) Options: -180-180 Default: 0 zexag=value Vertical exaggeration focus=x,y,z Focus to point on surface (from SW corner in map units) light_position=x,y,z Light position (x,y,z model coordinates) Default: 0.68,-0.68,0.80 light_color=name Light color Either a standard color name or R:G:B triplet Default: white light_brightness=integer Light brightness Options: 0-100 Default: 80 light_ambient=integer Light ambient Options: 0-100 Default: 20 fringe=string[,string,...] Fringe edges Options: nw,ne,sw,se nw: North-West edge ne: North-East edge sw: South-West edge se: South-East edge fringe_color=name Fringe color Either a standard color name or R:G:B triplet Default: grey fringe_elevation=integer Fringe elevation Default: 55 cplane=value[,value,...] Cutting plane index (0-5) cplane_position=x,y,z[,x,y,z,...] Cutting plane x,y,z coordinates Default: 0,0,0 cplane_rotation=value[,value,...] Cutting plane rotation along the vertical axis Options: 0-360 Default: 0 cplane_tilt=value[,value,...] Cutting plane tilt Options: 0-360 Default: 0 cplane_shading=string Cutting plane color (between two surfaces) Options: clear,top,bottom,blend,shaded Default: clear arrow_position=x,y Place north arrow at given position (in screen coordinates from bottom left corner) arrow_size=value North arrow size (in map units) arrow_color=name North arrow color Either a standard color name or R:G:B triplet Default: black output=name Name for output image file (without extension) format=string Graphics file format Options: ppm,tif Default: ppm size=width,height Size (width, height) of output image Default: 640,480
DESCRIPTION
m.nviz.image allows users to realistically render multiple surfaces (raster data) in a 3D space, optionally using thematic coloring, draping 2D vector data over the surfaces, displaying 3D vector data in the space, and visualization of volume data (3D raster data) from the command line.
EXAMPLE
Render elevation map in a 3D space. g.region rast=elevation m.nviz.image elevation_map=elevation output=elev perspective=15
SEE ALSO
wxGUI 3D view mode
AUTHOR
Martin Landa, Google Summer of Code 2008 (mentor: Michael Barton) and Google Summer of Code 2010 (mentor: Helena Mitasova) Anna Kratochvilova, Google Summer of Code 2011 (mentor: Martin Landa) Last changed: $Date: 2013-02-15 14:04:18 -0800 (Fri, 15 Feb 2013) $ Full index © 2003-2013 GRASS Development Team