COCO - SLALIB conversion of celestial coordinates
--------------------------------------------------
                    (see also SLALIB Version DEC94)

The COCO program converts star coordinates from one system to another.
Both the improved IAU system (post 1976) and the old system are
supported.

COCO can perform transformations between the following coordinate
systems:

      *  mean RA,Dec, old system, with E-terms (loosely FK4)

      *  mean RA,Dec, old system, no E-terms (some radio positions)

      *  mean RA,Dec, new system (loosely FK5)

      *  geocentric apparent RA,Dec, new system

      *  ecliptic longitude,latitude, new system (mean of date)

      *  galactic longitude,latitude, IAU 1958 system


The input/output arrangements of COCO are flexible, to allow a variety
of operating styles - interactive, input from a file, report to a
file, batch, etc.  Also, in addition to the report which is produced,
the results of the conversions are also available in a raw form, to a
fixed resolution and free from extraneous formatting; this file is
intended to be read easily by other programs.

COCO offers control over report resolution, and has a help facility.
All input is free format, and defaults are provided where this is
meaningful.

In order to comply with the IAU 1976 recommendations, all position
data published from 1984 on should be given in the new system, using
equinox J2000.0.  However, for many years to come positions will be
given in the old system, using equinox B1950.0.  Discriminating
astronomers and astrophysicists are strongly urged to give both B1950
and J2000 positions for every source mentioned in their publications;
the conversion can be done using COCO. SLALIB is COCO base library.  

COCO and SLALIB was produced by:

SCIENCE AND ENGINEERING RESEARCH COUNCIL                  
RUTHERFORD APPLETON LABORATORY
SPACE & ASTROPHYSICS DIVISION

ON VAX (ASTBO1)
COCO and SLALIB are available on ASTBO1 and BODIRA computers at IRA. 
The sources for the library (FORTRAN) was compiled on other systems (like 
DOS & UNIX succesfully). SLALIB can be found in SYS$LOCAL:[COCO]SLASTD.FOR 
file. 
 

Documentation :
           
         SYS$LOCAL:[COCO]SUN67.MEM     Coco Program
         SYS$LOCAL:[COCO]SUN56.MEM     SLALIB library
     

To start interactive session with coco you must type on ASTBO1 computer. 

	$ COCO
		 

To link your program with SLALIB you must include the library

        SYS$LOCAL:[COCO]SLALIB.OLB 
 
COCO functions are available also in the DIRA2 package: DB_COCO command.


ON UNIX (Alpha and Linux)
 
Coco works only on Alpha and can be started by command 
     
   coco


Slalib library is available in the directory: 

ALPHA:
-----
/soft/astro/slalib/alpha/libsla.o

LINUX:
-----
/soft/astro/slalib/linux/libsla.o


		M.Nanni     nanni@astbo1.bo.cnr.it