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

Last modified: Wed Oct 1 18:17:54 2025.

# Directory Listing of Routines

# projects/mms/sitl/eva/source/script

- EVA_CMD_LOAD
  This is a command-line script for loading a set of parameters for SITL and/or EVA.
- EVA_FONT_TEST
  Use this script when the dashboard in EVA's main control panel look corrupted
- EVA_GET_SITL_SELECTIONS
  To download SITL-selection files (max 10000 files) for a defined time period
- EVA_SITL_RESTORE_TXT
  This is a command-line script to be used when the SITL has a long list of

# Routine Descriptions

## EVA_CMD_LOAD

[Next Routine] [List of Routines]

     NAME:
       EVA_CMD_LOAD

     PURPOSE:
       This is a command-line script for loading a set of parameters for SITL and/or EVA.
       By default, this program loads variables as configured in EVA's "SITL_BASIC_DAYSIDE"
       parameterSet from the latest ROI timerange. Use keywords for selecting another
       parameterSet or timerange.

     OUTPUT:
       a variety of tplot-variables as configured in the specified parameter-Set.

     KEYWORDS:
        PARAMSET: The name of your preferred parameter-set (as configured in EVA)
                  If not specified, the default is "SITL_Basic_Dayside"
        PROBES:   List of probes, valid values for MMS probes are ['1','2','3','4'].
                  If no probe is specified the default is probe '3' (as it is in EVA)
        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']
        TIMESPAN: Set this keyword if you would like to use the 'timespan' command
                  before calling this program.
        PARAMLIST: A named variable that, if supplied, contains the list of
                   loaded tplot-variables.

     EXAMPLES:

      1. To load "SITL_Quick" parameters for MMS3 from the latest ROI

         MMS> eva_cmd_load, paramset='SITL_Quick', probe='3'

      2. To load "SITL_QUICK" parameters for MMS3 from the ROI of 2016 January 7.
         Here, the 'mms_get_roi' command is used to get the exact time range of the ROI.

         MMS> eva_cmd_load, paramset='SITL_Quick', probe='3', trange=mms_get_roi('2016-01-07')

      3. Do the same thing as #2, but by using the 'timespan' command

         MMS> timespan,'2016-01-07/20:40',13,/hours
         MMS> eva_cmd_load, paramet='SITL_Quick', probe='3', /timespan

     CREATED BY: Mitsuo Oka   Jan 2016

     $LastChangedBy: moka $
     $LastChangedDate: 2020-05-12 14:46:27 -0700 (Tue, 12 May 2020) $
     $LastChangedRevision: 28688 $
     $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/mms/sitl/eva/source/script/eva_cmd_load.pro $

(See projects/mms/sitl/eva/source/script/eva_cmd_load.pro)

## EVA_FONT_TEST

[Previous Routine] [Next Routine] [List of Routines]

     NAME:
       EVA_FONT_TEST

     PURPOSE:
       Use this script when the dashboard in EVA's main control panel look corrupted
       or the font is missing. If you run this script and clicked the DRAW button,
       you should see a phrase "325 buffers".

       If you do not see the phrase, then something is wrong in IDL. Please try re-booting
       your computer or re-installing IDL.

       If you do see the phrase and the script seems working okay, there could be another
       problem in EVA. Please relaunch IDL, display some data using, say SITL_Quick. Then,
       please send me everything you have in the IDL console.

     CREATED BY: Mitsuo Oka   July 2017

     $LastChangedBy: moka $
     $LastChangedDate: 2016-09-28 14:25:51 -0700 (Wed, 28 Sep 2016) $
     $LastChangedRevision: 21970 $
     $URL: svn+ssh://ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/mms/sitl/eva/source/script/eva_cmd_load.pro $

(See projects/mms/sitl/eva/source/script/eva_font_test.pro)

## EVA_GET_SITL_SELECTIONS

[Previous Routine] [Next Routine] [List of Routines]

     NAME:  eva_get_sitl_selections

     PURPOSE:
       To download SITL-selection files (max 10000 files) for a defined time period
       and return those filenames. If the time period is not defined,
       the latest file will be downloaded. The file timestamps can
       also be returned (i.e., the time the SITL submitted the selections)

     CALLING SEQUENCE: filenames = eva_get_sitl_selections(trange=trange [, num] )

     INPUT:
        trange: (optional, either string or double)
           - The time range from which SITL selection files are searched.
           - The file stamps (i.e., the time the SITL submitted the
             selections) are used for the search.
           - If omitted, the latest file will be searched.

     OUTPUT:
        filenames: a string array indicating the filenames of matched SITL-selections.

     OTHER OUTPUT:
        n         : the number of matched files.
        filetimes: the time stamps (i.e., the time the SITL submitted the
                    selections) of matched files.

     CREATED BY: moka in May 2020

     $LastChangedBy: moka $
     $LastChangedDate: 2016-01-11 11:40:15 -0800 (Mon, 11 Jan 2016) $
     $LastChangedRevision: 19706 $
     $URL: svn+ssh://ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/mms/sitl/bss/mms_get_roi.pro $

(See projects/mms/sitl/eva/source/script/eva_get_sitl_selections.pro)

## EVA_SITL_RESTORE_TXT

[Previous Routine] [List of Routines]

     NAME:
       EVA_SITL_RESTORE_TXT

     PURPOSE:
       This is a command-line script to be used when the SITL has a long list of
       burst-selections requested from non-SITL scientists. This script was developed
       during the commissioning phase when various instrument teams were requesting
       certain burst time periods for calibration purposes ("Extended ROI").
       By using this script, the SITL could easily add those requested segments
       into EVA without the hassle of adding segments manually one-by-one.

     USAGE:

       1. Launch EVA and display automated FOM, as usual.
       2. From the IDL console, type in the command:  MMS> eva_sitl_restore_txt
       3. A dialog appears for you to select a text file. There is a sample file at
          [YOUR_SPEDAS_DIRECTORY]/projects/mms/sitl/eva/source/script/eva_sitl_restore_txt_sample.txt
       4. Once you select a file, then the FOM-structure gets updated in EVA.

       The key point here is that we need to have the input file in a certain format.
       Please see the sample file above. No need to put a date for end-time (3rd column);
       If a segment was crossing mid-night, then the script will assume the day after
       the input date (See the 3rd line of the sample file).

       I still suggest checking each selection carefully after importing with this script.
       If you encounter an error, please check if there is any overlap in the selections.

     CREATED BY: Mitsuo Oka   August 2015

     $LastChangedBy: moka $
     $LastChangedDate: 2024-07-13 23:29:53 -0700 (Sat, 13 Jul 2024) $
     $LastChangedRevision: 32741 $
     $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/mms/sitl/eva/source/script/eva_sitl_restore_txt.pro $

(See projects/mms/sitl/eva/source/script/eva_sitl_restore_txt.pro)