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 23:04:18 +0100 (Fri, 15 Feb 2013) $ Full index © 2003-2014 GRASS Development Team