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

Last modified: Sat Jul 26 18:17:38 2025.

# Directory Listing of Routines

# 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

## TRACERS_CONFIG

[Next Routine] [List of Routines]

      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

      Author:  Davin Larson Nov 2006
               jmm, 2007-05-17, Altered to read thm_comfig text file,
               this removes the need for someone to alter this program
               jmm, 2007-07-02, applies slashes to remote and local
               directories, if they are not there
               cg, 2008-5-6, reset default default directory

     $LastChangedBy: elfin_shared $
     $LastChangedDate: 2025-07-14 22:58:01 -0700 (Mon, 14 Jul 2025) $
     $LastChangedRevision: 33465 $
     $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/tracers/common/tracers_config.pro $

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

## TRACERS_CONFIG_PUSH

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

     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)

## TRACERS_INIT

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

    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:
     2015-04-10, moka, Created based on 'thm_init'

     $LastChangedBy: elfin_shared $
     $LastChangedDate: 2025-07-14 22:58:01 -0700 (Mon, 14 Jul 2025) $
     $LastChangedRevision: 33465 $
     $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/tracers/common/tracers_init.pro $

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

## TRACERS_SET_VERBOSE

[Previous Routine] [List of Routines]

    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:
     21-aug-2012, jmm, jimm@ssl.berkeley.edu
     12-oct-2012, jmm, Added this comment to test SVN
     12-oct-2012, jmm, Added this comment to test SVN, again
     18-oct-2012, jmm, Another SVN test
     10-apr-2015, moka, adapted for elf from 'thm_set_verbose'

     $LastChangedBy: elfin_shared $
     $LastChangedDate: 2025-07-14 22:58:01 -0700 (Mon, 14 Jul 2025) $
     $LastChangedRevision: 33465 $
     $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)