Name: read_lapalma

   Purpose: read lapalma data -> SSW

   Input Parameters:
      files - list of files to read
      lpindex - output structure - (derived from anaheader info)
      lpdata  - optional output  - the data (2d or 3d)
  
   Keyword Parameters:
      outsize - size of output image rebinned
  
 CALLS: ***
	ANAFRD, BOX_MESSAGE, CONGRID [1], CONGRID [2], CONGRID [3], FILE_EXIST [2], ROT_XY
	anytim [1], anytim [2], anytim [3], anytim [4], anytim [5], data_chk [1]
	data_chk [2], file_exist [1], file_exist [3], get_logenv [1], get_logenv [2]
	gt_tagval [1], gt_tagval [2], read_genxcat, struct2ssw
   History:
      9-Nov-1998 - S.L.Freeland (CDAW 4, LMSAL)

   Name: read_soon

   Purpose: read one or more soon 2D/3D files

   Input Parameters:

       files - list of files to read
       dset  - subscripts of images relative to <files>
               [ -1 implies all ]
       index - output vector of 'header-structures'
       data  - 2D/3D data (image or cube)

   Keyword Parameters:
      pindex (OUTPUT) - the primary headers (one per input file)
      loud (switch) - if set, make soonfits loud
  
 CALLS: ***
	BOX_MESSAGE, CONV_H2A [1], CONV_H2A [2], GET_SUN [1], GET_SUN [2], REM_TAG [1]
	REM_TAG [2], SOONFITS, TAG_EXIST [1], TAG_EXIST [2], data_chk [1], data_chk [2]
	fitshead2struct, gt_tagval [1], gt_tagval [2], mreadfits, mxf_dset_map
	required_tags, struct2ssw
   History:
     2-march-1999 - S.L.Freeland - written
                    Based on earlier email to Alan Kiplinger
     3-march-1999 - S.L.Freeland - set ref CRVALx->arcsecs using lat/lon
                                   CROTA -> P angle
     7-Apr-1999   - S.L.Freeland - use solar Pangle (soon.PA was position angle..)

     13-May-1999  - Zarro (SM&A/GSFC) - added initial call to struct2ssw to
                    get standard time input for conv_h2a.
                    Also fixed P-angle sign
      4-apr-2006 - S.L.Freeland - fix date_d$obs 

   Method:
      Use mreadfits (SLF), soonfits(Randy Miesner) and SSW

   Referenced routines:
      mreadfits, soonfits, fitshead2struct, struct2ssw, $
      gt_tagval, mxf_dset_arr, conv_h2a
  
 Calling Example

   Name: read_sooncheck

   Purpose: read soon tape checklist info, return some tape status info

   Input Paramters:
      NONE:
   
   Output Paramters:
      tapes - tapenames in log
      cataloged - boolean (1=cataloged, 0 = not yet or failure)
      copied - boolean (1=copied, 0=not yet or failure)
   
 CALLS:
 CALLED BY
	soon_catstat, sooncat_cadence

 NAME:
 refractivity

 PURPOSE:
 Calculate the refractivity of air at the supplied conditions
 EXPLANATION:
 This procedure will take as inputs a set of physical conditions
 (temperature, density, humidity, and CO2 concentration) and
 calculate the refractivity (the index of refraction minus 1)
 of air at a specific wavelength.
 CALLING SEQUENCE:
 r = refractivity(wavelength, temp, pressure, humidity, xc)

 INPUTS:
 wavelength = wavelength at which to calculate refractivity,
 in nanometers (nm)
 temperature = temperature of air, in Celsius (C)
 (default = 20)
 pressure_pa = local air pressure, in pascals (P)
 (default = 100000)
 humidity = relative humidity, in percent (%)
 (default = 75)
 xc = concentration of CO2, in parts per million (ppm)
 (default = 380)

 OPTIONAL INPUT KEYWORDS:
 verbose = indicates level of output information
 0 = no output
 1 = standard output
 2 = extended output

 OPTIONAL OUTPUT KEYWORD:

 RESULTS:
 nprop = calculated refractivity

 CALLED BY:
	atmospheric_refraction
 EXAMPLE:
 r = refractivity(630, 12, 70000, 35, 400)
 CALLS: ***
	atmospheric_density
 COMMON BLOCKS:
 none

 PROCEDURE:
 Ciddor, P.E.: 1996, "Refractive index of air: new equations for
 the visible and near infrared", Applied Optics LP vol. 35,
 Issue 9, p.1566

 Ciddor, P.E. and Hill, R.J.: 1999, Applied Optics vol. 38, p. 1663.

 MODIFICATION HISTORY:
 Written, Kevin Reardon, INAF/Osservatorio Astrofisico di Arcetri, 2005

 Generates URL for remote database


FUNCTION remote_name_format, datatype, date


 INPUT PARAMETERS:
	date = Date of desired file, any standard format.
	datatype = Data name, as used in URL environmental.

 RETURNS:
	Subdirectory (if needed) and filename, string.  Completes
	the URL for accessing remote database.

 CALLS: ***
	mees_name_format, sec_name_format
 HISTORY:
	Written  October 31, 1999  Barry LaBonte
	Complete revision Spetember 13, 2000 BJL