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

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

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.

After generating the frames using the Matlab code (saved in the figures folder), they can be converted to a gif using the Python 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

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.