Insert short description of the project and aims here
This repository contains the python code used to analyse data and create the plots for the publication:
Low Frequency Extensions of Saturn Kilometric Radiation: A statistical view from the entire Cassini mission
which can be found here:
Describes how to download and structure the data
The LFE detection output of the UNET code (O'Dwyer et al. (YYYY)) can be found here:
The training data used to develop this model can be found and processed with the following:
The list of planetary phase oscillations (PPO) used:
Cassini Plotting Repository:
If you're familiar with using SPICE and spiceypy - and have your own metakernel - you can skip to the end of this section and replace the path with a path to your metakernel.
To use spiceypy to quickly retrieve Cassini ephemeris we must donwload the relevant SPICE kernels. DIAS SPICE Tools (Rutala, M. J.) is a great package for easily downloading the required kernels without needing any experience with SPICE. It can be downloaded using the following command:
git clone https://github.com/mjrutala/DIASPICETools
Then open a python terminal:
run python
inside python terminal
run:
from make_Metakernel import *
make_Metakernel("Cassini")
This will download the relevant kernel files needed (~3 GB), this may take some time.
When finished, you will find a subdirectories SPICE/Cassini/ which will contain metakernel_cassini.txt.
Update the spice.furnsh("path/to/metakernel") path inside findDetectionPositions.py with your path to your metakernel.
Note to add version numbers
- spiceypy
- matplotlib
- numpy
- pandas
- configparser
- tqdm
O'Dwyer, E. P., Jackman, C.M, Domijan, K., & Lamy, L. (2023). Image-based Classification of Intense Radio Bursts from Spectrograms: An Application to Saturn Kilometric Radiation (1.0.0) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.807562
O'Dwyer, Elizabeth P., Jackman, Caitriona M., Domijan, Katarina, Lamy, Laurent, & Louis, Corentin K. (2023). Selection of Low Frequency Extensions of Saturn Kilometric Radiation detected by Cassini/RPWS. (2.0.0) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.7895766
Provan, Gabrielle (2018). PPO phases 2004-2017. University of Leicester. Dataset. https://hdl.handle.net/2381/42436
Elizabeth O'Dwyer. (2022). elodwyer1/Cassini_Plotting: v1.0.0 (v1.0.0). Zenodo. https://doi.org/10.5281/zenodo.7349921
Describes what each file does and how to use the tools
Before running the script, you must replace the data_directory path in LFE_statistics to where you have stored the data files. You may need to change the file names below this too.
In LFE_statistics.py you will see the following python dictionary:
plot = {
"duration_histograms": True,
"inspect_longest_lfes": True,
"residence_time_multiplots": True,
"lfe_distributions": True,
"ppo_save": False,
"ppo_plot": True,
"local_ppo_plot": True
}These keys can be enabled and disabled by changing to either 'True' or 'False'
Prints an output of the LFE list to the terminal showing the longest durations
A processing step used to create the file needed for ppo_plot
Must be used in tandem with one of the two previous keys