ATSpectrograph

Note

This page is generated by the following python script generate_cet.py.

Back to table

Commands

changeDisperser

EFDB_Topic:ATSpectrograph_command_changeDisperser

disperser

IDL_Type:long
Units:unitless

Description: The disperser.

name

IDL_Type:string
IDL_Size:256
Units:unitless

Description: Name of the grating to select. Command gets rejected if both are set.

changeFilter

EFDB_Topic:ATSpectrograph_command_changeFilter

filter

IDL_Type:long
Units:unitless

Description: Id of the filter to select.

name

IDL_Type:string
IDL_Size:256
Units:unitless

Description: Name of the filter to select. Command gets rejected if both are set.

homeLinearStage

EFDB_Topic:ATSpectrograph_command_homeLinearStage

value

IDL_Type:boolean
Units:unitless

Description: Needed by the SAL API, but is unused.

moveLinearStage

EFDB_Topic:ATSpectrograph_command_moveLinearStage

distanceFromHome

IDL_Type:double
Units:mm

Description: The distance from home.

stopAllAxes

EFDB_Topic:ATSpectrograph_command_stopAllAxes

value

IDL_Type:boolean
Units:unitless

Description: Needed by the SAL API, but is unused.

abort

EFDB_Topic:SALGeneric_command_abort

value

IDL_Type:boolean
Units:unitless

Description: Not used

disable

Description: Transition from state Enabled to Disabled.

EFDB_Topic:SALGeneric_command_disable

value

IDL_Type:boolean
Units:unitless

Description: Not used

enable

Description: Transition from state Disabled to Enabled.

EFDB_Topic:SALGeneric_command_enable

value

IDL_Type:boolean
Units:unitless

Description: Not used

enterControl

Description: Transition from state Offline to Standby. Only “externally commandable” CSCs support this command; other CSCs start in Standby state and quit when they go to Offline.

EFDB_Topic:SALGeneric_command_enterControl

value

IDL_Type:boolean
Units:unitless

Description: Not used

exitControl

Description: Transition from state Standby to Offline. For CSCs that are not “externally commandable” this makes the CSC quit.

EFDB_Topic:SALGeneric_command_exitControl

value

IDL_Type:boolean
Units:unitless

Description: Not used

setAuthList

EFDB_Topic:SALGeneric_command_setAuthList

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

level

IDL_Type:int
Units:unitless

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

setValue

EFDB_Topic:SALGeneric_command_setValue

parametersAndValues

IDL_Type:string
IDL_Size:256
Units:unitless

Description: List of parameters and their values as a Json string

standby

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

EFDB_Topic:SALGeneric_command_standby

value

IDL_Type:boolean
Units:unitless

Description: Not used

start

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

EFDB_Topic:SALGeneric_command_start

settingsToApply

IDL_Type:string
IDL_Size:256
Units:unitless

Description: Name of the selected settings set

Enumerations

FilterPosition:
  • Filter0
  • Filter1
  • Filter2
  • Filter3
  • Inbetween
DisperserPosition:
 
  • Disperser0
  • Disperser1
  • Disperser2
  • Disperser3
  • Inbetween
Status:
  • Homing
  • Moving
  • Stationary
  • NotInPosition
Error:
  • None
  • Busy
  • NotInitialized
  • MoveTimeout
Port:
  • Nasmyth1
  • Nasmyth2

Events

detailedState

EFDB_Topic:ATSpectrograph_logevent_detailedState

detailedState

IDL_Type:long
Units:unitless

Description: The substate of the CSC.

disperserInPosition

EFDB_Topic:ATSpectrograph_logevent_disperserInPosition

inPosition

IDL_Type:boolean
Units:unitless

Description: Is the grating/disperser in position?

filterInPosition

EFDB_Topic:ATSpectrograph_logevent_filterInPosition

inPosition

IDL_Type:boolean
Units:unitless

Description: Is the filter in position?

fwState

EFDB_Topic:ATSpectrograph_logevent_fwState

state

IDL_Type:long
Units:unitless

Description: The state of the filter wheel.

gwState

EFDB_Topic:ATSpectrograph_logevent_gwState

state

IDL_Type:long
Units:unitless

Description: The state of the disperser.

internalCommand

EFDB_Topic:ATSpectrograph_logevent_internalCommand

commandObject

IDL_Type:byte
Units:unitless
Count:950

Description: The internal command that occurred.

linearStageInPosition

EFDB_Topic:ATSpectrograph_logevent_linearStageInPosition

inPosition

IDL_Type:boolean
Units:unitless

Description: Is the linear stage in position?

loopTimeOutOfRange

EFDB_Topic:ATSpectrograph_logevent_loopTimeOutOfRange

loopTimeOutOfRange

IDL_Type:boolean
Units:unitless

Description: Loop time is out of range.

lsState

EFDB_Topic:ATSpectrograph_logevent_lsState

state

IDL_Type:long
Units:unitless

Description: The state of the linear stage.

rejectedCommand

EFDB_Topic:ATSpectrograph_logevent_rejectedCommand

command

IDL_Type:string
Units:unitless

Description: The rejected command

state

IDL_Type:string
Units:unitless

Description: The bad state.

timestamp

IDL_Type:double
Units:unitless

Description: The time it was bad.

reportedDisperserPosition

EFDB_Topic:ATSpectrograph_logevent_reportedDisperserPosition

position

IDL_Type:long
Units:unitless

Description: The reported grating/disperser position.

name

IDL_Type:string
IDL_Size:256
Units:unitless

Description: Name of the grating/disperser.

focusOffset

IDL_Type:float
Units:mm
Description: Focus offset to be applied on the secondary mirror in units of mm, relative to no glass
being installed. Positive values push the secondary down and increase the back focal distance, therefore adding glass thickness will result in positive focus offsets.

pointingOffsets

IDL_Type:float
Units:arcsec
Count:2
Description: Pointing offset to be applied to the boresight in units of arcseconds, relative
to no glass being installed. Relative to the center of the detector,positive X-values result in moving along rows, to higher pixel values

reportedFilterPosition

EFDB_Topic:ATSpectrograph_logevent_reportedFilterPosition

position

IDL_Type:long
Units:unitless

Description: The reported position.

name

IDL_Type:string
IDL_Size:256
Units:unitless

Description: Name of the filter.

centralWavelength

IDL_Type:float
Units:nm
Description: Wavelength for which optical system will be optimized in units of nm.
Approximations are sufficient as the focus dependence on wavelength is weak.

focusOffset

IDL_Type:float
Units:mm
Description: Focus offset to be applied on the secondary mirror in units of mm, relative to no glass
being installed. Positive values push the secondary down and increase the back focal distance, therefore adding glass thickness will result in positive focus offsets.

pointingOffsets

IDL_Type:float
Units:arcsec
Count:2
Description: Pointing offset to be applied to the boresight in units of arcseconds, relative
to no glass being installed. Relative to the center of the detector,positive X-values result in moving along rows, to higher pixel values

reportedLinearStagePosition

EFDB_Topic:ATSpectrograph_logevent_reportedLinearStagePosition

position

IDL_Type:float
Units:mm

Description: The reported linear stage position.

settingsAppliedValues

EFDB_Topic:ATSpectrograph_logevent_settingsAppliedValues

host

IDL_Type:string
IDL_Size:16
Units:unitless

Description: IP of the controller in the format XXX.XXX.XXX.XXX

port

IDL_Type:long
Units:unitless

Description: Port to connect to controller.

linearStageMinPos

IDL_Type:float
Units:mm

Description: The minimum linear stage position.

linearStageMaxPos

IDL_Type:float
Units:mm

Description: The maximum linear stage position.

linearStageSpeed

IDL_Type:float
Units:mm/s

Description: The speed of the linear stage.

filterNames

IDL_Type:string
IDL_Size:256
Units:unitless

Description: Comma separated list of filter names.

filterCentralWavelengths

IDL_Type:string
IDL_Size:256
Units:unitless

Description: Comma separated list of filter central wavelengths.

filterFocusOffsets

IDL_Type:string
IDL_Size:256
Units:unitless

Description: Comma separated list of filter focus offsets to be applied to the hexapod [in mm].

filterPointingOffsets

IDL_Type:string
IDL_Size:256
Units:unitless

Description: Comma separated list of [X,Y] filter pointing offsets to be applied to boresight [in arcsec].

gratingNames

IDL_Type:string
IDL_Size:256
Units:unitless

Description: Comma separated list of disperser/grating names.

gratingFocusOffsets

IDL_Type:string
IDL_Size:256
Units:unitless

Description: Comma separated list of disperser/grating focus offsets to be applied to the hexapod [in mm].

gratingPointingOffsets

IDL_Type:string
IDL_Size:256
Units:unitless

Description: Comma separated list of [X,Y] grating pointing offsets to be applied to boresight [in arcsec].

instrumentPort

IDL_Type:long
Units:unitless

Description: Port the instrument is mounted in.

timeout

EFDB_Topic:ATSpectrograph_logevent_timeout

timeout

IDL_Type:boolean
Units:unitless

Description: Does time really exist? Or is it a product of society?

appliedSettingsMatchStart

EFDB_Topic:SALGeneric_logevent_appliedSettingsMatchStart

appliedSettingsMatchStartIsTrue

IDL_Type:boolean
Units:unitless

Description: True when the configuration matches the start conditions

authList

EFDB_Topic:SALGeneric_logevent_authList

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 a CSC goes into the Fault state as an explanation of the problem.

EFDB_Topic:SALGeneric_logevent_errorCode

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

EFDB_Topic:SALGeneric_logevent_heartbeat

heartbeat

IDL_Type:boolean
Units:unitless

Description: Beats the drum.

logLevel

Description: Current logging level.

EFDB_Topic:SALGeneric_logevent_logLevel

level

IDL_Type:int
Units:unitless

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

logMessage

Description: A log message.

EFDB_Topic:SALGeneric_logevent_logMessage

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.

settingVersions

Description: Information about settings which can be specified in the start command.

EFDB_Topic:SALGeneric_logevent_settingVersions

recommendedSettingsVersion

IDL_Type:string
Units:unitless

Description: List of comma seperated recomended versions of settings sets

recommendedSettingsLabels

IDL_Type:string
Units:unitless

Description: List of comma seperated names of settings sets

settingsUrl

IDL_Type:string
Units:unitless

Description: The URL where the settings sets definitions can be found

settingsApplied

Description: Base settings applied.

EFDB_Topic:SALGeneric_logevent_settingsApplied

settingsVersion

IDL_Type:string
IDL_Size:256
Units:unitless

Description: The SHA or name corresponding to the published configuration

otherSettingsEvents

IDL_Type:string
Units:unitless

Description: A comma delimited list of other specific CSC configuration events. This may be blank if no other CSC specific events are necessary

simulationMode

Description: Current simulation mode.

EFDB_Topic:SALGeneric_logevent_simulationMode

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

salVersion

IDL_Type:string
IDL_Size:16
Units:unitless

Description: This is the current version of SAL generation

xmlVersion

IDL_Type:string
IDL_Size:16
Units:unitless

Description: This is the current version of CSC XML

openSpliceVersion

IDL_Type:string
IDL_Size:16
Units:unitless

Description: This is the current version of OpenSplice

cscVersion

IDL_Type:string
IDL_Size:16
Units:unitless

Description: This is the top-level version of the 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 a CSC

summaryState

Description: Current summary state of the CSC

EFDB_Topic:SALGeneric_logevent_summaryState

summaryState

IDL_Type:long
Units:unitless

Description: High level state machine state identifier

Telemetry

loopTime

EFDB_Topic:ATSpectrograph_loopTime

loopTime

IDL_Type:double
Units:second

Description: Loop time.

timestamp

EFDB_Topic:ATSpectrograph_timestamp

timestamp

IDL_Type:double
Units:second

Description: The time.