Two-dimensional Cuts of Simulated Geomagnetic Storms

Authors: Qusai Al Shidi, Tuija Pulkkinen
Contact: qusai@umich.edu
Date Written: 2023-08-10

====================================================

These work accompanies https://doi.org/10.7302/dkjd-1j05 which has ground
magnetometer results.

## Description

Storms were run using the Space Weather Modeling Framework SWPC v2 geospace 
configuration. The storms were picked based on the geomagnetic index SYM-H
reaching magnitudes stronger (below) -50 nT. The configuration includes the
BATS-R-US model for the solar wind and magnetosphere magnetohydrodynamics, the 
Ridley Ionosphere Model (RIM) electropotential solver for the ionosphere, and 
the Rice Convection Model (RCM) for the ring current. The inputs for the runs 
was obtained from NASA's OMNI data of solar wind propagated to the bow-shock 
nose. An output of the y=0 (meridional) and z=0 (azimuthal) 2D planes were 
produced in a 15 minute cadence (in SM coordinates).

## Extracting

The files are in the `storm_cuts.tar` archive file. To extract, run the
following:

```
tar -xvf storm_cuts.tar
```

Or use an archive extraction tool that works for your operating system.

## File structure

```
storm_cuts/
  |---- y0/
    |---- y=0_var_2_eYYYMMDD-HHMMSS-sss_YYYYMMDD-HHMMSS-sss/
      |---- y=0_var_2_eYYYMMDD-HHMMSS-sss.out
  |---- z0/
    |---- z=0_var_2_eYYYMMDD-HHMMSS-sss_YYYYMMDD-HHMMSS-sss/
      |---- z=0_var_2_eYYYMMDD-HHMMSS-sss.out
```

The archive contains two folders `y0` and `z0`. These files contain the SWMF
2D output files for the geomagnetic storms solar wind and magnetospheric MHD
results.

## Reading and Visualizing Data

The `.out` files can be read and visualized using either the Python library
[spacepy](https://spacepy.github.io/) or the IDL visualization tools supplied
with [SWMF itself](https://github.com/SWMFsoftware/SWMF). For more information
on how to use those tools, visit their websites linked above.