OBSPLAN

Name

obsplan

Purpose

Generate a graphical summary of object location(s) for a given night.

Description

Calling Sequence

obsplan,objcode,obs,date

Inputs

objcode - String array of standard object codes (see ephem.pro)
-or-
String containing file name of the list of objects but you
must preceed the file name with @ to mark it as a file
and not the name of an object.
If supplied as a file, this file is a correspondence list
of the type read by rdmatch. Column 1 contains the standard
object code and column 2 has a full or common name. The
columns are separated by a <tab> character and the common name
column MUST begin with a single quote ('). See RDMATCH
for more details about this file format.
obs - Integer Marsden code of the observatory
688 - Lowell Observatory
500 - Geocentric
If you provide an invalid code, 688 is assumed.
date - UT date and time vector near midnight,
[year,month,day,hour,minutes,seconds]

Optional Input Parameters

Keyword Input Parameters

ALLDAY - Flag, if set generates a plot for a full 24 hour period.
AMLIMIT - Cutoff airmass for plot, default = 2.6
OBSFILE - Override on file name where observatory codes are to be found.
STARCAT - Override on file name where star catalog is to be found (see
coord for default).

Outputs

Generates a plot to the current graphics device.

Keyword Output Parameters

Common Blocks

Side Effects

Restrictions

Procedure

Modification History

94/10/07, Initial version written by Marc W. Buie, Lowell Observatory
96/02/08, MWB, added parameter validation, airmass limit option,
and file option on objcode
96/02/15, MWB, added support for star lookup and plotting. Also, now
computes object position throughout night instead of
just at midnight.
96/03/19, MWB, allow JD for input date.
96/10/18, MWB, fixed bug that ignored h,m,s in input date.
96/11/1, MWB, Added ALLDAY keyword
98/09/28, MWB, Fixed a coordinate interpolation bug.
99/01/27, MWB, added support for stars.
99/02/23, MWB, fixed some lingering problems.
2001/03/16, David Tucker, changed rdobscod default file call.
2002/12/04, MWB, added support for strings in obs input.