Note: This document is for an older version of GRASS GIS that is outdated. You should upgrade, and read the current manual page.

GRASS logo

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_mode=string[,string,...]] [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,...]
Constant elevation value(s) to use instead of a raster DEM
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
surface: drape on raster surface
flat: draw at constant elevation
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_mode=string[,string,...]
Vector point display mode
Options: surface,3D
Default: surface
surface: drape on raster surface
3D: place at 3D point's z-elevation
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)
Options: 0.0-1.0
Default: 0.84,0.16
height=value
Viewpoint height (in map units)
perspective=value
Viewpoint field of view (in degrees)
Options: 1-180
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:05:14 -0800 (Fri, 15 Feb 2013) $


Main index - misc index - Full index

© 2003-2014 GRASS Development Team