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

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

# Directory Listing of Routines

# projects/kaguya/general

- KGY_FILE_RETRIEVE
  Retrieve data and label files
- KGY_FILE_SOURCE
  Provides a structure that contains dummy information
- KGY_ORBIT_SNAP
  Plots Kaguya orbits in SSE and ME coordinates.

# Routine Descriptions

## KGY_FILE_RETRIEVE

[Next Routine] [List of Routines]

     PROCEDURE:
           kgy_file_retrieve
     PURPOSE:
           Retrieve data and label files
     CALLING SEQUENCE:
           files = kgy_file_retrieve('pbf/LEVEL1_VER1_DB/YYYYMMDD/PBF1_C_YYYYMMDD_*_I.DAT*',/daily_names,/valid_only,/last_version)
     INPUTS:
           PUBLIC: use publicly available data
           pathnames: String or string array with partial path to the remote file.
           (will be appended to local_data_dir)
     KEYWORDS:
           DAILY_NAMES : resolution (in days) for generating file names.
                         YYYY, yy, MM, DD,  hh,  mm, ss, .f, DOY, DOW, TDIFF are special characters that will be substituted with the appropriate date/time field
                         Be especially careful of extensions that begin with '.f' since these will be translated into a fractional second.
                         See "time_string"  TFORMAT keyword for more info.
           TRANGE : two element vector containing start and end times (UNIX_TIME or UT string).  if not present then timerange() is called to obtain the limits.
           SOURCE:  alternate file source.   Default is whatever is return by the function:  ppi_file_source()    (see "ppi_file_source" for more info)
           FILES:  if provided these will be passed through as output.
           VALID_ONLY:  Set to 1 to prevent non existent files from being returned.
           CREATE_DIR:  Generates a filename and creates the directories needed to create the file without errors.  Will not check for file on remote server.

     KEYWORDS Passed on to "FILE_RETRIEVE":
           LAST_VERSION : [0,1]  if set then only the last matching file is returned.  (Default is 1)
           VALID_ONLY:  [0,1]   If set then only existing files are returned. (Default is defined by source keyword)
           VERBOSE:  set verbosity level (2 is typical)
     LIMITATIONS:
           Beware of file pathnames that include the character sequences: YY,  MM, DD, hh, mm, ss, .f  since these can be retranslated to the time
     CREATED BY:
           Yuki Harada on 2015-07-05
           Mostly copied from 'mvn_pfp_file_retrieve'

     $LastChangedBy: haraday $
     $LastChangedDate: 2017-11-21 12:02:46 -0800 (Tue, 21 Nov 2017) $
     $LastChangedRevision: 24333 $
     $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/kaguya/general/kgy_file_retrieve.pro $

(See projects/kaguya/general/kgy_file_retrieve.pro)

## KGY_FILE_SOURCE

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

     FUNCTION:
           kgy_file_source
     PURPOSE:
           Provides a structure that contains dummy information
     CALLING SEQUENCE:
           source = kgy_file_source()
     INPUTS:
           default_source  (optional)  if this is a structure then it will be returned as the output
     KEYWORDS:
           PUBLIC: use publicly available data
           SET = [0,1]  : If set, then new options (KEYWORDS or DEFAULT_SOURCE) are made to the common block variable are therefor persistant.
                          DO NOT USE THIS KEYWORD INSIDE publically distributed code - IT WILL PRODUCE SIDE EFFECTS FOR OTHERS! !
           RESET = [0,1]  : If set then the default is restored.
                            DO NOT USE THIS KEYWORD INSIDE publically distributed code - IT WILL PRODUCE SIDE EFFECTS FOR OTHERS! !
     CREATED BY:
           Yuki Harada on 2015-07-15
           Modified from mvn_file_source

     $LastChangedBy: haraday $
     $LastChangedDate: 2021-01-14 23:35:04 -0800 (Thu, 14 Jan 2021) $
     $LastChangedRevision: 29602 $
     $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/kaguya/general/kgy_file_source.pro $

(See projects/kaguya/general/kgy_file_source.pro)

## KGY_ORBIT_SNAP

[Previous Routine] [List of Routines]

     PROCEDURE:
           kgy_orbit_snap
     PURPOSE:
           Plots Kaguya orbits in SSE and ME coordinates.
           Hold down the left mouse button and slide for a movie effect.
     KEYWORDS:

     CREATED BY:
           Yuki Harada on 2018-05-11

     $LastChangedBy: haraday $
     $LastChangedDate: 2018-05-15 00:52:42 -0700 (Tue, 15 May 2018) $
     $LastChangedRevision: 25222 $
     $URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/spdsoft/trunk/projects/kaguya/general/kgy_orbit_snap.pro $

(See projects/kaguya/general/kgy_orbit_snap.pro)