Generates complete URLs for Space Environment Center databases


FUNCTION sec_name_format, datatype, date


 INPUT PARAMETERS:
       datatype = Data name, may include preceding 'SEC_'.  Valid names are:
		EVENTS		Flare events list
		GOES_FLUX	GOES 5 minute soft x-ray flux
		KP		Geomagnetic Kp index
	date = Date of desired file, any standard format.

 RETURNS:
	Complete URL.

 CALLS: ***
	STR_SEP, anytim [1], anytim [2], anytim [3], anytim [4], anytim [5], anytim2doy [1]
	anytim2doy [2]
 CALLED BY:
	remote_name_format
 HISTORY:
	Written September 13, 2000  Barry LaBonte
	Name chase  1-Nov-2001  BJL

   Name: soon_cadence

   Purpose: read a soon_search output file and generate a plot file

   Input Parameters:
      textfile - output file (from pr_gsn)

   Calling Sequence:
      outplot=soon_cadence(filename)
 
 CALLS: ***
	LEGEND [1], LEGEND [2], LEGEND [3], STR2ARR [1], STR2ARR [2], UTPLOT [1], UTPLOT [2]
	UTPLOT [3], UTPLOT [4], UTPLOT [5], UTPLOT [6], WDEF [1], WDEF [2], anytim2ints [1]
	anytim2ints [2], evt_grid, int2secarr [1], int2secarr [2], linecolors [1]
	linecolors [2], rd_tfile [1], rd_tfile [2], str2cols [1], str2cols [2]
	str_replace [1], str_replace [2], strmids [1], strmids [2], zbuff2file [1]
	zbuff2file [2]
 CALLED BY:
	soon_search_www
   History:
      10-jun-1996 S.L.Freeland

   Name: soon_catstat

   Purpose: return SOONSPOT catalog status (or generate the status file)

   Input Paramters:
      NONE:

   Output Paramters:
     tape      - tapenames from soonspot checklist (read_sooncheck)
     catfile   - corresponding catalog file ('' = none found)
     nfiles    - number of files on tape (-1 = no catalog)
     tstart    - start time of first record on tape
     tstop     - stop time of last record
     cataloged - catalog program run?

   Keyword Paramters:
      generate - if set, generate the status file (default reads/reports)

 CALLS: ***
	CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], FILE_EXIST [2], STR2ARR [1]
	STR2ARR [2], UTPLOT [1], UTPLOT [2], UTPLOT [3], UTPLOT [4], UTPLOT [5], UTPLOT [6]
	WDEF [1], WDEF [2], concat_dir [4], deriv_arr [1], deriv_arr [2], evt_grid
	file_append [1], file_append [2], file_exist [1], file_exist [3], fmt_tim [1]
	fmt_tim [2], http_names, int2secarr [1], int2secarr [2], linecolors [1]
	linecolors [2], pr_status [1], pr_status [2], rd_gsn, rd_tfile [1], rd_tfile [2]
	read_sooncheck, soon_com2html, sort_index [1], sort_index [2], ssw_deltat
	str2cols [1], str2cols [2], str2html [1], str2html [2], str2html [3]
	str_replace [1], str_replace [2], strarrcompress, strcapitalize [1]
	strcapitalize [2], strjustify, strtab2html, sxt_html, timegrid, zbuff2file [1]
	zbuff2file [2]
   History:
      13-Jun-1996 (S.L.Freeland)
      18-jun-1996 (add status info)

   Name: soon_com2html

   Purpose: add soonspot tape comments to corresponding html file

 CALLS: ***
	BREAKFILE, BREAK_FILE [1], BREAK_FILE [2], BREAK_FILE [3], CONCAT_DIR [1]
	CONCAT_DIR [2], CONCAT_DIR [3], FILE_EXIST [2], break_file [4], concat_dir [4]
	file_append [1], file_append [2], file_exist [1], file_exist [3], file_list [1]
	file_list [2], rd_tfile [1], rd_tfile [2], str_replace [1], str_replace [2]
 CALLED BY:
	soon_catstat
   History:
      25-jun-1996 - S.L.Freeland

   Name: soon_comment_www

NAME:
	soon_sea
PURPOSE:
	TO allow access to the SOON catalog
CALLING SEQUENCE:
	.run soon_sea
HISTORY:
	Written 5-Aug-94 by M.Morrison
	23-Sep-94 (MDM) - Changed start/stop time format statement
			- Change "LI" option to allow user to select
			  which tape files to list
			- Added "SI" option to do per image listing of
			  search results.
	19-Apr-95 (MDM) - Adjusted to work to search for full disk
			  images without specifying a region
			- Corrected some catalog selection problems
			  (it wasn't parsing the times properly)
	25-Apr-95 (MDM) - Corrected error where full disk searches
			  were not being reset.

NAME:
	soon_search

PURPOSE:
	search the SOON catalog 

CALLING EXAMPLES:
       soon_search, starttime, endtime ,/full_disk [,/mail, address='emailadd']
       soon_search, starttime, endtime ,helio='N12W12',ref_date='9-Jul-94'
       soon_search, starttime, endtime ,helio='N12W12',ref_date='9-Jul-94', $
				gif_file="gifname"

 CALLS: ***
	ARR2STR [1], Arr2Str [2], CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3]
	FILE_SELTIME, anytim2ints [1], anytim2ints [2], concat_dir [4], data_chk [1]
	data_chk [2], file_append [1], file_append [2], get_host [1], get_host [2]
	get_user [1], get_user [2], gt_day [1], gt_day [2], in_fov, mail [1], mail [2]
	plot_gsn, pr_gsn [1], pr_gsn [2], rd_gsn, rd_tfile [1], rd_tfile [2], strspecial [1]
	strspecial [2], tbeep [1], tbeep [2], tbeep [3], tim2match [1], tim2match [2]
	tim2match [3]
 CALLED BY:
	soon_search_www
HISTORY:
       23-may-1995 (SLF) - Paramaterized MDM soon_sea (main program)
       14-jul-1995 (SLF) - add gif_file keyword (passed to plot_gsn)
       21-jul-1995 (SLF) - add image_list keyword and function
       24-apr-1996 (SLF) - work around bug in file_seltime
       26-apr-1996 (SLF) - add AR keyword and function
        6-Jun-1996 (SLF) - expand AR search (allow SN..., etc)
	26-aug-1998 (GLS) - corrected error in catfiles initialization
       28-aug-1998 (SLF) - improved(?) AR/SN/DL search logic   - added /MORE
       19-feb-1998 (SLF) - increase kludge from 15 to 50 days

NAME:
	soon_search

PURPOSE:
	search the SOON catalog 

CALLING EXAMPLES:
       soon_search, starttime, endtime ,/full_disk [,/mail, address='emailadd']
       soon_search, starttime, endtime ,helio='N12W12',ref_date='9-Jul-94'
       soon_search, starttime, endtime ,helio='N12W12',ref_date='9-Jul-94', $
				gif_file="gifname"

 CALLED BY:
	soon_search_www
HISTORY:
       23-may-1995 (SLF) - Paramaterized MDM soon_sea (main program)
       14-jul-1995 (SLF) - add gif_file keyword (passed to plot_gsn)
       21-jul-1995 (SLF) - add image_list keyword and function
       24-apr-1996 (SLF) - work around bug in file_seltime
       26-apr-1996 (SLF) - add AR keyword and function
        6-Jun-1996 (SLF) - expand AR search (allow SN..., etc)
	26-aug-1998 (GLS) - corrected error in catfiles initialization

   Name: soon_search_www

   Purpose: WWW front end to soon_search (input protect and user messages)

 CALLS: ***
	BREAK_FILE [1], BREAK_FILE [2], BREAK_FILE [3], CONCAT_DIR [1], CONCAT_DIR [2]
	CONCAT_DIR [3], SOON_REFORM, URL_QUERY2TIME, break_file [4], concat_dir [4]
	data_chk [1], data_chk [2], file_append [1], file_append [2], get_logenv [1]
	get_logenv [2], mkthumb, soon_cadence, soon_search [1], soon_search [2]
	soon_search [3], str2html [1], str2html [2], str2html [3], str2number [1]
	str2number [2], str_replace [1], str_replace [2], strtab2html, sxt_html
	tag_index [1], tag_index [2], url_decode
   History:
      15-May-1996 (S.L.Freeland) [use <url_decode> to simplify cgi script]
      11-Jun-1996 (S.L.Freeland) bail out on bad URL decode (old browsers?)

   Name: soon_table

   Purpose: read a soon_search output file and make a table

   Calling Sequence:
      outarr=soon_table(filename ['fieldstring'] )
      Circa 1-jan-1998 - S.L.Freeland
      26-apr-1999 - S.L.Freeland - handle difference in full d columns
 CALLS:

   Name: sooncat_cadence

   Purpose: plot SOONSPOT catalog cadennce information

   Input Parameters:
      t0, t1 - time range of interest

   Calling Sequence:
      outplot=sooncat_cadence(t0,t1)
 
 CALLS: ***
	FILE_SELTIME, LEGEND [1], LEGEND [2], LEGEND [3], SOON_TAPEINFO, STR2ARR [1]
	STR2ARR [2], UTPLOT [1], UTPLOT [2], UTPLOT [3], UTPLOT [4], UTPLOT [5], UTPLOT [6]
	WDEF [1], WDEF [2], data_chk [1], data_chk [2], evt_grid, get_logenv [1]
	get_logenv [2], linecolors [1], linecolors [2], rd_gsn, read_sooncheck
	sel_timrange [1], sel_timrange [2], zbuff2file [1], zbuff2file [2]
   Side Effects:
      "clobbers" color table (linecolors called)

   History:
      10-jun-1996 S.L.Freeland

 PROJECT:
       Master's Thesis

 NAME: soonfits (function)

 PURPOSE: read one or more soon images and/or headers

 CALLING SEQUENCE:

       result = soonfits(file, head [,extention=extention, help=help])

 INPUTS:
       file - the file name of the SOONSPOT extended FITS file.

 OPTIONAL INPUTS: 
       extention - the "frame" of the image file to read.  The
                   default is to read image zero.

 OUTPUTS:
       A 512x512 byte array containing the SOONSPOT image.

 OPTIONAL OUTPUTS:
       head - the image header.

 KEYWORD PARAMETERS: 
       /help.  Will call doc_library and list header, and return
       /loud - if set, print some info (default is quiet)
       /header_only - if set, dont bother reading image (return -1)

 CALLS: ***
	BOX_MESSAGE, DOC_LIBRARY, SOONFITS
 COMMON BLOCKS:
       None.

 RESTRICTIONS: 
       None.

 SIDE EFFECTS:
       None.

 CATEGORY:
       Randy Meisner's Master's Thesis.

 PREVIOUS HISTORY:
       Written March 23, 1997, by Randy Meisner, HAO/NCAR, Boulder, CO

 MODIFICATION HISTORY:
       
 VERSION:
       Version 1, March 23, 1997
       Version 1.1 3-March-1999 - S.L.Freeland add /HEADER_ONLY

   Name: sxt_html

   Purpose: return standard SXT header/trailer html

   Input Paramters:
      filename (optional) - appends the text to this file

   Keyword Paramters:
      header -  if set, return header html
      trailer - if set, return trailer html
      credits - if set, include SXT credits in trailer
      noimg -   if set, leave off logo
 CALLS:
 CALLED BY
	soon_catstat, soon_search_www