ATPtg

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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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: Select the operational focus of the telescope.

EFDB_Topic:

ATPtg_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:

ATPtg_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:

ATPtg_command_guideControl

state

IDL_Type:

long

Units:

unitless

Description: Guide controls state.

iersUpdate

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

EFDB_Topic:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_command_pointCloseFile

ignored

IDL_Type:

boolean

Units:

unitless

Description: Attribute required by the SAL API, but is unused.

pointLoadModel

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

EFDB_Topic:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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

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:

ATPtg_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:

ATPtg_logevent_azWrapWarning

level

IDL_Type:

long

Units:

unitless

Description: Warning level for azimuth wrap

currentDebugLevel

Description: Current debug level

EFDB_Topic:

ATPtg_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:

ATPtg_logevent_currentTarget

timestamp

IDL_Type:

double

Units:

second

Description: Current time in TAI second

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

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:

ATPtg_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:

ATPtg_logevent_elLimitWarning

level

IDL_Type:

long

Units:

unitless

Description: Elevation tracking high limit warning

focusNameInconsistentWarning

Description: The focus name selected on PTG component is different from the one selected in the mount component.

EFDB_Topic:

ATPtg_logevent_focusNameInconsistentWarning

eventState

IDL_Type:

boolean

Units:

unitless

Description: State of the focus name inconsistency.

focusNameSelected

Description: Name of the current operational focus

EFDB_Topic:

ATPtg_logevent_focusNameSelected

focus

IDL_Type:

long

Units:

unitless

Description: Selected Focus Name

iers

Description: Current IERS data used by the component

EFDB_Topic:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_logevent_objectSetWarning

level

IDL_Type:

long

Units:

unitless

Description: Object is setting warning level.

observatoryLocation

Description: Location of the observatory.

EFDB_Topic:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_logevent_pointingModel

timestamp

IDL_Type:

double

Units:

second

Description: Current time as TAI second

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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_logevent_wavelength

wavelength

IDL_Type:

double

Units:

micron

Description: Wavelength in microns

weatherDataApplied

Description: Latest weather data applied to kernel.

EFDB_Topic:

ATPtg_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:

ATPtg_logevent_weatherDataInvalid

eventState

IDL_Type:

boolean

Units:

unitless

Description: State of the weather data.

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:

ATPtg_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:

ATPtg_guiding

timestamp

IDL_Type:

double

Units:

second

Description: Current time as TAI seconds

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.

mountPositions

Description: Telemetry for mount positions in sky coordinate

EFDB_Topic:

ATPtg_mountPositions

cRioTimestamp

IDL_Type:

double

Units:

s

Description: Time for the first sample of each telemetry item in this topic, as measured by the cRIO clock, as unix time.

azimuthCalculatedAngle

IDL_Type:

double

Units:

deg

Count:

100

Description: Azimuth axis position reported by mount component.

elevationCalculatedAngle

IDL_Type:

double

Units:

deg

Count:

100

Description: Elevation axis positions reported by mount component.

nasmythCalculatedAngle

IDL_Type:

double

Units:

deg

Count:

100

Description: Nasmyth positions reported by mount component.

ra

IDL_Type:

double

Units:

deg

Count:

100

Description: RA calculated from the azimuthCalculatedAngle and elevationCalculatedAngle.

declination

IDL_Type:

double

Units:

deg

Count:

100

Description: Dec calculated from the azimuthCalculatedAngle and elevationCalculatedAngle.

skyAngle

IDL_Type:

double

Units:

deg

Count:

100

Description: Calculated sky angle.

mountStatus

Description: Current telescope mount status

EFDB_Topic:

ATPtg_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:

ATPtg_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:

ATPtg_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:

ATPtg_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.