Directory Listing of Routines

general/missions/rbsp/ect

RBSP_ECT_CONFIG
RBSP_ECT_INIT
RBSP_LOAD_ECT_L3
RBSP_LOAD_MAGEIS_L2
RBSP_READ_ECT_MAG_EPHEM[1]

Routine Descriptions

RBSP_ECT_CONFIG

  PRO rbsp_ect_config

  This procedure serves as the RBSP ECT configuration file.  It sets global (system)
  variables and initializes devices

  This procedure will define the location of data files and the data server.
  This procedure is intended to be called from within the "RBSP_ECT_INIT" procedure.

  This should be the only RBSP ECT file that requires modification for use in different
  locations.

  There is no need to modify this file if:
     - Your computer is an SSL UNIX machine that mounts "/disks/data/"   (i.e. ALL Linux and Solaris machines at SSL)
     - You use a portable computer that will be caching files on a local hard drive.


  Settings  in this file will be overridden by settings in the environment.
  (see setup_themis or setup_themis_bash for examples of setting environment
  variables on UNIX-like systems.  The environment can also be set on Windows
  systems.)

  KEYWORDS
     no_color_setup: do not set colors if already taken care of

  CREATED: Jan 2013, based on rbsp_efw_config
  AUTHOR: Kris Kersten, kris.kersten@gmail.com

 $LastChangedBy: aaronbreneman $
 $LastChangedDate: 2017-06-13 14:34:19 -0700 (Tue, 13 Jun 2017) $
 $LastChangedRevision: 23462 $
 $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/tags/spedas_4_0/general/missions/rbsp/ect/rbsp_ect_config.pro $

(See general/missions/rbsp/ect/rbsp_ect_config.pro)

RBSP_ECT_INIT

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

PROCEDURE: rbsp_ect_init
PURPOSE: Initializes system variables for RBSP ECT. Can be called from idl_startup to set
custom locations.

The system variable !RBSP_ECT is defined here. The elements of this structure are explained below:

!RBSP_ECT.LOCAL_DATA_DIR This is the root location for all RBSP ECT data files.
The RBSP ECT software expects all data files to reside in specific subdirectories relative
to this root directory.;

!RBSP_ECT.REMOTE_DATA_DIR This is the URL of the server that can provide the data files.
(default is: "http://themis.ssl.berkeley.edu/data/themis/")
if the software does not find a needed file in LOCAL_DATA_DIR,
then it will attempt to download the data from the URL and REMOTE_DATA_DIR is defined,
the software will attempt to download the file from REMOTE_DATA_DIR, place it in LOCAL_DATA_DIR
with the same relative pathname, and then continue processing.
(NOT YET IMPLEMENTED)

KEYWORDS:
RESET: Reset !rbsp_ect to values in environment (or values in keywords).
LOCAL_DATA_DIR: use given value for local_data_dir, rather than environment. Only works on
initial call or reset.
REMOTE_DATA_DIR: Use given value for remote_data_dir, rather than env. Only works on inital
call or reset.
NO_COLOR_SETUP do not set colors if already taken care of

Typical examples:

Desktop UNIX/LINUX computer located at SSL
LOCAL_DATA_DIR = '/disks/data/rbsp/' ; This master directory is read only.
REMOTE_DATA_DIR = '' ; Should be empty string. (/disks/data/rbsp and server are the same)

Desktop WINDOWS computer located at SSL
LOCAL_DATA_DIR = '\\justice\data\rbsp\' ; Justice is a samba server (physically the same as /disk/data/rbsp)
REMOTE_DATA_DIR = ''

laptop WINDOWS computer located far from a data server, but with internet connection.
LOCAL_DATA_DIR = 'C;\data\rbsp\' ; Local (portable) directory on laptop
REMOTE_DATA_DIR = 'http://themis.ssl.berkeley.edu/data/themis/' ; URL used to download data to LOCAL_DATA_DIR

MacOS computer located away from SSL without a nearby data server
LOCAL_DATA_DIR = '/data/rbsp/' ; Local (portable) directory on laptop
REMOTE_DATA_DIR = 'http://themis.ssl.berkeley.edu/data/themis/' ; URL used to download data to LOCAL_DATA_DIR

Note: If automatic downloads are used. (i.e. REMOTE_DATA_DIR is not an empty string) the user must ensure that
LOCAL_DATA_DIR is writeable.

Note to WINDOWS users: the WINDOWS version of IDL accepts both the '\' and '/' character as the directory
separation character. The converse is not true.

HISTORY
Forked from rbsp_efw_init, Jan 2013 - Kris Kersten, kris.kersten@gmail.com

$LastChangedBy: aaronbreneman $
$LastChangedDate: 2017-06-13 14:34:31 -0700 (Tue, 13 Jun 2017) $
$LastChangedRevision: 23463 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/tags/spedas_4_0/general/missions/rbsp/ect/rbsp_ect_init.pro $

(See general/missions/rbsp/ect/rbsp_ect_init.pro)

RBSP_LOAD_ECT_L3

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

 NAME: rbsp_load_ect_l3

 SYNTAX:

       timespan,'2012-10-13'
       rbsp_load_ect_l3,'a','mageis'

 PURPOSE: Fetches and loads RBSP ECT (hope, mageis, rept) particle data

 INPUT: N/A

 OUTPUT: N/A

 KEYWORDS:
	probe ->  'a' or 'b'
       type  ->  'hope','mageis','rept'
       get_support_data -> if not set then only the essentials are
       saved

 HISTORY:
	Created Jan 2015, Aaron Breneman

 NOTES:

 VERSION:
   $LastChangedBy: aaronbreneman $
   $LastChangedDate: 2018-12-06 10:48:41 -0800 (Thu, 06 Dec 2018) $
   $LastChangedRevision: 26267 $
   $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/tags/spedas_4_0/general/missions/rbsp/ect/rbsp_load_ect_l3.pro $

(See general/missions/rbsp/ect/rbsp_load_ect_l3.pro)

RBSP_LOAD_MAGEIS_L2

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

 NAME: rbsp_load_mageis_l2

 SYNTAX:

 PURPOSE: Fetches/loads RBSP ECT MagEIS L2 data

 INPUT: N/A

 OUTPUT: N/A

 KEYWORDS:
	probe=probe
	/get_mag_ephem - save the ECT mag ephemeris vars
	/get_support_data - save CDF support data to TPLOT

 HISTORY:
	Created Jan 2013, Kris Kersten, kris.kersten@gmail.com

 NOTES:
	Bins are labeled for the energy as listed in the CDF file.  This looks like
	the bottom energy for each bin.  This should probably be changed to reflect
	the center energy of each bin.

	There is overlap between the LOW, M35/75, and HIGH MagEIS FEDO energy
	channels that are used to construct the full L2 spectrum.  Overlapping bins
	are skipped to present a continuous energy spectrum.  This may need to be
	tweaked in the future, to average/weight overlapping bins, etc.
	See additional comments beginning at line ~70.


 VERSION:
   $LastChangedBy: jimm $
   $LastChangedDate: 2020-04-13 13:25:55 -0700 (Mon, 13 Apr 2020) $
   $LastChangedRevision: 28568 $
   $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/tags/spedas_4_0/general/missions/rbsp/ect/rbsp_load_mageis_l2.pro $

(See general/missions/rbsp/ect/rbsp_load_mageis_l2.pro)

RBSP_READ_ECT_MAG_EPHEM[1]

[Previous Routine] [List of Routines]

 NAME: rbsp_read_ect_mag_ephem
 SYNTAX:
 PURPOSE: Read in RBSP ECT's official magnetic field model predicted quantities
 INPUT: sc -> 'a' or 'b'
		 date -> '2014-01-01'
        type -> defaults to OP77Q. Can also have "TS04D" (definitive)
        or "T89Q" for predicted.
 OUTPUT: tplot variables with prefix 'rbsp'+sc+'_ME_'
		  Will also return perigeetimes as keyword
 KEYWORDS:
 HISTORY: Written by Aaron W Breneman, UMN
 VERSION:
   $LastChangedBy: $
   $LastChangedDate: $
   $LastChangedRevision: $
   $URL: $

(See general/missions/rbsp/ect/rbsp_read_ect_mag_ephem.pro)