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_,_._._. _]] [vveecc--
       ttoorr_=_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 par-
       ticular, _n_v_i_z provides a detailed user interface with sev-
       eral 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 mod-
       ified independently.  Also, cut-planes may be used to dis-
       play 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 resolu-
       tion, 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 pro-
       cessing 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 com-
       mand 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 parame-
	      ters 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 encapsulates  some  functionality	and  provides  an
       interface  for  users  to  access this functionality.  For
       example, _n_v_i_z is distributed with panels for  manipulating
       surfaces,  vector  files,  light  sources,  and so on.  In
       addition to these default panels, _n_v_i_z may also be config-
       ured to load application specific panels.


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

GGRRAASSSS RREESSOOUURRCCEE SSEETTTTIINNGGSS
       NvizPanelPath
	      Specifies a list of  directories	containing  addi-
	      tional 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 (prefer-
       ably  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 environment 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 envi-
       ronment variable?

       Tk not installed correctly or TKLIBRARY environment  vari-
       able not set correctly.


       Usage:	nviz   [-q]   [elevation=name[,name,...]]   [vec-
       tor=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)  ver-
       sions):

       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 Astley, U.S. Army CERL.

       Various	members of the GRASS community have provided sug-
       gestions 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)
