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: gcc GADF_to_IAGA.c -o GADF_to_IAGA -lm 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. Content of 'software' directory at IMAGE web pages https://space.fmi.fi/image/software -------------------------------------------------------------------------------------- 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 IAGA2002.h Routines for reading and writing IAGA2002 format files WDC.h Routines for reading and writing WDC 1-minute format files WDChour.h Routines for reading and writing WDC one hour format files NOR2.h Routines for reading Tromso Auroral observatory binary data files. 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. IL_index.h Routines for computing IMAGE electrojet indices (IL). K_index.h Rountines for computing K indices with FMI method. Dump_to_IAGA.c Program for converting data from Dump format (= format used internally at FMI) into IAGA format. Dump_to_IAGA2002.c Program for converting data from Dump format (= format used internally at FMI) into IAGA2002 format. Dump_to_JSON.c Program for converting data from Dump format (= format used internally at FMI) into JSON format. 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). Find_missing.c Program for finding missing data points in GADF,IAGA or WDC files. 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_IAGA.c A program which converts data from GADF format into IAGA format. GADF_to_TEXT.c Program for converting data from GADF format into simple columnar text format. GramPlot_new.c Program for generating magnetogram stack plots in postscript files. GramPlot.prm An example parameter file used with GramPlot program. IAGA_cat.c Program for catenating several IAGA files. IAGA_change_baselines.c Program for shifting data values in IAGA files IAGA_check_data.c Program for checking the validity of IAGA files IAGA_extend.c Program for extending the time coverage of an IAGA file. (e.g. making daily files from shorter data 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_fill_missing.c Program for filling given data points with missing data values. IAGA_find_stations.c Program for listing the stations in an IAGA file. IAGA_HDZ_to_XYZ.c Program for converting IAGA format file from HDZ representation into XYZ representation. IAGA_IL_index.c Program for computing IMAGE electrojet indices (IL). IAGA_interpolate.c Program for interpolating data in IAGA files IAGA_K_index.c Program for computing K indices with FMI method. 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_IAGA2002.c Program for converting data from IAGA format to IAGA2002 format. IAGA_to_JSON.c Program for converting data from IAGA format to JSON 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. IAGA_XYZ_to_HDZ.c Program for converting IAGA format file from XYZ representation into HDZ representation. IAGA2002_to_IAGA.c Program for converting data from IAGA2002 format to IAGA format. IL_index_gram.c Program for plotting IMAGE electrojet index grams in postscript files. NOR_to_IAGA.c Program for converting NOR format files (= binary format used at Tromso Auroral Observatory) into IAGA format. 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. WDChour_to_Matrix.c Program for converting data from WDC format (1-hour) into simple matrix. WDChour_to_TEXT.c Program for converting data from WDC format (1-hour) into TEXT format. WDC_to_IAGA.c Program for converting data from WDC 1-minute format into IAGA format. If you have problems in compiling the programs or if the programs don't work as they should, you can contact the IMAGE team at FMI: e-mail : image_team@fmi.fi