ORAC: Glossary and Reference List


Alan Bridger and Gillian Wright

orac000-garl Version: 06 Created: 22 February 1999 Modified: 22 February 1999

This document contains the ORAC project glossary and reference list.

1.0 Introduction


This document attempts to provide a glossary of all of the acronyms, abbreviations and terms used in the ORAC project documents. It also provides a list of all of the other documents referenced in these documents, and of other relevant documents. The purpose of this is to save repeating these list in each document produced.

New references and definitions will be added to this document as required. It is recognised that as new references are added they cannot be kept in alphabetic order as the reordering would require cross-references from other documents to be updated. However, some attempt at organisation is made by separating the documents into categories, giving each a separate number list.

As the project has developed some of the terms used to describe items and functions have changed. For example the adoption of the Gemini OT as the observation preparation system in ORAC has led to the adoption of a number of terms deriving from it. We have tried to idetify such dual terms in the glossary, but it may be incomplete.

2.0 Glossary


ADAM

Astronomical Data Acquisition Monitor, the distributed tasking system in use at UKIRT and at other UK connected telescopes, and by Starlink. This comes in a VMS flavour and a Unix flavour (also in Perkin-Elmer and Transputer flavours of less relevance).

ALICE

Array Limited Infrared Control Environment

CAD

Command Action Directive

CAR

Command Action Response

Chained

Observations are "chained" in the OT to indicate that they must be carried out sequentially, but not necessarily consecutively

Chooser

The ORAC software that allows the user to choose which Observation to carry out next, and which provides the user interface to the Sequencer.

CHOP

A mode in which exposures are secured at two adjacent positions on the sky by chopping and in which the array is read only at the end of each exposure.

chopping

The process of switching the telescope pointing between two adjacent points on the sky by movement of the chopping secondary mirror, the "chopper".

CICS

The Gemini Core Instrument Control System

Classical

The form of observing which is current practice at UKIRT, whereby an observer is awarded a block of time in which to observe.

Config

The ascii file that contains a description of the required instrument configuration ( filters, exposure times etc.), and which is used by the ICS

DHS

Data Handling System - or the system that is responsible for storage and rapid display of data acquired, and for other such "data handling". Depending on context this might be the Gemini DHS or the UKIRT DHS.

DRAMA

The AAO tasking system that has carried on where ADAM left off.

Edict

EDinburgh Infrared ConTrol. The next generation of ALICE.

EPICS

Experimental Physics and Industrial Control System

EXEC

EXECutable procedure - the description of the required sequence of instrument configurations, telecope moves, exposures, which is used by the Sequencer (ORAC) or ICS (current).

exposure

The interval between resets of the array. Depending on the current mode, the buildup of charge on the array may be read once or several times during this period.

Flexible Scheduling

Observatory operations in which an attempt is made to schedule individual observations for numerous users on any given night, according to required conditions, in order to maximise the science output of the telescope.

Frame

A data frame, or the acquisition thereof. Perhaps used inconsistently, and roughly equivalent to an integration in the current UKIRT system.

Grouped

Observations are grouped in the OT to indicate that they must be Scheduled as a single un-interruptible block, with any relative order.

ICD

Interface Control Document

ICS

Instrument Control System

Instrument Configuration

The same as Config.

integration

A sequence of one or more exposures. Data within an integration is combined in the detector software system and returned as a single dataset to the host. The exposures may be made in a single beam or in two beams, depending on the mode. The result of a single OBSERVE command.

mode

One of STARE, ND_STARE, CHOP, ND_CHOP, and similar UFTI terms.

ND_CHOP

A mode in which exposures are secured at two adjacent positions on the sky by chopping, and in which the array is read several times during each exposure.

ND_STARE

A mode in which exposures are performed at a single target position on the sky (i.e. not chopping) and in which the array is read several times during each exposure.

Observation Sequence

The sequence of telescope movements and integrations used to obtain an observation of a source.

observation

A sequence of one or more integrations secured on the same target object. In this definition is roughly equivalent to a group. (Not quite the same as Observation in OT terminology, but closely related subset - see next item)

Observation Definition

Also called Observation in some documents, and in particular by the OT. The electronic description of the instrument configuration, target details, sequence, required conditions for the observation of a single astronomical target. It is the smallest schedulable unit.

Observation Database

The database of Science Programmes and Observations which have been created using the OT and submitted to UKIRT.

Observation Scheduler

Those aspects of the Scheduler which are concerned with calculating an Observing plan for a night.

Observation Preparation System

The tool used by the users for phase-2 input. For the ORAC system this is the same as the OT. For the current system it refers to UKIRT_PREP

Observing Mode

The mode into which an instrument (or ICS) is put for an Observation. Thus for an OBSERVE command an ICS will be in a single Observing Mode and everything required to acquire the data at that stage must be handled by the ICS.

Observing Tool

Originally the Gemini Observing Tool, there is now also a version for UKIRT in development. The Phase 2 preparation system.

Observing Plan

Ordered list of targets to be observed on a given night, prepared by the Scheduler

ORAC-DR

The ORAC pipeline data reduction system

OCS

Observatory Control System. The system that has overall control of observing at the Observatory, in charge of the other systems. Depending on context this may be the Gemini OCS or the UKIRT OCS.

OT

Short for the Observing Tool (Gemini or UKIRT version).

PATT

Panel for the allocation of telescope time

Phase -1

Proposal submission by the observer, proposal information

Phase -2

The detailed definition of required Observations for accepted proposals.

Plan

short from of Observing Plan or Semester Plan

Program(me)

short form of Science Program(me)

Queue

The Observing Plan - the ordered list of Observations to be executed sequentially.

Queue Scheduled

Flexibly scheduled observing implementation in which the Observations to be carried out are sorted into a queue based on their requirements and priority.

Recipe

description of the steps for reducing data in ORAC-DR

Science Programme, Science Program

All the observations required for all the sources a PI has been awarded time for. In general 'programme' is used to refer to the human concept and 'program' to the electronic version - ie the output of the OT for several targets. (but this may not be consistent in older documents).

Semester Plan

Plan for a semester of flexible and classical observing, as prepared by the Scheduler

Service

The current UKIRT service programme.

Scheduler

Software to create nightly Observing Plans, and analyse Semester Plan

Script

Sometimes a general term, sometimes referring to an ORAC-DR script.

SGML

Standard Generalised Markup Language

SIR

Status and Information Record

STARE

A mode in which exposures are performed at a single target position on the sky (i.e. not chopping) and in which the array is read only at the end of each exposure.

Strategic Scheduler

Those functions of the Scheduler which are concerned with keeping track of/ analysing the distribution of allocations for a semester.

Target Description

Information describing the target: co-ordinates, guide star location

TAG

(UKIRT) Time Allocation Group

TCS

Telescope Control System

userid

The users chosen name which is used as the name of the sub-directory in which their Configs and EXECs are stored. (usually the users initials)

VxWorks

A real time operating system from Wind River.

XML

eXtensible Markup Language

3.0 References


3.1 ORAC References

References to documents in the ORAC project.

[O-1] orac001-wpd, "The ORAC Project: Overview and Description", Alan Bridger and Gillian Wright, Royal Observatory Edinburgh and Frossie Economou and Nick Rees, Joint Astronomy Centre.
[O-2] orac002-scen, "Scenarios", Gillian Wright, Royal Observatory Edinburgh.
[O-3] orac003-udrr, "UKIRT Data Reduction: Requirements", Alan Bridger and Gillian Wright, Royal Observatory Edinburgh and Frossie Economou, Joint Astronomy Centre.
[O-4] orac004-opsr, "Observation Preparation System: Requirements", Alan Bridger and Gillian Wright, Royal Observatory Edinburgh and Frossie Economou, Joint Astronomy Centre.
[O-5] orac005-seqr, "Observation Sequencer: Requirements", Alan Bridger and Gillian Wright, Royal Observatory Edinburgh and Frossie Economou, Joint Astronomy Centre.
[O-6] orac006-gote, "Using the Gemini Observing Tool on UKIRT", Alan Bridger and Gillian Wright, Royal Observatory Edinburgh.
[O-7] orac007-seqd. "Observing Sequencer: Design Document", Alan Bridger, Royal Observatory Edinburgh.
[O-8] orac008-udrd. "UKIRT Data Reduction Systrem Design", Frossie Economou, Joint Astronomy Centre, Alan Bridger, Gillian Wright and Malcolm Currie, Royal Observatory Edinburgh.
[O-9] orac009-ufts. "Ufti Scripts", Gillian Wright, Royal Observatory Edinburgh and Sandy Leggett, Joint Astronomy Centre.
[O-10] orac010-rev1. "Report of the ORAC Reviews, December 1997", Gillian Wright and Alan Bridger, Royal Observatory Edinburgh.
[O-11] orac011-drsg. "UKIRT Data Reduction: Software Guide", "The Usual Suspects"
[O-12] orac012-ocsd. "The Orac OCS: Overview Design". Alan Bridger, UKATC, Royal Observatory Edinburgh.
[O-13] orac013-seq2. "Observing Sequencer: Design Document", Alan Bridger, UKATC, Royal Observatory Edinburgh.
[O-14] orac014-chor. "Observation Chooser: Requirements", Alan Bridger and Gillian Wright, UKATC, Royal Observatory Edinburgh.
[O-15] orac015-oiis. "Orac Instrument Interface Specification", Alan Bridger, UKATC, Royal Observatory Edinburgh.
[O-16] orac016-fith. "UKIRT FITS Headers" Malcolm Currie, UKATC, Royal Observatory Edinburgh.
[O-17] orac017-rev2. "Report of the ORAC reviews - June 1998", Gillian Wright, UKATC, Royal Observatory Edinburgh.
[O-18] orac018-chod. "Observation Chooser: Design", Alan Bridger, Min Tan, Malcolm Currie, UKATC, Royal Observatory Edinburgh.
[O-19] orac019-odbc "Observation Database: Concept", Alan Bridger, Gillian Wright, UKATC, Royal Observatory Edinburgh.
[O-20] orac020-schr "UKIRT Scheduler: Requirements", Gillian Wright, Alan Bridger, UKATC, Royal Observatory Edinburgh.
[O-21] orac021-schp "UKIRT Scheduler:Preliminary Design", Alan Bridger, Gillian Wright ,UKATC, Royal Observatory Edinburgh

3.2 Michelle References

References to documents produced as part of the Michelle project.

[M-1] Michelle document 72d008s, "User requirements of the Michelle ALICE software.", Alan Pickup, Royal Observatory Edinburgh.
[M-2] Michelle document 72d010s, "Discussion Paper about the Software Requirements of the Michelle ALICE", Alan Bridger, Royal Observatory Edinburgh.
[M-3] Michelle document 75d001s, "User requirements of the Michelle Quick-Look Display", Alan Pickup, Royal Observatory Edinburgh.
[M-4] Michelle document 70d002s, "Structure of the Michelle Software and Migration to Gemini", Steven Beard, Royal Observatory Edinburgh.
[M-5] Michelle document 59d002, "Use of PCI Bus in Michelle ALICE", Joel Sylvester, Royal Observatory Edinburgh.
[M-6] Michelle document 59d003, "Michelle Data Acquisition Fibre Adaptor Mezzanine Card", Joel Sylvester, Royal Observatory Edinburgh.
[M-7] Michelle document 72d011s, "Software Requirements for the Michelle ALICE", Alan Bridger, Royal Observatory Edinburgh.
[M-8] Michelle document 70d004s, "Michelle Software: Glossary and Reference List", Alan Bridger, Royal Observatory Edinburgh.
[M-9] Michelle document 72d013s, "The Michelle ALICE Software Architecture", Alan Bridger & Alan Pickup, Royal Observatory Edinburgh.
[M-10] Michelle document 72d014s, "The Michelle ALICE Control Interface", Alan Pickup, Royal Observatory Edinburgh.

3.3 Gemini References

References to documents produced as part of the Gemini project.

[G-1] gscg.kkg.009, ICD 1a -- The System Command Interface, Gemini 8m Telescopes Project.
[G-2] gscg.grp.024, ICD 1b -- The Baseline Attribute/Value Interface, Gemini 8m Telescopes Project.
[G-3] gscg.kkg.010, ICD 2 -- Systems Status and Alarm Interfaces, Gemini 8m Telescopes Project.
[G-4] dhs_pdr_icd3, "ICD 3 -- Bulk Data Transfer", Norman Hill & Severin Gaudet, DAO.
[G-5] dhs_pdr_icd4, "ICD 4 -- Logging Interface", Norman Hill & Severin Gaudet, DAO.
[G-6] cics_smb_014, ICD 7a -- ICS Subsystem Interfaces, Steven Beard, Steve Wampler and Chris Mayer, Gemini 8m Telescopes Project.
[G-7] gscg.grp.012, ICD 8 -- Non-Conforming ICS Interfaces, Gemini 8m Telescopes Project.
[G-8] gscg.grp.???, "ICD 9 -- EPICS Time Bus Driver", Phil Taylor, Royal Greenwich Observatory.
[G-9] gscg.grp.025, ICD 16 -- The Parameter Definition Format, Steve Wampler, Gemini 8m Telescopes Project.
[G-10] ICD 1.4.4/1.9, "SCS to Science Instrument Interface", Magnus Paterson, Royal Observatory Edinburgh.
[G-11] cics_smb_013, "ICD 1.9/3.1 -- Science Instrument to Observatory Control System Interface", Steven Beard, Royal Observatory Edinburgh.
[G-12] cics_smb_021, "ICD 1.9/3.2 -- Science Instrument to Data Handling System Interface", Steven Beard, Royal Observatory Edinburgh.
[G-13] cics_smb_033, "ICD 1.9.3/1.9.5 -- Science Instrument to Detector Controller Interface", Steven Beard, Royal Observatory Edinburgh.
[G-14] TCS/PTW/6.6, "Time", P.T.Wallace, Rutherford Appleton Laboratory.
[G-15] comm_fprd_04, "Communications System Functional Performance Requirements", Jim Wright, International Gemini Project Office & Sandra Jaque, REUNA. (IN DRAFT)
[G-16] dhs_pdr_srs/02, "Software Requirements Specification", Dayle Kotturi, Normal Hill & Severin Gaudet, DAO - Gemini Data Handling System Report.
[G-17] dhs_pdr_sdd/02, "Software Design Description", Dayle Kotturi, Normal Hill & Severin Gaudet, DAO - Gemini Data Handling System Report.
[G-18] Wampler, S., Gillies, K., Puxley, P. & Walker, S. "Science Planning for the Gemini 8m Telescopes", SPIE vol 3112, in press (1998).
[G-19] Puxley, P., "Execution of queue-scheduled observations with the Gemini 8m telescopes", SPIE vol 3112, 234

3.4 Other References

References to other documents.

[X-1] Bridger, A. & Wright, G.S., "Queue Scheduled Observing at UKIRT - Evolution not Revolution", in "New Observing Modes for the Next Century", ed. Boroson, T., Davies, J. and Robson, I., ASP Conf. Ser. 87, 162 (1996).
[X-2] AAO/DRAMA_GUIDE_3, Guide to Writing DRAMA Tasks, Tony Farrell, Anglo-Australian Observatory.
[X-3] AAO/DITS_SPEC_5, Distributed Instrumentation Tasking System, Tony Farrell, Anglo-Australian Observatory.
[X-4] AAO/SDS_07, Self-defining Data System (SDS), Jeremy Bailey, Anglo-Australian Observatory.
[X-5] AAO/IMP_MANUAL_8, Interprocess Message Passing (IMP) System, Keith Shortridge, Anglo-Australian Observatory.
[X-6] LIGO Project internal working note, "Porting EPICS to the Baja4700", Dave Barker, Laser Interferometer Gravitational Wave Observatory CDS Group, Caltech/MIT.
[X-7] "Structured Development for Real-Time Systems", Ward, P.T. & Mellor, S.J., Yourdon Press, 1985.
[X-8] "The VLT Real Time Display", T. Herlin, A. Brighton & P. Biereilchel, ESO in "Astronomical Data Analysis Software and Systems V", ASP Conference Series, 101, 396. eds. George H. Jacoby & Jeannette Barnes. (1996)
[X-9] SUN/214 "GAIA - Graphical Astronomy and Image Analysis Tool", Peter W. Draper, Starlink Project, Rutherford Appleton Laboratory.
[X-10] SUN/27 "CGS4DR - Portable CGS4 data reduction", Phil Daly, Joint Astronomy Centre, pub. by Starlink Project, Rutherford Appleton Laboratory.
[X-11] "UKIRT Telescope Control System", Nick Rees, Joint Astronomy Centre, http://www.jach.hawaii.edu/UKIRT/software/telescope/.
[X-12] SUN/33 "NDF Routines for Accessing the Extensible N-Dimensional Data Format, Version 1.4, Programmers Manual", Rodney Warren-Smith, Starlink Project, Rutherford Appleton Laboratory.
[X-13] OCS System Note 18, "The Todd User Manual", Dennis Kelly, Joint Astronomy Centre/JCMT.
[X-14] OCS System Note 13, "The Todd Internals Manual", Dennis Kelly, Joint Astronomy Centre/JCMT.
[X-15] "Flexibly Scheduled Service Observing - Preliminary Requirements", R.P.J. Tilanus, Joint Astronomy Centre, Observation Management Project Note 1.0
[X-16] "Observation Management Project", R.M Prestage, T.Jenness, R.P.T. Tilanus, Joint Astronomy Centre, Observation Management Project Note 2.0
[X-17] "The VLT Control Software - Local and Remote Support for Operations by Astronomers and Operators", Allaert, E. & Raffi, G. in "New Observing Modes for the Next Century" ed. Boroson, T, Davies, J., and Robson, I., ASP Conf. Ser. 87, 192 (1996)
[X-18] http://ic-www.arc.nasa.gov/ic/projects/xfr/index.html
[X-19] Henry, G.W. , "ATIS Dispatch Scheduling of Robotic Telescopes" in "New Observing Modes for the Next Century" ed. Boroson, T, Davies, J., and Robson, I., ASP Conf. Ser. 87, 145 (1996)
[X-20] Steele, I.A. & Carter, D., "Control Software and Scheduling of the Liverpool Robotic Telescope", SPIE vol 3112, p222
[X-21] Steele, I.A., "An Object Model of the Liverpool Telescope", SPIE vol 3351, p232
[X-22] Chavan, A.M. et. al. , "Support tools for the VLT operations: the NTT prototyping experience", SPIE vol 3349, p97
[X-23] Johnston, M.D. & Miller, G.E., "SPIKE Intelligent Scheduling of Hubble Space Telescope Observations", in "Intelligent Scheduling" ed. Fox, M. & Zweben, M., (Morgan-Kaufmann, 1994) p 391