PLUTO(L)		  CSDS Commands			 PLUTO(L)

NAME
     pluto - graphical display of chemical and crystal structures

SYNOPSIS
     pluto [ -j	jobname	| -s structure_file ] [	-fig fig_file ]	[
     -l	listing_file ] [ -version ] [ -help ]

DESCRIPTION
     pluto interactively draws crystal structure  representations
     to	 an  X-window,	Tek terminal, plotter or postscript file.
     Structure input can be free format	or  any	 list  output  in
     FDAT format by quest(l).  pluto reads commands from standard
     input or the graphics window and writes  interactive  output
     to	 standard  output. It also writes a listing file.  One of
     the options  `-j'	or  `-s'  must	be  specified.	 Optional
     postscript	 output	 is written to file postscript,	or if the
     `-j' flag is specified to jobname.ps.

OPTIONS
     -j	jobname
	  Specify a jobname for	this run of pluto.  Unless  over-
	  ridden  by  the  `-s'	option,	pluto will read	structure
	  data from jobname.dat.  Unless overridden by the ` - l'
	  option, pluto	will write a listing to	jobname.list.

     -s	structure_file
	  Read crystal structure data from structure_file.

     -l	listing
	  Write	a listing file to listing.

     -fig configuration_file
	  Read	 graphics   configuration    data    from    file
	  configuration_file.  This  option  is	 identical to the
	  `-fig' option	for quest(l).

     -version
	  Print	the current version of the CSDS.

     -help
	  Print	these man pages.

ENVIRONMENT
     pluto recognises the same environment  variables  as  quest.
     When the CSDS was configured (using config.sh) default value
     were (implicitly) given to	the environment	variables CSDHOME
     and  CSDMACHINE.  They can, however, be overridden	by expli-
     citly defining them in current environment.

     CSDHOME
	  Look for auxiliary executables, scripts and  tables  in
	  the	sub-directories	  pointed  to  by  $CSDHOME  This

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

PLUTO(L)		  CSDS Commands			 PLUTO(L)

	  directory should be accessible to all	 potential  users
	  of  the Cambridge Crystallographic Data System and must
	  be accessible	by pluto.

     CSDMACHINE
	  Use	the    binary	 executables	from	directory
	  $CSDHOME/bin/d_$CSDMACHINE.  It is possible, especially
	  with the network file	system (NFS), to  have	different
	  types	of machines accessing the database. This variable
	  specifies the	current	machine	type to	the CSDS.

     In	addition,  pluto  recognises  the  environment	variable:
     QUESTFIG  and,  when  running X-windows, XENVIRONMENT. These
     environment variables can be  set	to  point  to  particular
     input files.  See the FILES section for more details.

FILES
     Input Files:

     jobname.dat
	  Structure information	is to be read from this	 file  in
	  FDAT format.

     jobname.fig
	  The graphics configuration file. It allows  users,  for
	  example,   to	 change	the colours used by the	Graphics.
	  If it	doesn't	exist, pluto links it to the  first  file
	  found	 in  the  list:	 command-line  `-fig' input file,
	  $QUESTFIG,	    ./quest.fig,	 $HOME/quest.fig,
	  $CSDHOME/csds/quest.fig.

     pluto.hlp
	  pluto	 reads	help  information  from	 this	file   in
	  $CSDHOME/csds.

SEE ALSO
     The "Unix Installation Notes", CCDC.   and	 Volume	 4.  Cam-
     bridge Structural Database	System.

DIAGNOSTICS
     The diagnostics produced by pluto are intended to	be  self-
     explanatory.

BUGS
     Don't redirect standard output.

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