About IMAGE software -------------------- This directory contains C language (ANSI) source files of several programs for handling IMAGE magnetometer data. There are two different kinds of files. Those with extension .c and those with extension .h. The files with .c extension may be compiled into an executable program. To compile and run these programs one needs to download all the header files (extension .h) and then the proper .c file into the same directory. The programs are generated by simply compiling the proper .c file. For example to compile the GADF_to_IAGA.c file one just needs to issue the following command (in Unix): cc GADF_to_IAGA.c -o GADF_to_IAGA This will generate an executable file GADF_to_IAGA. Information about the programs and their proper usage may be obtained by running the program without any parameters. (Note to C professionals: in addition to definitions the header files (.h) actually contain source codes for several procedures. I did it this way since then you don't have to tackle with make files and don't have to link programs with other object files. If you want it is very easy to separate the code from definitions and divide the header files into two pieces: .h file and .c file). I have made the programs as general as possible so that they would run in different platforms. Also the programs are general in the sense that they are able to handle files which contain magnetometer data from a network of stations and for arbitrary time intervals. So these programs are not specially intended for the IMAGE magnetometer network but should work fine in other situations as well. All this generality resulted in some sacrification in program execution times. Note : Some of the programs might not work properly in 64-bit systems. In compiling the programs it is advisable to use the -m32 option (compiles 32 bit binaries). Content of 'software' directory -------------------------------- Here is a short description of all the files found in this directory. More detailed information about the files and their usage may be found in the files themselves. Usage about the programs may also be found by running the programs without any parameters. NewTime.h A header file that defines routines for manipulating time. MagnData.h Definitions about how data is stored internally in memory and also routines for manipulating the data. StatInfo.h Information about the EISCAT and IMAGE stations. If you want to apply the programs to other stations you may add the station information into this file and then recompile your program. GADF.h Routines for reading and writing GADF format files IAGA.h Routines for reading and writing IAGA format files WDC.h Routines for reading and writing WDC format files TRO.h Routines for reading Tromso Auroral observatory binary data files. KIR.h Routines for reading binary data files from Kiruna Observatory. Dump.h Routines for reading and writing Dump format files Dump format is a file format used internally at FMI. PScript.h Routines for writing PostScript files. Usage.h Some routines for displaying information about the programs. Spike.h Routines for locating and removing spikes and similar structures. GADF_to_IAGA.c A program which converts data from GADF format into IAGA format. GADF_extract.c Program for extracting data from a GADF file. The user must specify the time period and stations to be extracted. GADF_to_TEXT.c Program for converting data from GADF format into simple columnar text format. IAGA_to_GADF.c A program which converts data from IAGA format into GADF format. Find_missing.c Program for finding missing data points in GADF,IAGA or WDC files. Find_average.c Program for finding daily average values and daily variations (GADF,IAGA, WDC or Dump format). Find_info.c Program for finding general information about data content (GADF,IAGA, WDC or Dump format). IAGA_change_baselines.c Program for shifting data values in IAGA files IAGA_extract.c Program for extracting data from a IAGA file. The user must specify the time period and stations to be extracted. IAGA_extend.c Program for extending the time coverage of an IAGA file. (e.g. making daily files from shorter data files). IAGA_fill_missing Program for filling given data points with missing data values. IAGA_interpolate.c Program for interpolating data in IAGA files IAGA_make_average.c Program for changing time resolution in IAGA files. E.g. may be used to make minute averages from 10 second recordings. IAGA_make_missing.c Creates an IAGA file where all data points are filled with missing data markers. IAGA_merge.c Program for merging two or more IAGA files into a single file. IAGA_remove.c Program for removing data of given stations from an IAGA file. IAGA_remove_spikes.c Program which attemps to remove spikes from IAGA files. IAGA_time_check.c Program for comparing the timing of two nearby stations. The analysis is based on cross correlation methods. Not very sophisticated but works sometimes. IAGA_time_shift.c Program which shifts the data in time in an IAGA file. IAGA_to_GADF.c Program for converting data from IAGA format to GADF format. IAGA_to_Matlab.c Program for converting data from IAGA format into MatLab readable binary files. IAGA_to_TEXT.c Program for converting data from IAGA format into simple columnar text format. IAGA_to_WDC.c Program for converting data from IAGA format into WDC (World Data Center) format. Dump_to_IAGA.c Program for converting data from Dump format (= format used internally at FMI) into IAGA format. TRO_to_IAGA.c Program for converting TRO format files (= binary format used at Tromso Auroral Observatory) into IAGA format. KIR_to_IAGA.c Program for converting KIR format files (= binary format used at Kiruna Observatory) into IAGA format. WDC_to_IAGA.c Program for converting data from WDC format into IAGA format. GramPlot.c Program for generating magnetogram stack plots in postscript files. GramPlot.prm An example parameter file used with GramPlot program. StationPlot.c Program for generating magnetograms (X,Y,Z) of a single station. The output file is a postscript file. StationPlot.prm An example parameter file used with StationPlot program. HDZ_to_XYZ.c Program for converting IAGA format file from HDZ representation into XYZ representation. XYZ_to_HDZ.c Program for converting IAGA format file from XYZ representation into HDZ representation. If you have problems in compiling the programs or if the programs don't work as they should, please don't hesitate to contact me: Lasse Hakkinen Finnish Meteorological Institute Geophysical Research Division P.O.Box 503 FIN-00101 Helsinki Finland phone : +358-9-19294634 e-mail : Lasse.Hakkinen@fmi.fi I will also try to keep the latest versions of the programs in the IMAGE web pages: http://space.fmi.fi/image/software/