This page was created by the IDL library routine mk_html_help2.

Last modified: Thu Aug 6 12:53:14 2020.

Directory Listing of Routines

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 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 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 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 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.
Copy and paste lines to command line, or type .run kyoto_crib_load_dst

Modifications:

WMFeuerstein, 8/21/2008.

(See 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 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 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.
  Note: Only provisional data is available. Kyoto does not make realtime AE indices available in this
  form due to the possible problems with the data (plots of realtime AE can be found on their website).
  Provisional data is usually available for up to few months before the present. Exact dates of availability
  can be checked at http://wdc.kugi.kyoto-u.ac.jp/ae_provisional/index.html.
  Note that there are no final AE indices produced.
  See also thm_crib_make_ae.pro for information on generating THEMIS pseudo AE indices.

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.
  no_server (in) Use only data available locally (same as deprecated no_download keyword).
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.
  Fixed use of trange keyword, added no_server keyword. lphilpott 17-oct-2011

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 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 in an array.
  no_server: set this keyword to use only locally available data files (i.e. don't connect to Kyoto server)
  dst_minutes: set the time for the hourly average at this time point. Default is 30.

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.
  Adding final data, no_server keyword, apply_time_clip keyword, fixed problem with trange not working, lphilpott oct-2011

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: egrimes $
 $LastChangedDate: 2019-06-04 13:15:57 -0700 (Tue, 04 Jun 2019) $
 $LastChangedRevision: 27317 $
 $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/tags/spedas_4_0/general/missions/kyoto/kyoto_load_dst.pro $

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