VISTA(L)		  CSDS Commands			 VISTA(L)

NAME
     vista - 3D	structural statistics display package

SYNOPSIS
     vista [ -j	]  jobname [ -help ] [ -version	] [ -reorderbytes
     order  ]  [   - fig  fig_file  ]  [  -of output_file ] [ -db
     database_file1 [ ... database_fileN ] ]

DESCRIPTION
     vista displays chemical structure statistics generated  from
     the output	of quest(l) runs.

OPTIONS
     -j	jobname
	  Specify a jobname for	this run of vista.  Output  files
	  will be given	the root name jobname.

     -db database1 ... databaseN
	  Search this database instead of  the	default	 `Master'
	  database.   This flag	must appear after all others (see
	  ENVIRONMENT below).  vista  will  search  the	 database
	  specified by the triplet database.ind, database.msk and
	  database.ind (The extensions .ind , .msk and	.tcd  are
	  invariant).  If  more	than one database is specified on
	  the  command	line  the  specified  databases	 will  be
	  searched  in	the  order  given.   The keyword `Master'
	  (case	sensitive) can be used to refer	 to  the  default
	  master database.

     -reorderbytes byteorder
	  Flag the database files as having a non-native  integer
	  format.  Note	 that  all subset databases created using
	  the SAVE ASER	option are in native format and	that  you
	  cannot  mix  native  and  non-native	databases.  Valid
	  values for  <byteorder>  are:	  OPPOSITE_ENDIAN  or  an
	  integer representing the required byte-reordering (e.g.
	  4321 has the same effect as OPPOSITE_ENDIAN ).  See the
	  CSD_DB_REORDER_BYTES	 environment   variable	  in  the
	  ENVIRONMENT section.	  - fig	 fig_file  Configure  the
	  graphics  for	 vista from the	file fig_file.	(See VIS-
	  TAFIG	in the ENVIRONMENT section.)

     -version
	  Print	version	information for	the current CSDS.

     -help
	  Display these	manual pages.

     -of output_filename
	  Write	output to  output_file instead of  standard  out.
	  Useful for batch runs	with the at(1) command.

CSD System  Last change: $Date:	1998/01/14 09:56:28 $		1

VISTA(L)		  CSDS Commands			 VISTA(L)

ENVIRONMENT
     vista recognises a	number of environment variables. When the
     CSDS  was	configured  (using config.sh) default values were
     (implicitly) assigned to the environment variables:  CSDHOME
     and  CSDMACHINE.  They can, however, be overridden	by expli-
     citly defining them within	the current environment.

     CSDHOME
	  Look for auxiliary executables, scripts and  tables  in
	  the  directory  pointed  to by $CSDHOME. This	directory
	  should be accessible to all potential	users of the Cam-
	  bridge  Crystallographic Data	System and must	be acces-
	  sible	by vista.

     CSDMACHINE
	  Use the  executables	and  database  for  machine  type
	  $CSDMACHINE.	It  is possible, especially with the net-
	  work file system (NFS),  to  have  different	types  of
	  machines  accessing  the database. This variable speci-
	  fies the current machine type	to the CSDS.

     CSD_DBFILE
	  If set, vista	looks for the names of the database files
	  in  the  file	 pointed  by  $CSD_DBFILE.  Otherwise  it
	  searches for the names list  in  the	following  files:
	  $CSDHOME/csds/db_$CSDHOST.dbl
	  $CSDHOME/csds/db_$CSDMACHINE.dbl   $CSDHOME/csds/db.dbl
	  using	the first one found.

     CSD_DB_REORDER_BYTES
	  Forces all database files  to	 be  interpreted  in  non
	  native  format. Integer bytes	will be	reordered accord-
	  ing to the value of this variable.

     CSD_CDROM_FILENAMES
	  If defined, CSD_CDROM_FILENAMES should be a script that
	  reads	filenames/directory_names from standard	input and
	  writes the equivalent	CD-ROM names to	standard  output.
	  For  example	if  the	 filenames in the cdrom	appear as
	  uppercase with version  numbers  then	 (in  the  Bourne
	  shell) type:

	  CSD_CDROM_FILENAMES="eval tr '[a-z]' '[A-Z]' |  sed  -e
	  '/[^/]$/s/$/;1/'"
	  export CSD_CDROM_FILENAMES

	  This	will  translate	  such	 names	 as   csds/   and
	  csds/version.txt   to	  CSDS/	  and  CSDS/VERSION.TXT;1
	  respectively.

FILES
     Input Files:

CSD System  Last change: $Date:	1998/01/14 09:56:28 $		2

VISTA(L)		  CSDS Commands			 VISTA(L)

     jobname.virtual_db
	  Contains a list of refcode names that	act as a  filter.
	  If it	doesn't	exist then it is linked	to the first file
	  found,  if  at  all,	in  the	 following  list:    `-v'
	  virtual_db, $QUESTVIRTUALDB.

     jobname.fig
	  The vista graphics configuration file. (Allows users to
	  change  the colours used by the graphics, for	example.)
	  If it	doesn't	exist it is  linked  to	 the  first  file
	  found	in the list: command-line $VISTAFIG, ./vista.fig,
	  $HOME	/vista.fig, $CSDHOME /csds/vista.fig.

	  CSD_DBFILE override the use of this file.

     $CSDHOME/csds/vista.hlp
	  The vista on-line help file.

SEE ALSO
     The "Unix Installation Notes", CCDC.

DIAGNOSTICS
     The diagnostics produced by vista are intended to	be  self-
     explanatory.   The	output of vista	is explained in	the "Get-
     ting Started Guide.".

CSD System  Last change: $Date:	1998/01/14 09:56:28 $		3