MAG-L Format 1.1 Description
Please start with reading the introduction about the
format and CDF.
The dataset containing high precision vector magnetic field data
(MAG-L) is designed to meet the science needs of the majority of the
investigations directed towards studies of the internal magnetic field
- core and crustal fields. Furthermore, it serves as a basic dataset
that all investigators may want in order to browse Ørsted data
for magnetic activity, data acquisition/fall out, conjugacies etc.
Data are fully calibrated and time-synchronous, and are distributed to
all groups that formally have joined the Ørsted science
investigation and who request this data. Each file in the standard
distribution dataset on CD-rom will contain 24 hours of observation
time whereas specifically requested datasets distributed via the Web
may contain smaller or larger periods of observation time. The data
files include the following data items:
- Calibrated vector and scalar magnetic field values
in ECEF polar coordinates at approximately 1 second time resolution
with an absolute timing accuracy of approximately
0.2 milliseconds. Error estimates for the vector
values based on the actual field measurements
which are sampled at 25 or 100 Hz rate.
- Signal intensity of magnetic field oscillations in the bands
5-10/30 Hz approximately (TBC), at 1 second time resolution
synchronized with the data in item 1.
- Particle indices describing the energetic particle flux-levels.
These are given at 1, 2, or 10 second time resolution
depending on the actual sampling frequency of the particle
detectors. They are synchronized as closely as possible to
the data in item 1, but may be up to 0.5 seconds off.
- Satellite position in ECEF polar
coordinates at 1 second time resolution fully synchronized
with the vector data of item 1.
- Magnetic field disturbance indices, among others, one
proposed by Berthelier and Menvielle.
Indices are given at appropriate time resolutions and
according to the actual satellite position (orbit).
Data will be distributed every 3 months. Since the calibration
parameters are subject to modifications as calibration efforts
proceed during the mission, revisions of earlier data releases are
anticipated. Therefore, each release will contain data for the
complete mission up to the release date. This strategy also allows
new groups joining the Ørsted investigation easily to be brought
up to date. If, however, the data volume (the number of CD-roms)
grows significantly late into the mission, and earlier data are not
changed, only new data may be distributed.
2.1 File Content
A 24 hour uncompressed data file from the standard distribution
will contain approximately 6 Mbytes (TBC). These files will
be written on CD-rom(s) in the Common Data Format (CDF).
If a large community of the Ørsted investigators express the wish for
data as simple columns of ASCII characters, this will be considered as
an alternative distribution format. The complete mission (14 months)
can be contained in three CD-roms (five to six if the plain ASCII
format is chosen).
- Header Information
Contains data release identification and description of how and
when the file was created, including software version numbers and/or
calibration parameter release numbers.
- TITLE
- The title of the data file. Currently it is: Oersted Prelim Mag-L: High
Precision Magnetic Field Data.
- TEXT
- References for further documentation.
- DATE
- The date the file was gennerated.
- VERSION
- The version of the file format eg. currently 1.0. Will change as
new CDF variables are added, or old variables are changed. If it is changed your
programs may need a revision to take the new info into account.
- LEVEL
- The level of the data in the file eg. currently 2.4. Will change as
new ways to process and refine the data are implemented at ØSDC.
- Data Entries
The following data entries are all contained in the MAG-L data
files. In order to save space occupied by these files, T and R
are given for all samples of B (records of the file), whereas
the other entries are sparse of the previous
kind, that is, an entry is only given an explicit value if it has
changed since the previous sample. Note: this also goes for
the Day entry which may change throughout a file
explicitly requested, e.g. via WWW.
- Day
- The day of the observation, type CDF_EPOCH
- T
- Time of day (UTC) of the observation [s], type CDF_REAL8
- State
- Spacecraft state information: Position and attitude.
Position coordinates, ECEF, all type CDF_REAL4
- r
- Radius [km]
- theta
- Co-latitude [degrees]
- phi
- Longitude [degrees]
SIM boresight unit vector, all type CDF_REAL4
- nr
- Radial component,
positive outwards
- ntheta
- Southward component
- nphi
- Eastward component
- QState
- Information and quality flag relating to position.
The bits of this CDF_UINT1 has the following interpretation
(bit 1 is least significant bit - LSB):
- : 0 = poor quality, 1 = Good quality (below 25 m spatial).
- M
- Magnetic coordinates, all type CDF_REAL4
- QDlat
- Quasi-dipole Latitude [degrees]
- QDlong
- Quasi-dipole Longitude (= Modified Apex Longitude) [degrees]
- MApexlat
- Modified Apex Latitude [degrees]
- MLT
- Magnetic local time [hours]
- F
- Scalar Magnetic measurements, one scalar value in [nT] units of type
CDF_REAL4:
- QF
- Information and quality flag relating to F
(scalar magnetic measurement).
The bits of this CDF_UINT1 has the following interpretation
(bit 1 is least significant bit - LSB):
- Frequency calibration: 0 = not applied (poor), 1 = applied (good).
- Has occasional time shifts: 0 = yes (poor), 1 = no (good).
- Spacecraft disturbance: 0 = ignored, 1 = compensated.
- Scalar magnetometer temperature information: 0 = unavailable, 1 = available.
- B
- Magnetic measurements, three spherical vector components (ECEF); vector
error estimate, and intensity of AC fluctuations.
All in [nT] units of type CDF_REAL4:
- Br
- Radial component,
positive outwards
- Btheta
- Southward component
- Bphi
- Eastward component
- Br,sigma,
Btheta,sigma, and
Bphi,sigma
- Error estimates - one for each
vector components above
- Bpar,ac,
Beast,ac, and
Borth,ac
- Fluctuations in intensity of the
magnetic field at frequencies
from 5 to 30 Hz (TBC).
- QB
- Information and quality flag relating to B
(magnetic measurement).
The bits of this CDF_UINT2 has the following interpretation
(bit 1 is least significant bit - LSB):
- General vector data quality: 0 = poor, 1 = good.
- Vector magnetometer sample rate: 0 = 25 Hz, 1 = 100 Hz.
- Temperature information: 0 = unavailable, 1 = available.
- Attitude information: 0 = poor, 1 = good.
- Torquer coils: 0 = on, 1 = off.
- Torquer coils disturbance: 0 = >1nT, 1 = <1nT.
- Scalar magnetometer power: 0 = on, 1 = off.
Further information may be included in this field.
Example:
QB = 50 = 0110010b:
Scalar magnetometer on, torquer coils off (=>no disturbance), poor
attitude, temperature information unavailable, 100 Hz poor quality CSC data.
- P
- Particle intensities characterizing the energetic flux level,
type CDF_REAL4:
- Pe,med
- Medium energy electrons
- Pe,high
- High energy electrons
- Pi,med
- Medium energy ions
- Pi,high
- High energy ions
- I
- Magnetic field disturbance indices.
See discussion below.
- IKp
- Kp index, type CDF_UINT1
- IDst
- Dst index, type CDF_INT2
- Iaa
- aa index, type CDF_INT2
- Iam
- am index, type CDF_INT2
- Ian
- an index, type CDF_INT2
- Ias
- as index, type CDF_INT2
- IKsec
- longitude sector index, type 9 *
CDF_INT1
- QI
- Information and quality flag relating to I
(magnetic field disturbance indices).
The bits of this CDF_UINT2 has the following interpretation
(bit 1 is least significant bit - LSB):
- Kp quality: 0 = provisional, 1 = final.
- Dst quality: 0 = provisional, 1 = final.
- aa quality: 0 = provisional, 1 = final.
- am, an, as quality: 0 = provisional, 1 = final.
- longitude sector index quality: 0 = provisional, 1 = final.
2.1.1 Position
The position information originates from the TANS or Turbo-Rogue GPS
receiver, whose position data goes into an advanced orbit model to
obtain maximum accuracy and provide position information at any point
in time. If the GPS data for some reason is unavailable causing a
decrease in position accuracy, this is indicated in the position
quality flag, QPos.
2.1.2 Scalar Magnetic Field Data, F
The scalar magnetic field is the output of the OVH scalar magnetometer
processed as follows:
- adjusted according to the frequency of the internal reference oscillator,
- corrected for magnetic disturbances from the spacecraft,
- time-shifted to compensate for the build-in filter of this instrument, and
- interpolated to match the actual time given by Day and
T of this data point.
Due to the filter of the OVH instrument this interpolation does
not degrade the quality of the scalar field data.
2.1.3 Vector Magnetic Field Data, B
The vector magnetic field values are those of a not yet final extraction
algorithm performing a sub-sampling like filtering of the calibrated 25 or 100
Hz data stream from the CSC instrument. Calibration of the data is described in
"IN-FLIGHT CALIBRATION METHODS USED FOR THE OERSTED MISSION" by Nils Olsen et
al. This document can be found at
http://www.dsri.dk/Oersted/Calibration/ESA-SP.pdf
The error estimates of the three magnetic vector components
derived from the filtering above are given in
BX,sigma for
X = r, theta, and
phi.
Bac is calculated from the raw
25 or 100 samples within the 1 second time frame centered at the
time of the data point. It is calculated as
Bac = rms(Bpert) where
Bpert is the length of the magnetic field perturbation
vector.
2.1.4 Particle Index, P
Intensities Pi's are calculated from the
count rates of detectors viewing parallel to the satellite boom axis,
which is typically radial outwards.
P1 is from
energy channel 2 of detector E1 (50 keV electrons),
P2 is from
channel 7 of E1 (500 keV electrons),
P3 is from
detector P1 channel 2 (300 keV protons), and
P4 is from
detector P1 channel 7 (3 MeV protons).
The count rates are multiplied with the geometrical factor of
the sensors determined by preflight calibrations
to convert to flux. Note, that no effort has been made to clean up
the data for spurious counts, solar illumination, etc. Note also that
the flux is really dependent on the shape of the particle distribution
functions.
No ``best fit'' calculation has been performed.
2.1.5 Magnetic Disturbance Indices, I
The basic idea is: ``as many as possible''.
In practice, a subset of a large set of magnetic disturbance indices is
selected for each distribution. Of this subset not all indices may be
available throughout - or even not at all in - the time period of the
distribution, but are present as part of a minimum required set of
indices.
The sparseness and fill-value facilities of CDF are exploited to make
this feasible using only limited file-space. Both the global set and
the selected subset of indices are TBD.
One index is likely always to be included, the
sector magnetic disturbance index of Berthelier and Menvielle (B&N).
This index can be calculated in almost real time in contrast to
conventional indices such as Dst (1-2 years).
The B&N index is calculated for 3 hour intervals and it is a sector
index, where the earth is divided into 9 longitudinal zones, 5 for the
northern hemisphere, and 4 for the southern.
The values are given in the following sequence: North sectors in increasing
longitude starting at Greenwich, then southern sectors. Details subject to
change without notice.
| Hemisphere | Sequence no. | IAGA | Longitude
|
| Northern | 1 | HAD | 355
|
| NGK | 12
|
| 2 | POD | 90
|
| SVD | 61
|
| 3 | MGD | 151
|
| PET | 158
|
| MMB | 144
|
| 4 | VIC | 236
|
| TUC | 249
|
| 5 | OTT | 284
|
| FRD | 282
|
| Southern | 6 | PAF | 70
|
| CZT | 51
|
| HER | 19
|
| 7 | GHA | 116
|
| AMS | 77
|
| 8 | EYR | 172
|
| CNB | 149
|
| 10 | AIA | 295
|
| TRW | 294
|
| PST | 303
|
Magnetic disturbance indices will also be made available
on-line at the Data Centre when they become available.
2.1.6 Quality and Information Flags, Q*
The quality and information flags and the conditions they flag
are yet provisional. Some conditions may yet be identified.
2.1.7 SIM boresight unit vector, n
This is a unit vector, giving the direction of the SIM boresight direction in
the ECEF local coordinate system. It is given to facilitate adjusting for the
non-uniform error distribution in the SIM instruments.
2.1.8 Magnetic coordinates, M
The magnetic coordinates (Quasi-dipole latitude, Quasi-dipole
longitude, Modified Apex Latitude and Magnetic Local Time) are
calculated using the algorithms described in: A. D. Richmond,
Ionospheric Electrodynamics Using Magnetic Apex Coordinates,
J. Geomagn. Geoelectr., 47, p. 191-212, 1995 using IGRF 2000 as main
field model (secular variation is not accounted for) and a reference
height h_R = 110 km.
More information on Quasi-dipole- and Apex-coordinates can be found at
ftp://ftp.hao.ucar.edu:122/archive/cedar/apex/README.
Back to the Ørsted
Science Data Centre Homepage
Back to the Ørsted
Homepage
E-Mail address:
Osdc@dmi.dk
Last modified $Date: 2003/05/19 09:09:32 $ by $Author: kib $.