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: Wed Mar 31 06:39:50 1999.
NAME: cdf_cat_file PURPOSE: Print information about a CDF to an ASCII file. CALLING SEQUENCE: cdf_cat_file,cdfname,file INPUTS: cdfname: name of CDf to be opened. file: name of ASCII file to be created (defaults to cdf_info.dat). HISTORY: Adapted from routine cdf_cat in IDL distribution. Simon Plunkett, 29 March 1996.
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/cdf_cat_file.pro)
NAME:
COCO_J2000
PROJECT:
SOHO-LASCO.
PURPOSE:
Transform between celestial and ecliptic coordinates for
equinox J2000.
CALLING SEQUENCE:
COCO_J2000, AI, BI, AO, BO, [ SELECT ]
INPUTS:
AI - Input Longitude in DEGREES, scalar or vector. If only two
parameters are supplied, then AI and BI will be modified to
contain the output longitude and latitude.
BI - Input Latitude in DEGREES
OPTIONAL INPUT:
SELECT - Integer (1-2) specifying type of coordinate transformation.
SELECT From To
1 Equatorial Ecliptic
2 Ecliptic Equatorial
If omitted, program will prompt for the value of SELECT
OUTPUTS:
AO - Output Longitude in DEGREES
BO - Output Latitude in DEGREES
HISTORY:
Adapted from IDL Astronomy Library routine EULER by
W. Landsman. Corrected to use obliquity of the ecliptic for
J2000. Simon Plunkett, February 1996.
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/coco_j2000.pro)
NAME: DTSELECT PURPOSE: Widget tool for date/time selection. CATEGORY: Widgets. CALLING SEQUENCE: dtselect, curtime INPUTS: None. OUTPUTS: curtime: Time selection as defined by user. MODIFICATION HISTORY: Written by: Simon Plunkett, May 1995.
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/dtselect.pro)
Project : SOHO - CDS Name : GET_SC_ATT() Purpose : Get the SOHO spacecraft attitude. Category : Class3, Orbit Explanation : Read the definitive attitude file to get the spacecraft pointing and roll information. If no definitive file is found, then the nominal values are returned as "Predictive". Syntax : Result = GET_SC_ATT( DATE [, TYPE ] ) Examples : Inputs : DATE = The date/time value to get the attitude information for. Can be in any CDS time format. Opt. Inputs : None. Outputs : The result of the function is a structure containing the spacecraft attitude information. It contains the following tags: SC_AVG_PITCH_ECLIP SC_AVG_ROLL_ECLIP SC_AVG_YAW_ECLIP SC_AVG_PITCH SC_AVG_ROLL SC_AVG_YAW GCI_AVG_PITCH GCI_AVG_ROLL GCI_AVG_YAW GSE_AVG_PITCH GSE_AVG_ROLL GSE_AVG_YAW GSM_AVG_PITCH GSM_AVG_ROLL GSM_AVG_YAW SC_STD_DEV_PITCH SC_STD_DEV_ROLL SC_STD_DEV_YAW SC_MIN_PITCH SC_MIN_ROLL SC_MIN_YAW SC_MAX_PITCH SC_MAX_ROLL SC_MAX_YAW All parameters are in radians. Opt. Outputs: TYPE = Returns whether predictive or definitive data was used to calculate the result. Returned as either "Definitive" or "Predictive". Keywords : RETAIN = If set, then the FITS attitude file will be left open. This speeds up subsequent reads. ERRMSG = If defined and passed, then any error messages will be returned to the user in this parameter rather than depending on the MESSAGE routine in IDL. If no errors are encountered, then a null string is returned. In order to use this feature, ERRMSG must be defined first, e.g. ERRMSG = '' Result = GET_SC_ATT( ERRMSG=ERRMSG, ... ) IF ERRMSG NE '' THEN ... Calls : CONCAT_DIR, FXBOPEN, FXBREAD Common : Private common block GET_SC_ATT is used to keep track of the attitude file opened when the RETAIN keyword is used. Restrictions: The attitude entries for the time closest to that requested is used to calculate the parameters. Since the attitude data is calculated every 10 minutes, this should be correct within +/-5 minutes. No attempt is made to interpolate to closer accuracy than that. Side effects: Any data with too much variation (max-min) in the attitude data are rejected. The limits are one arcminute in pitch and yaw, and one degree in roll. Prev. Hist. : None. History : Version 1, 3-Jan-1997, RA Howard, NRL Adapted from Version 7 of GET_SC_ATT, written by W.Thompson Removed /DIR from calls to concat_dir Changed call to OS_VERSION() to use system variable !version Contact : WTHOMPSON
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/get_att_fits.pro)
Project : SOHO - LASCO Name : GET_ORBIT_CDF() Purpose : Get the SOHO orbit information. Category : Class3, Orbit Explanation : Reads orbit information from either the definitive or predictive orbit file, whichever it can find first. Syntax : Result = GET_ORBIT_CDF( DATE [, TYPE ] ) Examples : Inputs : DATE = The date/time value to get the orbit information for. Can be in any SOHO/CDS time format. Opt. Inputs : None. Outputs : The result of the function is a structure containing the spacecraft orbit information. It contains the following tags. If unable to find this information, zeroes are returned instead. Opt. Outputs: TYPE = Returns whether predictive or definitive data was used to calculate the result. Returned as either "Definitive" or "Predictive". If the routine fails to return an answer, then the null string is returned. Keywords : RETAIN = If set, then the orbit cdf file will be left open. This speeds up subsequent reads. ERRMSG = If defined and passed, then any error messages will be returned to the user in this parameter rather than depending on the MESSAGE routine in IDL. If no errors are encountered, then a null string is returned. In order to use this feature, ERRMSG must be defined first, e.g. ERRMSG = '' Result = GET_ORBIT( ERRMSG=ERRMSG, ... ) IF ERRMSG NE '' THEN ... Calls : CONCAT_DIR, Various cdf handling routines. Common : Private common block GET_ORBIT_CDF is used to keep track of the orbit file opened when the RETAIN keyword is used. Side effects: None. Prev. Hist. : Adapted from William Thompson's GET_ORBIT to read CDF files rather than FITS. History : Written by Simon Plunkett, 27 March 1996. RAH, NRL, 18 Feb 97, mods to account for changes in CDF variables DW, NRL, 26 Aug 98, mod for change in predictive CDF filenames @(#)get_orbit_cdf.pro 1.2 08/26/98 LASCO IDL LIBRARY
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/get_orbit_cdf.pro)
Project : SOHO - LASCO Name : GET_ORBIT_CDF2() Purpose : Get the SOHO orbit information. Category : Class3, Orbit Explanation : Reads orbit information from either the definitive or predictive orbit file, whichever it can find first. Syntax : Result = GET_ORBIT_CDF2( DATE [, TYPE ] ) Examples : Inputs : DATE = The date/time value to get the orbit information for. Can be in any SOHO/CDS time format. Opt. Inputs : None. Outputs : The result of the function is a structure containing the spacecraft orbit information. It contains the following tags. If unable to find this information, zeroes are returned instead. Opt. Outputs: TYPE = Returns whether predictive or definitive data was used to calculate the result. Returned as either "Definitive" or "Predictive". If the routine fails to return an answer, then the null string is returned. Keywords : RETAIN = If set, then the orbit cdf file will be left open. This speeds up subsequent reads. ERRMSG = If defined and passed, then any error messages will be returned to the user in this parameter rather than depending on the MESSAGE routine in IDL. If no errors are encountered, then a null string is returned. In order to use this feature, ERRMSG must be defined first, e.g. ERRMSG = '' Result = GET_ORBIT( ERRMSG=ERRMSG, ... ) IF ERRMSG NE '' THEN ... Calls : CONCAT_DIR, Various cdf handling routines. Common : Private common block GET_ORBIT_CDF is used to keep track of the orbit file opened when the RETAIN keyword is used. Side effects: None. Prev. Hist. : Adapted from William Thompson's GET_ORBIT to read CDF files rather than FITS. History : Written by Simon Plunkett, 27 March 1996. Adapted to read new CDF files (CRN_EARTH and CRN_SPACE tags replaced by single CRN tag). SPP, 7 August 1996. Mods to deal with: 1) differing file names on CDs and in GSFC archive and 2) to take account of changes in CRN definition in CDF files. 14 March 1997 (SPP).
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/get_orbit_cdf2.pro)
Project : SOHO - CDS Name : GET_ORBIT_FITS() Purpose : Get the SOHO orbit information. Category : Class3, Orbit Explanation : Reads orbit information from either the definitive or predictive orbit file, whichever it can find first. Syntax : Result = GET_ORBIT_FITS( DATE [, TYPE ] ) Examples : Inputs : DATE = The date/time value to get the orbit information for. Can be in any CDS time format. Opt. Inputs : None. Outputs : The result of the function is a structure containing the spacecraft orbit information. It contains the following tags. If unable to find this information, zeroes are returned instead. Opt. Outputs: TYPE = Returns whether predictive or definitive data was used to calculate the result. Returned as either "Definitive" or "Predictive". If the routine fails to return an answer, then the null string is returned. Keywords : RETAIN = If set, then the orbit FITS file will be left open. This speeds up subsequent reads. ERRMSG = If defined and passed, then any error messages will be returned to the user in this parameter rather than depending on the MESSAGE routine in IDL. If no errors are encountered, then a null string is returned. In order to use this feature, ERRMSG must be defined first, e.g. ERRMSG = '' Result = GET_ORBIT_FITS( ERRMSG=ERRMSG, ... ) IF ERRMSG NE '' THEN ... OLD = If set, then files are read in from the subdirectory "old_samples". This is used to test the software until real data files are available. Calls : CONCAT_DIR, FXBOPEN, FXBREAD Common : Private common block GET_ORBIT is used to keep track of the orbit file opened when the RETAIN keyword is used. Restrictions: The orbit entries for the time closest to that requested is used to calculate the orbit parameters. Since the orbit data is calculated every 10 minutes, this should be correct within +/-5 minutes. No attempt is made to interpolate to closer accuracy than that. Side effects: None. Prev. Hist. : None. History : Version 1, 04-Dec-1995, William Thompson, GSFC Adapted from Bill Thompson's GET_ORBIT. Removed /DIR keyword from calls to CONCAT_DIR, 7 August 1996 (SPP). Changed structure definition to SOHO_ORBIT_FITS to avoid clashes with structures from CDF files, 14 March 1997 (SPP). Contact : WTHOMPSON
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/get_orbit_fits.pro)
PROJECT:
SOHO - LASCO
NAME:
POINTING3
PURPOSE:
Widget interface to display LASCO pointing information.
CATEGORY:
Widgets.
CALLING SEQUENCE:
Pointing3
INPUTS:
OPTIONAL INPUTS:
KEYWORD PARAMETERS:
OUTPUTS:
OPTIONAL OUTPUTS:
COMMON BLOCKS:
lasco.com, chandle.com
SIDE EFFECTS:
RESTRICTIONS:
PROCEDURE:
EXAMPLE:
MODIFICATION HISTORY:
Written by: Simon Plunkett, May 1995.
November 1995: Major revision--adapted to use FITS keywords
and do gnomonic projections. Got rid of (almost) all
common blocks. SPP.
December 1995: Included distortion effects in C2.
Tidied up format statements.
Made compatible with V1.0 of LASCO display
s/w. SPP.
April 1996: Adapted to use SOHO orbit parameters from CDF
files. SPP.
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/pointing3.pro)
NAME:
RD_CATALOG
PURPOSE:
Read star catalogs for any of the three LASCO coronagraphs.
CATEGORY:
CALLING SEQUENCE:
rd_catalog,telescope,catalog
INPUTS:
telescope: string containing telescope name.
KEYWORD PARAMETERS:
None.
OUTPUTS:
catalog: structure containing fields in catalog file.
PROCEDURE:
Straightforward.
MODIFICATION HISTORY:
Written by Simon Plunkett, April 1995.
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/rd_catalog.pro)
PROJECT:
SOHO - LASCO
NAME:
SETUP_ASTROM
PURPOSE:
Set up FITS-type astrometry structure in CD format for any
of the LASCO telescopes.
CALLING SEQUENCE:
setup_astrom, telescope, astrom
INPUTS:
telescope: string containing telescope name.
sunephem: structure containing solar ephemeris information
(obtained from sohoephem.pro).
naxis1: no. of pixels in horizontal direction.
naxis2: no. of pixels in vertical direction.
OUTPUTS:
astrom: Anonymous structure containing astrometry info in FITS
CD format.
OPTIONAL INPUTS:
ocentre: Two-element vector giving pixel location of centre of
occulting disk (defaults to image centre).
pscale: Scalar giving plate scale in arcsec/pixel (defaults to
nominal value for specified telescope.
vangle: Scalar giving angle of image vertical (Y-axis) from
solar north in degrees (defaults to zero).
PROCEDURE:
Straightforward.
RESTRICTIONS:
Assumes nominal values for astrometry parameters for each
telescope (i.e. solar north is straight up, Sun at centre of
occulter and nominal values for plate scale).
Intended to be called from another routine (e.g. starfield.pro).
MODIFICATION HISTORY:
Written by Simon Plunkett, February 1996.
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/setup_astrom.pro)
NAME: sohoephem PURPOSE: Compute solar/planetary ephemerides. CATEGORY: CALLING SEQUENCE: sohoephem,tjd,iorig,slong,slat,orient,nrot,trot,dsol,plong, plat,xphase,fillum,dpla INPUTS: tjd: Julian date (including fraction of day). rsoho: Position/velocity of SOHO in heliocentric coordinates (in AU and AU/day). iorig: Origin of coordinates. iorig = 1: Geocentric. iorig = 2: Sohocentric. OUTPUTS: sunephem: Structure containing solar ephemeris information. planephem: Array of structures containing planetary ephemeris information for 5 major planets. PROCEDURE: Uses CALL_EXTERNAL to FORTRAN routine. Results returned in structures. HISTORY: Written by Simon Plunkett, September 1995. Adapted 29 March 1996 to include SOHO orbit parameters. (SPP). KNOWN BUGS: Not handling planet positions correctly yet.
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/sohoephem.pro)
NAME:
sohoephem2
PURPOSE:
Compute solar/planetary ephemerides.
CATEGORY:
CALLING SEQUENCE:
sohoephem,tjd,iorig,slong,slat,orient,nrot,trot,dsol,plong,
plat,xphase,fillum,dpla
INPUTS:
tjd: Julian date (including fraction of day).
rsoho: Position/velocity of SOHO in heliocentric coordinates
(in AU and AU/day).
iorig: Origin of coordinates.
iorig = 1: Geocentric.
iorig = 2: Sohocentric.
OUTPUTS:
sunephem: Structure containing solar ephemeris information.
planephem: Array of structures containing planetary ephemeris
information for 5 major planets.
PROCEDURE:
Uses CALL_EXTERNAL to FORTRAN routine.
Results returned in structures.
HISTORY:
Written by Simon Plunkett, September 1995.
Adapted 29 March 1996 to include SOHO orbit parameters. (SPP).
Adapted 4 June 1996 to use FITS rather than CDF orbit files (SPP).
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/sohoephem2.pro)
NAME:
sohoephem3
PURPOSE:
Compute solar/planetary ephemerides.
CATEGORY:
CALLING SEQUENCE:
sohoephem,tjd,iorig,slong,slat,orient,nrot,trot,dsol,plong,
plat,xphase,fillum,dpla
INPUTS:
tjd: Julian date (including fraction of day).
rsoho: Position/velocity of SOHO in heliocentric coordinates
(in AU and AU/day).
iorig: Origin of coordinates.
iorig = 1: Geocentric.
iorig = 2: Sohocentric.
OUTPUTS:
sunephem: Structure containing solar ephemeris information.
planephem: Array of structures containing planetary ephemeris
information for 5 major planets.
PROCEDURE:
Uses CALL_EXTERNAL to FORTRAN routine.
Results returned in structures.
HISTORY:
Written by Simon Plunkett, September 1995.
Adapted 29 March 1996 to include SOHO orbit parameters. (SPP).
Adapted 4 June 1996 to use FITS rather than CDF orbit files. (SPP).
Adapted 14 March 1997 to use FITS or CDF files (including all
mods to CDF file structure). (SPP).
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/sohoephem3.pro)
PROJECT:
SOHO - LASCO
NAME:
STARFIELD
PURPOSE:
Widget interface to display stars and planets in field of view
of any of the three LASCO coronagraphs.
CATEGORY:
Widgets.
CALLING SEQUENCE:
Starfield
INPUTS:
OPTIONAL INPUTS:
KEYWORD PARAMETERS:
OUTPUTS:
OPTIONAL OUTPUTS:
COMMON BLOCKS:
SIDE EFFECTS:
RESTRICTIONS:
PROCEDURE:
EXAMPLE:
MODIFICATION HISTORY:
Written by: Simon Plunkett, February 1996
(adapted from pointing3.pro).
Adapted to use SOHO orbit parameters from CDF files,
2-April-96 (SPP).
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/starfield.pro)
PROJECT:
SOHO - LASCO
NAME:
STARFIELD2
PURPOSE:
Widget interface to display stars and planets in field of view
of any of the three LASCO coronagraphs.
CATEGORY:
Widgets.
CALLING SEQUENCE:
Starfield2
INPUTS:
OPTIONAL INPUTS:
KEYWORD PARAMETERS:
OUTPUTS:
OPTIONAL OUTPUTS:
COMMON BLOCKS:
SIDE EFFECTS:
RESTRICTIONS:
PROCEDURE:
EXAMPLE:
MODIFICATION HISTORY:
Written by: Simon Plunkett, February 1996
(adapted from pointing3.pro).
Adapted to use SOHO orbit parameters from FITS files,
4-June-96 (SPP).
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/starfield2.pro)
PROJECT:
SOHO - LASCO
NAME:
STARFIELD3
PURPOSE:
Widget interface to display stars and planets in field of view
of any of the three LASCO coronagraphs.
CATEGORY:
Widgets.
CALLING SEQUENCE:
Starfield3
INPUTS:
OPTIONAL INPUTS:
KEYWORD PARAMETERS:
OUTPUTS:
OPTIONAL OUTPUTS:
COMMON BLOCKS:
SIDE EFFECTS:
RESTRICTIONS:
PROCEDURE:
EXAMPLE:
MODIFICATION HISTORY:
Written by: Simon Plunkett, February 1996
(adapted from pointing3.pro).
Adapted to use SOHO orbit parameters from CDF files,
2-April-96 (SPP).
Adapted to use new version of CDF orbit files,
7-August-1996 (SPP).
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/starfield3.pro)
PROJECT:
SOHO - LASCO
NAME:
STARFIELD4
PURPOSE:
Widget interface to display stars and planets in field of view
of any of the three LASCO coronagraphs.
CATEGORY:
Widgets.
CALLING SEQUENCE:
Starfield4
INPUTS:
OPTIONAL INPUTS:
KEYWORD PARAMETERS:
OUTPUTS:
OPTIONAL OUTPUTS:
COMMON BLOCKS:
SIDE EFFECTS:
RESTRICTIONS:
PROCEDURE:
EXAMPLE:
MODIFICATION HISTORY:
Written by: Simon Plunkett, February 1996
(adapted from pointing3.pro).
Adapted to use SOHO orbit parameters from either CDF or FITS
files. 14 March 1997 (SPP).
(See /net/cronus/opt/local/idl_nrl_lib/lasco/astrometry/ephemeris/starfield4.pro)