ScriptQueue¶
Note
This page is generated by python script generate_cet.py.
Commands¶
- Location
First
Last
Before
After
add¶
Description: Add a script to the queue and configure it.
- EFDB_Topic
ScriptQueue_command_add
isStandard¶
- IDL_Type
boolean
- Units
unitless
Description: Is this a standard script (True) or an external script (False)?
path¶
- IDL_Type
string
- Units
unitless
Description: Path to script, relative to the root directory for standard or external scripts.
config¶
- IDL_Type
string
- Units
unitless
Description: Configuration as yaml text that is parsed to make a keyword argument dict for the script’s configure method.
descr¶
- IDL_Type
string
- Units
unitless
Description: Short description of why you are running this script.
locationSalIndex¶
- IDL_Type
int
- Units
unitless
Description: Index of Script SAL component referred to by location; ignored unless location is Before or After.
logLevel¶
- IDL_Type
int
- Units
unitless
Description: Logging level for the script, as a Python logging level: error=40, warning=30, info=20, debug=10, use default=0.
pauseCheckpoint¶
- IDL_Type
string
- Units
unitless
Description: Checkpoint(s) at which to pause the script, as a regular expression. No checkpoints if blank; all checkpoints if “.*”.
stopCheckpoint¶
- IDL_Type
string
- Units
unitless
Description: Checkpoint(s) at which to stop the script, as a regular expression. No checkpoints if blank; all checkpoints if “.*”.
move¶
Description: Move a script elsewhere in the queue. This will fail if the script is already running.
- EFDB_Topic
ScriptQueue_command_move
locationSalIndex¶
- IDL_Type
int
- Units
unitless
Description: Index of Script SAL component referred to by location; ignored unless location is Before or After.
pause¶
Description: Pause the queue. If a script is executing it will continue, but once that script is done no new script will be run.
- EFDB_Topic
ScriptQueue_command_pause
requeue¶
Description: Put a script back on the queue that has already run, is running or is queued.
- EFDB_Topic
ScriptQueue_command_requeue
locationSalIndex¶
- IDL_Type
int
- Units
unitless
Description: Index of Script SAL component referred to by the location field; ignored unless the location is Before or After.
resume¶
Description: Resume normal operation (unpause the queue).
- EFDB_Topic
ScriptQueue_command_resume
showAvailableScripts¶
Description: List the scripts that are available.
- EFDB_Topic
ScriptQueue_command_showAvailableScripts
showSchema¶
Description: Show the configuration schema for a given script.
- EFDB_Topic
ScriptQueue_command_showSchema
isStandard¶
- IDL_Type
boolean
- Units
unitless
Description: Is this a standard script (True) or an external script (False)?
path¶
- IDL_Type
string
- Units
unitless
Description: Path to script, relative to the root directory for standard or external scripts.
showScript¶
Description: Output script event for a specified script.
- EFDB_Topic
ScriptQueue_command_showScript
salIndex¶
- IDL_Type
int
- Units
unitless
Description: SAL index of Script for which you want information.
stopScripts¶
Description: Stop one or more queued scripts and/or the current script.
- EFDB_Topic
ScriptQueue_command_stopScripts
salIndices¶
- IDL_Type
int
- Units
unitless
- Count
400
Description: Indices of Script SAL component to stop, 0 terminated.
terminate¶
- IDL_Type
boolean
- Units
unitless
Description: If True, terminate the current script without giving it a chance to clean up. If False, try sending a stop command first, and only terminate if if that doesn’t work in a timely fashion.
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. For CSCs that start in Standby state this makes the CSC quit. CSCs that start in Offline state, they remain active.
- EFDB_Topic
SALGeneric_command_exitControl
- Category
csc
setAuthList¶
- 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 the 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 the CSC itself.
standby¶
Description: Transition from state Offline, 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”.
settingsToApply¶
- IDL_Type
string
- IDL_Size
256
- Units
unitless
Description: DEPRECATED: uae override instead. Name of the selected settings set
Enumerations¶
- ScriptProcessState
Loading
Configured
Running
Done
LoadFailed
ConfigureFailed
Terminated
Events¶
availableScripts¶
Description: List of available scripts.
- EFDB_Topic
ScriptQueue_logevent_availableScripts
standard¶
- IDL_Type
string
- Units
unitless
Description: Colon-separated paths to standard scripts, relative to the standard root directory.
external¶
- IDL_Type
string
- Units
unitless
Description: Colon-separated paths to external scripts, relative to the external root directory.
configSchema¶
Description: Configuration schema for a given script.
- EFDB_Topic
ScriptQueue_logevent_configSchema
isStandard¶
- IDL_Type
boolean
- Units
unitless
Description: Is this a standard script (True) or an external script (False)?
path¶
- IDL_Type
string
- Units
unitless
Description: Path to script, relative to the root directory for standard or external scripts.
configSchema¶
- IDL_Type
string
- Units
unitless
Description: Configuration schema: jsonschema encoded as yaml.
nextVisit¶
Description: Group ID and other information about the next script to be run.
- EFDB_Topic
ScriptQueue_logevent_nextVisit
coordinateSystem¶
- IDL_Type
short
- Units
unitless
- Enumeration
CSys_None, CSys_ICRS, CSys_Observed, CSys_Mount
Description: Coordinate system for position. A Script MetadataCoordSys enum. Observed is refracted apparent topocentric, e.g. similar to Mount but the telescope model is applied and the azimuth is wrapped. If None then position should be ignored.
position¶
- IDL_Type
double
- Units
degree
- Count
2
Description: Longitude, latitude axes of position in coordinateSystem
rotationSystem¶
- IDL_Type
short
- Units
unitless
- Description: Rotation system for cameraAngle, a Script MetadataRotSys enum
None: The camera rotator is not used; ignore cameraAngle.
Sky: Position angle of focal plane +Y, measured from N through E. At 0 degrees, +Y is along N and +X is along E/W depending on handedness. At 90 degrees, +Y is along E and +X is along S/N depending on handedness.
Horizon: Position angle of focal plane +Y, measured from +Alt through +Az. At 0 degrees, +Y is along +Alt and +X is along +/-Az, depending on handedness. At 90 degrees, +Y is along +Az and +X is along -/+Alt, depending on handedness.
Mount: The position sent to the instrument rotator; the details depend on the rotator.
filters¶
- IDL_Type
string
- Units
unitless
Description: Comma-separated names of acceptable filters, or blank for any filter.
duration¶
- IDL_Type
double
- Units
second
Description: Estimated duration of the script, excluding slewing to the initial position required by the script.
totalCheckpoints¶
- IDL_Type
int
- Units
unitless
Description: Predicted total number of checkpoints that will be seen (counting all repetitions of a repeated checkpoint); 0 if unknown.
nextVisitCanceled¶
Description: The group ID reported by a nextVisit event will not be used, because the script that was next to be run has been cancelled or rescheduled.
- EFDB_Topic
ScriptQueue_logevent_nextVisitCanceled
groupId¶
- IDL_Type
string
- Units
unitless
Description: Group ID for images taken by the script. This ID will not be used.
queue¶
Description: SAL indices of scripts on the queue.
- EFDB_Topic
ScriptQueue_logevent_queue
enabled¶
- IDL_Type
boolean
- Units
unitless
Description: Is the ScriptQueue CSC enabled? New scripts will only be started if both running and enable are True.
running¶
- IDL_Type
boolean
- Units
unitless
Description: Is the queue running (True) or paused (False)? New scripts will only be started if both running and enable are True.
salIndices¶
- IDL_Type
int
- Units
unitless
- Count
400
Description: SAL index of each Script on the queue. Item 0 is the next script to be run.
pastSalIndices¶
- IDL_Type
int
- Units
unitless
- Count
400
Description: SAL index of scripts that have been run. Item 0 is the script most recently run.
rootDirectories¶
Description: Root directories for scripts.
- EFDB_Topic
ScriptQueue_logevent_rootDirectories
script¶
Description: Information about a queued script.
- EFDB_Topic
ScriptQueue_logevent_script
isStandard¶
- IDL_Type
boolean
- Units
unitless
Description: True if this is a standard script, False if an external script.
path¶
- IDL_Type
string
- Units
unitless
Description: Path of script, relative to standard or external root directory.
timestampProcessStart¶
- IDL_Type
double
- Units
second
Description: When the script process started. 0 before the process is started.
timestampConfigureStart¶
- IDL_Type
double
- Units
second
Description: When script configuration began. 0 before configuration begins.
timestampConfigureEnd¶
- IDL_Type
double
- Units
second
Description: When script configuration finished (succeeded or failed). 0 before configuration ends.
timestampRunStart¶
- IDL_Type
double
- Units
second
Description: When the script was told to run. 0 before the script is told to run.
timestampProcessEnd¶
- IDL_Type
double
- Units
second
Description: When the script process ended. This is also approximately the time at which the script stopped running, if it was ever run. 0 before the script process ends.
processState¶
- IDL_Type
byte
- Units
unitless
Description: State of script process; a ScriptProcessState enum. Loading means the script is still being loaded and is not yet configured. Configured means the script has been configured and can be run. Running means the script has been commanded to run. Done means the script has finished (see scriptState to see whether it ran successfully). ConfigureFailed means the process was terminated because the configure command failed. Terminated means the process was terminated due to calling the terminate command, or due to calling the stop command when the script was not running or if running but stopping the script gently failed.
scriptState¶
- IDL_Type
byte
- Units
unitless
Description: State of the script; a ScriptState enum from Script_Events.xml; 0 if the script is not yet loaded.
appliedSettingsMatchStart¶
- EFDB_Topic
SALGeneric_logevent_appliedSettingsMatchStart
- Category
configurable
appliedSettingsMatchStartIsTrue¶
- IDL_Type
boolean
- Units
unitless
Description: DEPRECATED as a generic event. Few CSCs need something like this, and those that do should provide their own event. True when the configuration matches the start conditions
authList¶
- 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.
configurationApplied¶
Description: Information about CSC’s configuration.
- EFDB_Topic
SALGeneric_logevent_configurationApplied
- Category
configurable
configurations¶
- IDL_Type
string
- Units
unitless
Description: A comma-separated list of configurations applied. If configuration comes from a clone of a git repo, or similar directory, then it will be a list of file names, without the file extension. Ignore whitespace after commas.
version¶
- IDL_Type
string
- Units
unitless
Description: Version of the configuration source. For a clone of a git repo it will be a git hash.
url¶
- IDL_Type
string
- Units
unitless
Description: URL of the configuration source. For a clone of a git repo this will be a file URL. For a database it will be a standard database URL. This should always match the same-named field in configurationsAvailable.
schemaVersion¶
- IDL_Type
string
- Units
unitless
Description: Version of config schema used by the CSC. For a configuration git repo, this is the name of a folder in the config package, and is typically something like “v1”. This should always match the same-named field in configurationsAvailable.
otherInfo¶
- IDL_Type
string
- Units
unitless
Description: A comma-separated list of event topics (without the logevent prefix) used to publish the entire set of configuration parameters loaded by the CSC, and any other pertinent information. Ignore whitespace after commas.
configurationsAvailable¶
Description: Information about the source of configuration information for the CSC.
- EFDB_Topic
SALGeneric_logevent_configurationsAvailable
- Category
configurable
overrides¶
- IDL_Type
string
- Units
unitless
Description: Available overrides as a comma-separated list. Each entry is a possible value of the configurationOverride field of the start command. Ignore whitespace after commas.
version¶
- IDL_Type
string
- Units
unitless
Description: Version of the configuration source. For a clone of a git repo it will be a git hash.
url¶
- IDL_Type
string
- Units
unitless
Description: URL of the configuration source. For a clone of a git repo this will be a file URL. For a database it will be a standard database URL.
schemaVersion¶
- IDL_Type
string
- Units
unitless
Description: Version of config schema used by the CSC. For a configuration git repo, this is the name of a folder in the config package, and is typically something like “v1”.
errorCode¶
Description: Output when a CSC goes into the Fault state as an explanation of the problem.
- EFDB_Topic
SALGeneric_logevent_errorCode
- Category
csc
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
- Category
mandatory
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 the 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 the CSC itself.
logMessage¶
Description: A log message.
- EFDB_Topic
SALGeneric_logevent_logMessage
- Category
mandatory
level¶
- IDL_Type
int
- Units
unitless
Description: Message level, a Python logging level: error=40, warning=30, info=20, debug=10.
lineNumber¶
- IDL_Type
long
- Units
unitless
Description: Line number in the file specified by filePath.
timestamp¶
- IDL_Type
double
- Units
second
Description: The time at which the condition being reported was observed (TAI unix seconds). 0 if unspecified.
settingVersions¶
Description: DEPRECATED: use configurationsAvailable instead. Information about settings which can be specified in the start command.
- EFDB_Topic
SALGeneric_logevent_settingVersions
- Category
configurable
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: DEPRECATED: use configurationApplied instead. Base settings applied.
- EFDB_Topic
SALGeneric_logevent_settingsApplied
- Category
configurable
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
- 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: 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