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

Last modified: Wed Oct 7 01:15:19 2009.

# Directory Listing of Routines

# ssl_general/missions/kyoto

- KYOTO_AE_DOWNLOAD.PRO
  This routine will download the requested month of AE, AL, AO, and AU
- KYOTO_AE_LOAD
- KYOTO_CRIB_AE_LOAD
- KYOTO_CRIB_LOAD_AE
- KYOTO_CRIB_LOAD_DST
- KYOTO_DST2TPLOT
- KYOTO_DST_LOAD
- KYOTO_LOAD_AE
- KYOTO_LOAD_DST

# Routine Descriptions

## KYOTO_AE_DOWNLOAD.PRO

[Next Routine] [List of Routines]

    ***** WARNING: This routine is still being written!!! Do not attempt to use!

    NAME:
      KYOTO_AE_DOWNLOAD.PRO

    PURPOSE:
      This routine will download the requested month of AE, AL, AO, and AU
    data from the Kyoto server and store to the directory/file,
    YYYY/kyoto_ae_YYYY_MM.dat.

    Code: W.M.Feuerstein, 4/17/2008.

(See ssl_general/missions/kyoto/kyoto_ae_download.pro)

## KYOTO_AE_LOAD

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

    Name:
    KYOTO_AE_LOAD

    Purpose:
     Loads kyoto AE, AL, AO, and AU data into tplot format.
     Heavily modified from Davin Larson's KYOTO_DST_LOAD (Apr 2008).

    Syntax:
     kyoto_ae_load [, DATATYPE (!! NOT YET IMPLEMENTED !!) ]

    Keywords:
      Use DATATYPE to give any combination of AE, AL, AO, or AU.  NOT YET
        IMPLEMENTED!  For now, routine loads all by default.

    Code:
    W.M.Feuerstein, 4/16/2008.

    Modifications:
      Changed file format of name (kyoto_ae_YYYY_MM.dat to kyoto_ae_YYYYMM.dat),
        changed "DST" references to "AE", updated doc'n, WMF, 4/17/2008.

(See ssl_general/missions/kyoto/kyoto_ae_load.pro)

## KYOTO_CRIB_AE_LOAD

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

    Name:
    KYOTO_CRIB_AE_LOAD.PRO

    Purpose:
    Demonstrate the Kyoto AE data loader.

    Code:
    W. Michael Feuerstein, 4/17/2008.

    Modifications:
      Updated doc'n, WMF, 4/17/2008.

(See ssl_general/missions/kyoto/kyoto_crib_ae_load.pro)

## KYOTO_CRIB_LOAD_AE

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

    Crib sheet for KYOTO_LOAD_AE.PRO.

    Modifications:
      Changed name from KYOTO_CRIB_AE2TPLOT to KYOTO_CRIB_LOAD_AE, WMF, 6/4/2008.

    WMFeuerstein, 5/20/2008.

(See ssl_general/missions/kyoto/kyoto_crib_load_ae.pro)

## KYOTO_CRIB_LOAD_DST

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

    Crib sheet for KYOTO_LOAD_DST.PRO.  Modified from KYOTO_CRIB_LOAD_AE.PRO.

    Modifications:

    WMFeuerstein, 8/21/2008.

(See ssl_general/missions/kyoto/kyoto_crib_load_dst.pro)

## KYOTO_DST2TPLOT

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

    Name:
    KYOTO_DST2TPLOT

    Purpose:
      Queries the Kyoto servers for DST data and loads data into
      tplot format.  Adapted from KYOTO_AE2TPLOT.PRO.

    Syntax:
      kyoto_dst2tplot [ ,TRANGE = TRANGE ]
                      [ ,FILENAMES ]
                      [ ,< and data keywords below > ]

    Keywords:
      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 Kyoto format, and the Kyoto server will not be queried.
      DSTDATA, DSTTIME (Out):  Get 'dst' data, time basis.
      ALDATA, ALTIME (Out):  Get 'al' data, time basis.
      AODATA, AOTIME (Out):  Get 'ao' data, time basis.
      AUDATA, AUTIME (Out):  Get 'au' data, time basis.

    Code:
    W.M.Feuerstein, 5/15/2008.

    Modifications:
      Changed file format of name (kyoto_dst_YYYY_MM.dat to kyoto_dst_YYYYMM.dat),
        changed "DST" references to "DST", updated doc'n, WMF, 4/17/2008.
      Saved new version under new name (old name was KYOTO_DST_LOAD), added
        DATATYPE kw, validate and loop on datatypes, hardwired /DOWNLOADONLY,
        up'd data kwd's, up'd doc'n, WMF, 5/15/2008.
      Tested that the software defaults to local data when ther internet is not
        available even with /DOWNLOADONLY (yes), added acknowledgment and
        warning banner, added 'ax' datatype, WMF, 5/19/2008.

(See ssl_general/missions/kyoto/kyoto_dst2tplot.pro)

## KYOTO_DST_LOAD

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

     Procedure: kyoto_dst_load
     loads kyoto DST data into tplot format
     Davin Larson  Apr 2008

(See ssl_general/missions/kyoto/kyoto_dst_load.pro)

## KYOTO_LOAD_AE

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

    Name:
    KYOTO_LOAD_AE

    Purpose:
      Queries the Kyoto servers for AE, AL, AO, AU, and AX data and loads data into
      tplot format.  Highly modified from KYOTO_AE_LOAD.

    Syntax:
      KYOTO_LOAD_AE [ ,DATATYPE = string ]
                     [ ,TRANGE = [min,max] ]
                     [ ,FILENAMES = string scalar or array ]
                     [ ,<and data keywords below> ]

    Keywords:
      DATATYPE (I/O):
        Set to 'ae', 'al', 'ao', 'au', 'ax', or 'all'.  If not set, 'ae' 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 Kyoto format, and the Kyoto server will not be queried.
      AEDATA, AETIME (Out):  Get 'ae' data, time basis.
      ALDATA, ALTIME (Out):  Get 'al' data, time basis.
      AODATA, AOTIME (Out):  Get 'ao' data, time basis.
      AUDATA, AUTIME (Out):  Get 'au' data, time basis.
      VERBOSE (In): [1,...,5], Get more detailed (higher number) command line output.

    Code:
    W.M.Feuerstein, 5/15/2008.

    Modifications:
      Changed file format of name (kyoto_ae_YYYY_MM.dat to kyoto_ae_YYYYMM.dat),
        changed "DST" references to "AE", updated doc'n, WMF, 4/17/2008.
      Saved new version under new name (old name was KYOTO_AE_LOAD), added
        DATATYPE kw, validate and loop on datatypes, hardwired /DOWNLOADONLY,
        up'd data kwd's, up'd doc'n, WMF, 5/15/2008.
      Tested that the software defaults to local data when ther internet is not
        available even with /DOWNLOADONLY (yes), added acknowledgment and
        warning banner, added 'ax' datatype, WMF, 5/19/2008.
      Put acknowledment in header, upd'd doc'n, added ytitles, created
        DLIMITS.DATA_ATT.ACKNOWLEDGEMENT, WMF, 5/20/2008.
      Multiline ytitles, changed acknowledgment, WMF, 5/21/2008.
      Changed name from KYOTO_AE2TPLOT.PRO to KYOTO_LOAD_AE.PRO, WMF, 6/4/2008.
      Removed SOURCE.DOWNLOADONLY and SOURCE.MIN_AGE_LIMIT references, added
        VERBOSE kw per D. Larson, WMF, 7/8/2008.
      Default for VERBOSE kw, WMF, 7/24/2008.

    Acknowledgment:
      The provisional AE data are provided by the World Data Center for Geomagnetism, Kyoto,
      and are not for redistribution (http://wdc.kugi.kyoto-u.ac.jp/). Furthermore, we thank
      AE stations (Abisko [SGU, Sweden], Cape Chelyuskin [AARI, Russia], Tixi [IKFIA and
      AARI, Russia], Pebek [AARI, Russia], Barrow, College [USGS, USA], Yellowknife,
      Fort Churchill, Sanikiluaq (Poste-de-la-Baleine) [CGS, Canada], Narsarsuaq [DMI,
      Denmark], and Leirvogur [U. Iceland, Iceland]) as well as the RapidMAG team for
      their cooperations and efforts to operate these stations and to supply data for the provisional
      AE index to the WDC, Kyoto. (Pebek is a new station at geographic latitude of 70.09N
      and longitude of 170.93E, replacing the closed station Cape Wellen.)

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

(See ssl_general/missions/kyoto/kyoto_load_ae.pro)

## KYOTO_LOAD_DST

[Previous Routine] [List of Routines]

    Name:
    KYOTO_LOAD_DST

    Purpose:
      Queries the Kyoto servers for DST data and loads data into
      tplot format.  Adapted from KYOTO_AE2TPLOT.PRO.

    Syntax:
      kyoto_load_dst [ ,TRANGE = TRANGE ]
                      [ ,FILENAMES ]
                      [ ,< and data keywords below > ]

    Keywords:
      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 Kyoto format, and the Kyoto server will not be queried.
      DSTDATA, DSTTIME (Out):  Get 'dst' data, time basis.

    Code:
    W.M.Feuerstein, 5/15/2008.

    Modifications:
      Changed file format of name (kyoto_dst_YYYY_MM.dat to kyoto_dst_YYYYMM.dat),
        changed "DST" references to "DST", updated doc'n, WMF, 4/17/2008.
      Saved new version under new name (old name was KYOTO_DST_LOAD), added
        DATATYPE kw, validate and loop on datatypes, hardwired /DOWNLOADONLY,
        up'd data kwd's, up'd doc'n, WMF, 5/15/2008.
      Tested that the software defaults to local data when ther internet is not
        available even with /DOWNLOADONLY (yes), added acknowledgement and
        warning banner, added 'ax' datatype, WMF, 5/19/2008.
      Changed name from KYOTO_DST2TPLOT.PRO to KYOTO_LOAD_DST.PRO, added
        VERBOSE kw, added acknowledgement to DLIMITS structure, updated print, and
        header acknowledgement, WMF, 7/23/08.
      Changed acknowledgment as per Andreas Keiling, WMF, 8/4/2008.
      YTITLE reflects whether Provisional or RT data, WMF, 8/12/2008.
      YTITLE now set by file data (not kw), WMF, 8/15/2008.
      Updated doc'n, WMF, 8/25/2008.

    Acknowledgment:
      The DST data are provided by the World Data Center for Geomagnetism, Kyoto,  and
      are not for redistribution (http://wdc.kugi.kyoto-u.ac.jp/). Furthermore, we thank
      the geomagnetic observatories (Kakioka [JMA], Honolulu and San Juan [USGS], Hermanus
      [RSA], Alibag [IIG]), NiCT, INTERMAGNET, and many others for their cooperation to
      make the Dst index available.

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

(See ssl_general/missions/kyoto/kyoto_load_dst.pro)