Scroll to navigation

m.nviz.image(1grass) Grass User's Manual m.nviz.image(1grass)

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,...]] [bgcolor= name] [position=x,y] [height=value] [ perspective=value] [twist=value] [zexag=value] [light_position= x,y,z] [light_color=name] [light_brightness= integer] [light_ambient=integer] [ fringe=string[,string,...]] [ fringe_color=name] [ fringe_elevation=integer] 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-1000
 
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
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
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
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/2010)
Last changed: $Date: 2011-11-08 10:42:51 +0100 (Tue, 08 Nov 2011) $
Full index
© 2003-2011 GRASS Development Team
GRASS 6.4.2