DOI: 10.5281/zenodo.3946008
title: Magnetic Field Boundaries in Cassini Plasma Spectrometer Data

description: This dataset consists of: <em>get_files.sh</em> - a bash script to download ELS data (.DAT and .LBL) files. <em>crossing_events_urls.txt</em> - a text file containing URLs for each of the ELS<br> data files. <em>get_files.sh</em> reads this file directly. <em>crossing_events.txt</em> - a text file containing the list of crossing events<br> with associated data, obtained by processing Table S1 in [1]. <em>labels.zip</em> - a zip file containing directory with events for each DAT file,<br> in YAML format. <em>plotter.py</em> - a plotting script in Python. <em>requirements.txt</em> - a file indicating dependencies for the plotting script. <strong>Data</strong> This dataset spans 1259 observations from CAPS ELS, each with a .LBL file and a<br> .DAT file. Together, these take 128 GB of space. To download these files, do: <pre>./get_files.sh</pre> in a Bash shell/terminal. The files are stored in the 'data/' folder (created if<br> not present) in the current directory. ELS data files are obtained from NASA's Planetary Data System at<br> https://pds-ppi.igpp.ucla.edu/search/view/?f=yes&id=pds://PPI/CO-E_J_S_SW-CAPS-3-CALIBRATED-V1.0/DATA/CALIBRATED For help in understanding the ELS data files, see the CAPS User Guide at<br> https://pds-ppi.igpp.ucla.edu/ditdos/download?id=pds://PPI/COCAPS_1SAT/DOCUMENT/CAPS_USER_GUIDE/CAPS_PDS_USER_GUIDE_V1_00.PDF. <strong>Labels</strong> Unzipping the <em>labels.zip</em> file will create a <em>labels/</em> folder in the current<br> directory, requiring 28MB of space. Within <em>labels/</em>: <em>bs/</em> - includes bow shock crossing events. <em>mp/</em> - includes magnetopause crossing events. <em>dg/</em> - includes known data-gap events. See [1]. <em>sc/</em> - includes unreliable data events. See [1]. <em>valid/</em> - union of all files in <em>bs/</em> and <em>mp/</em>. <em>all/</em> - union of all files in <em>bs/</em>, <em>mp/</em>, <em>dg/</em> and <em>sc/</em>. Within the <em>labels/bs/</em> and <em>labels/mp/</em> folders: <em>in/</em> - crossing events with the transition direction as inward. <em>out/</em> - crossing events with the transition direction as outward. <em>all/</em> - union of all files in in/ and out/. Each label file is a YAML file containing a 'change_points' field. The entries<br> under this field each indicate the time of a transition event. The other fields<br> ('bimodality' and 'negative_ions') are not relevant for this dataset. <strong>Plotting the Data (and Labels)</strong> To help visualize the data and labels, we supply a plotting script<br> <em>plotter.py</em>, in Python (version 2.7). First, install dependencies with: <pre>pip install -r requirements.txt</pre> and then run: <pre>./plotter.py -h</pre> to see the available options. Example usage (after downloading data and<br> unzipping labels): <pre>./plotter.py data/ELS_200418018_V01.DAT -l labels/mp/all/ELS_200418018_V01.yaml --interpolated -f max_filter -fsize 100 --title "An Observation from CAPS ELS" </pre> will open up a new window with a plot of the data.<br> To directly save to a file, use the '-o <em>savefilename</em>' option. For example, <pre>./plotter.py data/ELS_200418018_V01.DAT -l labels/mp/all/ELS_200418018_V01.yaml --interpolated -f max_filter -fsize 100 --title "An Observation from CAPS ELS" -o ELS_200418018_V01.png </pre> <strong>References</strong> [1] Jackman, C. M., Thomsen, M. F., & Dougherty, M. K. (2019). Survey of<br> Saturn's magnetopause and bow shock positions over the entire Cassini mission:<br> Boundary statistical properties and exploration of associated upstream<br> conditions. Journal of Geophysical Research: Space Physics, 124, 8865– 8883.<br> https://doi.org/10.1029/2019JA026628 The original table of magnetopause and bow shock crossing events can be found at<br> https://agupubs.onlinelibrary.wiley.com/action/downloadSupplement?doi=10.1029%2F2019JA026628&file=jgra55251-sup-0001-Table_SI-S01.txt <strong>Grants</strong> NASA Contract through JPL with South West Research Institute. Grant Number: 1243218 Science and Technology Facilities Council. Grant Number: ST/L004399/1 NASA. Grant Number: 1243218 Diamond Jubilee Fellowship STFC. Grant Number: ST/L004399/1
description: {"references": ["Jackman, C. M., Thomsen, M. F., & Dougherty, M. K. (2019). Survey of Saturn's magnetopause and bow shock positions over the entire Cassini mission: Boundary statistical properties and exploration of associated upstream conditions. Journal of Geophysical Research: Space Physics, 124, 8865\u2013 8883. https://doi.org/10.1029/2019JA026628"]}