nviz(1) 		      Grass User's Manual		       nviz(1)



NNAAMMEE
       nnvviizz - Visualization and animation tool for GRASS data

SSYYNNOOPPSSIISS
       nnvviizz

       nnvviizz  [[--qq]]  [[ppaatthh_=_d_i_r]  [eelleevvaattiioonn_=_n_a_m_e	_[  _,_n_a_m_e_,_._._. _]] [vveeccttoorr_=_n_a_m_e _[
       _,_n_a_m_e_,_._._. _]] [ssiitteess_=_n_a_m_e _[ _,_n_a_m_e_,_._._. _]]

DDEESSCCRRIIPPTTIIOONN
       _n_v_i_z organizes several useful tools for combining and visualizing GRASS
       raster, vector and site files.  In particular, _n_v_i_z provides a detailed
       user interface with several panels used for specifying various options.
       The  user  may  specify	arbitrary  combinations of raster maps, vector
       maps, and site maps.  The attributes associated with each map (such  as
       color, masking, line width, etc.) may be modified independently.  Also,
       cut-planes may be used to display an interpolated cross	section  of  a
       set  of	raster	maps.	_n_v_i_z emphasizes a flexible and natural viewing
       mechanism allowing the user to modify view parameters  such  as	camera
       position,  surface  exaggeration,  display resolution, lighting models,
       and light position.  Lastly, _n_v_i_z supports an animation	and  scripting
       mechanism  for building visualizations of sequences of GRASS data.  The
       scripting mechanism may be used to record and playback  any  user  ses-
       sion.   Other  miscellaneous  features include: a facility for querying
       map displays for information, and image processing  tools  which  allow
       the placement of labels and scales on the display.

OOPPTTIIOONNSS
       The  initial  set  of  files used by _n_v_i_z may be specified by providing
       file arguments for elevation, vector and sites.	If the user  specifies
       program	arguments on the command line, the program will start with the
       given set of files.  Alternatively, the user can simply	type  _n_v_i_z  on
       the command line and the program will ask for parameter values and flag
       settings interactively, using the standard GRASS parser interface.

   FFllaagg::
       --qq     Quickstart.  Skip over the  usual  GRASS	parser	interface  and
	      start  _n_v_i_z.   Ignores  any  file parameters which may have been
	      specified on the command line.


   PPaarraammeetteerrss::
       ppaatthh==ddiirr
	      Search for additional panels in the specified directory.

       eelleevvaattiioonn==nnaammee[[,,nnaammee,,......]]
	      Use the given list of existing raster files as input.

       vveeccttoorr==nnaammee[[,,nnaammee,,......]]
	      Use the given list of existing vector files as input.

       ssiitteess==nnaammee[[,,nnaammee,,......]]
	      Use the given list of existing sites files as input.


PPAANNEELLSS
       _n_v_i_z features are presented to the user using "panels".	A panel encap-
       sulates	some  functionality  and  provides  an	interface for users to
       access this functionality.  For example, _n_v_i_z is distributed with  pan-
       els  for manipulating surfaces, vector files, light sources, and so on.
       In addition to these default panels, _n_v_i_z may  also  be	configured  to
       load application specific panels.


       In addition to the default panels, _n_v_i_z can be instructed to load addi-
       tional panels by either using the path option (see above) or by setting
       the  GRASS  resource  NvizPanelPath to the appropriate list of directo-
       ries.  Any directory specified as a path directory must contain a  pan-
       elIndex	file  which  names  the panels stored in that directory. Panel
       creation and panelIndex files are described elsewhere.

GGRRAASSSS RREESSOOUURRCCEE SSEETTTTIINNGGSS
       NvizPanelPath
	      Specifies a list of  directories	containing  additional	panels
	      (see PANELS).

       NvizAutoSurfColors
	      If  set  to  true then any surface loaded from the surface panel
	      will have the color attribute set to the	map  used  to  specify
	      topology.  This is the default behavior.


NNOOTTEESS
       Currently,  _n_v_i_z  must be invoked from within GRASS (preferably version
       5.x).  That is, start GRASS then invoke _n_v_i_z from the GRASS shell.


       _n_v_i_z is built on top of the Tcl/Tk environment.	Be sure  you  have  at
       least  Tcl  8.0 or later and Tk 8.0 or later and that appropriate envi-
       ronment variables are set correctly.

DDIIAAGGNNOOSSTTIICCSS
       ERROR: LOCATIONNAME not set

       The program was run outside of GRASS.


       TclAppInit failed: can't find /usr/local/lib/tcl/init.tcl; perhaps  you
       need to install Tcl or set your TCLLIBRARY environment variable?

       Tcl  not installed correctly or TCLLIBRARY environment variable not set
       correctly.


       TclAppInit failed: can't  find  /usr/local/lib/tk/tk.tcl;  perhaps  you
       need to install Tk or set your TKLIBRARY environment variable?

       Tk  not	installed  correctly or TKLIBRARY environment variable not set
       correctly.


       Usage: nviz [-q]  [elevation=name[,name,...]]  [vector=name[,name,...]]
       [sites=name[,name,...]]

       Invalid options were specified on the command line.

SSEEEE AALLSSOO
       _S_G_3_d

AAUUTTHHOORRSS
       Original program (Sg3d(NASA Panels) and Nviz(Motif) versions):

       David Gerdes, Bill Brown, and Helena Mitasova, U.S. Army CERL.


       Current version (Tcl/Tk version):

       Bill  Brown,  David Gerdes, Helena Mitasova, Terry Baker, and Mark Ast-
       ley, U.S. Army CERL.

       Various members	of  the  GRASS	community  have  provided  suggestions
       throughout the duration of the project.

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_3 _$



GRASS 5.0							       nviz(1)
