This page was created by the IDL library routine
mk_html_help
. For more information on
this routine, refer to the IDL Online Help Navigator
or type:
? mk_html_help
at the IDL command line prompt.
Last modified: Sat Sep 23 18:13:26 2006.
NAME: oclc_ey92_AAREADME PURPOSE Print the file 'oclc_ey92_AAREADME.pro' CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: oclc_ey92_AAREADME PROCEDURE README_oclc_ey92 These routines implement the model of Elliot, J. L. and L. A. Young 1992. Analysis of stellar occultation data for planetary atmospheres. I - Model fitting, with application to Pluto. Astronomical Journal 103, 991-1015. The routines are called oclc_ey92_*. oclc stands for OCcultation LightCurve. EY92 refers to the Elliot and Young 1992 paper cited above. Other occultation lightcurves can be implemented, and will be prefixed oclc__.pro. --------------------------------------------------------------------------- VARIABLES --------------------------------------------------------------------------- a exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a Unitless b Exponent for non-constant temperature, T(r) = T * (r/r0)^b Unitless. aser A(a, b, delta) in EY92 Series in delta for use in calculating theta Unitless. bser B(a,b,delta) in EY92 Series in delta for use in calculating dtheta Unitless. cser C(delta_tau) in EY92 Series in delta_tau for use in calculating optical depth Unitless. distobs D in EY92 Distance between target and observer cm dtheta d theta/d r in EY92 Derivative of the bending angle with respect to planet radius, positive for an isothermal atmosphere. radian/cm htau1 scale height of absorbtion coefficient cm kappa linear absorption coefficient kappa = kappa1 exp( - (r-r1)/(htau1 * (r/r1) ) ) EY92 3.23 1/cm (or cm^2/cm^3, cross section per particle * particle/volume) kappa1 linear absorption coefficient at r1 (top of haze) 1/cm (or cm^2/cm^3, cross section per particle * particle/volume) lam lambda in EY92 Ratio of radius (r) to scale height (H). Since H = kT r^2/(mu m_adu M G), this is the same as the ratio of kinetic energy (kT) to potential energy (mu m_adu M G/r). unitless lam0 lambda0 in EY92 Reference energy ratio. Energy ratio, lambda, evaluated at the reference radius, r0. unitless nu Refractivity. Unitless nu0 Reference refractivity. Refractivity at r0 Unitless phi normalized stellar flux. unitless. phiref normalized stellar flux for just refraction. unitless. r planet radius (distance from planet center). cm r0 reference planet radius (distance from planet center). cm rh half-light planet radius cm r1 planet radius of top of haze layer cm r2 planet radius where line-of-sight optical depth = 1 cm rtau_ref planet radius for reference tauobs, tauobs_ref (normally tauobs_ref = 1, whence rtau_ref = r2) rsurf planet radius of surface. flux is cut off (no diffraction) at r < rsurf cm rho shadow radius (distance from shadow center), negative for far-limb contribution. cm. rhoh half-light shadow radius cm rho_min minimum observer shadow radius cm t temperature K t0 temperature at reference radius, r0 K theta bending angle, negative for an isothermal atmosphere. radians. tauobs line-of-sight optical depth unitless. tauobs_ref value of tauobs at planet radius rtau_ref v shadow velocity cm/s vperph perpendicular shadow velocity cm/s --------------------------------------------------------------------------- FUNCTIONS --------------------------------------------------------------------------- aser = oclc_ey92_aseries(a, b, delta) bser = oclc_ey92_bseries(a, b, delta) cser = oclc_ey92_cseries(delta_tau) dtheta = oclc_ey92_dtheta(r0, theta0,lam0,a,b, r) phi = oclc_ey92_phi_of_r(r0,nu0,lam0,a,b,r1,kappa1,htau1,distobs,rsurf, r) lam = oclc_ey92_lam(r0, lam0, a, b, r) nu = oclc_ey92_nu(r0, nu0,lam0,a,b, r) rho = oclc_ey92_r_of_rho(r0, nu0,lam0,a,b, distobs, r) rho = oclc_ey92_rho_of_r(r0, nu0,lam0,a,b, distobs, r) tauobs = oclc_ey92_tauobs(r1, r2, htau1, r) theta = oclc_ey92_theta(r0,nu0,lam0,a,b, r)
(See oclc_ey92_AAREADME.pro)
NAME: oclc_ey92_aseries PURPOSE: (one line) return power series in 1/lam used by EY92 DESCRIPTION: return power series in 1/lam used by EY92 CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: aser = oclc_ey92_aseries(a,b,order,delta) INPUTS: a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b order - order of delta in the series (default 4) delta - 1/lambda (may be an array) OPTIONAL INPUT PARAMETERS: KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: A(delta,a,b) Series in delta for use in calculating theta Unitless. COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg A2 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_aseries.pro)
NAME: oclc_ey92_atmparam PURPOSE: (one line) convert "data parameters" to "atmospheric parameters" DESCRIPTION: convert "data parameters" to "atmospheric parameters" CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: oclc_ey92_atmparam, v, distobs, f, r0, order, timeim, timeem, timehiso, a, b,timeh1, timeh2, timehtau2, timemin, timemid, rhomin, nu0, lam0, r1, kappa1, htau1, rhof = rhof, r2 = r2 INPUTS: v - sky-plane velocity, cm/s distobs - Observer-target distance, cm f - flux level for timeim, timeem (unitless) r0 - reference radius (cm) order - expansion order for power series timeim - time of immersion (s) timeem - time of emersion (s) timehiso - equivalent isothermal scale height in units of s. timehiso ~= 1/(8 dphi/dt) at halflight) a - exponent for molecular weight b - exponent for temperature timeh1 - time between tim and haze onset (s) timeh2 - time between tim and optical-depth = 1 timehtau2 - scale height of haze at r2 in units of s timemin - minimum shadow radius in s (rhomin/v) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: rh - radius at half-light (phi = f) r2 - radius of tau = 1 OUTPUTS: timemid - midtiime (s) rhomin - minimum rho (cm) nu0 - reference refractivity (unitless) lam0 - reference energy ratio (unitless) r1 - radius of haze onset (cm) kappa1 - linear absorption at r1 Htau1 - scale height of absorption at r1 COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.18 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_atmparam.pro)
NAME: oclc_ey92_bseries PURPOSE: (one line) return power series in 1/lam used by EY92 DESCRIPTION: return power series in 1/lam used by EY92 CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: bser = oclc_ey92_bseries(a,b,order,delta) INPUTS: a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b order - order of delta in the series (default 4) delta - 1/lambda (may be an array) OPTIONAL INPUT PARAMETERS: KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: B(a,b,delta) Series in delta for use in calculating dtheta Unitless. COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg A2 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_bseries.pro)
NAME: oclc_ey92_cseries PURPOSE: (one line) return power series in 1/lam used by EY92 DESCRIPTION: return power series in 1/lam used by EY92 CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: cser = oclc_ey92_cseries(order,delta_tau) INPUTS: order - order for series delta_tau - H_tau1 r/r_1^2 OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: C(delta_tau) Series in delta_tau for use in calculating optical depth Unitless. COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg A7 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_cseries.pro)
NAME: oclc_ey92_d2t PURPOSE: (one line) return temperature second derivative as function of radius DESCRIPTION: return temperature second derivative (d^2t/dr^2) as function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: d2t = oclc_ey92_d2t(r0,lam0, b, Mp, mu0, r) INPUTS: r0 - reference radius (scalar, cm) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) b - exponent for non-constant temperature T(r) = T * (r/r0)^b Mp - planet mass (g). 1.30497e+25 for Pluto (Buie et al 2006) mu0 - reference molecular weight (unitless). 28.01 for Pluto. OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: d2t - second derivative of temperature (K/cm^2) at r COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.3 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_d2t.pro)
NAME: oclc_ey92_dnu PURPOSE: (one line) return dnu (derivative of refractivity) as a function of radius DESCRIPTION: return dnu as a function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: dnu = oclc_ey92_nu(r0,nu0,lam0,a,b, r) INPUTS: r0 - reference radius (scalar, cm) nu0 - refractivity at r0 (scalar, unitless) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b r - planet radius at which to evaluate nu (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: nu (refractivity, unitless) at r (planet radius, cm) COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.22 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_dnu.pro)
NAME: oclc_ey92_dt PURPOSE: (one line) return temperature gradient as function of radius DESCRIPTION: return temperature gradient as function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: dt = oclc_ey92_dt(r0,lam0, b, Mp, mu0, r) INPUTS: r0 - reference radius (scalar, cm) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) b - exponent for non-constant temperature T(r) = T * (r/r0)^b Mp - planet mass (g). 1.30497e+25 for Pluto (Buie et al 2006) mu0 - reference molecular weight (unitless). 28.01 for Pluto. OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: dt - temperature gradient (K/cm) at r COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.3 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_dt.pro)
NAME: oclc_ey92_dtheta PURPOSE: (one line) return dtheta (bending angle) as a function of radius DESCRIPTION: return dtheta as a function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: dtheta = oclc_ey92_dtheta(r0,nu0,lam0,a,b,order, r) INPUTS: r0 - reference radius (scalar, cm) nu0 - refractivity at r0 (scalar, unitless) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b order - order for series expantion r - radius at which to evaluat dtheta (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: dtheta at r Derivative of the bending angle with respect to planet radius, positive for an isothermal atmosphere. radian/cm COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 4.11 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_dtheta.pro)
NAME: oclc_ey92_func_dataparam PURPOSE: (one line) lightcurve fit of EY92 to flux(time) DESCRIPTION: lightcurve fit of EY92 to flux(time) CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: oclc_ey92_funcdataparam, y, param, z, pder INPUTS: y = shadow radius (km) param = [sb, dsb, sf, $ timeim, timeem, timehiso, a, b,timeh1, timeh2, timehtau2, timemin] OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: z = lightcurve COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_funcdataparam.pro)
NAME: oclc_ey92_h PURPOSE: (one line) return scale height (H) as a function of radius DESCRIPTION: return scale height (H) as a function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: h = oclc_ey92_h(r0,lam0, a, b, r) INPUTS: r0 - reference radius (scalar, cm) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b r - radius at which to evaluat H (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: H = scale height (cm), defined by H = k T / (mu m_amu g) or - (1/p) dp/dr = 1/H COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.21 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_h.pro)
NAME: oclc_ey92_hn PURPOSE: (one line) return scale height for density (Hn) as a function of radius DESCRIPTION: return scale height for density (Hn) as a function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: hn = oclc_ey92_hn(r0,lam0, a, b, r) INPUTS: r0 - reference radius (scalar, cm) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b r - radius at which to evaluat H (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: Hn = scale height (cm), defined by H = - (1/n(r) d n(r) / dr) COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.22 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_hn.pro)
NAME: oclc_ey92_kappa PURPOSE: (one line) return kappa as a function of radius DESCRIPTION: return kappa (absorption coeffient, cm^-1) as a function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: kappa = oclc_ey92_kappa(r1, kappa1, htau1, r) INPUTS: r1 - top of haze layer kappa1 - linear absorption coefficient at r1 htau1 - scale height of absorbtion coefficient r - radius at which to evaluat kappa (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: kappa (absorption coeffient, cm^-1) at r (planet radius, cm) COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.23 MODIFICATION HISTORY: Written 2006 Aug 17, Leslie Young
(See oclc_ey92_kappa.pro)
NAME: oclc_ey92_kappa1_of_r2 PURPOSE: (one line) return kappa1 (linear absorption coefficient at r1) s.t. tauobs(r2) = 1 DESCRIPTION: return kappa1 (linear absorption coefficient at r1) s.t. tauobs(r2) = 1 CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: kappa1 = oclc_ey92_kappa1_of_r2(r1, htau1, r2) INPUTS: r1 - top of haze layer htau1 - scale height of absorbtion coefficient r2 - planet radius of unit optical depth (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: kappa1 - linear absorption coefficient at r1 COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 4.20, 4.21 MODIFICATION HISTORY: Written 2006 Jun 30, Leslie Young 2006 Sep 14 LAY fixed documentation
(See oclc_ey92_kappa1_of_r2.pro)
NAME: oclc_ey92_kappa1_of_tauobs PURPOSE: (one line) return kappa1 (linear absorption coefficient at r1) s.t. tauobs(rtau_ref) = tauobs DESCRIPTION: return kappa1 (linear absorption coefficient at r1) s.t. tauobs(rtau_ref) = tauobs CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: kappa1 = oclc_ey92_kappa1_of_tauobs(r1, htau1, rtau_ref, tauobs_ref) INPUTS: r1 - top of haze layer htau1 - scale height of absorbtion coefficient rtau_ref - radius at which tauobs = tauobs_ref (scalar or array, cm) tauobs_ref (line-of-sight optical depth, unitless) at rtau_ref OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: kappa1 - linear absorption coefficient at r1 COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 4.20, 4.21 MODIFICATION HISTORY: Written 2006 Jun 30, Leslie Young
(See oclc_ey92_kappa1_of_tauobs.pro)
NAME: oclc_ey92_lam PURPOSE: (one line) return lambda (r/H) as a function of radius DESCRIPTION: return lambda (r/H) as a function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: lam = oclc_ey92_lam(r0,lam0, a, b, r) INPUTS: r0 - reference radius (scalar, cm) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b r - radius at which to evaluat lam (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: lambda = r/H = (gravitational potential energy/kinetic energy) Ratio of radius (r) to scale height (H). Since H = kT r^2/(mu m_adu M G), this is the same as the ratio of kinetic energy (kT) to potential energy (mu m_adu M G/r). unitless COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.9 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_lam.pro)
NAME: oclc_ey92_n PURPOSE: (one line) return n (number density) as a function of radius DESCRIPTION: return n as a function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: n = oclc_ey92_n(r0,nu0,lam0,a,b,nustp, r) INPUTS: r0 - reference radius (scalar, cm) nu0 - refractivity at r0 (scalar, unitless) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b r - planet radius at which to evaluate nu (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: nu (refractivity, unitless) at r (planet radius, cm) COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.20, 3.18 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_n.pro)
NAME: oclc_ey92_n0 PURPOSE: (one line) return reference number density DESCRIPTION: return reference number density CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: n0 = oclc_ey92_n0(nu0, nustp) INPUTS: nu0 - reference refractivity (scalar, cm) nustp - refractivity at STP (273.15 K, 1.013250e6 microsbar). 2.98e-4 for Pluto. OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: n0 - number density (cm^-3) at r0 COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.18 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_n0.pro)
NAME: oclc_ey92_nu PURPOSE: (one line) return nu (refractivity) as a function of radius DESCRIPTION: return nu as a function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: nu = oclc_ey92_nu(r0,nu0,lam0,a,b, r) INPUTS: r0 - reference radius (scalar, cm) nu0 - refractivity at r0 (scalar, unitless) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b r - planet radius at which to evaluate nu (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: nu (refractivity, unitless) at r (planet radius, cm) COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.20 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_nu.pro)
NAME: oclc_ey92_p PURPOSE: (one line) return pressure as a function of radius DESCRIPTION: return pressure as a function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: p = oclc_ey92_p(r0, nu0, lam0, a, b, mp, mu0, nustp, r) INPUTS: r0 - reference radius (scalar, cm) nu0 - refractivity at r0 (scalar, unitless) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) a - exponent for non-constant mean moleculr weight: mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature; T(r) = T * (r/r0)^b Mp - planet mass (g). 1.30497e+25 for Pluto (Buie et al 2006) mu0 - molecular weight (unitless). 28.01 for Pluto. nustp - refractivity at STP (273.15 K, 1.013250e6 microsbar). 2.98e-4 for Pluto. OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: p0 - pressure (microbar) at r0 COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.6 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_p.pro)
NAME: oclc_ey92_p0 PURPOSE: (one line) return reference pressure DESCRIPTION: return reference pressure CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: p0 = oclc_ey92_p0(r0, nu0, lam0, mp, mu0, nustp) INPUTS: r0 - reference radius (scalar, cm) nu0 - refractivity at r0 (scalar, unitless) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) Mp - planet mass (g). 1.30497e+25 for Pluto (Buie et al 2006) mu0 - molecular weight (unitless). 28.01 for Pluto. nustp - refractivity at STP (273.15 K, 1.013250e6 microsbar). 2.98e-4 for Pluto. OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: p0 - pressure (microbar) at r0 COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.18 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_p0.pro)
NAME: oclc_ey92_phiref_of_r PURPOSE: (one line) return phi from refaction as a function of planet radius DESCRIPTION: return phi from refaction as a function of planet radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: phi = oclc_ey92_phiref_of_r(r0, nu0, lam0, a, b, distobs, rsurf, order, r) INPUTS: r0 - reference radius (scalar, cm) nu0 - refractivity at r0 (scalar, unitless) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b rsurf - surface radius order - order for series expansion r - radius at which to evaluat phi (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: stellar flux, phi, at planet radius, r COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 2.1, 2.2, 2.3 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_phiref_of_r.pro)
NAME: oclc_ey92_phi_of_r PURPOSE: (one line) return phi (normalized stellar flux) as a function of planet radius, r DESCRIPTION: return phi as a function of planet radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: phi = oclc_ey92_phi_of_r(r0, nu0, lam0, a, b, r1, kappa1, htau1, distobs, rsurf, order, r) INPUTS: r0 - reference radius (scalar, cm) nu0 - refractivity at r0 (scalar, unitless) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b r1 - top of haze layer kappa1 - linear absorption coefficient at r1 htau1 - scale height of absorbtion coefficient rsurf - surface radius order - order for series expansion r - radius at which to evaluat phi (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: stellar flux, phi, at planet radius, r COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 2.1, 2.2, 2.3 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_phi_of_r.pro)
NAME: oclc_ey92_phi_of_rho PURPOSE: (one line) return phi (normalized stellar flux) as a function of shadow radius DESCRIPTION: return phi as a function of shadow radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: phi = oclc_ey92_phi_of_rho(r0,nu0,lam0,a,b,r1,kappa1,htau1,distobs,rsurf,farside, haze, order, rho) INPUTS: r0 - reference radius (scalar, cm) nu0 - refractivity at r0 (scalar, unitless) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b r1 - top of haze layer kappa1 - linear absorption coefficient at r1 htau1 - scale height of absorbtion coefficient rsurf - surface radius farside - if 1, add farside contribution haze - if 1, include haze extinction order - order for series expansion rho - shadow radius at which to evaluat phi (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: r_near - the near-side planet radius (cm) OUTPUTS: phi (normalized stellar flux) at shadow radius, rho. COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 2.1, 2.2, 2.3 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young Sep 9 2007 LAY. Don't calculate tau if haze = 0
(See oclc_ey92_phi_of_rho.pro)
NAME: oclc_ey92_rhomin_of_timemin PURPOSE: (one line) return rho_min = minimim shadow radius DESCRIPTION: return rho_min = minimim shadow radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: rho_min = oclc_ey92_rhomin_of_timemin(v, timemin) INPUTS: v = sky-plane velocity (assuming linear motion), cm/s timemin = minimum observer distance in units of s. OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: OUTPUTS: rhomin = minimum observer distance in units of cm COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: Admitedly silly to have this as a seperate function PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eq 5.8 MODIFICATION HISTORY: Written 2006 Aug 18, Leslie Young
(See oclc_ey92_rhomin_of_timemin.pro)
NAME: oclc_ey92_rho_of_r PURPOSE: (one line) return r (planet radius) as a function of rho (shadow radius) DESCRIPTION: return r as a function of rho CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: rho = oclc_ey92_rho_of_r(r0,nu0,lam0,a,b, distobs, order, r) INPUTS: r0 - reference radius (scalar, cm) nu0 - refractivity at r0 (scalar, unitless) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b distobs - planet-observer distance (scalar, cm) order - order of expansion for series r - planet radius (cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: rho at r rho - shadow radius at r (scalar or array, cm), negative for far-limb contribution; COMMON BLOCKS: SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 2.2 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_rho_of_r.pro)
NAME: oclc_ey92_rho_of_time PURPOSE: (one line) return rho (shadow radius) as a function of time assuming linear motion DESCRIPTION: return rho as a function of time CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: rho = oclc_ey92_rho_of_time(rhomin, timemid, v, time) INPUTS: rhomin - shadow radius at midtime (cm) timemid - mid time (s) v - sky-plane velocity, cm/s time - time (s) at which to evaluate rho OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: rho - shadow radius COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 5.1 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_rho_of_time.pro)
NAME: oclc_ey92_rh_of_rhoh PURPOSE: (one line) return rh (half-light planet radius) as a function of rhoh (half-light shadow radius) DESCRIPTION: return rh (half-light planet radius) and lam0 as a function of rho (half-light shadow radius) and hiso ( CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: rh = oclc_ey92_rh_of_rhoh(r0,a,b,distobs,order,rhoh,hiso,nu0,lam0) INPUTS: r0 - reference radius (scalar, cm) a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b distobs - planet-observer distance (scalar, cm) order - order for expansion of series rhoh - shadow radius at which flux = 1/2. hiso - equivalent isothermal scale height at rhoh, defined such that d phi/d rho = (1 + Hiso/2 rh + ...)/8 OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: rh such that oclc_ey92_rho_of_r(r0,nu0,lam0,a,b,distobs,r) = rhoh and oclc_ey92_phiref_of_r(r0,nu0,lam0,a,b,distobs,rsurf,order,r) = 0.5 rh is radius (distance from planet center) in cm. nu0 - refractivity at r0 (scalar, unitless) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eq 6.3-6.7 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_rh_of_rhoh.pro)
NAME: oclc_ey92_r_of_rho PURPOSE: (one line) return r (planet radius) as a function of rho (shadow radius) DESCRIPTION: return r as a function of rho CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: r = oclc_ey92_r_of_rho(r0,nu0,lam0,a,b, distobs, order, rho) INPUTS: r0 - reference radius (scalar, cm) nu0 - refractivity at r0 (scalar, unitless) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b distobs - planet-observer distance (scalar, cm) order - order for expansion of series rho - shadow radius at which to evaluate r (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: r such that oclc_ey92_rho_of_r(r0,nu0,lam0,a,b,distobs,r) = rho r is radius (distance from planet center) in cm. COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 2.2 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_r_of_rho.pro)
NAME: oclc_ey92_t PURPOSE: (one line) return temperature as function of radius DESCRIPTION: return temperature as function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: t = oclc_ey92_t(r0,lam0, b, Mp, mu0, r) INPUTS: r0 - reference radius (scalar, cm) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) b - exponent for non-constant temperature T(r) = T * (r/r0)^b Mp - planet mass (g). 1.30497e+25 for Pluto (Buie et al 2006) mu0 - reference molecular weight (unitless). 28.01 for Pluto. OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: t - temperature (K) at r COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.3 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_t.pro)
NAME: oclc_ey92_t0 PURPOSE: (one line) return reference temperature DESCRIPTION: return reference temperature CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: t0 = oclc_ey92_t0(r0,lam0, Mp, mu0) INPUTS: r0 - reference radius (scalar, cm) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) Mp - planet mass (g). 1.30497e+25 for Pluto (Buie et al 2006) mu0 - molecular weight (unitless). 28.01 for Pluto. OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: t0 - temperature (K) at r0 COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.10 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_t0.pro)
NAME: oclc_ey92_table2 PURPOSE: (one line) reproduce table 2 DESCRIPTION: reproduce table 2 CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: oclc_ey92_table2, time, rho, r, lam, nu, kappa, tauobs, phi_cyl, phi_ref, phi INPUTS: none OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: time - time COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991 MODIFICATION HISTORY: Written 2006 Sep 15, Leslie Young
(See oclc_ey92_table2.pro)
NAME: oclc_ey92_table3a PURPOSE: (one line) reproduce table 3a DESCRIPTION: reproduce table 3a CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: oclc_ey92_table3a, time, rho, r, lam, nu, kappa, tauobs, phi_cyl, phi_ref, phi INPUTS: none OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: time - time COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.18 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_table3a.pro)
NAME: oclc_ey92_table7 PURPOSE: (one line) reproduce table 7 DESCRIPTION: reproduce table 7 from Elliot and Young, 1992 CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: oclc_ey92_table7, kao=kao INPUTS: none OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: kao : optional filename for kao.utts KEYWORD OUTPUT PARAMETERS: none OUTPUTS: time - time COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991 MODIFICATION HISTORY: Written 2006 Sep 15, Leslie Young
(See oclc_ey92_table7.pro)
NAME: oclc_ey92_tauobs PURPOSE: (one line) return tauobs (line-of-sight optical depth) as a function of radius DESCRIPTION: return tauobs as a function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: tauobs = oclc_ey92_tauobs(r1, kappa1, htau1, order, r) INPUTS: r1 - top of haze layer kappa1 - linear absorption coefficient at r1 htau1 - scale height of absorbtion coefficient order - order for series r - radius at which to evaluat tauobs (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: tauobs (line-of-sight optical depth, unitless) at r (planet radius, cm) COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 4.20 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_tauobs.pro)
NAME: oclc_ey92_tauvert PURPOSE: (one line) return tauvert (vertical optical depth) as a function of radius DESCRIPTION: return tauvert as a function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: tauvert = oclc_ey92_tauvert(r1, kappa1, htau1, order, r) INPUTS: r1 - top of haze layer kappa1 - linear absorption coefficient at r1 htau1 - scale height of absorbtion coefficient order - order for series r - radius at which to evaluate tauvert (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: tauvert (optical depth from top to r, unitless) at r (planet radius, cm) COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: /r1 tau(r) = | kappa(r) dr /r kappa(r) from Elliot and Young 1992, eq 3.23 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_tauvert.pro)
NAME: oclc_ey92_theta PURPOSE: (one line) return theta (bending angle) as a function of radius DESCRIPTION: return theta as a function of radius CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: theta = oclc_ey92_theta(r0,nu0,lam0,a,b,order,r) INPUTS: r0 - reference radius (scalar, cm) nu0 - refractivity at r0 (scalar, unitless) lam0 - reference energy ratio (radius/scale height) (scalar, unitless) a - exponent for non-constant mean moleculr weight mu(r) = mu0 * (r/r0)^-a b - exponent for non-constant temperature T(r) = T * (r/r0)^b order - order for series expansion r - radius at which to evaluat theta (scalar or array, cm) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: none OUTPUTS: theta at r bending angle, negative for an isothermal atmosphere. radians. COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: None PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eg 3.20 MODIFICATION HISTORY: Written 2006 Jun 28, Leslie Young
(See oclc_ey92_theta.pro)
NAME: oclc_ey92_timemid PURPOSE: (one line) return mid time of event DESCRIPTION: return mid time of event CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: timemid = oclc_ey92_timemid(timeim, timeem) INPUTS: v = sky-plane velocity (assuming linear motion), cm/s rhomin = minimum observer distance (km) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: OUTPUTS: timemin = minimum observer distance in units of s. COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: Admitedly silly to have this as a seperate function PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eq 5.8 MODIFICATION HISTORY: Written 2006 Aug 18, Leslie Young
(See oclc_ey92_timemid.pro)
NAME: oclc_ey92_timemin_of_rhomin PURPOSE: (one line) return minimum observer distance in units of s. DESCRIPTION: return minimum observer distance in units of s. CATEGORY: Occultation lightcurve (oclc) CALLING SEQUENCE: time_min = oclc_ey92_timemin_of_rhomin(v, rhomin) INPUTS: v = sky-plane velocity (assuming linear motion), cm/s rhomin = minimum observer distance (km) OPTIONAL INPUT PARAMETERS: none KEYWORD INPUT PARAMETERS: none KEYWORD OUTPUT PARAMETERS: OUTPUTS: timemin = minimum observer distance in units of s. COMMON BLOCKS: None SIDE EFFECTS: RESTRICTIONS: Admitedly silly to have this as a seperate function PROCEDURE: Elliot and Young 1992, AJ 103, pp 991; eq 5.8 MODIFICATION HISTORY: Written 2006 Aug 18, Leslie Young
(See oclc_ey92_timemin_of_rhomin.pro)