This software demonstrates how to access the ACE ancillary data, which
is distributed in HDF format. You'll also need HDF routines for your
platform, available from http://hdf.ncsa.uiuc.edu/index.html.

The routines which do the work are in ancil_subs.c. They are currently
in a preliminary state, but should be enough to get you started using the
data. Check the comments in the code to learn the limitations.


Makefile      You'll need to edit the paths in this file to suit your setup.

NOTE: all the programs below require the full pathname of the
ACE_ANCIL.HDF file as a commandline input.

ccr_data_rd.c shows how to get an ascii printout of all the clock cal
              data in an ancillary data file.

aos_data_rd.c shows how to get an ascii printout of all the attitude/orbit
              data in an ancillary data file.
    
get_attitude.c shows how to get RTN attitude for a given spacecraft clock.

get_position.c shows how to get GSE position for a given spacecraft clock.

get_velocity.c shows how to get GSE_velocity for a given spacecraft clock.

get_ACEepoch.c shows how to get ACE Epoch time for a given spacecraft clock.

get_aosr_struct.c shows how to get the complete aosr data structure for
               a given spacecraft clock. Preliminary, does not interpolate

ancil_subs.c  routines for accessing the ancillary data. These
              routines are currently under construction, and should be used
	      with caution.

Note: all the routines in ancil_subs.c require the scclock to be passed as
a float64, since some applications require sub-second resolution.
