


data files: such data files as it may be possible to assemble for distribution.  

ODPPS: one tar file, odpps.tar, or odpps.tar.gz, containing 
	README, which appears also as ./docs/README
	shell scripts to set environment variables
	tar file with source code
	tar file with headerfiles and catalogfiles 

binaries: hopefully, they will be present for Linux, and possibly for Sparc.  
	if present, their tar files will contain instructions for where to put them ... 

----------------------------------------------------------------
the (hopefully) complete list of files: 

in the ODPPS home directory: 

convert 	directory of routines to convert JPL ephemeris files
			to O-Division format
			
docs		documentation directory
ephlib		the subroutine library file; you will create this 
include		header files (*.h)
progs		sources for executables
sources		sources for subroutines in ephlib 
README		tells which order to read files in 
where.data	a sample of how a tcsh shell script sets env. variables
maketar		tcsh shell script to tar the files in this package
GNU-GPL.UC	the Gnu public licence, altered to vest ownership 
			in the University of California 


----------------
directory ./docs:	this directory 

manifest	this file 
abstract	prepared for DOE and LLNL release; 
			summary of the particulars of this code and its origin
acknowledgements acknowledgements of other people's help

disclaimer	disclaimer of any warranty, disclaimer of all liability 
how2make.doc	how to build the executables in ./progs (planets.c, fastplan.c)
planets.doc	how to use the executables from planets.c and fastplan.c 

where.ftp	how to find the JPL ftp site with data files 

convert.doc	how to use the executables in the ./convert directory to
		convert a JPL format de-245 ascii ephemeris to Odiv format ascii


----------------
directory ./include:	the header (*.h) files 
			declarations of routines sorted approximately
			by functional category: 


f2c.h			used by d_mod.c in the sources directory

ms.h			general declarations 
matrix.h		vector and matrix manipulations in matrix.c 
hnav.h			general include file for everything except matrix.c 

nrutil.h		a few public domain Numerical Recipes routines 



----------------
directory ./progs:
asctobin.c		converts data files from ascii (slow) to binary (faster) 
catalog.c		catalogs data files 
				(duplicates a file in ../convert245)
fastplan.c		fast planetary positions from Keplerian orbits 
makefile		a simple makefile
planets.c		gives planetary position data from ephemeris tables

----------------
directory ./sources:
apparent.c	apparent place corrections 
babyloni.c	babylonian units, i. e, degrees, minutes, seconds 
calendar.c	calendar routines 
chebev.c	chebyshev polynomial evaluation 
coortran.c	coordinate transforms etc. 
d_mod.c		this is used only by nod.c and nod.f 
exorbs.c	sets Keplerian orbits of planets from _Expl. Supplement_
findheap.c	routines to find a "heap" of data 
gmstgast.c	routines for GMST and GAST
jplanets.c	high-level routines to interrogate JPL ephemeris 
jplgen.c	low-level routines; very old code, if still used.  
makefile	the makefile 
matrix.c	vector and matrix manipulations 
navancil.c	navigation ancillary routines 
navmain.c	nav. main routines -- Keplerian orbit manipulations 
nod.f		one USNO nutation routine, in fortran, excerpt from novas.f
			(see note below) 
nod.c		its translation into C
orbutili.c	orbital utility routines
planetx.c	fictional orbit for Planet X, with lit refs 
precnuta.c	precession and nutation routines 
printers.c	routines that print 
rwod.c		"Read Write O-Div" format low level subroutines
sunmoon.c	approximate orbit series expansions for sun and moon 

NOTE: 

novas.f, the source from which nod.f has been excerpted,
may be obtained entire from George Kaplan 
at the U. S. Naval Observatory, ghk@ceres.usno.navy.mil,
telephone (202) 653-0722.  
only nod.f, an excerpt from it, is used (for nutation).

The subroutine nod, called in C as nod_(), is the only 
routine used from novas.f, provided here in nod.f.

nod_() can be bypassed by commenting out the call to nod_()
in precnuta.c, and substituting there the call to gnod(),
which calls a subroutine implementing RM Green's nutation formula.  

Alternatively nod_ can be called from its C version, in nod.c;
this is the default.  

----------------
directory ./convert:
		(for more detailed comments on files in this directory,
			see convert.doc)

convert.c	converts JPL headers and data to OD headers and data
conheader.c	converts JPL headers to OD headers
extractjd.c	given O-Div catalog file and data files, extracts data to a file
			for your desired start and stop julian day numbers  
extractdates.c	same, but for calendar dates 
makefile	to make convert and conheader 

these next files are here from navigator.jpl.nasa.gov, /ephem/export/ascii:

header.200	header file for de/le-200 and -202 data files
header.102	header file for de-200/le-51 ephemeris data files 
header.402	header file for de/le-402

the same files converted to OD format 

od-head.102
od-head.200	these files should be moved to your EPHLOC directory 
od-head.402	(i. e., to whatever directory you put data files in,
od-head.245	whose name is also the value of the EPHLOC env. variable)


