This page summarises the standard formats used to exchange definitive magnetic observatory data. The World Data Centre for Geomagnetism, Edinburgh accepts WDC, IAGA-2002 and INTERMAGNET Archive Format (IAF), among other understandable formats. You can check a file contains properly formatted data on our web tool.
The descriptions below are brief guides. Refer to the linked specifications when writing software or preparing data for submission.
WDC format
Fixed-width ASCII records for hourly and minute means.
WDC files contain one record per element and day. Numeric fields are right-adjusted; negative values include a minus sign. Times are UT.
Hourly means
Each record is 122 characters long, including the two-character CR/LF record ending.
| Columns | Format | Description |
|---|---|---|
| 1-3 | A3 | Observatory 3-letter code. |
| 4-5 | I2 | Year (last two digits). |
| 6-7 | I2 | Month (01-12). |
| 8 | A1 | Element: D, I, H, X, Y, Z or F. |
| 9-10 | I2 | Day of month (01-31). |
| 11-12 | A2 | Blanks. |
| 13-14 | A1 + A1 | Arbitrary characters. |
| 15-16 | I2 | Century digits (18, 19 or 20 for the corresponding century). |
| 17-20 | I4 | Tabular base: degrees for D and I; hundreds of nT for intensity elements. |
| 21-116 | 24I4 | 24 hourly means, one for each UT hour (00-01 through 23-24). |
| 117-120 | I4 | Daily mean. Set to 9999 if any hourly value is missing. |
| 121-122 | CR/LF | Record ending (carriage return and line feed). |
Minute means
Each record contains the station position, date, element, hour, data status and 60 one-minute values.
| Columns | Format | Description |
|---|---|---|
| 1-6 | I6 | North-polar distance in thousandths of a degree; decimal point implied between columns 3 and 4. |
| 7-12 | I6 | Geographic longitude east of Greenwich in thousandths of a degree; decimal point implied between columns 9 and 10. |
| 13-14 | I2 | Year (last two digits). |
| 15-16 | I2 | Month (01-12). |
| 17-18 | I2 | Day of month (01-31). |
| 19 | A1 | Element: D, I, H, X, Y, Z or F. |
| 20-21 | I2 | Hour of day (00-23). |
| 22-24 | A3 | Observatory 3-letter code. |
| 25 | A1 | Arbitrary character. |
| 26 | I1 | Century digit: 0 for 2014, 8 for 1889, 9 (or space for backwards compatibility) for 1996. |
| 27 | A1 | Data status: preliminary (P) or definitive (D). |
| 28-34 | A7 | Blanks. |
| 35-394 | 60I6 | 60 one-minute values for the specified hour. |
| 395-400 | I6 | Hourly mean of the preceding 60 one-minute values. |
| 401-402 | CR/LF | Record ending (carriage return and line feed). |
Values, units and missing data
- For D and I, values are in tenths of an arc-minute. For H, X, Y, Z and F, values are in nT.
- Missing hourly values and missing minute values are represented by
9999(hourly files) and999999(minute files), respectively. - For hourly intensity elements:
value (nT) = tabular base x 100 + tabular value. - For hourly D and I:
value (degrees) = tabular base + tabular value / 600. - For minute means, each element value is stored in a six-character field, including a minus sign where required.
- Hourly records are sorted by observatory, year, month, element and day. Minute records are sorted by observatory, year, month, day and element.
IAGA-2002
A fixed-width ASCII exchange format for geomagnetic samples and means.
IAGA-2002 supports data intervals from milliseconds to monthly means. A file contains 12 mandatory file-header records, optional comment records, one mandatory data-header record and the data records. Each record is 70 characters, followed by the platform's carriage-return/line-feed sequence.
- Header records begin with a space in column 1 and end with
|in column 70. - The data header identifies DATE, TIME, DOY and the reported magnetic elements.
- Data records contain date, time and four magnetic elements (for example DHIF, DHZF or XYZF).
- D and I are expressed in angular minutes; H, X, Y, Z and F are expressed in nT.
99999denotes missing data;88888denotes an element not observed, at the reported precision.- Mean-centering and other details should be described in the optional comment records.
INTERMAGNET Archive Format (IAF)
A binary archive format for daily geomagnetic observatory records.
IAF stores data as 32-bit words. A daily record contains 5,888 words; monthly files contain one daily record for each day in the month. The record includes a header, minute means, hourly means, daily means and K-indices.
| Word positions | Contents |
|---|---|
| 1-16 | Header: station identifier, date, location, orientation, source, conversion factor, quality, instrumentation, K9, sampling rate, sensor orientation, publication date and format version (version-dependent). |
| 17-5776 | 1,440 one-minute values for each of four elements. |
| 5777-5872 | 24 hourly means for each of four elements. |
| 5873-5876 | Daily means for the four elements. |
| 5877-5884 | Eight K-indices. |
| 5885-5888 | Reserved words. |
- Minute, hourly and daily missing values are generally
999999; missing K-indices use999. - In applicable versions,
888888indicates that a scalar element was not recorded. - Element values are stored as integers with an implied decimal point (typically tenths of the unit).
- IAF has multiple versions. Readers should inspect the version field and follow the matching version specification.
The word layout above summarises IAF V2.11. Earlier versions differ in some header fields and conventions; software should not assume all IAF files use the same version.
For information about submitting definitive observatory data, see How to submit data to WDC Edinburgh.