MTPtg#

Note

This page is generated by python script generate_cet.py.

Back to table

Commands#

amLimitSet#

Description: Define the limit value for the airmass

EFDB_Topic:

MTPtg_command_amLimitSet

amlimit#

IDL_Type:

double

Units:

unitless

Description: Airmass limit value

azCurrentWrap#

Description: Move the azimuth axis by 360 or -360 degrees if possible.

EFDB_Topic:

MTPtg_command_azCurrentWrap

wrap#

IDL_Type:

long

Units:

unitless

Description: Wrap direction (cw=1 or ccw=2)?

azElTarget#

Description: Define a telescope target, with a position defined as Azimuth and Elevation.

EFDB_Topic:

MTPtg_command_azElTarget

targetName#

IDL_Type:

string

Units:

unitless

Description: Name of AzEl target

azDegs#

IDL_Type:

double

Units:

degree

Description: Azimuth of target in degrees

elDegs#

IDL_Type:

double

Units:

degree

Description: Elevation of target in degrees

trackId#

IDL_Type:

long

Units:

unitless

Description: Target identifier.

rotPA#

IDL_Type:

double

Units:

degree

Description: Desired instrument position angle, Eastwards from North

clearCollOffset#

Description: Clear (set to zero) collimation CA and CE values

EFDB_Topic:

MTPtg_command_clearCollOffset

num#

IDL_Type:

int

Units:

unitless

Description: Which offset to clear: 0 = user 1= handset 2=both

collOffset#

Description: Set collimation CE, CA values in the pointing model

EFDB_Topic:

MTPtg_command_collOffset

ca#

IDL_Type:

double

Units:

arcsec

Description: Collimation CA value

ce#

IDL_Type:

double

Units:

arcsec

Description: Collimation CE value

num#

IDL_Type:

int

Units:

unitless

Description: Which offset to clear to set: 0 = user 1= handset

debugLevel#

Description: Set the internal debug level. Increasing the debug level increases the number of log messages produced.

EFDB_Topic:

MTPtg_command_debugLevel

level#

IDL_Type:

long

Units:

unitless

Description: Log level.

ephemTarget#

Description: Define a telescope target using ephemeris data defined in a file.

EFDB_Topic:

MTPtg_command_ephemTarget

ephemFile#

IDL_Type:

string

Units:

unitless

Description: Name of file containing ephemeris data

targetName#

IDL_Type:

string

Units:

unitless

Description: Target name

dRA#

IDL_Type:

double

Units:

arcsec / s

Description: Differential Track Rate in RA, in addition to any inherent tracking rate the object may have

dDec#

IDL_Type:

double

Units:

arcsec / s

Description: Differential Track Rate in Dec, in addition to any inherent tracking rate the object may have

trackId#

IDL_Type:

long

Units:

unitless

Description: Target identifier.

rotPA#

IDL_Type:

double

Units:

degree

Description: Desired instrument position angle, Eastwards from North

validateOnly#

IDL_Type:

boolean

Units:

unitless

Description: If set True, then this target command is validated only, don’t change the current demand. The validation result will be posted by validatedTarget event.

focusName#

Description: Not used

EFDB_Topic:

MTPtg_command_focusName

focus#

IDL_Type:

long

Units:

unitless

Description: Select M3 focus position: prime, nasmyth1 or nasmyth2.

guideClear#

Description: Set current guiding offsets to zero

EFDB_Topic:

MTPtg_command_guideClear

ignored#

IDL_Type:

boolean

Units:

unitless

Description: This item is ignored and not used.

guideControl#

Description: Switch guiding on or off

EFDB_Topic:

MTPtg_command_guideControl

state#

IDL_Type:

long

Units:

unitless

Description: Guide controls state.

iersUpdate#

Description: Download IERS (earth rotation) data from remote server.

EFDB_Topic:

MTPtg_command_iersUpdate

ignored#

IDL_Type:

boolean

Units:

unitless

Description: This item is ignored and not used.

offsetAbsorb#

Description: Apply the current target offset(s) to the defined target position

EFDB_Topic:

MTPtg_command_offsetAbsorb

num#

IDL_Type:

int

Units:

unitless

Description: Which offset to absorb: 0 = user 1= handset 2 = both

offsetAzEl#

Description: Apply an offset, specified as Azimuth and Elevation offsets.

EFDB_Topic:

MTPtg_command_offsetAzEl

az#

IDL_Type:

double

Units:

arcsec

Description: Az offset position in arcseconds

el#

IDL_Type:

double

Units:

arcsec

Description: El offset in arcseconds

num#

IDL_Type:

int

Units:

unitless

Description: Offset identifier: 0 = user 1 = handset

offsetClear#

Description: Clear (set to zero) the currently defined target offset(s)

EFDB_Topic:

MTPtg_command_offsetClear

num#

IDL_Type:

int

Units:

unitless

Description: Which offset to clear: 0 = user 1= handset 2 = both

offsetPA#

Description: Apply an offset, defined by a position angle and radius, to the current target position.

EFDB_Topic:

MTPtg_command_offsetPA

angle#

IDL_Type:

double

Units:

degree

Description: Offset position angle in degrees, clockwise from North

radius#

IDL_Type:

double

Units:

arcsec

Description: Radial offset relative to target position

offsetRADec#

Description: Apply an offset in RA and Dec to the current target position.

EFDB_Topic:

MTPtg_command_offsetRADec

type#

IDL_Type:

long

Units:

unitless

Description: Type of offset: RA/Dec or Tangent Plane

off1#

IDL_Type:

double

Units:

arcsec

Description: Offset in RA or X, relative to target position (in arcsec if type is TPLANE, second if SIMPLE)

off2#

IDL_Type:

double

Units:

arcsec

Description: Offset in Dec or Y, relative to target position

num#

IDL_Type:

int

Units:

unitless

Description: Offset identifier: 0 = user 1 = handset

planetTarget#

Description: Select a named major planet as the telescope target.

EFDB_Topic:

MTPtg_command_planetTarget

planetName#

IDL_Type:

long

Units:

unitless

Description: Id of the planet name; mercury (1), venus (2), moon (3), mars (4), jupiter (5), saturn (6), uranus (7), neptune (8) or pluto (9)

dRA#

IDL_Type:

double

Units:

arcsec / second

Description: Differential Track Rate in RA, in addition to the planet’s inherent tracking rate

dDec#

IDL_Type:

double

Units:

arcsec / second

Description: Differential Track Rate in Declination , in addition to the planet’s inherent tracking rate

trackId#

IDL_Type:

long

Units:

unitless

Description: Target identifier.

rotPA#

IDL_Type:

double

Units:

degree

Description: Desired instrument position angle, Eastwards from North

validateOnly#

IDL_Type:

boolean

Units:

unitless

Description: If set True, then this target command is validated only, don’t change the current demand. The validation result will be posted by validatedTarget event.

pointAddData#

Description: Add telescope axis position data to the pointing data file.

EFDB_Topic:

MTPtg_command_pointAddData

ignored#

IDL_Type:

boolean

Units:

unitless

Description: This item is ignored and not used.

pointCloseFile#

Description: Close the pointing data file.

EFDB_Topic:

MTPtg_command_pointCloseFile

ignored#

IDL_Type:

boolean

Units:

unitless

Description: This item is ignored and not used.

pointLoadModel#

Description: Load a telescope pointing model defined in an existing data file

EFDB_Topic:

MTPtg_command_pointLoadModel

pointingFile#

IDL_Type:

string

Units:

unitless

Description: Name of existing pointing model data file

pointNewFile#

Description: Create and open a new pointing data file. A unique name for the file will be defined internally.

EFDB_Topic:

MTPtg_command_pointNewFile

ignored#

IDL_Type:

boolean

Units:

unitless

Description: This item is ignored and not used.

poriginAbsorb#

Description: Apply the current pointing origin offset(s) to the defined pointing origin

EFDB_Topic:

MTPtg_command_poriginAbsorb

num#

IDL_Type:

int

Units:

unitless

Description: Which offset to absorb: 0 = user 1= handset 2 = both

poriginClear#

Description: Clear (set to zero) any currently defined pointing origin offsets

EFDB_Topic:

MTPtg_command_poriginClear

num#

IDL_Type:

int

Units:

unitless

Description: Which offset to absorb: 0 = user 1= handset 2 = both

poriginOffset#

Description: Define an [X,Y] position offset for the current pointing origin on the focal plane

EFDB_Topic:

MTPtg_command_poriginOffset

dx#

IDL_Type:

double

Units:

mm

Description: X Pointing origin offset in the focal plane

dy#

IDL_Type:

double

Units:

mm

Description: Y Pointing origin offset in the focal plane.

num#

IDL_Type:

int

Units:

unitless

Description: Offset number: 0 = user 1 = handset

poriginXY#

Description: Define the absolute [X,Y] position of the pointing origin on the focal plane. The pointing origin is the position on the focal plane at which the current target is positioned.

EFDB_Topic:

MTPtg_command_poriginXY

x#

IDL_Type:

double

Units:

mm

Description: X Pointing origin in the focal plane. Origin is the axis of the rotator

y#

IDL_Type:

double

Units:

mm

Description: Y Pointing origin in the focal plane. Origin is the axis of the rotator

raDecTarget#

Description: Define a telescope target, with a position defined as RA and Dec.

EFDB_Topic:

MTPtg_command_raDecTarget

targetName#

IDL_Type:

string

Units:

unitless

Description: Name of target

frame#

IDL_Type:

long

Units:

unitless

Description: Target co-ordinate reference frame

epoch#

IDL_Type:

double

Units:

year

Description: Target epoch in years e.g. 2000.0. Julian (J) epoch is assumed.

equinox#

IDL_Type:

double

Units:

year

Description: Target equinox in years e.g. 2000.0

ra#

IDL_Type:

double

Units:

hour

Description: RA of target (Hours)

declination#

IDL_Type:

double

Units:

degree

Description: Declination of target (Degrees)

parallax#

IDL_Type:

double

Units:

arcsec

Description: Parallax (arcseconds)

pmRA#

IDL_Type:

double

Units:

arcsec / year

Description: Proper Motion (RA) in RA Seconds/year

pmDec#

IDL_Type:

double

Units:

arcsec / year

Description: Proper motion (Dec) in Arcseconds/year

rv#

IDL_Type:

double

Units:

km / second

Description: Radial velocity (km/sec)

dRA#

IDL_Type:

double

Units:

arcsec / second

Description: Differential Track Rate in RA

trackId#

IDL_Type:

long

Units:

unitless

Description: Target identifier.

dDec#

IDL_Type:

double

Units:

arcsec / second

Description: Differential Track Rate in Dec

rotAngle#

IDL_Type:

double

Units:

deg

Description: Desired instrument position angle, Eastwards from North if rotStartFrame is target or azel. Rotator physical angle if rotStartFrame is fixed.

rotStartFrame#

IDL_Type:

long

Units:

unitless

Description: Rotator co-ordinate frame for rotator start position. target = same frame as target. azel = maintain sky orientation. fixed = rotator physical angle.

rotTrackFrame#

IDL_Type:

long

Units:

unitless

Description: Rotator co-ordinate frame for rotator tracking. target = same frame as target. azel = maintain sky orientation. fixed = rotator physical angle.

rotMode#

IDL_Type:

long

Units:

unitless

Description: Rotator position mode (Field or Slit optimized)

azWrapStrategy#

IDL_Type:

long

Units:

unitless

Description: Azimuth wrap strategy.(1-noUnWrap, 2-optimize, 3-maxTimeOnTarget)

timeOnTarget#

IDL_Type:

double

Units:

second

Description: The total expected time on the target.

validateOnly#

IDL_Type:

boolean

Units:

unitless

Description: If set True, then this target command is validated only, don’t change the current demand. The validation result will be posted by validatedTarget event.

rotCurrentWrap#

Description: Move the rotator axis by 360 or -360 degrees if possible.

EFDB_Topic:

MTPtg_command_rotCurrentWrap

wrap#

IDL_Type:

long

Units:

unitless

Description: Wrap direction (cw = 1 or ccw=2)?

rotOffset#

Description: Define the instrument alignment angle (IAA)

EFDB_Topic:

MTPtg_command_rotOffset

iaa#

IDL_Type:

double

Units:

deg

Description: Instrument Alignment Angle (IAA)

startTracking#

Description: Calculate the RA and Dec co-ordinates that correspond to the current mount position and start tracking on this target

EFDB_Topic:

MTPtg_command_startTracking

trackId#

IDL_Type:

long

Units:

unitless

Description: Target identifier.

stopTracking#

Description: Stop tracking. Axes positions will not be sent to the mount.

EFDB_Topic:

MTPtg_command_stopTracking

ignored#

IDL_Type:

boolean

Units:

unitless

Description: This attribute is ignored and not used.

wavelength#

Description: Set the target effective wavelength

EFDB_Topic:

MTPtg_command_wavelength

wavelength#

IDL_Type:

double

Units:

micron

Description: Effective target wavelength

disable#

Description: Transition from state Enabled to Disabled.

EFDB_Topic:

SALGeneric_command_disable

Category:

csc

enable#

Description: Transition from state Disabled to Enabled.

EFDB_Topic:

SALGeneric_command_enable

Category:

csc

exitControl#

Description: Transition from state Standby to Offline. Most CSCs will quit, but CSCs that support the enterControl command will keep running.

EFDB_Topic:

SALGeneric_command_exitControl

Category:

csc

setAuthList#

Description: Specify who can command this CSC.

EFDB_Topic:

SALGeneric_command_setAuthList

Category:

csc

authorizedUsers#

IDL_Type:

string

Units:

unitless

Description: Comma seperated list of authorized users currently allowed to command this CSC,

in the form user@host. If the first character is +/- then the specified users are added/removed. Duplicates are silently ignored. The CSC’s own user@host is silently ignored, because it is always authorized. For removal, CSCs that are not in the list are silently ignored. Whitespace is allowed after the optional initial +/- and after each comma.

nonAuthorizedCSCs#

IDL_Type:

string

Units:

unitless

Description: Comma seperated list of CSC’s not currently allowed to command this CSC,

in the form name[:index]. An index of 0 is stripped (name:0 becomes name). If the first character is +/- then the specified CSCs are added/removed. Duplicates are silently ignored. For removal, CSCs that are not in the list are silently ignored. Whitespace is allowed after the optional initial +/- and after each comma.

setLogLevel#

Description: Set the logging level.

EFDB_Topic:

SALGeneric_command_setLogLevel

Category:

csc

level#

IDL_Type:

int

Units:

unitless

Description: Logging level, as a Python logging level: error=40, warning=30, info=20, debug=10.

subsystem#

IDL_Type:

string

Units:

unitless

Description: If this CSC itself has sub-ordinate components, they may be listed here. An empty string means the setting applies to all such sub-ordinate components, or just to this CSC itself.

standby#

Description: Transition from state Offline/Available, Disabled or Fault to Standby.

EFDB_Topic:

SALGeneric_command_standby

Category:

csc

start#

Description: Transition from state Standby to Disable, in a specified configuration.

EFDB_Topic:

SALGeneric_command_start

Category:

csc

configurationOverride#

IDL_Type:

string

Units:

unitless

Description:

Configuration override in the form [{name}][:{version}]. For salobj-based CSCs: name is a filename with “.yaml” suffix and version is a git hash; for example:

  • “foo.yaml” specifies just a file. Two or three config files are loaded: “_init.yaml”, “_{site}.yaml” (if present), and “foo.yaml”.

  • “:37bf936” specifies just a git hash. One or two config files are loaded from the specified git commit: “_init.yaml” and “_{site}.yaml” (if present.

  • “bar.yaml:HEAD~2” specifies both a file and a git hash. Two or three config files are read from the specified git commit: “_init.yaml”, “_{site}.yaml” (if present), and “bar.yaml”.

Enumerations#

SummaryState:
  • DisabledState

  • EnabledState

  • FaultState

  • OfflineState

  • StandbyState

LogLevel:
  • none

  • fatal

  • error

  • warning

  • info

  • debug

  • verbose

OffTypes:
  • simple

  • tplane

OnOff:
  • on

  • off

Wraps:
  • cw

  • ccw

CoordFrame:
  • fk5

  • icrs

  • azel

  • planet

  • ephem

RotFrame:
  • target

  • azel

  • fixed

RotMode:
  • field

  • slit

Planets:
  • mercury

  • venus

  • moon

  • mars

  • jupiter

  • saturn

  • uranus

  • neptune

  • pluto

Foci:
  • prime

  • nasmyth1

  • nasmyth2

WarningLevel:
  • none

  • minor

  • major

DetailedStates:
  • notTracking

  • azEl

  • openLoop

  • guiding

TargetTypes:
  • raDec

  • azEl

  • planet

  • ephem

WrapStrategy:
  • noUnWrap

  • optimize

  • maxTimeOnTarget

Events#

airmassWarning#

Description: Airmass at the current target elevation exceeds the Airmass warning value.

EFDB_Topic:

MTPtg_logevent_airmassWarning

level#

IDL_Type:

long

Units:

unitless

Description: Airmass warning level.

azWrapWarning#

Description: The time to the current azimuth wrap limit for the target is less than the azimuth wrap warning value.

EFDB_Topic:

MTPtg_logevent_azWrapWarning

level#

IDL_Type:

long

Units:

unitless

Description: Warning level for azimuth wrap

currentDebugLevel#

Description: Current debug level

EFDB_Topic:

MTPtg_logevent_currentDebugLevel

currentLevel#

IDL_Type:

long

Units:

unitless

Description: Current debug level.

currentTarget#

Description: This event is posted when a new target command (raDecTarget, azElTarget, planetTarget or ephemTarget) is accepted by the component. The target command’s parameter values will be copied to the same parameters in this event.

EFDB_Topic:

MTPtg_logevent_currentTarget

timestamp#

IDL_Type:

double

Units:

second

Description: Current time in TAI seconds

targetType#

IDL_Type:

long

Units:

unitless

Description: raDec, azEl, planet or ephemeris?

targetName#

IDL_Type:

string

Units:

unitless

Description: Name of current target

ra#

IDL_Type:

double

Units:

rad

Description: Target RA in radians

declination#

IDL_Type:

double

Units:

rad

Description: Target Dec in radians

frame#

IDL_Type:

long

Units:

unitless

Description: Target tracking co-ordinate frame (FK5 or ICRS)

azDegs#

IDL_Type:

double

Units:

degree

Description: Azimuth.

elDegs#

IDL_Type:

double

Units:

degree

Description: Elevation.

planetName#

IDL_Type:

long

Units:

unitless

Description: Id of the planet name; mercury (1), venus (2), moon (3), mars (4), jupiter (5), saturn (6), uranus (7), neptune (8) or pluto (9)

ephemFile#

IDL_Type:

string

Units:

unitless

Description: Ephemeris file name.

equinox#

IDL_Type:

double

Units:

year

Description: Target equinox in years

raString#

IDL_Type:

string

Units:

hour

Description: Target RA as a string (HH MM SS.SS).

decString#

IDL_Type:

string

Units:

degree

Description: Target Dec as a string (DD MM SS.SS)

epoch#

IDL_Type:

double

Units:

year

Description: Target epoch in years

difftrackRA#

IDL_Type:

double

Units:

arcsec / second

Description: Target differential track rate in RA (units RAsecs/second)

difftrackDec#

IDL_Type:

double

Units:

arcsec / second

Description: Target differential track rate in Dec (units arcsecs/second)

properMotionRA#

IDL_Type:

double

Units:

arcsec / year

Description: Target proper motion in RA (units RAsecs/year)

properMotionDec#

IDL_Type:

double

Units:

arcsec / year

Description: Target proper motion in Dec (units arcsecs/year)

parallax#

IDL_Type:

double

Units:

arcsec

Description: Target annual parallax in arcseconds

radvel#

IDL_Type:

double

Units:

km / second

Description: Target radial velocity in kms/sec

rotPA#

IDL_Type:

double

Units:

degree

Description: Rotator position angle in degrees(planet and ephemeris target)

rotAngle#

IDL_Type:

double

Units:

degree

Description: Desired instrument position angle, Eastwards from North if rotStartFrame is target or azel. Rotator physical angle if rotStartFrame is fixed.

rotStartFrame#

IDL_Type:

long

Units:

unitless

Description: Rotator co-ordinate frame for rotator start position. target = same frame as target. azel = maintain sky orientation. fixed = rotator physical angle.

rotTrackFrame#

IDL_Type:

long

Units:

unitless

Description: Rotator co-ordinate frame for rotator tracking. target = same frame as target. azel = maintain sky orientation. fixed = rotator physical angle.

rotMode#

IDL_Type:

long

Units:

unitless

Description: Rotator tracking mode (Field or Slit optimized)

raHours#

IDL_Type:

double

Units:

hour

Description: Target RA in hours

decDegs#

IDL_Type:

double

Units:

degree

Description: Target Dec in degrees

detailedState#

Description: The substate of the component.

EFDB_Topic:

MTPtg_logevent_detailedState

detailedState#

IDL_Type:

long

Units:

unitless

Description: Current detailed state

elLimitWarning#

Description: The time before the current target reaches elevation high limit is less than the object set warning value.

EFDB_Topic:

MTPtg_logevent_elLimitWarning

level#

IDL_Type:

long

Units:

unitless

Description: Elevation tracking high limit warning

focusNameInconsistentWarning#

Description: Not used

EFDB_Topic:

MTPtg_logevent_focusNameInconsistentWarning

eventState#

IDL_Type:

boolean

Units:

unitless

Description: State of the focus name inconsistency.

focusNameSelected#

Description: Not used

EFDB_Topic:

MTPtg_logevent_focusNameSelected

focus#

IDL_Type:

long

Units:

unitless

Description: Selected Focus Name

iers#

Description: Current IERS data used by the component

EFDB_Topic:

MTPtg_logevent_iers

timestamp#

IDL_Type:

double

Units:

second

Description: Timestamp (as returned by SAL’s getCurrentTime) of successful IERS update.

dut1#

IDL_Type:

double

Units:

second

Description: DUT1 = UT1 - UTC (seconds)

poleX#

IDL_Type:

double

Units:

arcsec

Description: Polar Motion X

poleY#

IDL_Type:

double

Units:

arcsec

Description: Polar Motion Y

iersOutOfDate#

Description: The IERS data has not been updated recently

EFDB_Topic:

MTPtg_logevent_iersOutOfDate

eventState#

IDL_Type:

boolean

Units:

unitless

Description: State of the iers

moonProximityWarning#

Description: The distance between the current target position and the Moon’s position is less than the Moon proximity warning value.

EFDB_Topic:

MTPtg_logevent_moonProximityWarning

level#

IDL_Type:

long

Units:

unitless

Description: Level of the moon proximity warning.

mountDataWarning#

Description: The mount status data hasn’t been received for more than the duration specified in the configuration file.

EFDB_Topic:

MTPtg_logevent_mountDataWarning

level#

IDL_Type:

long

Units:

unitless

Description: Warning level from the mount.

objectSetWarning#

Description: The time before the current target sets below the elevation lower limit is less than the object set warning value.

EFDB_Topic:

MTPtg_logevent_objectSetWarning

level#

IDL_Type:

long

Units:

unitless

Description: Object is setting warning level.

observatoryLocation#

Description: Location of the observatory.

EFDB_Topic:

MTPtg_logevent_observatoryLocation

longitude#

IDL_Type:

double

Units:

degree

Description: Site longitude.

latitude#

IDL_Type:

double

Units:

degree

Description: Site latitude.

height#

IDL_Type:

double

Units:

meter

Description: Site height above see level.

timeZone#

IDL_Type:

double

Units:

hour

Description: Time zone offset.

offsetSummary#

Description: Target offset data.

EFDB_Topic:

MTPtg_logevent_offsetSummary

timestamp#

IDL_Type:

double

Units:

second

Description: Current time as TAI seconds

iaa#

IDL_Type:

double

Units:

deg

Description: Rotator Instrument Alignment Angle

userOffsetRA#

IDL_Type:

double

Units:

arcsec

Description: User Offset in RA (arcsecs)

userOffsetDec#

IDL_Type:

double

Units:

arcsec

Description: User offset in Dec (arcsecs)

handsetOffsetRA#

IDL_Type:

double

Units:

arcsec

Description: Handset offset in RA (arcsecs)

handsetOffsetDec#

IDL_Type:

double

Units:

arcsec

Description: Handset offset in Dec (arcsecs)

userCollOffsetCA#

IDL_Type:

double

Units:

arcsec

Description: Collimation CA user offset (arcsecs)

userCollOffsetCE#

IDL_Type:

double

Units:

arcsec

Description: Collimation CE user offset (arcsecs)

handsetCollOffsetCA#

IDL_Type:

double

Units:

arcsec

Description: Collimation handset offset CA (arcsecs)

handsetCollOffsetCE#

IDL_Type:

double

Units:

arcsec

Description: Collimation CE handset offset (arcsecs)

pointingOriginX#

IDL_Type:

double

Units:

mm

Description: Pointing origin X on the focal plane (mm)

pointingOriginY#

IDL_Type:

double

Units:

mm

Description: Pointing origin Y on the focal plane (mm)

pointingOriginUserDX#

IDL_Type:

double

Units:

mm

Description: User pointing origin offset X on the focal plane (mm)

pointingOriginUserDY#

IDL_Type:

double

Units:

mm

Description: User pointing origin offset Y on the focal plane (mm)

pointingOriginHandsetDX#

IDL_Type:

double

Units:

mm

Description: Handset pointing origin offset X on the focal plane (mm)

pointingOriginHandsetDY#

IDL_Type:

double

Units:

mm

Description: Handset pointing origin offset Y on the focal plane (mm)

pointData#

Description: Data added to pointing file by pointAddData command.

EFDB_Topic:

MTPtg_logevent_pointData

expectedAzimuth#

IDL_Type:

double

Units:

degree

Description: Expected target Azimuth

expectedElevation#

IDL_Type:

double

Units:

degree

Description: Expected target Elevation

measuredAzimuth#

IDL_Type:

double

Units:

degree

Description: Measured Azimuth

measuredElevation#

IDL_Type:

double

Units:

degree

Description: Measured Elevation

measuredRotator#

IDL_Type:

double

Units:

degree

Description: Measured Rotator

filePath#

IDL_Type:

string

Units:

unitless

Description: Path of the pointing file.

pointingFile#

Description: Pointing file is created or closed.

EFDB_Topic:

MTPtg_logevent_pointingFile

fileIsOpen#

IDL_Type:

boolean

Units:

unitless

Description: If true, pointing file is open. If false, pointing file is closed.

filePath#

IDL_Type:

string

Units:

unitless

Description: Path of the pointing file.

pointingModel#

Description: Pointing model data currently loaded.

EFDB_Topic:

MTPtg_logevent_pointingModel

timestamp#

IDL_Type:

double

Units:

second

Description: Current time in TAI seconds

pointingModelTermNames#

IDL_Type:

string

Units:

unitless

Description: Comma separated list of pointing model term names.

pointingModelTermValues#

IDL_Type:

string

Units:

unitless

Description: Comma separated term values.

ptgAzCurrentWrap#

Description: Current internally selected azimuth wrap (azimuth travel range).

EFDB_Topic:

MTPtg_logevent_ptgAzCurrentWrap

currentWrap#

IDL_Type:

long

Units:

unitless

Description: Direction of the azimuth wrap: cw (1) or ccw (2).

ptgRotCurrentWrap#

Description: Current internally selected rotator wrap (rotator travel range).

EFDB_Topic:

MTPtg_logevent_ptgRotCurrentWrap

currentWrap#

IDL_Type:

long

Units:

unitless

Description: Direction of the rotator wrap: cw (1) or ccw (2).

rotWrapWarning#

Description: The time to the current rotator wrap limit for the target is less than the rotator wrap warning value.

EFDB_Topic:

MTPtg_logevent_rotWrapWarning

level#

IDL_Type:

long

Units:

unitless

Description: Rotator Wrap limit warning level.

sunProximityWarning#

Description: The distance between the current target position and the Sun’s position is less than the Sun proximity warning value.

EFDB_Topic:

MTPtg_logevent_sunProximityWarning

level#

IDL_Type:

long

Units:

unitless

Description: Telescope is approaching the Sun

timesOfLimits#

Description: Times of the current target reaching limits

EFDB_Topic:

MTPtg_logevent_timesOfLimits

timestamp#

IDL_Type:

double

Units:

second

Description: Time the limits were calculated. TAI seconds.

timeAzLim#

IDL_Type:

double

Units:

second

Description: Time the target reaches azimuth limit. TAI seconds.

timeRotLim#

IDL_Type:

double

Units:

second

Description: Time the target reaches rotator limit. TAI seconds.

timeElHighLimit#

IDL_Type:

double

Units:

second

Description: Time the target reaches elevation high limit. TAI seconds.

timeElLowLimit#

IDL_Type:

double

Units:

second

Description: Time the target reaches elevation low limit. TAI seconds.

timeUnobservable#

IDL_Type:

double

Units:

second

Description: Time the target becomes unobservable. TAI seconds.

trackId#

IDL_Type:

long

Units:

unitless

Description: Target identifier.

trackPosting#

Description: Indicates whether mount and rotator tracking commands are being posted

EFDB_Topic:

MTPtg_logevent_trackPosting

status#

IDL_Type:

boolean

Units:

unitless

Description: If true, PTG controller is currently posting track commands to Mount components.

validatedTarget#

Description: Target validation result and expected axis positions. The event is posted when the received target command’s validateOnly is true.

EFDB_Topic:

MTPtg_logevent_validatedTarget

isValid#

IDL_Type:

boolean

Units:

unitless

Description: If true, the target is observable.

az#

IDL_Type:

double

Units:

degree

Description: Azimuth

el#

IDL_Type:

double

Units:

degree

Description: Elevation

rot#

IDL_Type:

double

Units:

degree

Description: Rotator

trackId#

IDL_Type:

long

Units:

unitless

Description: Target identifier.

wavelength#

Description: Currently defined target wavelength

EFDB_Topic:

MTPtg_logevent_wavelength

wavelength#

IDL_Type:

double

Units:

micron

Description: Wavelength in microns

weatherDataApplied#

Description: Latest weather data applied to kernel.

EFDB_Topic:

MTPtg_logevent_weatherDataApplied

ambientTemp#

IDL_Type:

double

Units:

deg_C

Description: Ambient temperature.

pressure#

IDL_Type:

double

Units:

unitless

Description: Current pressure. (mbar)

humidity#

IDL_Type:

double

Units:

percent

Description: Air relative humidity

weatherDataInvalid#

Description: The weather data has not been updated or invalid data received.

EFDB_Topic:

MTPtg_logevent_weatherDataInvalid

eventState#

IDL_Type:

boolean

Units:

unitless

Description: State of the weather data.

authList#

Description: Who can command this CSC.

EFDB_Topic:

SALGeneric_logevent_authList

Category:

csc

authorizedUsers#

IDL_Type:

string

Units:

unitless

Description: Comma seperated list of authorized users currently allowed to command this CSC.

nonAuthorizedCSCs#

IDL_Type:

string

Units:

unitless

Description: Comma seperated list of CSC’s not currently allowed to command this CSC.

errorCode#

Description: Output when this CSC goes into the Fault state as an explanation of the problem.

EFDB_Topic:

SALGeneric_logevent_errorCode

Category:

csc

errorCode#

IDL_Type:

long

Units:

unitless

Description: A numeric error code.

errorReport#

IDL_Type:

string

Units:

unitless

Description: An string providing detailed information about the error.

traceback#

IDL_Type:

string

Units:

unitless

Description: An optional stack trace of the error condition.

heartbeat#

Description: Event output at regular intervals (typcally once per second) to show that the SAL component is alive.

EFDB_Topic:

SALGeneric_logevent_heartbeat

Category:

mandatory

heartbeat#

IDL_Type:

boolean

Units:

unitless

Description: Deprecated field that you should ignore.

logLevel#

Description: Current logging level.

EFDB_Topic:

SALGeneric_logevent_logLevel

Category:

mandatory

level#

IDL_Type:

int

Units:

unitless

Description: Current logging level, a Python logging level: error=40, warning=30, info=20, debug=10.

subsystem#

IDL_Type:

string

Units:

unitless

Description: If this CSC itself has sub-ordinate components, they may be listed here. An empty string means the setting applies to all such sub-ordinate components, or just to this CSC itself.

logMessage#

Description: A log message.

EFDB_Topic:

SALGeneric_logevent_logMessage

Category:

mandatory

name#

IDL_Type:

string

Units:

unitless

Description: Log name.

level#

IDL_Type:

int

Units:

unitless

Description: Message level, a Python logging level: error=40, warning=30, info=20, debug=10.

message#

IDL_Type:

string

Units:

unitless

Description: Log message.

traceback#

IDL_Type:

string

Units:

unitless

Description: Exception traceback; “” if not an exception.

filePath#

IDL_Type:

string

Units:

unitless

Description: Path to source file.

functionName#

IDL_Type:

string

Units:

unitless

Description: Function or method name.

lineNumber#

IDL_Type:

long

Units:

unitless

Description: Line number in the file specified by filePath.

process#

IDL_Type:

long

Units:

unitless

Description: Process ID.

timestamp#

IDL_Type:

double

Units:

second

Description: The time at which the condition being reported was observed (TAI unix seconds). 0 if unspecified.

simulationMode#

Description: Current simulation mode.

EFDB_Topic:

SALGeneric_logevent_simulationMode

Category:

csc

mode#

IDL_Type:

int

Units:

unitless

Description: Current simulation mode; 0 for normal operation (no simulation); other supported values are specific to each CSC.

softwareVersions#

Description: Current versions of software in use by CSC.

EFDB_Topic:

SALGeneric_logevent_softwareVersions

Category:

mandatory

salVersion#

IDL_Type:

string

IDL_Size:

256

Units:

unitless

Description: This is the current version of SAL generation.

xmlVersion#

IDL_Type:

string

IDL_Size:

256

Units:

unitless

Description: This is the current version of CSC XML.

openSpliceVersion#

IDL_Type:

string

IDL_Size:

256

Units:

unitless

Description: This is the current version of OpenSplice.

cscVersion#

IDL_Type:

string

IDL_Size:

256

Units:

unitless

Description: The software version of this CSC.

subsystemVersions#

IDL_Type:

string

Units:

unitless

Description: A comma delimited list of key=value pairs relating subsystem name (key) to its version number (value). This may be left blank if there are no subsystems within this CSC.

summaryState#

Description: Current summary state of this CSC.

EFDB_Topic:

SALGeneric_logevent_summaryState

Category:

csc

summaryState#

IDL_Type:

long

Units:

unitless

Description: High level state machine state identifier.

Telemetry#

currentTargetStatus#

Description: Calculated demands for current target

EFDB_Topic:

MTPtg_currentTargetStatus

timestamp#

IDL_Type:

double

Units:

second

Description: Current time in TAI seconds

demandAz#

IDL_Type:

double

Units:

deg

Description: Demanded target Azimuth.

demandEl#

IDL_Type:

double

Units:

deg

Description: Demanded target Elevation

demandRot#

IDL_Type:

double

Units:

deg

Description: Demanded Rotator Angle

demandAzVelocity#

IDL_Type:

double

Units:

deg / s

Description: Demanded Azimuth velocity.

demandElVelocity#

IDL_Type:

double

Units:

deg / s

Description: Demanded Elevation velocity

demandRotVelocity#

IDL_Type:

double

Units:

deg / s

Description: Demanded Rotator velocity

ha#

IDL_Type:

double

Units:

hour

Description: Current Hour Angle of target

parAngle#

IDL_Type:

double

Units:

deg

Description: Current Parallactic Angle of the target

airmass#

IDL_Type:

double

Units:

unitless

Description: Current Airmass of the target

demandRa#

IDL_Type:

double

Units:

hour

Description: Demanded target Right Ascension.

demandDec#

IDL_Type:

double

Units:

deg

Description: Demanded target Declination.

guiding#

Description: Guiding data

EFDB_Topic:

MTPtg_guiding

timestamp#

IDL_Type:

double

Units:

second

Description: Current time in TAI second

guideControlState#

IDL_Type:

boolean

Units:

unitless

Description: On/off state of guiding.

guideAutoClearState#

IDL_Type:

boolean

Units:

unitless

Description: On/off state of Guide Auto Clear.

guideGA#

IDL_Type:

double

Units:

arcsec

Description: Guiding GA term (arcsecs)

guideGB#

IDL_Type:

double

Units:

arcsec

Description: Guiding GB term (arcsecs)

rotation#

IDL_Type:

double

Units:

arcsec

Description: Guider rotation offset.

mountPosition#

Description: Telemetry for mount positions in sky coordinates

EFDB_Topic:

MTPtg_mountPosition

timestamp#

IDL_Type:

double

Units:

s

Description: RA and Dec calculation timestamp, in TAI seconds

azimuthActualPosition#

IDL_Type:

double

Units:

deg

Description: Azimuth axis position reported by mount component.

elevationActualPosition#

IDL_Type:

double

Units:

deg

Description: Elevation axis position reported by mount component.

rotatorActualPosition#

IDL_Type:

double

Units:

deg

Description: Rotator axis position reported by rotator component.

ra#

IDL_Type:

double

Units:

deg

Description: RA calculated from the azimuthActualPosition and elevationActualPosition.

declination#

IDL_Type:

double

Units:

deg

Description: Dec calculated from the azimuthActualPosition and elevationActualPosition.

skyAngle#

IDL_Type:

double

Units:

deg

Description: Calculated sky angle.

mountStatus#

Description: Current telescope mount status

EFDB_Topic:

MTPtg_mountStatus

timestamp#

IDL_Type:

double

Units:

second

Description: Current time in TAI seconds

mountRA#

IDL_Type:

double

Units:

hour

Description: Current RA of mount (degrees)

mountDec#

IDL_Type:

double

Units:

deg

Description: Current Dec of mount (degrees)

mountAz#

IDL_Type:

double

Units:

deg

Description: Mount azimuth.

mountEl#

IDL_Type:

double

Units:

deg

Description: Mount elevation.

mountRot#

IDL_Type:

double

Units:

deg

Description: Rotator angle.

namedAzEl#

Description: Named telescope positions specified in the configuration file

EFDB_Topic:

MTPtg_namedAzEl

names#

IDL_Type:

string

Units:

unitless

Description: Names of the Named AzEl positions (Comma separated)

azPositions#

IDL_Type:

string

Units:

deg

Description: Azimuth positions of the named position. (Comma separated, specify ‘n/a’ to indicate no movement.)

elPositions#

IDL_Type:

string

Units:

deg

Description: Elevation positions of the named position. (Comma separated, specify ‘n/a’ to indicate no movement.)

rotPositions#

IDL_Type:

string

Units:

deg

Description: Rotator positions of the named position. (Comma separated, specify ‘n/a’ to indicate no movement.)

skyEnvironment#

Description: Information related to the Sun and the Moon

EFDB_Topic:

MTPtg_skyEnvironment

timestamp#

IDL_Type:

double

Units:

second

Description: Current time. TAI seconds.

sunsetTime#

IDL_Type:

double

Units:

second

Description: Sunset time. TAI seconds.

twilightEndTime#

IDL_Type:

double

Units:

second

Description: Astronomical twilight end time. TAI seconds.

twilightBeginTime#

IDL_Type:

double

Units:

second

Description: Astronomical twilight begin time. TAI seconds.

sunriseTime#

IDL_Type:

double

Units:

second

Description: Sunrise time. TAI seconds.

moonriseTime#

IDL_Type:

double

Units:

second

Description: Moonrise time. TAI seconds.

moonsetTime#

IDL_Type:

double

Units:

second

Description: Moonset time. TAI seconds.

moonPhase#

IDL_Type:

double

Units:

percent

Description: Moon phase (%)

sunAltitude#

IDL_Type:

double

Units:

deg

Description: Altitude of the Sun

moonAltitude#

IDL_Type:

double

Units:

deg

Description: Altitude of the Moon

sunTargetDistance#

IDL_Type:

double

Units:

deg

Description: Distance on the sky between the target and the Sun

moonTargetDistance#

IDL_Type:

double

Units:

deg

Description: Distance on the sky between the target and the Moon

timeAndDate#

Description: Time related data

EFDB_Topic:

MTPtg_timeAndDate

timestamp#

IDL_Type:

double

Units:

second

Description: Current time in TAI seconds

utc#

IDL_Type:

double

Units:

day

Description: UTC time

lst#

IDL_Type:

double

Units:

hour

Description: Local Sidereal Time.

mjd#

IDL_Type:

double

Units:

day

Description: Modified Julian Data in days

localTime#

IDL_Type:

double

Units:

day

Description: Local Time (UTC).

localTimeString#

IDL_Type:

string

Units:

unitless

Description: Local Time (UTC) as a sexagesimal string (HH:MM:SS.SSS)

leapSecs#

IDL_Type:

int

Units:

second

Description: Number of leap seconds = TAI - UTC.

timezone#

IDL_Type:

double

Units:

hour

Description: Timezone in hours.