This readme file is a work in progress.

Magnetospheric Multiscale Mission (MMS):

Brief description of mission and instrumentation.

Include in brief description the 4 spacecraft, their instruments, formation flying, launched March 13, 2015, status ongoing, and list of mission PHASES and their times. 

Data Directory: https://cdaweb.gsfc.nasa.gov/pub/data/mms/

This file points to the on-line archived datasets for MMS: 

Dataset directories:

     Link to list of cdaweb directories and DOI’s for each dataset.

Documents: https://cdaweb.gsfc.nasa.gov/pub/data/mms/documents

	   Note: documents will be updated as made available.

Notes on connecting the dots: In the CMAD documentation it is not always clear where to find the files or information, this is the purpose of these notes.

     Internal Photoelectron Model for the FPI DES (electron) measurements:
     Model Files: https://cdaweb.gsfc.nasa.gov/pub/data/mms/models/fpi/
  	
For either the DES mms1_fpi_brst_l2_des-moms or mms1_fpi_fast_l2_des-moms cdf’s, similar for all 4 spacecraft. 
The model to use for a given time interval is given by the CDF attributes.
 
     PHOTOELECTRON_MODEL_FILENAMES
      
     and its scaling factor by the attribute
      
     PHOTOELECTRON_MODEL_SCALING_FACTOR
   
For example, for in the file:  mms1_fpi_brst_l2_des-moms_20161225155844_v3.4.1.cdf 
Which covers the burst mode time interval:  2016-12-25T15:58:44.027Z to 2016-12-25T16:00:13.997Z the attribute values are 

PHOTOELECTRON_MODEL_FILENAMES =  'mms_fpi_brst_l2_des-bgdist_v1.1.0_p3-5.cdf'; so in Model Files directory (https://cdaweb.gsfc.nasa.gov/pub/data/mms/models/fpi/) one needs to use the one specified for this interval.
	
PHOTOELECTRON_MODEL_SCALING_FACTOR = '0.3500000'  

How apply the model to correct for internal photoelectrons is given in the CMAD section 4.5.7.2 Correction for DES Photoelectrons pg. G17-G18.
    The CMAD document is in the documents directory.


Additional related information and data services:

* NASA: http://mms.gsfc.nasa.gov
* Wikipedia: https://en.wikipedia.org/wiki/Magnetospheric_Multiscale_Mission

Data contact: Scott.A.Boardsen@nasa.gov
July 18, 2023