This page was created by the IDL library routine mk_html_help2.

Last modified: Wed Apr 17 11:44:33 2013.


Directory Listing of Routines


Routine Descriptions

FILE_DAILYNAMES_IUG

[Next Routine] [List of Routines]
  Procedure:  FILE_DAILYNAMES
  Author: Atsuki Shinbori

(See iugonet/load/file_dailynames_iug.pro)


FILE_HTTP_COPY

[Previous Routine] [Next Routine] [List of Routines]
  WARNING: the interface to this routine is not yet solidified. Use the wrapper routine:
  file_retrieve instead. This routine is still under development.

 NAME:
    file_http_copy

 PURPOSE:
    Downloads file(s) from http servers.
    Also performs Searches without download.
    Copies the file to a user specified local directory.
    By default, files are only downloaded if the remote file is newer than
    the local file (based on mtime) or if the files differ in size.
    This routine is intended for use with simple HTTP file servers.
    Wildcard matching and recursive file searching can be used as well.

 CALLING SEQUENCE: There are two methods:
 Method 1:
    FILE_HTTP_COPY, pathnames, SERVERDIR=serverdir, LOCALDIR=localdir
    where:
      pathnames = (input string(s), scaler or array)  Relative path name of file to download.;
      serverdir = (scaler input string)  Root name of source URL, must
                                         begin with: 'http://' and end with '/'
      localdir  = (scaler input string)  Root name of local directory, typically
                                         ends with '/'
    Note:   The source is at:    serverdir + pathnames
            The destination is:  localdir + pathnames
 Method 2:
    FILE_HTTP_COPY, URL
       URL = full URL(S) of source file
       Directory structure is not retained with this procedure

 Example:
    FILE_HTTP_COPY, 'ssl_general/misc/file_http_copy.pro',  $
              SERVERDIR='http://themis.ssl.berkeley.edu/data/themis/socware/bleeding_edge/idl/' $
              localdir = 'myidl/'

    Note: Unix style directory separaters '/' should be used throughout. This convention will still
          work with WINDOWS.

 Alternate calling sequence:
    FILE_HTTP_COPY,URL
        where URL is an input (string) such as:  URL = '

 INPUTS:
      URL - scalar or array string giving a fully qualified url

 OPTIONAL KEYWORDS:
     NO_CLOBBER:   (0/1) Set this keyword to prevent overwriting local files.
     IGNORE_FILESIZE: (0/1) Set this keyword to ignore file size when
           evaluating need to download.
     NO_DOWNLOAD:  (0/1) Set this keyword to prevent file downloads (url_info
           is still returned)
     URL_INFO=url_info: (output) Named variable that returns information about
           remote file such as modification time and file size as determined
           from the HTML header. A zero is returned if the remote file is
           invalid.
     FILE_MODE= file_mode:     If non-zero, sets the permissions for downloaded files.
     DIR_MODE = dir_mode:      Sets permissions for newly created directories
                            (Useful for shared directories)
     ASCII_MODE:  (0/1)   When set to 1 it forces files to be downloaded as ascii text files (converts CR/LF)
                          Setting this keyword will force ignore_filesize keyword to be set as well because
                          files will be of different sizes typically.
     VERBOSE:      (input; integer) Set level of verboseness:   Uses "DPRINT"
           0-nearly silent;  2-typical messages;  4: debugging info


 Examples:
   ;Download most recent version of this file to current directory:
   FILE_HTTP_COPY,'http://themis.ssl.berkeley.edu/data/themis/socware/bleeding_edge/idl/ssl_general/misc/file_http_copy.pro'

 OPTIONAL INPUT KEYWORD PARAMETERS:
       PATHNAME = pathname   ; pathname is the filename to be created.
                If the directory does not exist then it will be created.
                If PATHNAME does not exist then the original filename is used
                and placed in the current directory.
;
 RESTRICTIONS:

     PROXY: If you are behind a firewall and have to access the net through a
         Web proxy,  set the environment variable 'http_proxy' to point to
         your proxy server and port, e.g.
         setenv,  'http_proxy=http://web-proxy.mpia-hd.mpg.de:3128'
         setenv,  'http_proxy=http://www-proxy1.external.lmco.com'

               The URL *MUST* begin with "http://".

 PROCEDURE:
     Open a socket to the webserver and download the header.

 EXPLANATION:
     FILE_HTTP_COPY can access http servers - even from behind a firewall -
     and perform simple downloads. Currently,
     Requires IDL V5.4 or later on Unix or Windows, V5.6 on
     Macintosh

 EXAMPLE:
      IDL> FILE_HTTP_COPY,'http://themis.ssl.berkeley.edu/themisdata/thg/l1/asi/whit/2006/thg_l1_asf_whit_2006010103_v01.cdf'
      IDL> PRINTDAT, file_info('thg_l1_asf_whit_2006010103_v01.cdf')
      or


 MINIMUM IDL VERSION:
     V5.4  (uses SOCKET)
 MODIFICATION HISTORY:
   Original version:  WEBGET()
     Written by M. Feldt, Heidelberg, Oct 2001 
     Use /swap_if_little_endian keyword to SOCKET  W. Landsman August 2002
     Less restrictive search on Content-Type   W. Landsman   April 2003
     Modified to work with FIRST image server-  A. Barth, Nov 2006
   FILE_HTTP_COPY:   New version created by D Larson:  March 2007.
     Checks last modification time of remote file to determine need for download
     Checks size of remote file to determine need to download
     Very heavily modified from WEBGET():
   May/June 2007 - Modified to allow file globbing (wildcards).
   July 2007   - Modified to return remote file info  (without download)
   July 2007   - Modified to allow recursive searches.
   August 2007 - Added file_mode keyword.
   April  2008 - Added dir_mode keyword
   Sep 2009    - Fixed user-agent

 $LastChangedBy: aaflores $
 $LastChangedDate: 2012-07-03 16:28:11 -0700 (Tue, 03 Jul 2012) $
 $LastChangedRevision: 10679 $
 $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/ssl_general/trunk/misc/file_http_copy.pro $

(See iugonet/load/file_http_copy.pro)


FILE_RETRIEVE

[Previous Routine] [Next Routine] [List of Routines]
FUNCTION file_retrieve(pathnames,local_data_dir=local_data_dir)

Arguments:
    pathnames: String or string array with partial path to the remote file. 
               (will be appended to remote_data_dir)
    newpathnames: (optional) String or string array with partial path to file destination.
                   (ill be appended to local_data_dir)

Keywords:
    local_data_dir:  String or string array w/ local data directory(s)
                     If newpathnames is set it will be appended to this variable; if not, 
                     pathnames will be appended. 
    remote_data_dir:  String or string array w/ remote data directory(s)
                      Pathnames will be appended to this variable.
    
History: 
    2012-6-25:  local_data_dir and remote_data_dir accept array inputs 
                with the same # of elements as pathnames/newpathnames

$LastChangedBy: jimm $
$LastChangedDate: 2012-07-05 10:20:54 -0700 (Thu, 05 Jul 2012) $
$LastChangedRevision: 10680 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/ssl_general/trunk/misc/file_retrieve.pro $

(See iugonet/load/file_retrieve.pro)


IUG_LOAD_ASK_NIPR

[Previous Routine] [Next Routine] [List of Routines]
PROCEDURE: IUG_LOAD_ASK_NIPR,
  iug_load_ask_nipr, site = site, trange = trange, 
                     verbose = verbose, downloadonly = downloadonly

PURPOSE:
  Loads keogram data obtained with AWI by NIPR.

KEYWORDS:
  site  = Observatory name.  For example, iug_load_ask_nipr, site = 'tro'.
          The default is 'all', i.e., load all available stations.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /verbose, if set, then output some useful info
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

EXAMPLE:
  iug_load_ask_nipr, site = 'tro'

 Written by: Y.-M. Tanaka, Feb. 20, 2012 (ytanaka at nipr.ac.jp)

(See iugonet/load/iug_load_ask_nipr.pro)


IUG_LOAD_AWS_ID

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

NAME:
iug_load_aws_id

PURPOSE:
  Queries the RISH server for the surface meterology data taken by the automatic weather 
  station (AWS) at the Indonesian stations and loads data into tplot format.

SYNTAX:
 iug_load_aws_id, datatype = datatype, site=site, $
                    downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_aws_id, datatype = 'troposphere'.
            The default is 'troposphere'. 
  site = AWS observation site.  
         For example, iug_load_aws_id, site = 'pon'.
         The default is 'all', i.e., load all available observation points.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
  A. Shinbori, 28/02/2013.
  
MODIFICATIONS:
  A. Shinbori, 08/04/2013.
    
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_aws_id.pro)


IUG_LOAD_AWS_KTB

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

NAME:
iug_load_aws_ktb

PURPOSE:
  Queries the RISH server for the surface meterology data taken by the automatic weather 
  station (AWS) at the Kototabang stations and loads data into tplot format.

SYNTAX:
 iug_load_aws_ktb, datatype = datatype, site=site, $
                    downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_aws_ktb, datatype = 'troposphere'.
            The default is 'troposphere'. 
  site = AWS observation site.  
         For example, iug_load_aws_ktb, site = 'ktb'.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
  A. Shinbori, 28/02/2013.
  
MODIFICATIONS:
   
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_aws_ktb.pro)


IUG_LOAD_AWS_RISH

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

NAME:
iug_load_aws_rish

PURPOSE:
  Queries the RISH server for the surface meterology data taken by the automatic weather 
  station (AWS) and loads data into tplot format.

SYNTAX:
 iug_load_aws_rish, datatype = datatype, site=site, $
                    downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_aws_rish, datatype = 'troposphere'.
            The default is 'troposphere'. 
  site = AWS observation site.  
         For example, iug_load_aws_rish, site = 'bik'.
         The default is 'all', i.e., load all available observation points.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
  A. Shinbori, 28/02/2013.
  
MODIFICATIONS:

   
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_aws_rish.pro)


IUG_LOAD_AWS_SGK

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

NAME:
iug_load_aws_sgk

PURPOSE:
  Queries the RISH server for the surface meterology data taken by the automatic weather 
  station (AWS) at Shigaraki and loads data into tplot format.

SYNTAX:
 iug_load_aws_sgk, datatype = datatype, site=site, $
                    downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_aws_sgk, datatype = 'troposphere'.
            The default is 'troposphere'. 
  site = AWS observation site.  
         For example, iug_load_aws_sgk, site = 'sgk'.
         The default is 'all', i.e., load all available observation points.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
  A. Shinbori, 28/02/2013.
  
MODIFICATIONS:

   
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_aws_sgk.pro)


IUG_LOAD_BLR_RISH

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

NAME:
iug_load_blr_rish

PURPOSE:
  Queries the Kyoto_RISH server for the CSV data (uwnd, vwnd, wwnd, pwr1-5, wdt1-5) 
  of the troposphere taken by the boundary layer radar (BLR) at Kototabang, Shigaraki and Serpong
  and loads data into tplot format.

SYNTAX:
 iug_load_blr_rish, datatype = datatype, site=site, parameter=parameter, $
                        downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_blr_rish, datatype = 'troposphere'.
            The default is 'troposphere'. 
   site = BLR observation site.  
          For example, iug_load_blr_rish, site = 'ktb'.
          The default is 'all', i.e., load all available observation points.
  parameter = parameter name of BLR obervation data.  
          For example, iug_load_blr_rish, parameter = 'uwnd'.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
  A. Shinbori, 09/09/2010.
  
MODIFICATIONS:
  A. Shinbori, 03/23/2011.
  A. Shinbori, 12/26/2011.
  A. Shinbori, 31/01/2012.
  A. Shinbori, 10/02/2012.
  A. Shinbori, 17/12/2012.
  A. Shinbori, 27/02/2013.
   
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_blr_rish.pro)


IUG_LOAD_EAR

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

NAME:
iug_load_ear

PURPOSE:
  Queries the RISH servers for all the observation data (troposphere and FAI)
  taken by the equatorial atmosphere radar (EAR) and loads data into tplot format.

SYNTAX:
  iug_load_ear [ ,DATATYPE = string ]
                [ ,PARAMETERS = string]
                [ ,TRANGE = [min,max] ]
                [ ,FILENAMES = string scalar or array ]
                [ , ]

KEYWOARDS:
  DATATYPE = The type of data to be loaded. In this load program,
             DATATYPEs are 'troposphere', 'e_region', 'v_region' etc.

  PARAMETERS (I/O):
    Set to wind parameters.  If not set, 'uwnd' is
      assumed.  Returns cleaned input, or shows default.  
  TRANGE (In):
    Pass a time range a la TIME_STRING.PRO.
  FILENAMES (In):
    *PRESENTLY DISABLED* Pass user-defined file names (full paths to local data files).  These will
      be read a la the RISH format, and the RISH server will not be queried.
  VERBOSE (In): [1,...,5], Get more detailed (higher number) command line output.

DATA AVAILABILITY:
  Please check the following homepage of the time schedule of field-aligned irregularity (FAI) observation 
  before you analyze the FAI data using this software. 
  http://www.rish.kyoto-u.ac.jp/ear/data-fai/index.html#data

CODE:
A. Shinbori, 13/05/2010.

MODIFICATIONS:
A. Shinbori, 25/11/2010.
A. Shinbori, 08/11/2011.
A. Shinbori, 11/05/2011.
A. Shinbori, 27/05/2011.
A. Shinbori, 15/06/2011.
A. Shinbori, 25/07/2011.

ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_ear.pro)


IUG_LOAD_EAR_IONO_EFR_NC

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

NAME:
iug_load_ear_iono_efr_nc

PURPOSE:
  Queries the Kyoto_RISH servers for the FAI observation data in the NetCDF format 
  taken by the equatorial atmosphere radar (EAR) and loads data into
  tplot format.

SYNTAX:
 iug_load_ear_iono_efr_nc, datatype = datatype, parameter1=parameter1, $
                           downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_ear_iono_er_nc, datatype = 'ionosphere'.
            The default is 'fai'. 
  parameter1 = first parameter name of EAR FAI obervation data.  
          For example, iug_load_ear_iono_er_nc, parameter = 'efb1p16'.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

DATA AVAILABILITY:
  Please check the following homepage of the time schedule of field-aligned irregularity (FAI) observation 
  before you analyze the FAI data using this software. 
  http://www.rish.kyoto-u.ac.jp/ear/data-fai/index.html#data

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 09/07/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 17/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_ear_iono_efr_nc.pro)


IUG_LOAD_EAR_IONO_EFR_TXT

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

NAME:
iug_load_ear_iono_efr_txt

PURPOSE:
  Queries the Kyoto_RISH servers for the FAI observation data in the CSV format 
  taken by the equatorial atmosphere radar (EAR) and loads data into
  tplot format.

SYNTAX:
 iug_load_ear_iono_efr_txt, datatype = datatype, parameter1=parameter1, parameter2=parameter2 $
                          downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_ear_iono_efr_txt, datatype = 'fai'.
            The default is 'fai'. 
  parameter1 = first parameter name of EAR FAI obervation data.  
          For example, iug_load_ear_iono_efr_txt, parameter1 = 'efb1p16'.
          The default is 'all', i.e., load all available parameters.
  parameter2 = second parameter name of EAR FAI obervation data.  
          For example, iug_load_ear_iono_efr_txt, parameter2 = 'dpl1'.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

DATA AVAILABILITY:
  Please check the following homepage of the time schedule of field-aligned irregularity (FAI) observation 
  before you analyze the FAI data using this software. 
  http://www.rish.kyoto-u.ac.jp/ear/data-fai/index.html#data

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 06/10/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 17/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_ear_iono_efr_txt.pro)


IUG_LOAD_EAR_IONO_ER_NC

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

NAME:
iug_load_ear_iono_er_nc

PURPOSE:
  Queries the Kyoto_RISH servers for the FAI observation data in the NetCDF format 
  taken by the equatorial atmosphere radar (EAR) and loads data into
  tplot format.

SYNTAX:
 iug_load_ear_iono_er_nc, datatype = datatype, parameter1=parameter1, $
                          downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_ear_iono_er_nc, datatype = 'fai'.
            The default is 'fai'. 
  parameter1 = first parameter name of EAR FAI obervation data.  
          For example, iug_load_ear_iono_er_nc, parameter1 = 'eb1p2a'.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.
                 
DATA AVAILABILITY:
  Please check the following homepage of the time schedule of field-aligned irregularity (FAI) observation 
  before you analyze the FAI data using this software. 
  http://www.rish.kyoto-u.ac.jp/ear/data-fai/index.html#data

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 09/07/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 17/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_ear_iono_er_nc.pro)


IUG_LOAD_EAR_IONO_ER_TXT

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

NAME:
iug_load_ear_iono_er_txt

PURPOSE:
  Queries the Kyoto_RISH servers for the FAI observation data in the CSV format 
  taken by the equatorial atmosphere radar (EAR) and loads data into
  tplot format.

SYNTAX:
 iug_load_ear_iono_er_txt, datatype = datatype, parameter1=parameter1, parameter2=parameter2 $
                          downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_ear_iono_er_txt, datatype = 'ionosphere'.
            The default is 'ionosphere'. 
  parameter1 = first parameter name of EAR FAI obervation data.  
          For example, iug_load_ear_iono_er_txt, parameter = 'eb1p2a'.
          The default is 'all', i.e., load all available parameters.
  parameter2 = second parameter name of EAR FAI obervation data.  
          For example, iug_load_ear_iono_er_txt, parameter = 'dpl1'.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

DATA AVAILABILITY:
  Please check the following homepage of the time schedule of field-aligned irregularity (FAI) observation 
  before you analyze the FAI data using this software. 
  http://www.rish.kyoto-u.ac.jp/ear/data-fai/index.html#data

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 06/10/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 17/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_ear_iono_er_txt.pro)


IUG_LOAD_EAR_IONO_FR_NC

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

NAME:
iug_load_ear_iono_fr_nc

PURPOSE:
  Queries the Kyoto_RISH servers for the FAI observation data in the NetCDF format 
  taken by the equatorial atmosphere radar (EAR) and loads data into
  tplot format.

SYNTAX:
 iug_load_ear_iono_fr_nc, datatype = datatype, parameter1=parameter1, $
                          downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_ear_iono_fr_nc, datatype = 'fai'.
            The default is 'fai'. 
  parameter1 = first parameter name of EAR FAI obervation data.  
          For example, iug_load_ear_iono_fr_nc, parameter1 = 'fb1p16a'.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.
                 
DATA AVAILABILITY:
  Please check the following homepage of the time schedule of field-aligned irregularity (FAI) observation 
  before you analyze the FAI data using this software. 
  http://www.rish.kyoto-u.ac.jp/ear/data-fai/index.html#data

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 09/07/2011.
 A. Shinbori, 01/12/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 17/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_ear_iono_fr_nc.pro)


IUG_LOAD_EAR_IONO_FR_TXT

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

NAME:
iug_load_ear_iono_fr_txt

PURPOSE:
  Queries the Kyoto_RISH servers for the FAI observation data in the CSV format 
  taken by the equatorial atmosphere radar (EAR) and loads data into
  tplot format.

SYNTAX:
 iug_load_ear_iono_fr_txt, datatype = datatype, parameter1=parameter1, parameter2=parameter2 $
                           downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_ear_iono_fr_txt, datatype = 'fai'.
            The default is 'fai'. 
  parameter1 = first parameter name of EAR FAI obervation data.  
          For example, iug_load_ear_iono_fr_txt, parameter1 = 'fb1p16a'.
          The default is 'all', i.e., load all available parameters.
  parameter2 = second parameter name of EAR FAI obervation data.  
          For example, iug_load_ear_iono_fr_txt, parameter2 = 'dpl1'.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

DATA AVAILABILITY:
  Please check the following homepage of the time schedule of field-aligned irregularity (FAI) observation 
  before you analyze the FAI data using this software. 
  http://www.rish.kyoto-u.ac.jp/ear/data-fai/index.html#data

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 06/10/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 17/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_ear_iono_fr_txt.pro)


IUG_LOAD_EAR_IONO_VR_NC

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

NAME:
iug_load_ear_iono_vr_nc

PURPOSE:
  Queries the Kyoto_RISH servers for the FAI observation data in the NetCDF format 
  taken by the equatorial atmosphere radar (EAR) and loads data into
  tplot format.

SYNTAX:
 iug_load_ear_iono_vr_nc, datatype = datatype, parameter1=parameter1, $
                          downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_ear_iono_vr_nc, datatype = 'fai'.
            The default is 'fai'. 
  parameter1 = first parameter name of EAR FAI obervation data.  
          For example, iug_load_ear_iono_vr_nc, parameter = 'vb3p4a'.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

DATA AVAILABILITY:
  Please check the following homepage of the time schedule of field-aligned irregularity (FAI) observation 
  before you analyze the FAI data using this software. 
  http://www.rish.kyoto-u.ac.jp/ear/data-fai/index.html#data

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 09/07/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 17/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_ear_iono_vr_nc.pro)


IUG_LOAD_EAR_IONO_VR_TXT

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

NAME:
iug_load_ear_iono_vr_txt

PURPOSE:
  Queries the Kyoto_RISH servers for the FAI observation data in the CSV format 
  taken by the equatorial atmosphere radar (EAR) and loads data into
  tplot format.

SYNTAX:
 iug_load_ear_iono_vr_txt, datatype = datatype, parameter1=parameter1, parameter2=parameter2 $
                          downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_ear_iono_vr_txt, datatype = 'fai'.
            The default is 'fai'. 
  parameter1 = first parameter name of EAR FAI obervation data.  
          For example, iug_load_ear_iono_vr_txt, parameter1 = 'vb3p4a'.
          The default is 'all', i.e., load all available parameters.
  parameter2 = second parameter name of EAR FAI obervation data.  
          For example, iug_load_ear_iono_vr_txt, parameter2 = 'dpl1'.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

DATA AVAILABILITY:
  Please check the following homepage of the time schedule of field-aligned irregularity (FAI) observation 
  before you analyze the FAI data using this software. 
  http://www.rish.kyoto-u.ac.jp/ear/data-fai/index.html#data

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 06/10/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 17/12/2012.

ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_ear_iono_vr_txt.pro)


IUG_LOAD_EAR_TROP_NC

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

NAME:
iug_load_ear_trop_nc

PURPOSE:
  Queries the Kyoto_RISH servers for the standard observation data of troposphere and stratsoohere
  in the netCDF format taken by the equatorial atmosphere radar (EAR) and loads data into
  tplot format.

SYNTAX:
 iug_load_ear_trop_nc, datatype = datatype, downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_ear_trop_nc, datatype = 'troposphere'.
            The default is 'troposphere'. 
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 13/11/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 18/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_ear_trop_nc.pro)


IUG_LOAD_EAR_TROP_TXT

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

NAME:
iug_load_ear_trop_txt

PURPOSE:
  Queries the Kyoto_RISH servers for the standard observation data of troposphere and stratsoohere
  in the CSV format taken by the equatorial atmosphere radar (EAR)and loads data into
  tplot format.

SYNTAX:
 iug_load_ear_trop_txt, datatype = datatype, parameter=parameter, $
                        downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_ear_trop_txt, datatype = 'troposphere'.
            The default is 'troposphere'. 
  parameter = parameter name of EAR troposphere standard obervation data.  
          For example, iug_load_ear_trop_txt, parameter = 'uwnd'.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 13/11/2011.
 A. Shinbori, 26/12/2011.
 A. Shinbori, 31/01/2011.
 A. Shinbori, 18/12/2011.
   
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_ear_trop_txt.pro)


IUG_LOAD_EISCAT

[Previous Routine] [Next Routine] [List of Routines]
 PROCEDURE: IUG_LOAD_EISCAT
   iug_load_eiscat, site=site, $
                    ydatatype=ydatatype, $
                    get_support_data=get_support_data, $
                    trange=trange, $
                    verbose=verbose, $
                    downloadonly=downloadonly, $
                    no_download=no_download

 PURPOSE:
   loads the EISCAT radar data.

 KEYWORDS:
   site  = Combination of observatory and antenna, example, 
           erg_load_eiscat, site='esr_42m',
           the default is 'all', i.e., load all available sites.
           This can be an array of strings, e.g., ['esr_32m', 'esr_42m']
           or a single string delimited by spaces, e.g., 'esr_32m esr_42m'.
   ydatatype = data type of y-axis. Default is 'alt', i.e., altitude.
   trange = (Optional) Time range of interest  (2 element array).
   /get_support_data : turn this on to load the supporting data.
   /verbose: set to output some useful info
   /downloadonly: if set, then only download the data, do not load it 
           into variables.
   /no_download: use only files which are online locally.

 EXAMPLE:
   iug_load_eiscat, site='esr_42m', $
                 trange=['2011-2-1/00:00:00','2011-2-3/00:00:00']

   For more information, see http://www.iugonet.org/en/ 
                         and http://polaris.nipr.ac.jp/~eiscat/eiscatdata/

 Written by: Y.-M. Tanaka, July 25, 2011 (ytanaka at nipr.ac.jp)
 Modified by: Y.-M. Tanaka, August 24, 2011
   Separated "print_str_maxlet" to another file. 
 Modified by: Y.-M. Tanaka, December 1, 2011
   to load data with various int_times separately to different tplot
   vars.
 Modified by: Y.-M. Tanaka, June 6, 2012
   Integragted all pulse_code and integration_time data for one day 
   into a CDF file

(See iugonet/load/iug_load_eiscat.pro)


IUG_LOAD_EISCAT_VECVEL

[Previous Routine] [Next Routine] [List of Routines]
PROCEDURE: IUG_LOAD_EISCAT_VECVEL,
  iug_load_eiscat_vecvel, site = site, trange = trange, 
         verbose = verbose, downloadonly = downloadonly

PURPOSE:
  Loads 3D ion velocity data obtained with EISCAT UHF radar/ESR.

KEYWORDS:
  site  = Observatory name.  For example, serc_load_gmag_sample, site = 'tro'.
          The default is 'all', i.e., load all available stations.
  /verbose, if set, then output some useful info
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

EXAMPLE:
  iug_load_eiscat_vecvel, site = 'tro_uhf'

 Written by: Y. Ogawa, Feb. 25, 2012 (yogawa at nipr.ac.jp)

(See iugonet/load/iug_load_eiscat_vecvel.pro)


IUG_LOAD_GMAG_MM210

[Previous Routine] [Next Routine] [List of Routines]
 PROCEDURE: iug_load_gmag_mm210
   to load the 210 MM geomagnetic data from the STEL ERG-SC site 

 NOTE: This procedure is a simple alias to "erg_load_gmag_mm210" 
   and calls the original one by just providing the same 
   arguments/keywords given.
   Some load procedures for the ground-based observational data 
   in the  ERG mission, named "erg_load_???", can be also called  
   by "iug_load_???", because these data are related to the both 
   ERG and IUGONET projects.
   For more information, see http://www.iugonet.org/en/ 
                         and http://gemsissc.stelab.nagoya-u.ac.jp/erg/
   See the rules of the road.
   For more information, see http://stdb2.stelab.nagoya-u.ac.jp/mm210/

 KEYWORDS:
   site  = Observatory name, example, iug_load_gmag_mm210, site='rik',
           the default is 'all', i.e., load all available stations.
           This can be an array of strings, e.g., ['rik', 'onw']
           or a single string delimited by spaces, e.g., 'rik onw'.
           Sites:  tik zgn yak irt ppi bji lnp mut ptn wtk
                   lmt kat ktn chd zyk mgd ptk msr rik onw
                   kag ymk cbi gua yap kor ktb bik wew daw
                   wep bsv dal can adl kot cst ewa asa mcq
   datatype = Time resolution. '1min' for 1 min, and '1h' for 1 h.
              The default is '1min'.
   /downloadonly, if set, then only download the data, do not load it into variables.
   trange = (Optional) Time range of interest  (2 element array).

 EXAMPLE:
   iug_load_gmag_mm210, site='rik onw', datatype='1min', $
                        trange=['2003-11-20/00:00:00','2003-11-21/00:00:00']

 Written by: Y.-M Tanaka, Apr 22, 2010 (ytanaka at nipr.ac.jp)

   $LastChangedBy$
   $LastChangedDate$
   $LastChangedRevision$
   $URL$

(See iugonet/load/iug_load_gmag_mm210.pro)


IUG_LOAD_GMAG_NIPR

[Previous Routine] [Next Routine] [List of Routines]
 PROCEDURE: IUG_LOAD_GMAG_NIPR
   iug_load_gmag_nipr, site = site, $
                     datatype=datatype, $
                     trange=trange, $
                     verbose=verbose, $
                     downloadonly=downloadonly
                     no_download=no_download

 PURPOSE:
   Loads the fluxgate magnetometer data obtained by NIPR.

 NOTE: This procedure is a simple alias to "erg_load_gmag_nipr" 
   and calls the original one by just providing the same 
   arguments/keywords given.
   Some load procedures for the ground-based observational data 
   in the  ERG mission, named "erg_load_???", can be also called  
   by "iug_load_???", because these data are related to the both 
   ERG and IUGONET projects.
   For more information, see http://www.iugonet.org/en/ 
                         and http://gemsissc.stelab.nagoya-u.ac.jp/erg/

 KEYWORDS:
   site  = Observatory name, example, iug_load_gmag_nipr, site='syo',
           the default is 'all', i.e., load all available stations.
           This can be an array of strings, e.g., ['syo', 'hus']
           or a single string delimited by spaces, e.g., 'syo hus'.
           Available sites: syo hus tjo aed isa
   datatype = Time resolution. Please notice that '1sec' means nearly
           1-sec time resolution. Even if datatype was set to '1sec', 
           the time resolution corresponds to
           2sec : syo(1981-1997), hus & tjo(1984-2001/08), isa(1984-1989), 
                  aed(1989-1999/10)
           1sec : syo(1997-present)
           0.5sec  : hus & tjo(2001/09-present), aed(2001/09-2008/08)
           Available datatype: 1sec(default) or 20hz
   trange = (Optional) Time range of interest  (2 element array).
   /verbose : set to output some useful info
   /downloadonly: if set, then only download the data, do not load it 
           into variables.
   /no_download: use only files which are online locally.

 EXAMPLE:
   iug_load_gmag_nipr, site='syo', $
                 trange=['2003-11-20/00:00:00','2003-11-21/00:00:00']

 Written by Y.-M. Tanaka, December 24, 2010 (ytanaka at nipr.ac.jp)

(See iugonet/load/iug_load_gmag_nipr.pro)


IUG_LOAD_GMAG_NIPR_INDUCTION

[Previous Routine] [Next Routine] [List of Routines]
 PROCEDURE: iug_load_gmag_nipr_induction
   to load NIPR induction magnetometer data 

 KEYWORDS:
   site  = Observatory name, example, iug_load_gmag_nipr_induction, site='syo',
           the default is 'all', i.e., load all available stations.
           This can be an array of strings, e.g., ['syo', 'hus']
           or a single string delimited by spaces, e.g., 'syo hus'.
           Available sites: syo hus tjo aed isa
   /downloadonly, if set, then only download the data, do not load it into variables.
   /no_server, use only files which are online locally.
   /no_download, use only files which are online locally. (Identical to no_server keyword.)
   trange = (Optional) Time range of interest  (2 element array).
   frequency_dependent = get frequecy-dependent sensitivity
            (frequency [Hz] and sensitivity (H,D,Z) [Vp-p])

 EXAMPLE:
   iug_load_gmag_nipr_induction, site='syo', $
         trange=['2008-02-28/00:00:00','2008-02-28/02:00:00']

 Written by: Y. Miyashita, Jan 23, 2011
             ERG-Science Center, STEL, Nagoya Univ.
             erg-sc-core at st4a.stelab.nagoya-u.ac.jp
 Revised for NIPR data by Y. Sato, August 6, 2012 (sato.yuka at nipr.ac.jp)

(See iugonet/load/iug_load_gmag_nipr_induction.pro)


IUG_LOAD_GMAG_SERC

[Previous Routine] [Next Routine] [List of Routines]
PROCEDURE: IUG_LOAD_GMAG_SERC,
  iug_load_gmag_serc, site = site, datatype = datatype, $
                      trange = trange, verbose = verbose, $
                      downloadonly = downloadonly
PURPOSE:
  This procedure allows you to download and plot MAGDAS 1-minute
  averaged magnetometer data on TDAS.
  It is currently applicable only to MAGDAS 1-minute averaged
  data observed during recent WHI campaign (from March 20 to April 16, 2008).
  You can see more details about this data:
  http://magdas.serc.kyushu-u.ac.jp/whi/index.php
  Future data release is a work in progress.

KEYWORDS:
  site  = Observatory name.  For example, serc_load_gmag_sample, site = 'kuj'.
          The default is 'all', i.e., load all available stations.
  datatype = The type of data to be loaded.  In this sample
             procedure, there is only one option, the default value of 'mag'.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /verbose, if set, then output some useful info
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

EXAMPLE:
  iug_load_gmag_serc, site = 'kuj', trange = ['2007-01-22/00:00:00','2007-01-24/00:00:00']

CODE:
  Shuji Abe

CHANGELOG:
  07-April-2010, abeshu, test release.
  08-April-2010, abeshu, minor update.
  14-November-2010, abeshu, update.
  08-March-2011, abeshu, update.
  01-May-2011, abeshu, modify title and ylabel on tdas plot.
  09-May-2011, abeshu, modify the rules of the road.
  12-Jan-2012, abeshu, add default colors.
  21-Jan-2012, abeshu, change default color of total magnetic field.

ACKNOWLEDGMENT:


 $LastChangedBy: $
 $LastChangedDate: $
 $LastChangedRevision: $
 $URL: $

(See iugonet/load/iug_load_gmag_serc.pro)


IUG_LOAD_GMAG_STEL_INDUCTION

[Previous Routine] [Next Routine] [List of Routines]
 PROCEDURE: iug_load_gmag_stel_induction

 PURPOSE:
   To load STEL induction magnetometer data from the STEL ERG-SC site 

 NOTE: 
   This procedure is a simple alias to "iug_load_gmag_stel_induction"
   and calls the original one by just providing the same
   arguments/keywords given.
   Some load procedures for the ground-based observational data
   in the  ERG mission, named "erg_load_???", can be also called
   by "iug_load_???", because these data are related to the both
   ERG and IUGONET projects.
   For more information, see http://www.iugonet.org/en/
                         and http://gemsissc.stelab.nagoya-u.ac.jp/erg/
   See the rules of the road.
   For more information, see http://stdb2.stelab.nagoya-u.ac.jp/magne/

 KEYWORDS:
   site  = Observatory name, example, iug_load_gmag_stel_induction, site='msr',
           the default is 'all', i.e., load all available stations.
           This can be an array of strings, e.g., ['msr', 'sta']
           or a single string delimited by spaces, e.g., 'msr sta'.
           Sites: ath mgd ptk msr sta
   /downloadonly, if set, then only download the data, do not load it into variables.
   /no_server, use only files which are online locally.
   /no_download, use only files which are online locally. (Identical to no_server keyword.)
   trange = (Optional) Time range of interest  (2 element array).
   frequency_dependent = get frequecy-dependent sensitivity and phase difference
            (frequency [Hz], sensitivity (H,D,Z) [V/nT], and phase_difference (H,D,Z) [deg])
   /time_pulse, get time pulse

 EXAMPLE:
   iug_load_gmag_stel_induction, site='msr sta', $
         trange=['2008-02-28/00:00:00','2008-02-28/02:00:00']

 Written by: Y.-M Tanaka, Apr 12, 2013 (ytanaka at nipr.ac.jp)

(See iugonet/load/iug_load_gmag_stel_induction.pro)


IUG_LOAD_GMAG_WDC

[Previous Routine] [Next Routine] [List of Routines]
PROCEDURE: IUG_LOAD_GMAG_WDC
 iug_load_gmag_wdc, site=site, $
                        trange=trange, $
                        resolution = resolution, $
                        level=level, $
                        verbose=verbose, $
                        addmaster=addmaster, $
                        downloadonly=downloadonly, $
                        no_download=no_download

PURPOSE:
  Loading geomag data in WDC format from WDC for Geomag Kyoto.

KEYWORDS:
  site  = Station ABB code or name of geomagnetic index.
          Ex1) iug_load_gmag_wdc, site = 'kak', ...
          Ex2) iug_load_gmag_wdc, site = ['dst', 'ae'], ...
          If you skip this option, AE Dst SYM/ASY and KAK data are retrieved.
  trange= (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full month, a full
          month's data is loaded.
  reolution = Time resolution of the data: 'min' or 'hour',
          default set to 'min' for AE index and geomag data.
  level = The level of the data, the default is 'final' for geomag data.
          For AE and Dst index, the default is ['final', 'provsional'].
  /verbose : set to output some useful info.
  /addmaster, if set, then times = [!values.d_nan, times]
  /downloadonly, if set, then only download the data, do not load it
                 into variables.
  no_download: use only files which are online locally.

EXAMPLE:
   timespan, '2007-01-22',1,/days
   iug_load_gmag_wdc, site = 'ae', resolution = 'min'

NOTES:
  At WDC Kyoto, data service for TDAS clients is beta testing.
  Please check the data catalog at http://wdc-data.iugonet.org/.

Written by:  Daiki Yoshida,  Aug 2010
Last Updated:  Yukinobu KOYAMA,  Oct 21, 2011
 

(See iugonet/load/iug_load_gmag_wdc.pro)


IUG_LOAD_GMAG_WDC_CREATE_TPLOT_VARS

[Previous Routine] [Next Routine] [List of Routines]
Procedure: IUG_LOAD_GMAG_WDC_CREATE_TPLOT_VARS
 iug_load_gmag_wdc_create_tplot_vars, $
    sname = sname, $
    element = element, $
    resolution = res, $
    level = level, $
    tplot_name, $
    tplot_ytitle, tplot_ysubtitle, tplot_labels, $
    tplot_colors, tplot_dlimit

Notes:
  This procedure is called from load procedures for WDC format data,
  'iug_load_gmag_wdc*' provided by WDC Kyoto.

Written by:  Daiki Yoshida,  Aug 2010
Updated by:  Daiki Yoshida,  Sep 14, 2010
Updated by:  Daiki Yoshida,  Nov 12, 2010
Updated by:  Daiki Yoshida,  Jan 11, 2011
Updated by:  Yukinobu KOYAMA, Jan 21, 2012

(See iugonet/load/iug_load_gmag_wdc_create_tplot_vars.pro)


IUG_LOAD_GMAG_WDC_QDDAYS

[Previous Routine] [Next Routine] [List of Routines]
FUNCTION: IUG_LOAD_GMAG_WDC_QDDAYS
 function iug_load_gmag_wdc_qddays, $
    trange=trange, $
    verbose=verbose, $
    downloadonly=downloadonly, $
    no_download=no_download

Purpose:
  Load date list of International 5/10 quietest days
  and International 5 disturbed days from WDC Kyoto.

Keywords:
  trange= (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full month, a full
          month's data is loaded
  /verbose : set to output some useful info
  /downloadonly, if set, then only download the data, do not load it
                 into variables.
  no_download: use only files which are online locally.

Example:
  THEMIS> timespan, '2001-1-1'
  THEMIS> qdays = iug_load_gmag_wdc_qddays(/no_download)
  THEMIS> help, qdays, /str
  QDAYS            INT       = Array[12, 12]
  THEMIS> print, qdays[0,*]
   2001       1       1      30       6       2      19      18      27       7       5       9

Notes:
  International Q-Days and D-Days are now derived by
  GeoForschungsZentrum (GFZ) Potsdam from Kp index.
  reference: http://wdc.kugi.kyoto-u.ac.jp/qddays/index.html

Written by:  Daiki Yoshida,  Aug 2010
Last Updated:  Daiki Yoshida,  Jan 11, 2010
 

(See iugonet/load/iug_load_gmag_wdc_qddays.pro)


IUG_LOAD_GMAG_WDC_RELPATH

[Previous Routine] [Next Routine] [List of Routines]
Function: IUG_LOAD_GMAG_WDC_RELPATH
function iug_load_gmag_wdc_relpath, sname = sname, $
                                    trange = trange, $
                                    resolution = res, $
                                    level = level, $
                                    addmaster = addmaster, $
                                    _extra = _extra

Purpose:
  create relpath string from abb code

Notes:
  This procedure is called from load procedures for WDC format data,
  'iug_load_gmag_wdc*' provided by WDC Kyoto.


Written by:  Daiki Yoshida,  Aug 2010
Updated by:  Daiki Yoshida,  Sep 14, 2010

(See iugonet/load/iug_load_gmag_wdc_relpath.pro)


IUG_LOAD_GMAG_WDC_RELPATH_TO_YEAR

[Previous Routine] [Next Routine] [List of Routines]
Function: IUG_LOAD_GMAG_WDC_RELPATH_TO_YEAR
function iug_load_gmag_wdc_relpath_to_year

Purpose:
  get year from data path string

Notes:
  This procedure is called from load procedures for WDC format data,
  'iug_load_gmag_wdc*' provided by WDC Kyoto.


Written by:  Daiki Yoshida,  Aug 2010
Updated by:  Daiki Yoshida,  Sep 14, 2010

(See iugonet/load/iug_load_gmag_wdc_relpath_to_year.pro)


IUG_LOAD_GMAG_WDC_VSNAMES

[Previous Routine] [Next Routine] [List of Routines]
Function: IUG_LOAD_GMAG_WDC_VSNAMES
function iug_load_gmag_wdc_vsnames

Purpose:
  return valid site names for WDC data.

Notes:
  This procedure is called from load procedures for WDC format data,
  'iug_load_gmag_wdc*' provided by WDC Kyoto.
  WDC station list was provided at online data catalogue:
  http://wdc.kugi.kyoto-u.ac.jp/catmap/obs.html

Todo:
  1) Modify to read station-list file.
  2) Modify to get station-list files from cgi or mdb via file_transfer.


Written by:  Daiki Yoshida,  Sep 14, 2010

(See iugonet/load/iug_load_gmag_wdc_vsnames.pro)


IUG_LOAD_GMAG_WDC_WDCHR

[Previous Routine] [Next Routine] [List of Routines]
Procedure: IUG_LOAD_GMAG_WDC_WDCHR
pro iug_load_gmag_wdc_wdchr, $
    site = site, $
    trange = trange, $
    verbose = verbose, $
    level = level, $
    addmaster = addmaster, $
    downloadonly = downloadonly, $
    no_download = no_download

Purpose:
  Loading geomag hourly mean data in WDC format from WDC for Geomag Kyoto.

Notes:
  This procedure is called from 'iug_load_gmag_wdc' provided by WDC Kyoto.
  References about Dst index and WDC hourly means record format:
  http://wdc.kugi.kyoto-u.ac.jp/hyplt/format/wdchrformat.html
  http://wdc.kugi.kyoto-u.ac.jp/dstae/format/dstformat.html

Written by:  Daiki Yoshida,  Aug 2010
Updated by:  Daiki Yoshida,  Sep 14, 2010
Updated by:  Daiki Yoshida,  Sep 28, 2010
Updated by:  Daiki Yoshida,  Nov 12, 2010
Updated by:  Daiki Yoshida,  Jan 11, 2011
Updated by:  Daiki Yoshida,  Mar 1, 2011

(See iugonet/load/iug_load_gmag_wdc_wdchr.pro)


IUG_LOAD_GMAG_WDC_WDCMIN

[Previous Routine] [Next Routine] [List of Routines]
Procedure: IUG_LOAD_GMAG_WDC_WDCMIN
pro iug_load_gmag_wdc_wdcmin, $
    site = site, $
    trange = trange, $
    verbose = verbose, $
    level = level, $
    addmaster = addmaster, $
    downloadonly = downloadonly, $
    no_download = no_download

Purpose:
  Loading geomag 1-min record data in WDC format from WDC for Geomag Kyoto.

Notes:
  This procedure is called from 'iug_load_gmag_wdc' provided by WDC Kyoto.
  References about WDC 1-min record, ASY/SYM index and AE index record format:
  http://wdc.kugi.kyoto-u.ac.jp/mdplt/format/wdcformat.html
  http://wdc.kugi.kyoto-u.ac.jp/aeasy/format/asyformat.html
  http://wdc.kugi.kyoto-u.ac.jp/aeasy/format/aeformat.html

Written by:  Daiki Yoshida,  Aug 2010
Updated by:  Daiki Yoshida,  Sep 13, 2010
Updated by:  Daiki Yoshida,  Sep 28, 2010
Updated by:  Daiki Yoshida,  Nov 12, 2010
Updated by:  Daiki Yoshida,  Jan 11, 2011
Updated by:  Daiki Yoshida,  Mar 1, 2011
Updated by:  Yukinobu KOYAMA, Jan 21, 2011

(See iugonet/load/iug_load_gmag_wdc_wdcmin.pro)


IUG_LOAD_HF_TOHOKUU

[Previous Routine] [Next Routine] [List of Routines]
 PROCEDURE: iug_load_hf_tohokuu

 PURPOSE:
   To load the Jupiter's/solar wide band spectral data in HF-band 

 KEYWORDS:
   site  = Observatory name. Only 'iit' is allowed.
   parameter = The polarization of the radiowave.
               'RH' for right handed, and 'LH' for left handed.
   /downloadonly, if set, then only download the data, do not load it into variables.
   /no_download: use only files which are online locally.
   trange = (Optional) Time range of interest  (2 element array).

 EXAMPLE:
   iug_load_lfrto, site='ath', datatype='30sec', $
                        trange=['2010-10-24/00:00:00','2010-10-25/00:00:00']

 NOTE: See the rules of the road.
       For more information, see http://iprt.gp.tohoku.ac.jp/

 Written by: M.Yagi, Oct 2, 2012
             PPARC, Tohoku Univ.

   $LastChangedBy: M.Yagi $
   $LastChangedDate: 2013-01-09 $
   $URL:

(See iugonet/load/iug_load_hf_tohokuu.pro)


IUG_LOAD_IONOSONDE_RISH

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

NAME:
iug_load_ionosonde_rish

PURPOSE:
  Queries the RISH server for the ionogram data taken by the ionosonde 
  at Shigaraki and loads data into tplot format.

SYNTAX:
 iug_load_ionosonde_rish, datatype = datatype, site=site, $
                    downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_ionosonde_rish, datatype = 'ionosphere'.
            The default is 'ionosphere'. 
  site = Ionosonde observation site.  
         For example, iug_load_ionosonde_rish, site = 'sgk'.
         The default is 'all', i.e., load all available observation points.
  /fixed_freq, if set, then tplot variables for every fixed frequency (2-18 MHZ) are created.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
  A. Shinbori, 24/10/2012.
  
MODIFICATIONS:
  A. Shinbori, 12/11/2012.
  A. Shinbori, 18/12/2012.
  A. Shinbori, 09/01/2013.
  A. Shinbori, 18/02/2013.
   
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_ionosonde_rish.pro)


IUG_LOAD_IPRT

[Previous Routine] [Next Routine] [List of Routines]
Procedure: iug_load_iprt,
  iug_load_iprt, site = site, datatype = datatype, $
           trange = trange, verbose = verbose, $
           downloadonly = downloadonly
Purpose:
  This procedure allows you to download and plot TOHOKUU_RADIO OBSERVATION data on TDAS.
  This is a sample code for IUGONET analysis software.

Keywords:
  site  = Observatory name. Only 'iit' is allowed.
  datatype = The type of data to be loaded.  In this sample
             procedure, there is only one option, the default value of 'Sun'.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /verbose, if set, then output some useful info
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

 PROCEDURES USED:
  fits_read, sxpar, fits_open, fits_close, gettok, sxdelpar, sxaddpar, valid_num
  For the use of this procedure, get FITS I/O procedures from
  the IDL Astronomy Library (http://idlastro.gsfc.nasa.gov/fitsio.html).
  You can download these procedures by running get_fitslib.


Example:
 timespan,'2010-11-03',1,/hours
  iug_load_iprt
  tplot_names
  zlim,'iprt_sun_L',20,120
  zlim,'iprt_sun_R',20,120
  tplot,['iprt_sun_L','iprt_sun_R']


Code:
  Shuji Abe, revised by M. Kagitani

ChangeLog:
  7-April-2010, abeshu, test release.
  8-April-2010, abeshu, minor update.
  27-JUL.-2010, revised for this procedure by M. Kagitani
  12-NOV.-2010, revised by M. Kagitani
  25-NOV.-2010, renamed to 'iug_load_iprt.pro' by M. Kagitani

Acknowledgment:


 $URL: $

(See iugonet/load/iug_load_iprt.pro)


IUG_LOAD_IRIO_NIPR

[Previous Routine] [Next Routine] [List of Routines]
 PROCEDURE: IUG_LOAD_IRIO_NIPR
   iug_load_irio_nipr, site = site, $
                     datatype=datatype, $
                     trange=trange, $
                     verbose=verbose, $
                     downloadonly=downloadonly, $
                     no_download=no_download

 PURPOSE:
   Loads the imaging riometer data obtained by NIPR.

 KEYWORDS:
   site  = Observatory name, example, iug_load_irio_nipr, site='syo',
           the default is 'all', i.e., load all available stations.
           This can be an array of strings, e.g., ['syo', 'hus']
           or a single string delimited by spaces, e.g., 'syo hus'.
           Available sites as of April, 2013 : syo
   datatype = observation frequency in MHz for imaging riometer
           At present, '30' or '38' is only available for datatype.
   trange = (Optional) Time range of interest  (2 element array).
   /verbose: set to output some useful info
   /downloadonly: if set, then only download the data, do not load it 
           into variables.
   /no_download: use only files which are online locally.

 EXAMPLE:
   iug_load_gmag_nipr, site='syo', $
                 trange=['2003-11-20/00:00:00','2003-11-21/00:00:00']

 Written by Y.-M. Tanaka, December, 2012 (ytanaka at nipr.ac.jp)

(See iugonet/load/iug_load_irio_nipr.pro)


IUG_LOAD_LFRTO

[Previous Routine] [Next Routine] [List of Routines]
 PROCEDURE: iug_load_lfrto

 PURPOSE:
   To load the Low Frequency Radio Transmitter Observation data from the Tohoku University site 

 KEYWORDS:
   site  = Observatory name, example, iug_load_lfrto, site='ath',
           the default is 'ath', athabasca station.
           This can be an array of strings, e.g., ['ath', 'nal']
           or a single string delimited by spaces, e.g., 'ath nal'.
           Sites:  ath nal
   trans = Transmitter code, example, iug_load_lfrto, trans='wwvb',
           the default is 'all', i.e., load all available transmitter.
           This can be an array of strings, e.g., ['wwvb', 'ndk']
           or a single string delimited by spaces, e.g., 'wwvb ndk'.
           Transmitter:  wwvb ndk nlk npm nau nrk nwc msf dcf
   parameter = Parameter name.
               'power' or 'pow' for amplitude.
               'phase' or 'pha' for phase.
   datatype  = Time resolution. '30sec' or '30s' for 30 sec.
               The default is '30sec'.
   /downloadonly, if set, then only download the data, do not load it into variables.
   /no_download: use only files which are online locally.
   /verbose : set to output some useful info
   trange = (Optional) Time range of interest  (2 element array).

 EXAMPLE:
   iug_load_lfrto, site='ath', datatype='30sec', $
                        trange=['2011-05-29/00:00:00','2011-05-30/00:00:00']

 NOTE: See the rules of the road.
       For more information, see http://iprt.gp.tohoku.ac.jp/

 NAMING CONVENTIONS:
       lfrto_[site]_[trans]_[parameter+datatype]
       ex. lfrto_ath_wwvb_pow30s

 Written by: M.Yagi, Oct 2, 2012
             PPARC, Tohoku Univ.

   $LastChangedBy: M.Yagi $
   $LastChangedDate: 2013-01-09 $
   $URL:

(See iugonet/load/iug_load_lfrto.pro)


IUG_LOAD_LTR_RISH

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

NAME:
iug_load_ltr_rish

PURPOSE:
  Queries the Kyoto_RISH servers for the observation data (uwnd, vwnd, wwnd, pwr1-5, wdt1-5)
  in the CSV format taken by the L-band lower troposphere radar (LTR) and loads data into
  tplot format.

SYNTAX:
 iug_load_ltr_rish, datatype = datatype, site=site, parameter=parameter, $
                        downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_ltr_rish, datatype = 'troposphere'.
            The default is 'troposphere'. 
   site = LTR observation site.  
          For example, iug_load_ltr_rish, site = 'sgk'.
          The default is 'all', i.e., load all available observation points.
  parameter = parameter name of LTR obervation data.  
          For example, iug_load_ltr_rish, parameter = 'uwnd'.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 09/19/2010.

MODIFICATIONS:
 A. Shinbori, 03/24/2011.
 A. Shinbori, 12/26/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 10/02/2012.
 A. Shinbori, 18/12/2012.
  
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_ltr_rish.pro)


IUG_LOAD_METEOR_BIK_NC

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

NAME:
iug_load_meteor_bik_nc

PURPOSE:
  Queries the RISH servers for the meteor data (netCDF format) taken by 
  the meteor wind radar (MWR) at Biak and loads data into tplot format.

SYNTAX:
 iug_load_meteor_bik_nc, datatype = datatype, parameter = parameter, length = length, downloadonly = downloadonly, $
                           trange = trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_meteor_bik_nc, datatype = 'thermosphere'.
            The default is 'thermosphere'.
  length = Data length '1-day' or '1-month'. For example, iug_load_meteor_bik_nc, length = '1_day'.
           A kind of parameters is 2 types of '1_day', and '1_month'.  
 parameter = Data parameter. For example, iug_load_meteor_bik_nc, parameter = 'h2t60min00'. 
             A kind of parameters is 4 types of 'h2t60min00', 'h2t60min00', 'h4t60min00', 'h4t60min00'.
             The default is 'all'.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 23/09/2012.

MODIFICATIONS:

  
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_meteor_bik_nc.pro)


IUG_LOAD_METEOR_BIK_TXT

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

NAME:
iug_load_meteor_bik_txt

PURPOSE:
  Queries the Kyoto_RISH servers for the horizontal wind data (uwnd, vwnd, uwndsig, vwndsig, mwnum)
  in the text format taken by the meteor wind radar (MWR) at Biak and loads data into
  tplot format.

SYNTAX:
 iug_load_meteor_ktb_bik, datatype=daatype, parameter = parameter, length = length, downloadonly = downloadonly, $
                           trange = trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_meteor_ktb_nc, datatype = 'thermosphere'.
            The default is 'thermosphere'.
  length = Data length '1-day' or '1-month'. For example, iug_load_meteor_bik_txt, length = '1_day'.
           A kind of parameters is 2 types of '1_day', and '1_month'. 
  parameter = Data parameter. For example, iug_load_meteor_bik_txt, parameter = 'h2t60min00'. 
              A kind of parameters is 4 types of 'h2t60min00', 'h2t60min00', 'h4t60min00', 'h4t60min00'.
              The default is 'all'.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 15/07/2011.
 A. Shinbori, 19/01/2013.
 
MODIFICATIONS:
 

ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_meteor_bik_txt.pro)


IUG_LOAD_METEOR_KTB_NC

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

NAME:
iug_load_meteor_ktb_nc

PURPOSE:
  Queries the RISH servers for the meteor data (netCDF format) taken by 
  the meteor wind radar (MWR) at Kototabang and loads data into tplot format.

SYNTAX:
 iug_load_meteor_ktb_nc, datatype = datatype, parameter = parameter, length = length, downloadonly = downloadonly, $
                           trange = trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_meteor_ktb_nc, datatype = 'thermosphere'.
            The default is 'thermosphere'.
  length = Data length '1-day' or '1-month'. For example, iug_load_meteor_ktb_nc, length = '1_day'.
           A kind of parameters is 2 types of '1_day', and '1_month'.  
 parameter = Data parameter. For example, iug_load_meteor_ktb_nc, parameter = 'h2t60min00'. 
             A kind of parameters is 4 types of 'h2t60min00', 'h2t60min00', 'h4t60min00', 'h4t60min00'.
             The default is 'all'.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 11/07/2011.
 A. Shinbori, 06/10/2011.
 A. Shinbori, 27/12/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 28/05/2012.
 A. Shinbori, 12/06/2012.
 A. Shinbori, 25/07/2012.
 A. Shinbori, 18/12/2012.
  
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_meteor_ktb_nc.pro)


IUG_LOAD_METEOR_KTB_TXT

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

NAME:
iug_load_meteor_ktb_txt

PURPOSE:
  Queries the RISH servers for the meteor observation data (text format) taken by 
  the meteor wind radar (MWR) at Kototabang and loads data into tplot format.

SYNTAX:
 iug_load_meteor_ktb_txt, datatype=datatype, parameter = parameter, length = length, downloadonly = downloadonly, $
                           trange = trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_meteor_ktb_txt, datatype = 'thermosphere'.
            The default is 'thermosphere'.
  length = Data length '1-day' or '1-month'. For example, iug_load_meteor_ktb_txt, length = '1_day'.
           A kind of parameters is 2 types of '1_day', and '1_month'. 
  parameter = Data parameter. For example, iug_load_meteor_ktb_txt, parameter = 'h2t60min00'. 
              A kind of parameters is 4 types of 'h2t60min00', 'h2t60min00', 'h4t60min00', 'h4t60min00'.
              The default is 'all'.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 11/07/2011.
 A. Shinbori, 06/10/2011.
 A. Shinbori, 27/12/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 07/02/2012.
 A. Shinbori, 28/05/2012.
 A. Shinbori, 12/06/2012.
 A. Shinbori, 18/12/2012.
   
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_meteor_ktb_txt.pro)


IUG_LOAD_METEOR_NIPR

[Previous Routine] [Next Routine] [List of Routines]
 PROCEDURE: IUG_LOAD_METEOR_NIPR
   iug_load_meteor_nipr, site = site, trange = trange, $
       get_support_data = get_support_data, verbose = verbose, $
       downloadonly = downloadonly, no_download = no_download

 PURPOSE:
   loads meteor radar data of NIPR

 KEYWORDS:
   site  = Observatory name.  For example, iug_load_meteor_nipr, site = 'tro'.
   trange = (Optional) Time range of interest  (2 element array).
   /verbose: set to output some useful info
   /downloadonly: if set, then only download the data, do not load it 
           into variables.
   /no_download: use only files which are online locally.

 EXAMPLE:
   iug_load_meteor_nipr, site = 'tro', trange = ['2007-01-22/00:00:00','2007-01-24/00:00:00']

 Written by: Y.-M. Tanaka, July 25, 2011 (ytanaka at nipr.ac.jp)

(See iugonet/load/iug_load_meteor_nipr.pro)


IUG_LOAD_METEOR_RISH

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

NAME:
iug_load_meteor_rish

PURPOSE:
  Queries the RISH servers for the meteor observation data (netCDF format) taken by 
  the meteor wind radar (MWR) at Kototabang and Serpong and loads data into tplot format.

SYNTAX:
 iug_load_meteor_rish, datatype = datatype, site=site, parameter = parameter, $
                       downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
 datatype = Observation data type. For example, iug_load_meteor_rish, datatype = 'thermosphere'.
            The default is 'thermosphere'. 
   site  = Observatory code name.  For example, iug_load_meteor_rish, site = 'ktb'.
           The default is 'all', i.e., load all available stations.
  length = Data length '1-day' or '1-month'. For example, iug_load_meteor_rish, length = '1_day'.
           A kind of parameters is 2 types of '1_day', and '1_month'.
 parameter = Data parameter. For example, iug_load_meteor_rish, parameter = 'h2t60min00'. 
             A kind of parameters is 5 types of 'h2t60min00', 'h2t60min30', 'h4t60min00', 'h4t60min00', 'h4t240min00'.
             The default is 'h2t60min00'. 
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.


CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 11/05/2011.
 A. Shinbori, 28/05/2012.
 A. Shinbori, 24/07/2012.
 A. Shinbori, 19/01/2013.
  
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_meteor_rish.pro)


IUG_LOAD_METEOR_SRP_NC

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

NAME:
iug_load_meteor_srp_nc

PURPOSE:
  Queries the RISH servers for the meteor data (netCDF format) taken by 
  the meteor wind radar (MWR) at Serpong and loads data into tplot format.

SYNTAX:
 iug_load_meteor_srp_nc, datatype = datatype, parameter = parameter, length = length, downloadonly = downloadonly, $
                           trange = trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_meteor_srp_nc, datatype = 'thermosphere'.
            The default is 'thermosphere'.
  length = Data length '1-day' or '1-month'. For example, iug_load_meteor_srp_nc, length = '1_day'.
           A kind of parameters is 2 types of '1_day', and '1_month'. 
  parameter = Data parameter. For example, iug_load_meteor_srp_nc, parameter = 'h2t60min00'. 
             A kind of parameters is 2 types of 'h2t60min00', 'h4t60min00'.
             The default is 'all'.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 11/07/2011.
 A. Shinbori, 06/10/2011.
 A. Shinbori, 27/12/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 28/05/2012.
 A. Shinbori, 12/06/2012.
 A. Shinbori, 25/07/2012.
 A. Shinbori, 18/12/2012.
  
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_meteor_srp_nc.pro)


IUG_LOAD_METEOR_SRP_TXT

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

NAME:
iug_load_meteor_srp_txt

PURPOSE:
  Queries the RISH servers for the meteor data (text format) taken by 
  the meteor wind radar (MWR) at Serpong and loads data into tplot format.

SYNTAX:
 iug_load_meteor_srp_txt, datatype = datatype, parameter = parameter, length=length, downloadonly = downloadonly, $
                          trange = trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_meteor_srp_txt, datatype = 'thermosphere'.
            The default is 'thermosphere'. 
  length = Data length '1-day' or '1-month'. For example, iug_load_meteor_srp_txt, length = '1_day'.
           A kind of parameters is 2 types of '1_day', and '1_month'.
  parameter = Data parameter. For example, iug_load_meteor_srp_txt, parameter = 'h2t60min00'. 
              A kind of parameters is 4 types of 'h2t60min00', 'h2t60min00', 'h4t60min00', 'h4t60min00'.
              The default is 'all'.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 11/07/2011.
 A. Shinbori, 06/10/2011.
 A. Shinbori, 27/12/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 07/02/2012.
 A. Shinbori, 28/05/2012.
 A. Shinbori, 12/06/2012.
 A. Shinbori, 18/12/2012.
  
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_meteor_srp_txt.pro)


IUG_LOAD_MF_RISH

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

NAME:
iug_load_mf_rish

PURPOSE:
  Queries the Kyoto_RISH servers for the observation data (uwind, vwind, wwind)
  in the NetCDF format taken by the MF radar at Pameungpeuk and loads data into
  tplot format.

SYNTAX:
 iug_load_mf_rish, datatype = datatype, site=site, downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
 datatype = Observation data type. For example, iug_load_mf_rish, datatype = 'thermosphere'.
            The default is 'thermosphere'. 
   site  = Observatory code name.  For example, iug_load_mf_rish, site = 'pam'.
          The default is 'all', i.e., load all available stations.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 09/19/2010.

MODIFICATIONS:
 A. Shinbori, 03/24/2011.
 A. Shinbori, 02/04/2013.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mf_rish.pro)


IUG_LOAD_MF_RISH_PAM_BIN

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

NAME:
iug_load_mf_rish_pam_bin

PURPOSE:
  Queries the Kyoto_RISH servers for the observation data (uwind, vwind, wwind)
  in the binary format (SSWMA) taken by the MF radar at Pameungpeuk and loads data into
  tplot format.

SYNTAX:
 iug_load_mf_rish_pam_bin, datatype = datatype, site=site, downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_mf_rish_pam_bin, datatype = 'thermosphere'.
            The default is 'thermosphere'.
   site  = Observatory code name.  For example, iug_load_mf_rish_pam_bin, site = 'pam'.
          The default is 'all', i.e., load all available stations.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 09/19/2010.

MODIFICATIONS:
 A. Shinbori, 03/24/2011.
 A. Shinbori, 27/12/2011.
 A. Shinbori, 24/12/2011.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mf_rish_pam_bin.pro)


IUG_LOAD_MF_RISH_PAM_NC

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

NAME:
iug_load_mf_rish_pam_nc

PURPOSE:
  Queries the Kyoto_RISH servers for the observation data (uwind, vwind, wwind)
  in the NetCDF format taken by the MF radar at Pameungpeuk and loads data into
  tplot format.

SYNTAX:
 iug_load_mf_rish_pam_nc, datatype = datatype, site=site, downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_mf_rish_pam_nc, datatype = 'thermosphere'.
            The default is 'thermosphere'. 
   site  = Observatory code name.  For example, iug_load_mf_rish_pam_nc, site = 'pam'.
          The default is 'all', i.e., load all available stations.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.
                 
CODE:
 A. Shinbori, 09/19/2010.

MODIFICATIONS:
 A. Shinbori, 03/24/2011.
 A. Shinbori, 27/12/2011.
 A. Shinbori, 31/10/2012.
 A. Shinbori, 24/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mf_rish_pam_nc.pro)


IUG_LOAD_MF_RISH_PON_NC

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

NAME:
iug_load_mf_rish_pon_nc

PURPOSE:
  Queries the Kyoto_RISH servers for the observation data (uwind, vwind, wwind)
  in the NetCDF format taken by the MF radar at Pontianak and loads data into
  tplot format.

SYNTAX:
 iug_load_mf_rish_pon_nc, datatype = datatype, site=site, downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_mf_rish_pon_nc, datatype = 'thermosphere'.
            The default is 'thermosphere'. 
   site  = Observatory code name.  For example, iug_load_mf_rish_pon_nc, site = 'pon'.
          The default is 'all', i.e., load all available stations.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.
                 
CODE:
 A. Shinbori, 18/01/2013.

MODIFICATIONS:

 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mf_rish_pon_nc.pro)


IUG_LOAD_MF_RISH_PON_TXT

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

Name:
iug_load_mf_rish_pon_txt

Purpose:
  Queries the Kyoto_RISH renkei2 servers for pontianak data and loads data into
  tplot format.

Syntax:
 iug_load_mf_rish_pon_txt, datatype = datatype, site = site, downloadonly = downloadonly, trange = trange, verbose = verbose

Keywords:
  datatype = Observation data type. For example, iug_load_mf_rish_pon_txt, datatype = 'thermosphere'.
            The default is 'thermosphere'. 
   site  = Observatory code name.  For example, iug_load_mf_rish_pon_txt, site = 'pon'.
          The default is 'all', i.e., load all available stations.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.


Code:
  A. Shinbori, 10/09/2010.

Modifications:
  A. Shinbori, 05/06/2011.

  
Acknowledgment:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mf_rish_pon_txt.pro)


IUG_LOAD_MU

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

NAME:
iug_load_mu

PURPOSE:
  Queries the Kyoto_RISH servers for all the observation data taken by 
  the Middle and Upper atmosphere (MU) radar at Shigaraki and loads data into
  tplot format.

SYNTAX:
  iug_load_mu [ ,DATATYPE = string ]
              [ ,LEVEL = string ]
              [ ,PARAMETER = string ]
              [ ,TRANGE = [min,max] ]
              [ ,FILENAMES = string scalar or array ]
              [ , ]

KEYWOARDS:
  DATATYPE = The type of data to be loaded. In this load program,
             DATATYPEs are 'troposphere' etc.
  LEVEL = The level of mesospheric data to be loaded. In this load program,
             LEVELs are 'org' and 'scr'.
  PARAMETER = The parameter of meteor data to be loaded. In this load program,
             PARAMETERs are 'h1t60min00','h1t60min30','h2t60min00' and 'h2t60min30'.
  LENGTH = The file type of meteor data to be loaded.
             LENGTHs are '1-day' and '1-month'. Default is 1-day.
  TRANGE (In):
    Pass a time range a la TIME_STRING.PRO.
  FILENAMES (In):
    *PRESENTLY DISABLED* Pass user-defined file names (full paths to local data files).  These will
      be read a la the RISH format, and the RISH server will not be queried.
  VERBOSE (In): [1,...,5], Get more detailed (higher number) command line output.

CODE:
 A. Shinbori, 09/19/2010.

MODIFICATIONS:
 A. Shinbori, 03/24/2011.
 A. Shinbori, 08/08/2012.
 A. Shinbori, 04/10/2012.
 A. Shinbori, 12/11/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mu.pro)


IUG_LOAD_MU_IONO_DRIFT_NC

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

NAME:
iug_load_mu_iono_drift_nc

PURPOSE:
  Queries the Kyoto_RISH servers for ionospheric plasma drift velocity in netCDF format 
  estimated from the incoherent scatter observation of the MU radar at Shigaraki 
  and loads data into tplot format.

SYNTAX:
 iug_load_mu_iono_drift_nc, datatype = datatype, downloadonly = downloadonly, $
                          trange = trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_mu_iono_drift_nc, datatype = 'ionosphere'.
            The default is 'ionosphere'.  
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 03/10/2012.

MODIFICATIONS:
 A. Shinbori, 12/11/2012. 
 A. Shinbori, 24/12/2012. 
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mu_iono_drift_nc.pro)


IUG_LOAD_MU_IONO_DRIFT_TXT

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

NAME:
iug_load_mu_iono_drift_txt

PURPOSE:
  Queries the Kyoto_RISH servers for ionospheric plasma drift velocity in text format 
  estimated from the incoherent scatter observation of the MU radar at Shigaraki 
  and loads data into tplot format.

SYNTAX:
 iug_load_mu_iono_drift_txt, datatype = datatype, downloadonly = downloadonly, $
                          trange = trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_mu_iono_drift_txt, datatype = 'ionosphere'.
            The default is 'ionosphere'.  
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 03/10/2012.

MODIFICATIONS:
 A. Shinbori, 12/11/2012.
 A. Shinbori, 24/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mu_iono_drift_txt.pro)


IUG_LOAD_MU_IONO_PWR_NC

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

NAME:
iug_load_mu_iono_pwr_nc

PURPOSE:
  Queries the Kyoto_RISH servers for ion and electron temperatures in netCDF format 
  estimated from the incoherent scatter observation of the MU radar at Shigaraki 
  and loads data into tplot format.

SYNTAX:
 iug_load_mu_iono_pwr_nc, datatype = datatype, downloadonly = downloadonly, $
                          trange = trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_mu_iono_pwr_nc, datatype = 'ionosphere'.
            The default is 'ionosphere'.  
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 02/10/2012.

MODIFICATIONS:
 A. Shinbori, 12/11/2012.
 A. Shinbori, 24/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mu_iono_pwr_nc.pro)


IUG_LOAD_MU_IONO_PWR_TXT

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

NAME:
iug_load_mu_iono_pwr_txt

PURPOSE:
  Queries the Kyoto_RISH servers for ion and electron temperatures in text format 
  estimated from the incoherent scatter observation of the MU radar at Shigaraki 
  and loads data into tplot format.

SYNTAX:
 iug_load_mu_iono_pwr_txt, datatype = datatype, parameter = parameter, downloadonly = downloadonly, $
                          trange = trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_mu_iono_pwr_txt, datatype = 'ionosphere'.
            The default is 'ionosphere'.
  parameter = parameter name of echo power data taken by the MU incherent scatter mode.  
          For example, iug_load_mu_iono_pwr_txt, parameter = 'pwr1'.
          The default is 'all', i.e., load all available parameters.  
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 03/10/2012.

MODIFICATIONS:
 A. Shinbori, 12/11/2012.
 A. Shinbori, 24/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mu_iono_pwr_txt.pro)


IUG_LOAD_MU_IONO_TETI_NC

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

NAME:
iug_load_mu_iono_teti_nc

PURPOSE:
  Queries the Kyoto_RISH servers for ion and electron temperatures in netCDF format 
  estimated from the incoherent scatter observation of the MU radar at Shigaraki 
  and loads data into tplot format.

SYNTAX:
 iug_load_mu_iono_teti_nc, datatype = datatype, downloadonly = downloadonly, $
                          trange = trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_mu_iono_teti_nc, datatype = 'ionosphere'.
            The default is 'ionosphere'.  
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 02/10/2012.

MODIFICATIONS:
 A. Shinbori, 12/11/2012. 
 A. Shinbori, 24/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mu_iono_teti_nc.pro)


IUG_LOAD_MU_IONO_TETI_TXT

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

NAME:
iug_load_mu_iono_teti_txt

PURPOSE:
  Queries the Kyoto_RISH servers for ion and electron temperatures in text format 
  estimated from the incoherent scatter observation of the MU radar at Shigaraki 
  and loads data into tplot format.

SYNTAX:
 iug_load_mu_iono_teti_txt, datatype = datatype, downloadonly = downloadonly, $
                          trange = trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_mu_iono_teti_txt, datatype = 'ionosphere'.
            The default is 'ionosphere'.  
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 03/10/2012.

MODIFICATIONS:
 A. Shinbori, 24/12/2012.

ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mu_iono_teti_txt.pro)


IUG_LOAD_MU_MESO_TXT

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

NAME:
iug_load_mu_meso_txt

PURPOSE:
  Queries the RISH servers for the standard observation data (CSV format) of the 
  mesosphere taken by the Middle and Upper atmosphere (MU) radar at Shigaraki and 
  loads data into tplot format.

SYNTAX:
 iug_load_mu_meso_txt, datatype = datatype, parameter1=parameter1, parameter2=parameter2 $
                          downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_mu_meso_txt, datatype = 'mesosphere'.
            The default is 'mesosphere'. 
  parameter1 = Parameter name of MU mesosphere obervation data.  
          For example, iug_load_mu_meso_txt, parameter1 = 'dpl1'.
          The default is 'all', i.e., load all available parameters.
  parameter2 = Choice of original and screening data of MU mesosphere obervation.  
          For example, iug_load_mu_meso_txt, parameter2 = 'screening'.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.


CODE:
 A. Shinbori, 25/07/2012.

MODIFICATIONS:
 A. Shinbori, 12/11/2012.
 A. Shinbori, 24/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mu_meso_txt.pro)


IUG_LOAD_MU_MESO_WIND_NC

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

NAME:
iug_load_mu_meso_wind_nc

PURPOSE:
  Queries the RISH servers for the 1-hour average wind data (netCDF format) of the 
  mesosphere taken by the Middle and Upper atmosphere (MU) radar at Shigaraki 
  and loads data into tplot format.

SYNTAX:
 iug_load_mu_meso_wind_nc, datatype = datatype, downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_mu_wind_meso_nc, datatype = 'mesosphere'.
            The default is 'mesosphere'.
  level = Observation data level. For example, iug_load_mu_wind_meso_nc, level = 'org'.
            For example, iug_load_mu_meso_txt, parameter2 = 'scr'.
            The default is 'all', i.e., load all available level data.           
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 21/07/2012.

MODIFICATIONS:
 A. Shinbori, 12/11/2012.
 A. Shinbori, 24/12/2012.
  
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mu_meso_wind_nc.pro)


IUG_LOAD_MU_MESO_WIND_TXT

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

NAME:
iug_load_mu_meso_wind_txt

PURPOSE:
  Queries the RISH servers for the 1-hour average wind data (CSV format) of the 
  mesosphere taken by the Middle and Upper atmosphere (MU) radar at Shigaraki 
  and loads data into tplot format.

SYNTAX:
 iug_load_mu_meso_wind_txt, datatype = datatype, downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_mu_wind_meso_txt, datatype = 'mesosphere'.
            The default is 'mesosphere'.
  parameter = parameter name of wind data in the mesosphere.  
          For example, iug_load_mu_meso_wind_txt, parameter = 'uwnd'.
          The default is 'all', i.e., load all available parameters.
  level = Observation data level. For example, iug_load_mu_wind_meso_txt, level = 'org'.
            The default is 'all', i.e., load all available levels.
            When you set the level of 'org', the original data are stored in tplot variables.
            When you set the level of 'scr', the screening data are stored in tplot variables.            
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 25/07/2012.

MODIFICATIONS:
 A. Shinbori, 12/11/2012.
 A. Shinbori, 24/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mu_meso_wind_txt.pro)


IUG_LOAD_MU_METEOR_NC

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

NAME:
iug_load_mu_meteor_nc

PURPOSE:
  Queries the Kyoto_RISH servers for the horizontal wind data (uwnd, vwnd, uwndsig, vwndsig, mwnum)
  in the NetCDF format estimated from the meteor wind special observation of the MU radar at Shigaraki
  and loads data into tplot format.

SYNTAX:
 iug_load_mu_meteor_nc, datatype = datatype, parameter = parameter,length = length,downloadonly = downloadonly, $
                           trange = trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_mu_meteor_nc, datatype = 'thermosphere'.
            The default is 'thermosphere'.
  length = Data length '1-day' or '1-month'. For example, iug_load_mu_meteor_nc, length = '1_day'.
           A kind of parameters is 2 types of '1_day', and '1_month'.   
  parameters = Data parameter. For example, iug_load_meteor_srp_nc, parameter = 'h1t60min00'. 
             A kind of parameters is 2 types of 'h1t60min00', 'h1t30min00'.
             The default is 'all'.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 06/07/2012.

MODIFICATIONS:
 A. Shinbori, 08/08/2012.
 A. Shinbori, 24/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mu_meteor_nc.pro)


IUG_LOAD_MU_METEOR_TXT

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

NAME:
iug_load_mu_meteor_txt

PURPOSE:
  Queries the Kyoto_RISH servers for the horizontal wind data (uwnd, vwnd, uwndsig, vwndsig, mwnum)
  in the text format estimated from the meteor wind special observation of the MU radar at Shigaraki
  and loads data into tplot format.

SYNTAX:
 iug_load_mu_meteor_txt, parameter = parameter, downloadonly = downloadonly, $
                          trange = trange, verbose=verbose

KEYWOARDS:
  parameter = Data parameter. For example, iug_load_mu_meteor_txt, parameter = 'h1t60min00'. 
              A kind of parameters is 2 types of 'h1t60min00' and 'h1t30min00'.
              The default is 'all'.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 10/06/2010.

MODIFICATIONS:
 A. Shinbori, 13/11/2011.
 A. Shinbori, 08/08/2012.
 A. Shinbori, 12/11/2012.
 A. Shinbori, 24/12/2012.
 A. Shinbori, 15/04/2013.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mu_meteor_txt.pro)


IUG_LOAD_MU_TROP_TXT

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

NAME:
iug_load_mu_trop_txt

PURPOSE:
  Queries the Kyoto_RISH servers for the standard observation data of the 
  troposphere and lower stratsphere in the CSV format taken by the Middle and 
  Upper atmosphere (MU) radar at Shigaraki and loads data into tplot format.

SYNTAX:
 iug_load_ear_trop_txt, datatype = datatype, parameter=parameter, $
                        downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_mu_trop_txt, datatype = 'troposphere'.
            The default is 'troposphere'. 
  parameter = parameter name of MU troposphere standard obervation data.  
          For example, iug_load_mu_trop_txt, parameter = 'uwnd'.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 19/09/2010.

MODIFICATIONS:
 A. Shinbori, 24/03/2011.
 A. Shinbori, 13/11/2011.
 A. Shinbori, 26/12/2011.
 A. Shinbori, 31/01/2012.
 A. Shinbori, 19/12/2012.
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_mu_trop_txt.pro)


IUG_LOAD_RADIOSONDE_DAWEX_NC

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

NAME:
iug_load_radiosonde_dawex_nc

PURPOSE:
  Queries the Kyoto RISH server for the netCDF data (press, temp, rh, uwnd, vwnd) 
  of the troposphere taken by the radiosonde at DAW, GNP and 
  and loads data into tplot format.

SYNTAX:
 iug_load_radiosonde_dawex_nc, datatype = datatype, site=site, $
                        downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_radiosonde_dawex_nc, datatype = 'troposphere'.
            The default is 'troposphere'. 
   site = DAWEX observation site.  
          For example, iug_load_radiosonde_dawex_nc, site = 'drw'.
          The default is 'all', i.e., load all available observation points.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
  A. Shinbori, 19/12/2012.
  
MODIFICATIONS:
  A. Shinbori, 26/02/2013.
  
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_radiosonde_dawex_nc.pro)


IUG_LOAD_RADIOSONDE_DAWEX_TXT

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

NAME:
iug_load_radiosonde_dawex_txt

PURPOSE:
  Queries the Kyoto RISH server for the text data (press, temp, rh, uwnd, vwnd) 
  of the troposphere taken by the radiosonde at DAW, GNP and 
  and loads data into tplot format.

SYNTAX:
 iug_load_radiosonde_dawex_txt, datatype = datatype, site=site, $
                        downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_radiosonde_dawex_txt, datatype = 'troposphere'.
            The default is 'troposphere'. 
   site = DAWEX observation site.  
          For example, iug_load_radiosonde_dawex_txt, site = 'drw'.
          The default is 'all', i.e., load all available observation points.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
  A. Shinbori, 19/12/2012.
  
MODIFICATIONS:
  A. Shinbori, 16/02/2013.
  A. Shinbori, 26/02/2013.
  
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_radiosonde_dawex_txt.pro)


IUG_LOAD_RADIOSONDE_RISH

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

NAME:
iug_load_radiosonde_rish

PURPOSE:
  Queries the Kyoto_RISH servers for all the observation data taken by 
  the radiosonde at several observation points and loads data into
  tplot format.

SYNTAX:
  iug_load_radiosonde_rish [ ,DATATYPE = string ]
                           [ ,SITE = string ]
                           [ ,TRANGE = [min,max] ]
                           [ ,FILENAMES = string scalar or array ]
                           [ , ]

KEYWOARDS:
  DATATYPE = The type of data to be loaded. In this load program,
             DATATYPEs are 'DAWEX' and 'misc'.
  SITE = The observation site. In this load program,
             defualt is 'sgk'.
  TRANGE (In):
    Pass a time range a la TIME_STRING.PRO.
  FILENAMES (In):
    *PRESENTLY DISABLED* Pass user-defined file names (full paths to local data files).  These will
      be read a la the RISH format, and the RISH server will not be queried.
  VERBOSE (In): [1,...,5], Get more detailed (higher number) command line output.

CODE:
 A. Shinbori, 19/12/2012.

MODIFICATIONS:
 
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_radiosonde_rish.pro)


IUG_LOAD_SDFIT

[Previous Routine] [Next Routine] [List of Routines]
 PROCEDURE: iug_load_sdfit
   to load the SuperDARN fitacf data from the STEL ERG-SC site 

 NOTE: This procedure is a simple alias to "erg_load_sdfit" 
   and calls the original one by just providing the same 
   arguments/keywords given.
   Some load procedures for the ground-based observational data 
   in the  ERG mission, named "erg_load_???", can be also called  
   by "iug_load_???", because these data are related to the both 
   ERG and IUGONET projects.
   For more information, see http://www.iugonet.org/en/ 
                         and http://gemsissc.stelab.nagoya-u.ac.jp/erg/

 :KEYWORDS:
    sites: 3-letter code of SD radar name. 
           Currently only the following codes work: 
           'hok', 'ksr'  
    cdffn: File path of a CDF file if given explicitly. 
    get_support_data: Turn this on to load the supporting data 
    trange: time range for which data are loaded. 
            e.g., ['2008-10-01/00:00:00','2008-10-02/00:00:00'] 

 :AUTHOR: 
     Tomo Hori (E-mail: horit at stelab.nagoya-u.ac.jp)
 :HISTORY:
   2010/03/09: Created as a draft version
   2010/07/01: now work for hok and ksr
   2010/09/10: added some keywords

(See iugonet/load/iug_load_sdfit.pro)


IUG_LOAD_SMART

[Previous Routine] [Next Routine] [List of Routines]
 :PROCEDURE: iug_load_smart

 :PURPOSE:
    Load the solar image data in the FITS format obtained by the SMART telescope 
    at the Hida Observatory, Kyoto Univ. Under some environment, you should set 
    the following environment:
               > setenv ROOT_DATA_DIR ~/data/
               before you start the IDL.

 :Keywords:
    datatype:  basically set the telescope (e.g., halpha)
    filter:    filter name(s) (e.g., m05 )
    lst:       set a named variable to return the URL list of data files
    downloadonly: if set, then only download the data, do not load it into 
               variables.

 :EXAMPLES:
   timespan, '2005-08-03/05:00', 0.5, /hour
   iug_load_smart,filter='p00'
   iug_load_smart,filter='m08'
   tplot_names
   iug_plot2d_smart,'smart_t1_p00',4,4
   movie_iug_smart,'smart_t1_m08'

 :Author:
 	Tomo Hori (E-mail: horit@stelab.nagoya-u.ac.jp)
       Satoru UeNo (E-mail: ueno@kwasan.kyoto-u.ac.jp)

 :HISTORY:
 	2012/05/08: Created by TH
       2012/05/17: Addition of FITS_READ and STORE_DATA by SU

(See iugonet/load/iug_load_smart.pro)


IUG_LOAD_WPR_RISH

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

NAME:
iug_load_wpr_rish

PURPOSE:
  Queries the Kyoto_RISH servers for the observation data (uwnd, vwnd, wwnd, pwr1-5, wdt1-5)
  in the CSV format taken by the Luneberg lens wind profiler radar (LL-WPR) and loads data into
  tplot format.

SYNTAX:
 iug_load_wpr_rish, datatype = datatype, site=site, parameter=parameter, $
                        downloadonly=downloadonly, trange=trange, verbose=verbose

KEYWOARDS:
  datatype = Observation data type. For example, iug_load_wpr_rish, datatype = 'troposphere'.
            The default is 'troposphere'. 
   site = LTR observation site.  
          For example, iug_load_wpr_rish, site = 'sgk'.
          The default is 'all', i.e., load all available observation points.
  parameter = parameter name of WPR obervation data.  
          For example, iug_load_wpr_rish, parameter = 'uwnd'.
          The default is 'all', i.e., load all available parameters.
  trange = (Optional) Time range of interest  (2 element array), if
          this is not set, the default is to prompt the user. Note
          that if the input time range is not a full day, a full
          day's data is loaded.
  /downloadonly, if set, then only download the data, do not load it
                 into variables.

CODE:
 A. Shinbori, 06/10/2011.

MODIFICATIONS:
 A. Shinbori, 26/12/2011.
 A. Shinbori. 31/01/2012.
 A. Shinbori, 10/02/2012.
 A. Shinbori, 04/03/2013.
 A. Shinbori, 08/04/2013.
  
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_load_wpr_rish.pro)


IUG_MOVIE_SMART

[Previous Routine] [Next Routine] [List of Routines]
 :PROCEDURE:
    iug_movie_smart

 :PURPOSE:
    Show movie of the solar images obtained by the SMART telescope 
      at the Hida Observatory, Kyoto Univ.

 :KEYWOARDS:
    valuename : tplot variables for image data

 :EXAMPLES:
    iug_movie_smart, 'smart_t1_p00'

 :Author:
    Satoru UeNo (E-mail: ueno@kwasan.kyoto-u.ac.jp)

(See iugonet/load/iug_movie_smart.pro)


IUG_PLOT2D_IONOGRAM

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

NAME:
  iug_plot2d_ionogram

PURPOSE:
  Generate several ionogram plots from the ionogram data taken by the ionosonde. 

SYNTAX:
  iug_plot2d_ionogram, datatype = datatype, valuename=valuename

KEYWOARDS:
  datatype = Observation data type. For example, plot_iug_ionogram, datatype = 'ionosphere'.
            The default is 'ionosphere'. 
  valuename = tplot variable names of ionosonde observation data.  
         For example, iug_plot2d_ionogram,valuename = 'iug_ionosonde_sgk_ionogram'.
         The default is 'iug_ionosonde_sgk_ionogram'.

CODE:
  A. Shinbori, 11/01/2013.
  
MODIFICATIONS:

  
ACKNOWLEDGEMENT:
 $LastChangedBy:  $
 $LastChangedDate:  $
 $LastChangedRevision:  $
 $URL $

(See iugonet/load/iug_plot2d_ionogram.pro)


IUG_PLOT2D_IRIO

[Previous Routine] [Next Routine] [List of Routines]
 :PROCEDURE:
    iug_plot2d_irio, vn, col, row, start_time=start_time, $
           step=step, valrng=valrng, flipns=flipns, flipew=flipew, $
           oblique_cor=oblique_cor

 :PURPOSE:
    Plot 2D image of the imaging riometer data obtained by NIPR. 
    The data are mapped to 90km altitude in the magnetic coordinate.

 :KEYWOARDS:
    vn  : tplot variables for image data
    col : number of column
    row : number of row
    start_time : start time of the images
    step: time step
    valrng: minimal and maximal values for display (default: [0, 4])
    flipns: set to flip in the North-South direction (default: top is north)
    flipew: set to flip in the East-West direction (default: right is east)
    oblique_cor: if set, CNA for the oblique beams is corrected by CNA*cos(ze).

 :EXAMPLES:
    iug_plot2d_irio, 'nipr_irio_syo_cna', 3, 3, $
                     start_time='2003-02-09/01:30', step=60

 :Author:
    Y.-M. Tanaka (ytanaka at nipr.ac.jp)

(See iugonet/load/iug_plot2d_irio.pro)


IUG_PLOT2D_SMART

[Previous Routine] [List of Routines]
 :PROCEDURE:
    iug_plot2d_smart

 :PURPOSE:
    Plot the solar image data obtained by the SMART telescope at the Hida Observatory, 
      Kyoto Univ.

 :KEYWOARDS:
    vn  : tplot variables for image data
    col : number of column
    row : number of row
    start_time : start time of the images

 :EXAMPLES:
    iug_plot2d_smart, 'smart_t1_p00', 3, 3, start_time='2005-08-03/05:00:00'

 :Author:
    Tomo Hori (E-mail: horit@stelab.nagoya-u.ac.jp)
    Satoru UeNo (E-mail: ueno@kwasan.kyoto-u.ac.jp)

(See iugonet/load/iug_plot2d_smart.pro)