This page was created by the IDL library routine mk_html_help2.

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

projects/tracers/common

• TRACERS_CONFIG
• TRACERS_CONFIG_PUSH
• TRACERS_INIT
  Initializes system variables for tracers.
• TRACERS_SET_VERBOSE
  Sets verbose level in !tracers.verbose and in tplot_options
  

Routine Descriptions

  PRO tracers_config

  This procedure serves as the TRACERS 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 "TRACERS_INIT" procedure.

  This should be the only TRACERS 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.

  KEYWORDS
     colortable  - sets the color table for spd_graphics_config. this is not
                   set if the no_color_setup keyword is used
     no_color_setup   added to prevent cronjob to crash, hfrey, 2007-02-10


 $LastChangedBy: jwl $
 $LastChangedDate: 2025-08-20 16:06:21 -0700 (Wed, 20 Aug 2025) $
 $LastChangedRevision: 33566 $
 $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/tracers/common/tracers_config.pro $

(See projects/tracers/common/tracers_config.pro)

 FUNCTION: tracers_config_push

 PURPOSE: Puts structure A into structure B.
          By default, the same tag must exist in both structures.
 INPUT:
    A - structure to be place in structure B
    B - structure that will contain structure A

 KEYWORD:
    force - if this keyword is set, a tag of 'A' does not necessarily be in 'B'.
            Such a tag will be forced (or newly added) into 'B'

(See projects/tracers/common/tracers_config_push.pro)

NAME:    tracers_init

PURPOSE:
   Initializes system variables for tracers.
   
NOTE:
   The system variable !tracers is defined here, just like !THEMIS.
   The elements of this structure are explained below:

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

   !TRACERS.REMOTE_DATA_DIR   This is not implemented yet because there is no server at this point in time.
                  A URL will most likely be available after launch.

   *******
   WARNING: This version of tracers_init uses the remote data dir in the PUBLIC AREA
   *******

KEYWORDS:
   RESET:           Reset !tracers 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: Not yet implemented.
   NO_COLOR_SETUP   do not set colors if already taken care of


HISTORY:

 $LastChangedBy: jwl $
 $LastChangedDate: 2025-07-31 17:36:13 -0700 (Thu, 31 Jul 2025) $
 $LastChangedRevision: 33518 $
 $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/tracers/common/tracers_init.pro $

(See projects/tracers/common/tracers_init.pro)

NAME:
 tracers_set_verbose

PURPOSE:
 Sets verbose level in !tracers.verbose and in tplot_options

CALLING SEQUENCE:
 tracers_set_verbose, vlevel

INPUT:
 vlevel = a verbosity level, if not set then !tracers.verbose is used
          (this is how you would propagate the !tracers.verbose value
          into tplot options)

HISTORY:

 $LastChangedBy: jwl $
 $LastChangedDate: 2025-07-31 17:36:13 -0700 (Thu, 31 Jul 2025) $
 $LastChangedRevision: 33518 $
 $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/tracers/common/tracers_set_verbose.pro $

(See projects/tracers/common/tracers_set_verbose.pro)