8 years of dayside Magnetospheric Multiscale (MMS) unsupervised clustering plasma regions classifications

These files contain the 1-minute resolution dataset (“labeled_sunside_data.csv”) and 15 minute or longer region list (“_region_list.csv”) for Toy-Edens et al.'s Classifying 8 years of MMS Dayside Plasma Regions via Unsupervised Machine Learning. The 1-minute resolution file contains the rolled up 1-minute epoch, probe name (mms1, mms2, mms3, mms4), features that go into clustering and post-cleansing methods, spacecraft positions (in GSE, GSM, and magnetic latitude/local time), raw and cleansed clustering labels, and transition name. The 15+ minute region lists contain the name of the plasma region type, the probe name (mms1, mms2, mms3, mms4), and the start and stop epoch of  >= 15 minute epoch where the probe is solidly within that region.

We ask that if you use any parts of the dataset that you cite Toy-Edens et al.'s Classifying 8 years of MMS Dayside Plasma Regions via Unsupervised Machine Learning (Submitted for review and publication to Journal of Geophysical Research: Space Research 1/2024 - DOI to be created upon acceptance).

This work was funded by grant 2225463 from the NSF GEM program.

The following tables detail the contents of the described files:

labeled_sunside_data.csv description

Column Name

Description

Epoch

Epoch in datetime

 probe

MMS probe name

 ratio_max_width

Ratio of the width of the most prominent ion spectra peak (in number of energy channels) to max number of energy channels. See paper for more information

 ratio_high_low

Ratio of the mean of the log intensity of high energies in the ion spectra to the mean of the log intensity of low energies in the ion spectra. See paper for more information

 norm_Btot

Magnitude of the total magnetic field normalized to 50nT. See paper for more information

 small_energy_mean

The denominator in ratio_high_low

 large_energy_mean

The numerator in ratio_high_low

 temp_total

Total temperature from the DIS moments. See paper for more information

 r_gse_x

x position of the spacecraft in GSE

 r_gse_y

y position of the spacecraft in GSE

 r_gse_z

z position of the spacecraft in GSE

 r_gsm_x

x position of the spacecraft in GSM

 r_gsm_y

y position of the spacecraft in GSM

 r_gsm_z

z position of the spacecraft in GSM

 mlat

magnetic latitude of spacecraft

 mlt

magnetic local time of spacecraft

 raw_named_label

Raw cluster assigned plasma region label (allowed values: magnetosheath, magnetosphere, solar wind, ion foreshock)

 modified_named_label

Cleansed cluster assigned plasma region label (use these unless have a specific reason to use raw labels). See paper for more information

 transition_name

Transition names (e.g. quasi-perpendicular bow shock, magnetopause). See paper for more information

_region_list.csv description

Column Name

Description

start

Starting Epoch in datetime

stop

Stopping Epoch in datetime

probe

MMS probe name

region

Cleansed cluster name associated with 1-minute resolution “modified_named_label”