Geomagnetic Data Exchange Formats

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.

ColumnsFormatDescription
1-3A3Observatory 3-letter code.
4-5I2Year (last two digits).
6-7I2Month (01-12).
8A1Element: D, I, H, X, Y, Z or F.
9-10I2Day of month (01-31).
11-12A2Blanks.
13-14A1 + A1Arbitrary characters.
15-16I2Century digits (18, 19 or 20 for the corresponding century).
17-20I4Tabular base: degrees for D and I; hundreds of nT for intensity elements.
21-11624I424 hourly means, one for each UT hour (00-01 through 23-24).
117-120I4Daily mean. Set to 9999 if any hourly value is missing.
121-122CR/LFRecord ending (carriage return and line feed).
The older convention used column 15 for the international quiet/disturbed day flag (Q=1, D=2), and column 16 for a blank (data since 1900) or 8 (data before 1900). The century digits in columns 15-16 supersede that convention.
Minute means

Each record contains the station position, date, element, hour, data status and 60 one-minute values.

ColumnsFormatDescription
1-6I6North-polar distance in thousandths of a degree; decimal point implied between columns 3 and 4.
7-12I6Geographic longitude east of Greenwich in thousandths of a degree; decimal point implied between columns 9 and 10.
13-14I2Year (last two digits).
15-16I2Month (01-12).
17-18I2Day of month (01-31).
19A1Element: D, I, H, X, Y, Z or F.
20-21I2Hour of day (00-23).
22-24A3Observatory 3-letter code.
25A1Arbitrary character.
26I1Century digit: 0 for 2014, 8 for 1889, 9 (or space for backwards compatibility) for 1996.
27A1Data status: preliminary (P) or definitive (D).
28-34A7Blanks.
35-39460I660 one-minute values for the specified hour.
395-400I6Hourly mean of the preceding 60 one-minute values.
401-402CR/LFRecord ending (carriage return and line feed).
The records are sorted according to observatory code, year, month, day, element. Missing data value spaces are padded with 999999. Each element value and the hourly mean is given in a 6-digit field including a minus sign for negative values.

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) and 999999 (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.
  • 99999 denotes missing data; 88888 denotes an element not observed, at the reported precision.
  • Mean-centering and other details should be described in the optional comment records.

Official IAGA-2002 specification (NOAA/NCEI)

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 positionsContents
1-16Header: station identifier, date, location, orientation, source, conversion factor, quality, instrumentation, K9, sampling rate, sensor orientation, publication date and format version (version-dependent).
17-57761,440 one-minute values for each of four elements.
5777-587224 hourly means for each of four elements.
5873-5876Daily means for the four elements.
5877-5884Eight K-indices.
5885-5888Reserved words.
  • Minute, hourly and daily missing values are generally 999999; missing K-indices use 999.
  • In applicable versions, 888888 indicates 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.