Robot is a general purpose plotting and data analysis program.  The
main documentation is contained in the file Docs/RobotManual.ps.

Precompiled binaries for Sun's and LINUX systems are also available by
anonymous ftp to ftp.astro.psu.edu A dynamically linked binary for
Alpha - OSF/1 is also available. An old DECstation binary
is also available.

To be able to build Robot you need to have:

1) a C compiler
2) the public domain f2c converter (see below) or a FORTRAN compiler 
3) XView for your system
Note:
*) This version has been built on a Sun running OS 4.1.x and Solaris,
a DECstation running Ultrix V4.2 (see appendix), a PC clone running
LINUX and a DEC Alpha running OSF/1.
*) There is a Makefile in the Robot directory (no imake files!) You
might have to hack on this. e.g. you may want to alter the default size
of data files that can be read in (ARRAYSIZE). In addition the system
utilities and their locations for printing and mailing may need to be
adjusted.
*) You can either type "make" in the top level directory or in the
Robot directory.
*) On a Solaris machine type "make solaris"
*) The executable is Robot/robot

If you're not running OpenWindows when you do Make you may
have to set LD_LIBRARY_PATH to the correct directory e.g.

setenv LD_LIBRARY_PATH  /usr/local/openwin3/lib


You'll also have to either edit the Makefile to point to the XView
include directory or do a

setenv OPENWINHOME /usr/local/openwin3

(or wherever the OpenWindows main directory is located).

If you don't have a FORTRAN compiler it is still possible to build
Robot using C code converted via the f2c program.  To build using this
code use the makefile.f2c located in the Robot directory. (N.B. a
common mistake in installing f2c is not to add #define USE_STRLEN when
creating libI77 - this is needed on Sun's and DECstations - also note
that versions of f2c before May 19th did not correctly cope with "err
=" in FORTRAN internal I/O).
f2c can be obtained by ftp from research.att.com (log in as "netlib"
instead of "anonymous").


The LANGUAGE flag in the makefiles determines whether Robot will
attempt to use US or British spellings for labels etc.


Although I can't guarantee to fix all problems please _DO_ let me know
about any problems you have or suggestions for changes. 

If you publish a paper in a journal which includes a graph produced by
Robot I'd be grateful if you could send me a reprint.
If you wish to cite this program you may reference:  Corbet, R.H.D.,
Larkin, C. & Nousek, J.A.  Proceedings of "Astronomical Data Analysis
and Software Systems", Tucson, November, 1991. Astronomical Society of
the Pacific Conference Series, 1992, Vol. 25, 106. (ISBN 0-937707-44-9)

Robin Corbet                                |  corbet@lheamail.gsfc.nasa.gov 
Laboratory for High Energy Astrophysics     |  (301) 286 2851  - voice
Code 666                                    |  (301) 286 1682  - FAX
NASA/Goddard Space Flight Center            |
Greenbelt, MD 20771                         |
U.S.A.                                      |

/*
 * These routines are to be considered prototype, developmental software and
 * the right is reserved to make changes and improvements to these routines
 * at any time.  Full copyright protection for the software posted on this
 * directory is retained.  Users are authorized to make copies and use this
 * software at their own risk. We make no representation about  the
 * suitability of  this software for any purpose.  It is provided ``as is''
 * without express or implied warranty.
 */

Appendix - LINUX
----------------

Edit Robot/makefile.f2c (or Makefile) so that MAILER and LPR refer to
the appropriate system commands.

makefile.f2c should work under LINUX. (g77 has not yet been tested with
robot). - Do either "make f2c" or "make linux" to use this.

If your LINUX box has a small screen you might find it useful to invoke
robot with something like:

$ robot -plotscale 0.5 -scale small
or
$ robot -plotscale small -scale small

You may wish to copy the file Robot/text_extras_menu to a file named
.text_extras_menu in your home directory to avoid XView complaining
about this file being missing.

Appendix - Alphas + OSF/1
-------------------------

*) Get the XView port to OSF/1 from
ftp.cs.cmu.edu:/afs/cs.cmu.edu/user/mjchan/pub/xview3.2-alpha-dist.tar.gz
OR try
ftp.sdsc.edu:/pub/ccms/xview
(reported to have fixed some bugs in the CMU version)
*) edit Robot/Makefile (or makefile.f2c) so that MAILER and LPR refer
to the appropriate system commands (if necessary)
*) do "make alpha"
*) See also the notes about compiling on a DECstation.
*) pixrect.h may also be needed
*) Will probably need to set LD_LIBRARY_PATH (see above).

You may wish to copy the file Robot/text_extras_menu to a file named
.text_extras_menu in your home directory to avoid XView complaining
about this file being missing.

Appendix - DECstations
----------------------
(This refers to MIPS based Ultrix machines)

As I have a Sun, not a DECstation, Robot has not been very extensively
tested on a DEC. I have built it on a remote machine and displayed it
on my Sun. The most obvious bugs brought to light by compiling on a DEC
were fixed.

To build on a DECstation:

*) If you don't have XView you can get both ported source and binaries
for DECstations via anonymous ftp from media-lab.mit.edu.  (Make sure
your copy is after mid-September 1992) Fonts are available from
ftp.x.org.

*) Alter the makefile in Fitsio and/or Fitsioc to build fitsdec.f
instead of fitssun.f

The present version has been tested using f2c and the DEC FORTRAN
compiler. I have not attempted to use the MIPS FORTRAN compiler.


It might be necessary to do an xhost on the local machine.
Konrad Hinsen (hinsen@acds21.physik.rwth-aachen.de) wrote:
: In article <HINSEN.94Mar24111853@acds21.physik.rwth-aachen.de> I wrote:

:    I would like to run a program that requires XView on our cluster of
:    DECstations (MIPS/Ultrix, not Alpha). From gatekeeper.dec.com I 
:    obtained a binary version of XView 3.2 for Ultrix, and with that
:    I managed to compile the program. However, it immediately stops
:    with the error message "Cannot open connection to window server:
:    :0.0 (Server package)"  (":0.0" is the value of DISPLAY).

>From am32573@labs1.zel.etf.hr
>I have similar problem with SoftPC and MIT's X11R5 server. The  solution
>is to execute xhost +name.of.local.machine


