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

Last modified: Fri Nov 7 18:17:52 2025.

# Directory Listing of Routines

# projects/iugonet/load/ascii2tplot

- ASCII2TPLOT
  Loads data from ascii format files.
- ASCII2TPLOT_XY
  Loads data from ascii format files.
- ASCII2TPLOT_XYV_1
  Loads data from ascii format files.
- ASCII2TPLOT_XYV_2
  Loads data from ascii format files.
- SPD_UI_LOAD_SPEDAS_ASCII
- SPD_UI_LOAD_SPEDAS_ASCII_SUB
  display a dialog when importing ASCII data

# Routine Descriptions

## ASCII2TPLOT

[Next Routine] [List of Routines]

     PROCEDURE: ascii2tplot
       ascii2tplot, files, files=files2, format_type=format_type, tformat=tformat, $
           tvar_column=tvar_column, tvarnames=tvarnames, $
           delimiter=delimiter, data_start=data_start, comment_symbol=comment_symbol, $
           v_column=v_column, vvec=vvec, $
           time_column=time_column, input_time=input_time

     PURPOSE:
       Loads data from ascii format files.

     KEYWORDS:
       files : Ascii data files which you want to load.
       format_type: 0 or 1 or 2. It specifies the function used to read the ascii
           files, i.e., 0:ascii2tplot_xy, 1:ascii2tplot_xyv_1, 2:ascii2tplot_xyv_2.
       tformat : Format string for date&time such as "YYYY-MM-DD/hh:mm:ss"
       tvar_column : A scalar or a vector that identifies the column number for output
           tplot variables. The number starts from 0 except for the columns for
           date&time. (e.g., tvar_column=0 or tvar_column=[0, 1, 2])
       tvarnames : A string or string array for output tplot variable names.
           If the number of elements of tvar_column is greater than 1, tvarnames
           should have the same number of elememnts or only one element.
           (e.g., tvarnames='tvar0' or tvarnames=['tvar0','tvar1','tvar2'])
       delimiter : A scalar string that identifies the end of a field.
           One or more single characters are allowed. (e.g., deliminator=', ;')
       data_start : Number of header lines you want to skip.
           (e.g., data_start=10)
       comment_symbol : A string that identifies the character used to delineate
           comments.
       v_column : A scalar that specifies the number of column of vdata, where
           vdata[1:nx,1:nv] is used to create tplot variations by the command as follows;
           store_data, tvarnames, data={x:xdata, y:ydata, v:vdata}.
           xdata[1:nx] is made from date&time and ytada[1:nx,1:nv] is identified
           by tvar_column.
       vvec : A vector for vdata, where vdata[1:nv] is used to create tplot variations
           by the command as follows;
           store_data, tvarnames, data={x:xdata, y:ydata, v:vdata}.
           xdata[1:nx] is made from date&time and ytada[1:nx,1:nv] is identified
           by tvar_column.
       time_column : Optional. If this keyword is set, "tformat" is not used.
           A vector of 6 melements that shows the existence of date&time data,
           (year, month, day, hour, minute, second) in the ascii file. For example,
           if the data file includes the columns for [hour minute second] only,
           then time_column = [0, 0, 0, 1, 1, 1].
       input_time : Need to set this keyword when the time_column is set.
           For example, if the data file includes the columns for [hour minute second]
           only, then you need to set [year, month day] as follows;
           input_time = [2017, 3, 1, 0, 0, 0].

     EXAMPLE:
       ascii2tplot, files='stn20120301.txt', format_type=0,
            tformat='YYYY-MM-DD hh:mm:ss.fff', tvar_column=[1,2,3], $
            tvarnames='mag_stn', delimiter=',', comment_symbol=';'

     Written by Y.-M. Tanaka, April 25, 2018 (ytanaka at nipr.ac.jp)

(See projects/iugonet/load/ascii2tplot/ascii2tplot.pro)

## ASCII2TPLOT_XY

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

     PROCEDURE: ascii2tplot_xy
       ascii2tplot_xy, files, files=files2, tformat=tformat, delimiter=delimiter, $
            data_start=data_start, comment_symbol=comment_symbol, tvar_column=tvar_column, $
            tvarnames=tvarnames

     PURPOSE:
       Loads data from ascii format files.

     KEYWORDS:
       files : Ascii data files which you want to load.
       tformat : Format string for date&time such as "YYYY-MM-DD/hh:mm:ss"
       tvar_column : A scalar or a vector that identifies the column number for output
           tplot variables. The number starts from 0 except for the columns for
           date&time. (e.g., tvar_column=0 or tvar_column=[0, 1, 2])
       tvarnames : A string or string array for output tplot variable names.
           If the number of elements of tvar_column is greater than 1, tvarnames
           should have the same number of elememnts or only one element.
           (e.g., tvarnames='tvar0' or tvarnames=['tvar0','tvar1','tvar2'])
       delimiter : A scalar string that identifies the end of a field.
           One or more single characters are allowed. (e.g., deliminator=', ;')
       data_start : Number of header lines you want to skip.
           (e.g., data_start=10)
       comment_symbol : A string that identifies the character used to delineate
           comments.
       time_column : Optional. If this keyword is set, "tformat" is not used.
           A vector of 6 melements that shows the existence of date&time data,
           (year, month, day, hour, minute, second) in the ascii file. For example,
           if the data file includes the columns for [hour minute second] only,
           then time_column = [0, 0, 0, 1, 1, 1].
       input_time : Need to set this keyword when the time_column is set.
           For example, if the data file includes the columns for [hour minute second]
           only, then you need to set [year, month day] as follows;
           input_time = [2017, 3, 1, 0, 0, 0].

     EXAMPLE:
       ascii2tplot_xy, files='stn20120301.txt', tformat='YYYY-MM-DD hh:mm:ss.fff', $
            tvar_column=[1,2,3], tvarnames='mag_stn', $
            delimiter=',', comment_symbol=';',

     Written by Y.-M. Tanaka, April 25, 2018 (ytanaka at nipr.ac.jp)

(See projects/iugonet/load/ascii2tplot/ascii2tplot_xy.pro)

## ASCII2TPLOT_XYV_1

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

     PROCEDURE: ascii2tplot_xyv_1
       ascii2tplot_xyv_1, files, files=files2, tformat=tformat, $
            tvar_column=tvar_column, tvarnames=tvarnames, v_column=v_column, $
            delimiter=delimiter, data_start=data_start, comment_symbol=comment_symbol, $
            time_column=time_column, input_time=input_time

     PURPOSE:
       Loads data from ascii format files.

     KEYWORDS:
       files : Ascii data files which you want to load.
       tformat : Format string for date&time such as "YYYY-MM-DD/hh:mm:ss"
       tvar_column : A scalar or a vector that identifies the column number for output
           tplot variables. The number starts from 0 except for the columns for
           date&time. (e.g., tvar_column=0 or tvar_column=[0, 1, 2])
       tvarnames : A string or string array for output tplot variable names.
           If the number of elements of tvar_column is greater than 1, tvarnames
           should have the same number of elememnts or only one element.
           (e.g., tvarnames='tvar0' or tvarnames=['tvar0','tvar1','tvar2'])
       v_column : A scalar that specifies the number of column of vdata, where
           vdata[1:nx,1:nv] is used to create tplot variations by the command as follows;
           store_data, tvarnames, data={x:xdata, y:ydata, v:vdata}.
           xdata[1:nx] is made from date&time and ytada[1:nx,1:nv] is identified
           by tvar_column.
       delimiter : A scalar string that identifies the end of a field.
           One or more single characters are allowed. (e.g., deliminator=', ;')
       data_start : Number of header lines you want to skip.
           (e.g., data_start=10)
       comment_symbol : A string that identifies the character used to delineate
           comments.
       time_column : Optional. If this keyword is set, "tformat" is not used.
           A vector of 6 melements that shows the existence of date&time data,
           (year, month, day, hour, minute, second) in the ascii file. For example,
           if the data file includes the columns for [hour minute second] only,
           then time_column = [0, 0, 0, 1, 1, 1].
       input_time : Need to set this keyword when the time_column is set.
           For example, if the data file includes the columns for [hour minute second]
           only, then you need to set [year, month day] as follows;
           input_time = [2017, 3, 1, 0, 0, 0].

     EXAMPLE:
       ascii2tplot_xyv_1, files='stn20120301.txt', tformat='YYYY-MM-DD hh:mm:ss.fff', $
            tvar_column=[1,2,3,4], tvarnames=['Ne', 'Te', 'Ti', 'Vi'], $
            v_column=0, delimiter=',', comment_symbol=';'

     Written by Y.-M. Tanaka, April 25, 2018 (ytanaka at nipr.ac.jp)

(See projects/iugonet/load/ascii2tplot/ascii2tplot_xyv_1.pro)

## ASCII2TPLOT_XYV_2

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

     PROCEDURE: ascii2tplot_xyv_2
       ascii2tplot_xyv_2, files, files=files2, tformat=tformat, $
            tvarnames=tvarnames, vvec=vvec, $
            delimiter=delimiter, data_start=data_start, comment_symbol=comment_symbol, $
            time_column=time_column, input_time=input_time

     PURPOSE:
       Loads data from ascii format files.

     KEYWORDS:
       files : Ascii data files which you want to load.
       tformat : Format string for date&time such as "YYYY-MM-DD/hh:mm:ss"
       tvarnames : A string for output tplot variable names.
           (e.g., tvarnames='tvar0')
       vvec : A vector for vdata, where vdata[1:nv] is used to create tplot variations
           by the command as follows;
           store_data, tvarnames, data={x:xdata, y:ydata, v:vdata}.
           xdata[1:nx] is made from date&time and ydada[1:nx,1:nv] is identified
           by tvar_column.
       delimiter : A scalar string that identifies the end of a field.
           One or more single characters are allowed. (e.g., deliminator=', ;')
       data_start : Number of header lines you want to skip.
           (e.g., data_start=10)
       comment_symbol : A string that identifies the character used to delineate
           comments.
       time_column : Optional. If this keyword is set, "tformat" is not used.
           A vector of 6 melements that shows the existence of date&time data,
           (year, month, day, hour, minute, second) in the ascii file. For example,
           if the data file includes the columns for [hour minute second] only,
           then time_column = [0, 0, 0, 1, 1, 1].
       input_time : Need to set this keyword when the time_column is set.
           For example, if the data file includes the columns for [hour minute second]
           only, then you need to set [year, month day] as follows;
           input_time = [2017, 3, 1, 0, 0, 0].

     EXAMPLE:
       ascii2tplot_xyv_2, files='stn20120301.txt', tformat='YYYY-MM-DD hh:mm:ss.fff', $
            tvarnames='Ne', vvec=[0, 0.1, 0.2, 0.5, 1.0, 2.0, 4.0, 8.0],
            delimiter=',', comment_symbol=';'

     Written by Y.-M. Tanaka, April 25, 2018 (ytanaka at nipr.ac.jp)

(See projects/iugonet/load/ascii2tplot/ascii2tplot_xyv_2.pro)

## SPD_UI_LOAD_SPEDAS_ASCII

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

      Name: SPD_UI_LOAD_SPEDAS_ASCII

      Purpose: Loads data from a CDF chosen by user. Note that only CDFs that conform to SPEDAS standards can be opened.
      CDFs that do not conform may produce unhelpful error messages.

      Inputs:
      info - The info structure from the main gui
      ev - The event structure from the main gui

    $LastChangedBy: nikos $
    $LastChangedDate: 2018-08-01 11:03:38 -0700 (Wed, 01 Aug 2018) $
    $LastChangedRevision: 25538 $
    $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/iugonet/load/ascii2tplot/spd_ui_load_spedas_ascii.pro $

(See projects/iugonet/load/ascii2tplot/spd_ui_load_spedas_ascii.pro)

## SPD_UI_LOAD_SPEDAS_ASCII_SUB

[Previous Routine] [List of Routines]

    NAME:
     spd_ui_load_spedas_ascii_sub

    PURPOSE:
     display a dialog when importing ASCII data

    INPUT:
     ev - event structure from the main GUI

    HISTORY:

(See projects/iugonet/load/ascii2tplot/spd_ui_load_spedas_ascii_sub.pro)