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

Last modified: Tue Aug 5 18:17:40 2025.

# Directory Listing of Routines

# spedas_gui/utilities/cotrans

- SPD_COTRANS[1]
- SPD_COTRANS[2]
- SPD_UI_COTRANS

# Routine Descriptions

## SPD_COTRANS[1]

[Next Routine] [List of Routines]

    Purpose:
      Helps simplify transformation logic code using a recursive formulation.
      Rather than specifying the set of transformations for each combination of
      in_coord & out_coord, this routine will perform only the nearest transformation
      then make a recursive call to itself, with each call performing one additional
      step in the chain.  This makes it so only neighboring coordinate transforms need be
      specified.

    The set of transformations forms the following graph:
      GSE<->GEI<->GEO<->MAG
      GSE<->GSM<->SM

(See spedas_gui/utilities/cotrans/spd_cotrans.pro)

## SPD_COTRANS[2]

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

    Procedure:
      spd_cotrans

    Purpose:
      Transform between various THEMIS and geophysical coordinate systems

    Calling Sequence:
      spd_cotrans, input_name [,output_name]

    Arguments:
     input_name: String or string array of input tplot variable(s).  Standard tplot
                 wildcards may be used to specify multiple variables.
     output_name (optional) String or string array of output tplot variable names.
                 Number of output names must match number of input names once
                 wildcards are considered.

    Keywords:
      in_coord:  String specifying the coordinate system of the input(s).
                 This keyword is optional if the dlimits.data_att.coord_sys attribute
                 is present for the tplot variable, and if present, it must match
                 the value of that attribute (see cotrans_set_coord, cotrans_get_coord).
                   e.g. 'gse', 'gsm', 'sm', 'gei','geo', 'mag'
      out_coord:  String specifying the desitnation coordinate system.
                    e.g. 'gse', 'gsm', 'sm', 'gei','geo', 'mag'
      in_suffix:  Suffix of input variable name.  This specifies the portion of
                  the input variable's name that will be replace with the output
                  suffix.  If specified, the name effective input name will be
                  input_name + in_suffix
      out_suffix:  Suffix appended to the output name.  If in_suffix is present or
                   the input coordinates are part of the input variable's name then
                   they will be replaced with out_suffix.

      out_vars: return a list of the names of any transformed variables

      valid_names:  return valid coordinate system names in named varibles supplied to
                    in_coord and/or out_coord keywords.
      ignore_dlimits: set this keyword to true so that an error will not
                      be produced if the internal label of the coordinate system clashed
                      with the user provided coordinate system.
      no_update_labels: Set this keyword if you want the routine to not update the labels automatically

    Notes:
      This procedure was forked from thm_cotrans.

    $LastChangedBy: aaflores $
    $LastChangedDate: 2016-02-24 18:53:52 -0800 (Wed, 24 Feb 2016) $
    $LastChangedRevision: 20171 $
    $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/spedas_gui/utilities/cotrans/spd_cotrans.pro $

(See spedas_gui/utilities/cotrans/spd_cotrans.pro)

## SPD_UI_COTRANS

[Previous Routine] [List of Routines]

    Name:
      spd_ui_cotrans

    Purpose:
      Performs coordinate transformations on GUI data

    Input:
      tlb:  top level widget ID
      out_coord:  string storing the destination coordinate system
      active:  string array of variables to be transformed
      loadedData:  the loadedData object
      callSequence:  the call sequence object for replaying SPEDAS documents.
      sobj:  status bar object
      historywin:  history window object
      replay:  This keyword determines whether operations are pushed
               onto the call sequence and whether popups are displayed
      tvar_overwrite_selections:  Set this keyword when the replay keyword is set.
                                  It should contain an array of what overwrite selection
                                  was made for each processed variable.

    Output:
      none

    Notes:
      -If successful all previous active data variables will be replaced with
       their transformed copies.

    $LastChangedBy: jwl $
    $LastChangedDate: 2017-08-25 16:18:12 -0700 (Fri, 25 Aug 2017) $
    $LastChangedRevision: 23832 $
    $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/spedas_gui/utilities/cotrans/spd_ui_cotrans.pro $

(See spedas_gui/utilities/cotrans/spd_ui_cotrans.pro)