The Equatorial Magnetometer Network

Information about J-format


Explanation of kyushu university data format ( J-format )

July 1991, 1st ed. by M. Shinohara and T. Kitamura
June 1998, 2nd ed. by M. Shinohara
  1. Elements of Kyushu University magnetic data
    Fluxgate magnetometer (ring core type)
    Sampling time : 3 seconds.
    component : H,D,Z, 3 components

  2. How many days data in a disk ?
    The data is recorded on MS-DOS disk with a format called "J- format". A 5 inch floppy disk can store 6 files, and each file contains one day magnetic data. One floppy disk, therefore, stores 6 day data in it.

    One disk : 6 files, 6 days data

  3. File name
    Each file has a file name, which is composed of 7 characters with a 3 character extension. The first byte should be a letter "r", and the following 6 bytes denote the "YYMMDD". The 3 character extension should be a 3 character abbreviation of a station name. The structure of the "name" is shown as follows.

    'r' 1 byte the first should be " r "
    year 2 byte ex. 1991 -> 91
    month 2 byte 01 -> January
    day 2 byte 11 -> 11th day
    station 3 byte ex. bel for BELEM

    File name format : rxxxxxx.xxx example --> r910111.bel

  4. Structure of the data
    Each file consists of three parts. The first is the "data information" which are written in "text" format. You can read this "text" by "type command" (MS-DOS) or the screen editor. The second is "linkage data", which is described later. The third is the "magnetic data", which is in "binary".

    The data = data information ("text")
    + linkage data ("binary")
    + magnetic data ("binary")

    The details is as follows.


[ Structure of data : "Information" + "Linkage" + "Magnetic data" ]

< Information >
.
.
.
< end of information >
[ 001A H ]
< linkage values, Lh,Ld,Lz >
total 6 byte integer
No.1 magnetic data
[ H comp. ]
[ D comp. ]
[ Z comp. ]
No.2 magnetic data
[ H comp. ]
[ D comp. ]
[ Z comp. ]
No.3 magnetic data
[ H comp. ]
[ D comp. ]
[ Z comp. ]
No.4 - No.28798 magnetic data
:
:
:
No.28799 magnetic data
[ H comp. ]
[ D comp. ]
[ Z comp. ]
No.28800 magnetic data
[ H comp. ]
[ D comp. ]
[ Z comp. ]

[ Fig. 1 ]


  • How to get longer data than one day
    Each file contains one day data, which is differential. This means that each file is independent. In order to get longer data continued longer than one day, you have to re-calcu late each of n+1, n+2, n+3 .... days , and have to join the files under following procedure.

    1. Calculate "Base(n+1)" on n+1 day

      Base(n+1) = Link(n+1) + Base(n)
      Base(1) = Link(1)

      where "Base(n+1)" is the baseline value on n+1 day and "Link(n+1)" means the linkage value of n+1 day, where n = 1,2,...,N (N is the number of days to be joined).

    2. Reexamine the data
      Reexamine the magnetic data as below

      Data(i,j,n+1) = Base(j,n) + each magnetic value(i,j,n+1)

      where i=1,2,.... 28800; j = H,D,Z

    The meaning of the above is shown in Fig.1.

  • Sample program
    In order to indicate the text file with WWW browser, extension of sample C program file has been changed to .txt. Please save this program by name of "j_sample.c" when you download it.

  • Sample output
    The sample output of the reading program.