This page was created by the IDL library routine `mk_html_help2`.

Last modified: Mon Aug 25 17:03:11 2025.

# Directory Listing of Routines

# projects/mms/scm

- MMS_LOAD_SCM
  Load data from the MMS Search Coil Magnetometer (SCM)
- MMS_SET_SCM_OPTIONS
  This procedure sets some default metadata for SCM data products

# Routine Descriptions

## MMS_LOAD_SCM

[Next Routine] [List of Routines]

     PROCEDURE:
             mms_load_scm

     PURPOSE:
             Load data from the MMS Search Coil Magnetometer (SCM)

     KEYWORDS:
             trange:       time range of interest [starttime, endtime] with the format
                           ['YYYY-MM-DD','YYYY-MM-DD'] or to specify more or less than a day
                           ['YYYY-MM-DD/hh:mm:ss','YYYY-MM-DD/hh:mm:ss']
             probes:       list of probes, valid values for MMS probes are ['1','2','3','4']. If
                           no probe is specified the default is '1'
             level:        indicates level of data processing. scm levels include 'l1a', 'l1b',
                           'l2'. The default if no level is specified is 'l2'
             datatype:     scm data types include ['cal', 'scb', 'scf', 'schb', 'scm', 'scs'].
                           If no value is given the default is scsrvy for srvy data, and scb for brst data.
             data_rate:    instrument data rates for MMS scm include 'brst' 'fast' 'slow' 'srvy'.
                           The default is 'srvy'.
             local_data_dir: local directory to store the CDF files; should be set if
                           you're on *nix or OSX, the default currently assumes Windows (c:\data\mms\)
             source:       specifies a different system variable. By default the MMS mission system
                           ariable is !mms
             get_support_data: load support data (defined by support_data attribute in the CDF)
             tplotnames:   names for tplot variables
             no_color_setup: don't setup graphics configuration; use this keyword when you're
                           using this load
                           routine from a terminal without an X server running
             time_clip:    clip the data to the requested time range; note that if you do not use
                           this keyword you may load a longer time range than requested
             no_update:    set this flag to preserve the original data. if not set and newer data
                           is found the existing data will be overwritten
             suffix:       appends a suffix to the end of the tplot variable name. this is useful for
                           preserving original tplot variable.
             varformat:    should be a string (wildcards accepted) that will match the CDF variables
                           that should be loaded into tplot variables
             cdf_filenames:  this keyword returns the names of the CDF files used when loading the data
             cdf_version:  specify a specific CDF version # to load (e.g., cdf_version='4.3.0')
             latest_version: only grab the latest CDF version in the requested time interval
                           (e.g., /latest_version)
             major_version: only open the latest major CDF version (e.g., X in vX.Y.Z) in the requested time interval
             min_version:  specify a minimum CDF version # to load
             spdf:         grab the data from the SPDF instead of the LASP SDC (only works for public access)
             available:    returns a list of files available at the SDC for the requested parameters
                           this is useful for finding which files would be downloaded (along with their sizes) if
                           you didn't specify this keyword (also outputs total download size)
             versions:     this keyword returns the version #s of the CDF files used when loading the data
             always_prompt: set this keyword to always prompt for the user's username and password;
                           useful if you accidently save an incorrect password, or if your SDC password has changed
             tt2000: flag for preserving TT2000 timestamps found in CDF files (note that many routines in
                           SPEDAS (e.g., tplot.pro) do not currently support these timestamps)

     EXAMPLE:
         load scm burst data
         MMS> mms_load_scm, trange=['2015-09-13',2015-09-14'], probes='1', level='l1b', $
                        data_rate='brst', datatype='scb'

         set time span and load probes 1 and 2 survey data
         timespan, '2015-09-13', 1d
         MMS> mms_load_scm, probes=['1','2'], level='l1b', data_rate='srvy', datatype='scm'

         get list of valid scm rates, levels, and datatypes
         MMS> mms_load_options, 'scm', rate=r, level=l, datatype=dt

         See crib sheet mms_load_scm_crib.pro for more detailed usage examples

     NOTES:
        The MMS plug-in in SPEDAS requires IDL 8.4 to access data at the LASP SDC

        Have questions regarding this load routine, or its usage?
              https://groups.google.com/forum/#!forum/spedas

        Please see the notes in mms_load_data for more information

    $LastChangedBy: egrimes $
    $LastChangedDate: 2019-12-04 14:03:21 -0800 (Wed, 04 Dec 2019) $
    $LastChangedRevision: 28081 $
    $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/mms/scm/mms_load_scm.pro $

(See projects/mms/scm/mms_load_scm.pro)

## MMS_SET_SCM_OPTIONS

[Previous Routine] [List of Routines]

     PROCEDURE:
             mms_set_scm_options

     PURPOSE:
             This procedure sets some default metadata for SCM data products

     KEYWORDS:

    $LastChangedBy: egrimes $
    $LastChangedDate: 2019-12-04 14:03:21 -0800 (Wed, 04 Dec 2019) $
    $LastChangedRevision: 28081 $
    $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/mms/scm/mms_set_scm_options.pro $

(See projects/mms/scm/mms_set_scm_options.pro)