This page was created by the IDL library routine mk_html_help2.

Last modified: Thu Aug 6 12:53:14 2020.

projects/mms/edp

• MMS_EDP_FIX_METADATA
  Helper routine for setting EDP metadata
• MMS_LOAD_EDP
  Load data from the EDP (Electric field Double Probes) instrument
  

Routine Descriptions

 PROCEDURE:
         mms_edp_fix_metadata

 PURPOSE:
         Helper routine for setting EDP metadata



$LastChangedBy: egrimes $
$LastChangedDate: 2020-07-23 14:51:27 -0700 (Thu, 23 Jul 2020) $
$LastChangedRevision: 28930 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/tags/spedas_4_0/projects/mms/edp/mms_edp_fix_metadata.pro $

(See projects/mms/edp/mms_edp_fix_metadata.pro)

 PROCEDURE:
         mms_load_edp

 PURPOSE:
         Load data from the EDP (Electric field Double Probes) instrument

 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 probe '1'
         level:        indicates level of data processing. Current levels include: 
                       ['l1a', 'l1b', 'l2', 'l2pre', 'ql', 'sitl']
         datatype:     data types include currently include  ['dce', 'dcv', 'ace', 'hmfe', 'scpot']; default is dce
         data_rate:    instrument data rates include ['brst', 'fast', 'slow', 'srvy']. 
                       the default is 'fast'
         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 variable 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
                       do not set colors
         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)

 NOTES:
     The MMS plug-in in SPEDAS requires IDL 8.4 to access data at the LASP SDC
    
     Please always use error bars on E-field data 
     loaded with this routine; see the crib sheet
     mms_load_edp_crib.pro for an example of using 
     the error bars
     
     Have questions regarding this load routine, or its usage?
          https://groups.google.com/forum/#!forum/spedas

 EXAMPLE:
    See mms_load_edp_crib.pro for usage examples.
     
    set the time frame
    MMS1> timespan, '2015-12-15', 1, /day
    load L2 edp dce data for all probes
    MMS1> mms_load_edp, data_rate='slow', probes=[1, 2, 3, 4], datatype='dce', level='L2'

 HISTORY:
   - Created by Matthew Argall @UNH
   - Minor updates to defaults by egrimes@igpp
    
$LastChangedBy: egrimes $
$LastChangedDate: 2020-06-09 14:30:21 -0700 (Tue, 09 Jun 2020) $
$LastChangedRevision: 28770 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/tags/spedas_4_0/projects/mms/edp/mms_load_edp.pro $

(See projects/mms/edp/mms_load_edp.pro)