Usage

Matlab Code (Frames Generation)

Data Download Procedure

To download the OBSERVATORY_FILE data, use the following procedure:

1. Register for an account at https://supermag.jhuapl.edu/mag/?tab=register
2. Go to https://supermag.jhuapl.edu/mag/?tab=customdownload
3. Select either "High Fidelity" (1 second time resolution) or "Low Fidelity" (1 minute time resolution) data
4. Select the time range on the right side of the page
5. select the stations to download
6. Scroll down and choose CSV as the output format
7. keep all other options as default
8. Enter Security Code
9. Click Download Megnetometer Data

Running the Code

To run the code, use the following procedure:

1. Download the data using the procedure above
2. edit the graphMap.m file to point OBSRVATORY_FILE parameter to the correct data file
3. run the graphMap.m file

Output

The file graphMap.m will output a map of the stations and the data points that were downloaded. The data points are color coded based on the magnitude of the magnetic field at that point. The color scale is shown on the right side of the map. The map is saved as a .png file in the figures folder in the same directory as the graphMap.m file.

OPTIONAL: Python (Animation Generation)

Data Preparation

After generating the frames using the Matlab code (saved in the figures folder), they can be converted to a gif using the Python code.

Running the Animation Code

1. Install the required packages using pip install -r requirements.txt
2. Place the images from figures into the animation folder
3. Run create_animation.py

Animation Output

The file create_animation.py will output a gif file in the parent folder (software) of animation folder. The gif file is named animation.gif.