

Level 1 Data Documentation
Contents
- Level 1 Data Organization
- Data Structures by Instrument
- Automatic HDF code generation - hdfgen.pl
- Step-by-Step Level 1 Data User Guide
- Level 1 Data Processing Changelog - Chronicle of changes in ASC Level 1 data processing software.
Level 1 Data Organization
ACE Level 1 data are distributed by the ACE Science Center to each of the ACE instrument teams, and are permanently archived at NASA's National Space Science Data Center (the NSSDC). Since the ACE data are non-proprietary, no authorization for release of the data to the general science community is required. NOTE: The NSSDC does not currently make the ACE Level 1 data available directly online.
However, ACE Level 1 data requires significant further processing to make them useful for scientific studies. The experience and expertise required to perform this processing rests with the instrument teams. Therefore, it is strongly recommended that users of Level 1 data from the ACE Science Center, or the permanent NASA archive at the NSSDC, contact the responsible instrument teams regarding correct usage of the data.
The ACE Level 1 data are organized to meet the individual requirements of the nine ACE instrument teams. Several (in some cases many) data structures are defined for each instrument, and several more are defined for the spacecraft engineering data. The data structures were defined by the Science Center in consultation with each instrument team. Therefore, the degree to which the raw data is massaged during Level 1 processing varies from instrument to instrument.
The basic elements of the Level 1 data produced by the Science
Center are C data structures, each defined in their own include
file. Based on the definition of a data structure, a library of C
subroutines is created that make it quite easy to read/write that
data structure from/to
HDF4 format data files.
All ACE Level 1 data are formatted in HDF4 (Version 4.2).
Data Structures by Instrument
The Level 1 and browse data structures for each instrument and for the spacecraft engineering data can be viewed by selecting the appropriate link below.
- CRIS
- EPAM
- MAG
- S3DPU
- SEPICA
- SIS
- SWEPAM Electron
- SWEPAM Ion
- SWICS
- SWIMS
- ULEIS
- Spacecraft Engineering Data

Level 1 Data User Guide
The ACE Level 1 data requires significant further processing to make it useful for scientific studies, so it is most likely that you will want to read the data and process it using your own custom software. This guide is intended to help get you started. If you are not already familiar with ACE data, we encourage you to read the previous sections of this document before reading the material below. We assume that you have already gained access to the data by contacting one of the ACE instrument teams.
Note: All ACE Level 1 data is in HDF format, so you can access the data using any of the scientific data analysis applications which support the HDF format (IDL, NOESYS, etc.). However, if you wish to take this route, be aware that the Science Center does not provide support for these applications.
The Science Center has put together a software package to enable you to access ACE Level 1, browse and ancillary HDF data files from C programs. The package contains source code and example programs which illustrate how to read most of the Level 1 data structures from a Level 1 HDF file. What follows is a step-by-step guide for obtaining, installing and using this software package.
- Obtain and install the required tools on your
system.
- C compiler. The Science Center uses gcc, and our makefiles are tailored for use with GNU make, but most C compliers should work fine with our software.
- HDF libraries. These may be obtained from the HDF4 library archive . Unix, VMS, Windows NT/95, DEC Alpha NT and Macintosh platforms are supported.
- Obtain the latest version of the ACE Level 1
software package, from here:
ACE Level 1 Software
The package is a zip-compressed archive, named acel1src-linuxV4-0.zip, which unzips into a directory called "acetest". The acetest directory contains a number of subdirectories, whose contents are described in the accompanying README file. In particular, the "hdfsubs" directory contains all the low-level routines created automatically by our hdfgen.pl perl script (See the previous section, Automatic HDF Code Generation - hdfgen.pl). So, you do not need to have perl or hdfgen.pl installed on your system to use this software package. - Compile example programs.
Let's imagine you are interested in data from the MAG instrument. MAG example programs are in the "magtest" subdirectory. Go there, edit the Makefile to suit your system, and run "make". If all goes well, five programs should be created - mag_avgvec_rd, mag_fft_rd, mag_hskp_rd, mag_snap_rd and mag_vec_rd. Each of these programs reads MAG data from a Level 1 HDF data file. mag_vec_rd reads data contained in the MagVectorSet data structure, defined in the include file mag_vector.h. The other programs read data from the other MAG Level 1 data structures.The procedure is the same for other instruments. EPAM example programs are in the "epamtest" subdirectory, etc., etc.
- Test example programs. Run the test programs with a Level 1 HDF file as input. Each of the test programs prints a subset of the data. Check that this works and that the data make sense.
- Use the example programs as templates to
help you write routines to access Level 1 data from your own analysis
programs. Each of the example programs makes calls to lower-level
routines ASC has provided (in the hdfsubs directory). You will want to make
similar calls to these routines from your own software.
Documentation of the lower-level routines called by the example programs - If necessary, fold ACE ancillary data into your
data analysis. ACE ancillary data include
Attitude and Orbit data, and
Clock Calibration data. These data allow one to
- determine the ACE spacecraft attitude, position and velocity at any given time
- convert vector data in spacecraft coordinates to other coordinate systems (ISTP provides a FORTRAN library to help with this).
- accurately calculate ACEepoch from the spacecraft onboard clock. ACEepoch is seconds since 00:00:00Z on Jan 1, 1996.
ACE ancillary data is provided in a HDF format data file which is updated daily by the Science Center. This file may be downloaded from
ftp://mussel.srl.caltech.edu/pub/ace/ancil
Examples illustrating how to access the ancillary data from C programs are in the "anciltest" subdirectory of the ACE Level 1 software package.
If you have any questions which are not answered here, please
contact an ASC staff member.
Our Email Address:
Last Updated: 30 June 2000
Return to ASC Home Page