# Space Weather Modeling Framework simulations of ground magnetometer data

## PARAM.in

This is a template input file used to generate the simulations. You can find
SWMF [here](https://github.com/MSTEM-QUDA/SWMF). The configuration and commit
hash used was:

  SWMF                              original  master 2022-04-05 1f775416b

  GM/BATSRUS                        original  master 2022-05-13 386c592

  GM/BATSRUS/srcBATL                original  master 2022-05-13 a9b2640

  GM/BATSRUS/srcUserExtra           original  master 2022-05-06 d4b585f

  IE/Ridley_serial                  original  master 2022-05-04 6dc60d1

  IM/RCM2                           original  master 2022-01-16 0f7beff

  share                             original  master 2022-05-09 f543b9b

  util                              original  master 2022-03-14 29c284c

## Data

Data files are tarred and xzipped. To untar run with this command: `tar -xvf`

## indeces.tar.xz

Space seperated files of minute global indeces of each simulated geomagnetic 
storm.

### geo*.log Headers

it year mo dy hr mn sc msc Kp K_12 K_13 K_14 K_15 K_16 K_17 K_18 K_19 K_20 K_21 K_22 K_23 K_00 K_01 K_02 K_03 K_04 K_05 K_06 K_07 K_08 K_09 K_10 K_11 AL AU AE AO 

`it` is the time step, followed by the time in UTC. Next follows the storm K
indeces and the Auroral Electroject indeces are the last 4. These are the
simulated results.

### log*.log

it year mo dy hr mn sc msc dt rho mx my mz p bx by bz pmin pmax dst_sm dstflx_R=3.0 cpcpn cpcps

`it` is the time step, followed by the time in UTC. `dt` is the delta time
step, used in this study is `dst_sm` which is the SYM-H simulated and `cpcpn`
which is the north cross polar cap potential.

## stations.tar.xz

Comma seperated files of minute station magnetometer data for all storms. The
file names are the station abbreviations. Please visit
[SuperMAG](https://supermag.jhuapl.edu/) for a more
information.

### Headers

Year,Month,Day,Hour,Min,Sec,BnObs,BeObs,BdObs,BnSim,BeSim,BdSim

The first six are the times in UTC. The last six are the magnetic perturbation
components North, East and Down for Observed (Magnetometer) and Simulated
(SWMF).

## station_stats.txt

Statistical derivations for each station in a space seperated file.

### Headers

station geolon geolat maglon maglat mean std p0 p25 p50 p75 p100 bn_mean bn_std bn_p0 bn_p25 bn_p50 bn_p75 bn_p100 skew hss_50 hss_200

The station abbreviation and geographic and geomagnetic longitudes and latitudes
are given. Following is the mean, standard deviation and percentile of the
errors in B_Horizontal. The same is repeated for B_North.