The OYSTER scheduling routines assist in creating an observing list (stored in the startable) from scratch or from another list stored on disk, and computing the visibility of the stars in a specific night and array configuration. The date of observation is taken from the variable date, and the array name from the variable systemid. If these are not defined, defaults are used for date (the next night) and for array (NPOI).
As to the system configuration, a list of stations can be passed
to plotuptime which will then create a system configuration
Create startable for stars specified.read_obslist,file_char
Read observation list from file and create startable. This procedure only reads the first, i.e. the star column of the file. It ignores lines containing an exclamation mark.selectup[,from_data_int][,mintime=min]
Remove stars from startable which are not available. Either compute predicted availability (default), or derive from currently loaded data (). Use keyword mintime (default 3 hours) to specify minimum availability after sunset and before sunrise.selectnew[,dates=nd][,scans=ns]
Remove stars from startable which were observed before at least nd times with ns scans or more each. The parameters default to and .selectdone[,dates=nd][,scans=ns]
Remove stars from startable which have not been observed before at least nd times with ns scans or more each. The parameters default to and .addstar,stars_char
Add one or more stars to the startable.removestar,stars_char
Examples: addstar,'FKV0193', addstar,['FKV0621','FKV0641']. Also sorts the stars by ID.
Remove one or more stars from the startable.addcal,star_char[,vlimit_real]
Lookup a calibrator for given star. The nearest calibrator (based on classification in diameter.bsc) with a visual magnitude brighter than vlimit (default 4.5) is added to the startable.compileobslist
Rename stars in startable to their FKV equivalents, if possible, read the catalogs, get auxilliary information, and re-order stars.plotuptime[,from_data_int][,stations=stations] [,stars=stars]
Compute visibility for stars in startable and plot. If from_data=1, plot actual visibility for currently loaded scan data. A list of stars can be passed to this procedure, which is a shurtcut over allocation with get_startable. If stations are not defined, a four-station astrometric array is assumed.writeobslist[,from_data_int][,time=time]
Compute visibility and write startable with auxilliary information to file. The name of the file is derived from the date, the extension is .obs. The RA and declination fields in the observing list now refer to a suitable background, i.e. blank sky location.compile_astrometry
Compile astrometry observing list.