}

TCC Message Keyword

TCC Message Keyword Dictionary5.2
airTemp
DescriptionTemperature of the outside air. Used for refraction correction.
Values1
 
TypeFloat (float,flt4)
UnitsC
Invalidnan
altDTime
DescriptionApproximate altitude controller clock time - TCC clock time. Warning: this has systematic error on the order of 0.1 seconds due to communication lag. It is primarily intended to indicate serious time discrepancies. Furthermore, some or all axes may show large error if any one axis controller delays the write or times out. To fix a time discrepancy, first set the TCC clock via the WWV clock (SET TIME), then set the controller clocks (AXIS INIT). has systematic error due to communication delays.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
altErr
DescriptionAltitude servo error statistics: maximum absolute value, mean and standard deviation.
Values3
 
Descriptionmaximum absolute value
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptionmean absolute value
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptionstandard deviation absolute value
TypeFloat (float,flt4)
Unitsas
Invalidnan
altLim
DescriptionAltitude motion limits used by the TCC (which are more restrictive than the limits used by the axis controller).
Values5
 
Descriptionminimum position
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionmaximum position
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionmaximum speed
TypeFloat (float,flt4)
Unitsdeg/sec
Invalidnan
 
Descriptionmaximum acceleration
TypeFloat (float,flt4)
Unitsdeg/sec^2
Invalidnan
 
Descriptionmaximum jerk
TypeFloat (float,flt4)
Unitsdeg/sec^3
Invalidnan
altReply
DescriptionUnparsed reply from the altitude axis controller
Values1
 
TypeString (str,text)
altStat
DescriptionStatus reported by the axis controller.
Values4
 
Descriptionposition
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionvelocity
TypeFloat (float,flt4)
Unitsdeg/sec
Invalidnan
 
Descriptiontime
TypeFloat (float,flt4)
UnitsTAI (MJD, sec)
Invalidnan
 
Descriptionstatus word
TypeUInt (long,int4)
Invalidnan
altTrackAdvTime
DescriptionStatistics for how far in advance tracking updates are sent to the altitude controller
Values5
 
Descriptionnumber of samples
TypeInt (int,int4)
Invalidnan
 
Descriptionminimum
TypeFloat (float,flt4)
Unitssec
Invalidnan
 
Descriptionmaximum
TypeFloat (float,flt4)
Unitssec
Invalidnan
 
Descriptionmean
TypeFloat (float,flt4)
Unitssec
Invalidnan
 
Descriptionstandard deviation
TypeFloat (float,flt4)
Unitssec
Invalidnan
axePos
DescriptionActual mount position of azimuth, altitude and instrument rotator, as reported by the axes controllers. Not many digits past the decimal but very useful for status displays. Axes that are not available are listed as 'nan'. The state of the axes is given by AxisCmdState, which is always displayed in the same message as this keyword. See also TCCPos
Values3
 
Descriptionazimuth
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionaltitude
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptioninstrument rotator
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
axisBadStatusMask
DescriptionIf any bit is high both in this mask and in the status word from an axis controller, then the status is flagged as 'bad'. This flag is stored in the AxeLim block. See also AxisWarnStatusMask and Bad<AxisName>Status.
Values1
 
TypeUInt (long,int4)
Invalidnan
axisCmdState
DescriptionThe state of each axis as commanded by the TCC. Warning: this is only the state commanded by the TCC. To see what the axes are actually doing, see keywords such as !!! doesn't exist?: <AxisName>Stat!!!, AxePos and AxisErrCode. AxisCmdState supersedes TCCStatus, which is deprecated but still present for now.
Values3
 
Repeated3 times
TypeEnum (str,int2)
Value-0Drifting (The axis is moving at constant velocity while the TCC computes a slew path.)
Value-1Halted (The axis has been halted (by user request or because of a problem such as a communications failure).)
Value-2Halting (The axis is slewing to a stop, as per the track/stop command.)
Value-3Slewing (The axis is slewing.)
Value-4Tracking (The axis is tracking.)
Value-5NotAvailable ((only applicable to the rotator) there is no rotator at this instrument port.)
Value-6? (Unknown (indicates a TCC bug))
axisConnState
DescriptionState of connection to each axis controller
Values3
 
Descriptionazimuth axis
TypeString (str,text)
 
Descriptionaltitude axis
TypeString (str,text)
 
Descriptioninstrument rotator, or NotAvailable if the current instrument has no rotator
TypeString (str,text)
axisErrCode
DescriptionThe error code for each axis, as a string. The error code explains why an axis is not moving. Common codes are: CannotCompute: Could not compute the position. ControllerError: The axis controller reported an error or there was a communications error (such as a timeout or bad command echo). HaltRequested: The axis was halted by the user. MinPos: The minimum position limit was exceeded. MaxPos: Maximum position limit exceeded, or (if alternate wraps allowed) position out of bounds. MaxVel: Maximum velocity exceeded. NoRestart: The axis was already halted and a slew or offset was performed that left halted axis halted. NotAvailable: (only applicable to the rotator) there is no rotator at this instrument port. ?: Unknown (indicates a TCC bug).
Values3
 
Repeated3 times
TypeString (str,text)
Invalid?
axisMaxDTime
DescriptionIndicates the maximum axis controller clock error (in sec), that is acceptable before a warning is printed. This value is stored in the AxeLim block. See also <AxisName>DTime and Bad<AxisName>DTime.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
axisNoSlew
DescriptionIndicates that one or more axes will not be able to slew.
Values1
 
DescriptionA string of three characters corresponding to azimuth, altitude, and instrument rotator respectively. Each character may be 'T', for cannot slew, or 'F' for can slew.
TypeString (str,text)
axisNoTrack
DescriptionIndicates that one or more axes have stopped tracking (probably due to running into a limit).
Values1
 
DescriptionA string of three characters corresponding to azimuth, altitude, and instrument rotator respectively. Each character may be 'T', for initialized, or 'F' for not.
TypeString (str,text)
axisWarnStatusMask
DescriptionIf any bit is high both in this mask and in the status word from an axis controller, then the status is flagged as a warning. This mask is stored in the AxeLim block. See also AxisBadStatusMask and Warn<AxisName>Status.
Values1
 
TypeUInt (long,int4)
Invalidnan
azDTime
DescriptionApproximate azimuth controller clock time - TCC clock time. Warning: this has systematic error on the order of 0.1 seconds due to communication lag. It is primarily intended to indicate serious time discrepancies. Furthermore, some or all axes may show large error if any one axis controller delays the write or times out. To fix a time discrepancy, first set the TCC clock via the WWV clock (SET TIME), then set the controller clocks (AXIS INIT). has systematic error due to communication delays.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
azErr
DescriptionAzimuth servo error statistics: maximum absolute value, mean and standard deviation.
Values3
 
Descriptionmaximum absolute value
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptionmean absolute value
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptionstandard deviation absolute value
TypeFloat (float,flt4)
Unitsas
Invalidnan
azLim
DescriptionAzimuth motion limits used by the TCC (which are more restrictive than the limits used by the axis controller).
Values5
 
Descriptionminimum position
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionmaximum position
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionmaximum speed
TypeFloat (float,flt4)
Unitsdeg/sec
Invalidnan
 
Descriptionmaximum acceleration
TypeFloat (float,flt4)
Unitsdeg/sec^2
Invalidnan
 
Descriptionmaximum jerk
TypeFloat (float,flt4)
Unitsdeg/sec^3
Invalidnan
azReply
DescriptionUnparsed reply from the azimuth axis controller
Values1
 
TypeString (str,text)
azStat
DescriptionStatus reported by the axis controller.
Values4
 
Descriptionposition
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionvelocity
TypeFloat (float,flt4)
Unitsdeg/sec
Invalidnan
 
Descriptiontime
TypeFloat (float,flt4)
UnitsTAI (MJD, sec)
Invalidnan
 
Descriptionstatus word
TypeUInt (long,int4)
Invalidnan
azTrackAdvTime
DescriptionStatistics for how far in advance tracking updates are sent to the azimuth controller
Values5
 
Descriptionnumber of samples
TypeInt (int,int4)
Invalidnan
 
Descriptionminimum
TypeFloat (float,flt4)
Unitssec
Invalidnan
 
Descriptionmaximum
TypeFloat (float,flt4)
Unitssec
Invalidnan
 
Descriptionmean
TypeFloat (float,flt4)
Unitssec
Invalidnan
 
Descriptionstandard deviation
TypeFloat (float,flt4)
Unitssec
Invalidnan
azWrapPref
DescriptionPreferred wrap for the azimuth axis.
Values1
 
TypeEnum (str,int2)
Value-0None
Value-1Nearest
Value-2Negative
Value-3Middle
Value-4Positive
Value-5NoUnwrap
badAltDTime
DescriptionIndicates that the altitude axis controller's clock is too far off from the TCC's clock.
Valuesnone
badAltStatus
DescriptionIndicates that a seriously bad bit is set in the altitude axis controller's status word. See also AxisBadStatusMask and Warn<AxisName>Status.
Valuesnone
badAzDTime
DescriptionIndicates that the azimuth axis controller's clock is too far off from the TCC's clock.
Valuesnone
badAzStatus
DescriptionIndicates that a seriously bad bit is set in the azimuth axis controller's status word. See also AxisBadStatusMask and Warn<AxisName>Status.
Valuesnone
badRotDTime
DescriptionIndicates that the rotator axis controller's clock is too far off from the TCC's clock.
Valuesnone
badRotStatus
DescriptionIndicates that a seriously bad bit is set in the rotator axis controller's status word. See also AxisBadStatusMask and Warn<AxisName>Status.
Valuesnone
boresight
DescriptionThe user-specified position of the boresight (the position of the object on the instrument). In older versions of the TCC it was set via 'Offset InstPlane', and this still may work, but the new recommended way to set it is 'Offset Boresight'. Internally to the TCC this variable is known as Obj_Inst_xy.
Values6
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
broadcast
DescriptionMessage sent by the broadcast command.
Values1
 
TypeString (str,text)
calibOff
DescriptionThe current calibration offset.
Values9
 
Descriptionazimuth
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Descriptionaltitude
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Descriptionrotator
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
chebyBegEndTime
DescriptionTime range (TAI, MJD seconds) over which the Chebyshev polynomial is evaluated. Only meaningful if UseCheby=T.
Values2
 
Descriptionbeginning time
TypeFloat (float,flt4)
Unitssec
 
Descriptionend time
TypeFloat (float,flt4)
Unitssec
chebyCoeffsDist
DescriptionCoefficients of a Chebychev polynomial of the first kind specifying the value of distance to the object (au). The range of the polynomial is given by ChebyBegEndTime. Only meaningful if UseCheby=T.
Values0 or more
 
Repeatedat least 0 times
TypeFloat (float,flt4)
chebyCoeffsUser1
DescriptionCoefficients of a Chebychev polynomial of the first kind specifying the value of user position axis 1 (deg). The range of the polynomial is given by ChebyBegEndTime. Only meaningful if UseCheby=T.
Values0 or more
 
Repeatedat least 0 times
TypeFloat (float,flt4)
chebyCoeffsUser2
DescriptionCoefficients of a Chebychev polynomial of the first kind specifying the value of user position axis 2 (deg). The range of the polynomial is given by ChebyBegEndTime. Only meaningful if UseCheby=T.
Values0 or more
 
Repeatedat least 0 times
TypeFloat (float,flt4)
chebyFile
DescriptionPath of a file loaded using Track/Chebyshev=path. The file contains Chebyshev polynomial coefficients that describe the path of an object. Only meaningful if UseCheby=T.
Values1
 
Descriptionpath to file
TypeString (str,text)
cmd
DescriptionPartial text of a TCC command. Only 40 or so characters is shown; the remainder is truncated without warning.
Values1
 
TypeString (str,text)
cmdDTime
DescriptionPredicted duration of command, in seconds.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
convAng
DescriptionChange in orientation: the converted reference direction minus the user-supplied reference direction. A vector is constructed perpendicular to the position along the user-supplied reference direction. This vector is converted to the final coordinate system, and its angle measured with respect to the final coordinate system to give the converted reference direction.
Values3
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
convPM
DescriptionConverted proper motion, parallax, and radial velocity (output of CONVERT command).
Values4
 
Repeated2 times
Descriptionproper motion
TypeFloat (float,flt4)
Unitsas/century
Invalidnan
 
Descriptionparallax
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptionradial velocity (positive receding)
TypeFloat (float,flt4)
Unitskm/sec
Invalidnan
convPos
DescriptionConverted position (output of CONVERT command).
Values6
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
currArcOff
DescriptionThe current value of the arc offset. This will only differ from the ObjArcOff if the velocity is nonzero and is being corrected for drift scanning (TDICorr). (Internal to the TCC this is obj.userArcOff with the velocity multiplied by obj.arcVelCorr. There is no obj.currArcOff.)
Values6
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
currUsers
DescriptionThe number of users currently connected to the TCC software.
Values1
 
TypeUInt (long,int4)
Invalidnan
disabledProc
DescriptionShows which optional processes are disabled (if any). Note: the names are as known by VMS; hence they include a leading 'T_' and are all uppercase.
Values0 or more
 
Repeatedat least 0 times
TypeString (str,text)
duration
DescriptionShows the current duration (in seconds) of some operation. Other keywords on the same line should indicate what this is the duration of. See also See also MaxDuration.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
expected
DescriptionBad echo from a controller; this is the text that was expected. See also Received.
Values1
 
TypeString (str,text)
expTime
DescriptionExposure time (sec). This time is used for guiding, pointing error corrections, and as a default for GCAMERA commands.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
failed
DescriptionThe command failed. Warning: not reliably output and not intended for automated use; please use the command status code instead.
Values1
 
TypeString (str,text)
gCamID
DescriptionIdentification of the guide camera in use.
Values1-2
 
Repeated1-2 times
Descriptiondevice ID
TypeInt (int,int4)
Invalidnan
gcView
DescriptionName of guide camera view. The normal default view has no name ('')
Values1
 
TypeString (str,text)
gImCtr
DescriptionGuide image center (unbinned pixels); se also GImScale. pos. (unbinned pixels) = offset + scale * pos. (deg).
Values2
 
Descriptionx pixels
TypeFloat (float,flt4)
Invalidnan
 
Descriptiony pixels
TypeFloat (float,flt4)
Invalidnan
gImLim
DescriptionEdges of guide image (unbinned pixels).
Values4
 
Descriptionmin x
TypeFloat (float,flt4)
Invalidnan
 
Descriptionmin y
TypeFloat (float,flt4)
Invalidnan
 
Descriptionmax x
TypeFloat (float,flt4)
Invalidnan
 
Descriptionmax y
TypeFloat (float,flt4)
Invalidnan
gImScale
DescriptionGuide image scale (unbinned pixels/deg); see also GImCtr. pos. (unbinned pixels) = offset + scale * pos. (deg).
Values2
 
Descriptionx scale
TypeFloat (float,flt4)
Invalidnan
 
Descriptiony scale
TypeFloat (float,flt4)
Invalidnan
gmechID
Descriptionguide camera mechanical controller iD (0 if none); new TCC outputs one value, old TCC outputs two
Values1-2
 
Repeated1-2 times
TypeUInt (long,int4)
Invalidnan
gPCtr
Descriptiondeprecated (use gProbeInfo)
Values2
 
Repeated2 times
TypeFloat (float,flt4)
Invalidnan
gPLim
Descriptiondeprecated (use gProbeInfo)
Values4
 
Repeated4 times
TypeFloat (float,flt4)
Invalidnan
gProbe
Descriptiondeprecated (use gProbeInfo)
Values1
 
TypeInt (int,int4)
Invalidnan
gProbeInfo
Descriptioninformation about a guide probe; information is provided for all probes in order from 1 to N, so if you see information for probe 1 you can erase data about the remaining probes
Values11
 
Descriptionnumber (1, ...)
TypeInt (int,int4)
Invalidnan
 
Descriptionenabled?
TypeBool (int,int2)
FalseF
TrueT
 
Descriptioncenter x
TypeFloat (float,flt4)
Unitsunbinned pixels
Invalidnan
 
Descriptioncenter y
TypeFloat (float,flt4)
Unitsunbinned pixels
Invalidnan
 
Descriptionmin x
TypeFloat (float,flt4)
Unitsunbinned pixels
Invalidnan
 
Descriptionmin y
TypeFloat (float,flt4)
Unitsunbinned pixels
Invalidnan
 
Descriptionmax x
TypeFloat (float,flt4)
Unitsunbinned pixels
Invalidnan
 
Descriptionmax y
TypeFloat (float,flt4)
Unitsunbinned pixels
Invalidnan
 
Descriptionx position of center of guide probe w.r.t. rotator
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptiony position of center of guide probe w.r.t. rotator
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionangle from probe image x to rotator x
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
gPRotGImAng
Descriptiondeprecated(use gProbeInfo)
Values1
 
TypeFloat (float,flt4)
Invalidnan
gPRotXY
Descriptiondeprecated (use gProbeInfo)
Values2
 
TypeFloat (float,flt4)
Invalidnan
 
TypeFloat (float,flt4)
Invalidnan
gSWavelength
DescriptionThe central wavelength for the object (in Angstroms). Used to correct for refraction. See also ObjWavelength
Values1
 
TypeFloat (float,flt4)
UnitsA
Invalidnan
guideOff
DescriptionThe current guide offset.
Values9
 
Descriptionazimuth
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Descriptionaltitude
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Descriptionrotator
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
humidity
DescriptionRelative humidity (fraction, NOT percent!); used for refraction correction.
Values1
 
TypeFloat (float,flt4)
Invalidnan
iimCtr
DescriptionInstrument image center (unbinned pixels). See also IImScale, IImLim. pos. (unbinned pixels) = offset + scale * pos. (deg)
Values2
 
Descriptionx
TypeFloat (float,flt4)
Unitspixels
Invalidnan
 
Descriptiony
TypeFloat (float,flt4)
Unitspixels
Invalidnan
iimLim
DescriptionEdges of instrument image (unbinned pixels). See also IImScale, IImCtr.
Values4
 
Descriptionmin x
TypeFloat (float,flt4)
Unitspixels
Invalidnan
 
Descriptionmin y
TypeFloat (float,flt4)
Unitspixels
Invalidnan
 
Descriptionmax x
TypeFloat (float,flt4)
Unitspixels
Invalidnan
 
Descriptionmax y
TypeFloat (float,flt4)
Unitspixels
Invalidnan
iimScale
DescriptionInstrument image scale (unbinned pixels/deg) See also IImCtr, IImLim. pos. (unbinned pixels) = offset + scale * pos. (deg)
Values2
 
Descriptionx
TypeFloat (float,flt4)
Unitspixels/deg
Invalidnan
 
Descriptiony
TypeFloat (float,flt4)
Unitspixels/deg
Invalidnan
inst
DescriptionName of the current instrument.
Values1
 
TypeString (str,text)
instFocus
DescriptionSecondary mirror focus offset due to instrument.
Values1
 
TypeFloat (float,flt4)
Unitsum
Invalidnan
instPos
DescriptionName of instrument position ('non' if none specified yet).
Values1
 
TypeEnum (str,int2)
Value-0NA1
Value-1NA2
Value-2BC1
Value-3TR1
Value-4TR2
Value-5SK1
Value-6SK2
Value-7SK3
Value-8SK4
Value-9CA1
Value-10non
ipConfig
DescriptionInstrument-position configuration, e.g. is an instrument rotator available
Values1
 
DescriptionA string of three characters corresponding to availablity for instrument rotator, guide camera, and uider mechanical respectively. Each character may be 'T', for true, or 'F' for false.
TypeString (str,text)
iter
DescriptionIteration number. Other keywords on the same line should indicate what is being iterated. See also MaxIter.
Values1
 
TypeUInt (long,int4)
Invalidnan
job
Values1
 
TypeString (str,text)
jobList
Descriptionbatch jobs that can be queued
Values0 or more
 
Repeatedat least 0 times
TypeString (str,text)
jobStatus
Descriptionstatus of current batch job
Values2
 
Descriptionname of job
TypeString (str,text)
 
Descriptionstatus of job
TypeString (str,text)
lst
DescriptionLocal apparent sidereal time (LST), as an angle.
Values1
 
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
maxDuration
DescriptionMaximum duration of a task, in seconds. Other keywords on the same line should indicate what this is the maximum duration of. See also Duration.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
maxIter
DescriptionMaximum number of iterations allowed. Other keywords on the same line should indicate what is being iterated. See also Iter.
Values1
 
TypeUInt (long,int4)
Invalidnan
maxUsers
DescriptionThe maximum number of users that may use the TCC software at this time. See also CurrUsers. Warning: this value only applies to subsequent attempts to connect. If this value is reduced below the current number of users, it will have no affect on the current users.
Values1
 
TypeUInt (long,int4)
Invalidnan
mirrorConnState
DescriptionState of connection to each mirror controller
Values3
 
Descriptionprimary mirror, or NotAvailable if no primary mirror controller
TypeString (str,text)
 
Descriptionsecondary mirror, or NotAvailable if no secondary mirror controller
TypeString (str,text)
 
Descriptiontertiary mirror, or NotAvailable if no tertiary mirror controller
TypeString (str,text)
moved
DescriptionIndicates that the telescope made an immediate move (the default style of offset). The telescope may still be moving (especially if it's a large offset), since the TCC has no reliable way of knowing when an immediate move is done.
Valuesnone
moveItems
DescriptionIndicates which user-set position attributes have been changed for a move. This keyword always appears with Moved or SlewBeg, and never appears any other time.
Values1
 
DescriptionA 9 character string; each character is either Y (item changed) or N (item did not change): 1=object name 2=any of: object position, coordinate system, epoch, distance, proper motion (or parallax), or radial velocity 3=object magnitude 4=object offset 5=arc offset (eg for drift-scanning) 6=boresight position, 7=rotator angle or type of rotation 8=guide offset 9=calibration offset
TypeString (str,text)
numUsers
Descriptionnumber of users
Values1
 
TypeInt (int,int4)
objArcOff
DescriptionUser-specified arc offset. This is an offset along a great circle. The magnitude of the vector is the length of the arc. The angle of the vector specifies the tangent to the arc (at the beginning of the arc, e.g. at the position before applying the arc offset). (Note: if velocity is being corrected for drift scanning, e.g. TDICorr, then the position and time components are regularly updated. This is purely for internal bookkeeping purposes. The velocity component is left alone (ironically enough) but is not the true current velocity; for that see CurrArcOff.) See also CurrArcOff, TDICorr.
Values6
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
objDist
DescriptionGeocentric distance to the object, in au, or 'inf' if very far away.
Values1
 
TypeFloat (float,flt4)
Unitsau
Invalidnan
objInstAng
DescriptionOrientation of object on the instrument. Specifically, it is the angle from the instrument x,y axes to the axes of the object's user-specified coordinate system (typically RA,Dec). For example: if the direction of increasing coordinate system axis 1 (typically RA) lies along the instrument x axis, the angle is 0; if along y, the angle is 90.
Values3
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
objMag
DescriptionObject brightness, in magnitudes.
Values1
 
TypeFloat (float,flt4)
Unitsmag
Invalidnan
objName
DescriptionObject name. The name is an arbitrary string set by the user or from a catalog or whatever. The TCC makes no use of the name.
Values1
 
TypeString (str,text)
objNetPos
DescriptionPosition of object in the user-specified coordinate system, with proper motion, parallax & radial velocity removed to the current date, and including the current object offset and arc offset.
Values6
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
objObs
Descriptionobserved (refracted apparent topocentric) position of target
Values6
 
Descriptionazimuth
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Descriptionaltitude
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
objOff
Descriptiondeprecated: not supported by new TCC
Values6
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
objPM
Descriptionproper motion, etc. of target
Values4
 
Descriptionequatorial proper motion (dEquatAng/dt)
TypeFloat (float,flt4)
Unitsas/century
Invalidnan
 
Descriptionpolar proper motion
TypeFloat (float,flt4)
Unitsas/century
Invalidnan
 
Descriptionparallax
TypeFloat (float,flt4)
Unitsarcsec
Invalidnan
 
Descriptionradial velocity (positive receding)
TypeFloat (float,flt4)
Unitskm/sec
Invalidnan
objPos
DescriptionUser-specified position of the object (excluding offsets).
Values6
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
objSys
DescriptionUser-specified coordinate system of object, as described in TCC Commands: coordSys
Values2
 
TypeEnum (str,int2)
Value-0ICRS
Value-1FK5
Value-2FK4
Value-3Gal
Value-4Geo
Value-5None
Value-6Topo
Value-7Obs
Value-8Phys
Value-9Mount
Value-10Inst
Value-11GImage
 
Descriptiondate; 0 for systems with no date, and for observed systems if the current date is being used
TypeFloat (float,flt4)
Invalidnan
objWavelength
DescriptionThe central wavelength for the object (in Angstroms). Used to correct for refraction. See also GSWavelength
Values1
 
TypeFloat (float,flt4)
UnitsA
Invalidnan
objZPMPos
DescriptionPosition of object in user-specified coordinate system, but with proper motion, parallax, and radial velocity removed to the current epoch.
Values6
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
predFWHM
DescriptionPredicted seeing FWHM (arcsec). Used for guiding and pointing error correction, and as a default for GCAMERA commands.
Values1
 
TypeFloat (float,flt4)
Unitsas
Invalidnan
pressure
DescriptionAir pressure; used for refraction correction.
Values1
 
TypeFloat (float,flt4)
UnitsPa
Invalidnan
primActMount
DescriptionActuator lengths determined from primEncMount and the mirror model. This may not match primCmdMount, even if the actuators move as commanded, due to systematic errors in the mirror model.For an actuator without an encoder, the commanded actuator mount is used.
Values1 or more
 
Repeatedat least once
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
primCmdMount
Descriptioncommanded position of primary mirror actuators
Values1 or more
 
Repeatedat least once
TypeFloat (float,flt4)
Invalidnan
primDesEncMount
DescriptionDesired encoder lengths, in actuator microsteps, based on primDesOrient and the mirror model. There is one entry per actuator, rather than per encoder: for an actuator without an encoder, the commanded actuator mount is used.
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
primDesOrient
Descriptiondesired orientation of primary mirror
Values5-6
 
Descriptionpiston
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Descriptionx tilt
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptiony tilt
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptionx translation
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Descriptiony translation
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Repeated0-1 times
Descriptionrotation about z (new TCC only)
TypeFloat (float,flt4)
Unitsas
Invalidnan
primDesOrientAge
DescriptionTime elapsed since this orient was commanded.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
primEncMount
DescriptionMeasured encoder lengths, in actuator microsteps, based on primDesOrient and the mirror model. There is one entry per actuator, rather than per encoder; for an actuator without an encoder, the commanded actuator mount is used.
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
primF_BFTemp
Values2
 
Descriptionfront temperature
TypeFloat (float,flt4)
UnitsC
Invalidnan
 
Descriptionfront-back temperature difference
TypeFloat (float,flt4)
UnitsC
Invalidnan
primModelMount
DescriptionActuator mount position determined from desOrient the the mirror model
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
primMountErr
DescriptionError in mount position for a given iteration. Apply this delta to primCmdMount each iteration.
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
primNetMountOffset
DescriptionOffset applied to a model mount at the beginning of a move, to prevent motion for a null move and speed up convergence for a small move. It primarily compensates for systematic error in the mirror model.
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
primOrient
Descriptionactual orientation of primary mirror
Values5-6
 
Descriptionpiston
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Descriptionx tilt
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptiony tilt
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptionx translation
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Descriptiony translation
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Repeated0-1 times
Descriptionrotation about z (new TCC only)
TypeFloat (float,flt4)
Unitsas
Invalidnan
primReply
DescriptionUnparsed reply from the primary mirror controller
Values1
 
TypeString (str,text)
primState
Descriptionsummarizes current state of secondary galil and any remaning time or move iterations
Values5
 
DescriptionState of galil device, one of: Moving, Done, Homing, Failed, NotHomed
TypeString (str,text)
 
Descriptioncurrent iteration
TypeUInt (long,int4)
 
Descriptionmax iterations
TypeUInt (long,int4)
 
Descriptionremaining time on move or home
TypeFloat (float,flt4)
Unitsseconds
Invalidnan
 
Descriptiontotal time for move or home
TypeFloat (float,flt4)
Unitsseconds
Invalidnan
primStatus
Descriptionstatus word from the primiary mirror controller
Values1-6
 
Repeated1-6 times
TypeUInt (long,int4)
Invalidnan
ptCorr
Descriptionmeasured pointing error in a form suitable for guiding (thus, relative to current guide and calibration offsets).All values are in the pointing frame, which is the rotator frame rotated such that x = az
Values4
 
Descriptionaz pointing correction on the sky
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionalt pointing correction on the sky
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionx position in pointing frame
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptiony position in pointing frame
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
ptData
Descriptionmeasured pointing error in a form suitable recording pointing model data
Values5
 
Descriptionaz desired physical position
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionalt desired physical position
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionaz mount position
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionalt mount position
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionrot physical angle
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
ptErrProbe
Descriptionguide probe to use for pointing error measurement; 0 if none
Values1
 
TypeInt (int,int4)
ptRefPos
Description(deprecated; use ptRefStar instead) position of pointing reference star (equatorial PVT, polar PVT)
Values6
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
ptRefRadius
Descriptiondeprecated
Values1
 
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
ptRefStar
DescriptionInformation about a pointing reference star
Values9
 
Descriptionequatorial position
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionpolar position
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionparallax
TypeFloat (float,flt4)
Unitsarcsec
Invalidnan
 
Descriptionequatorial proper motion (dEquatAng/dt as arcsec/year)
TypeFloat (float,flt4)
Invalidnan
 
Descriptionpolar proper motion (arcsec/year)
TypeFloat (float,flt4)
Invalidnan
 
Descriptionradial velocity (km/sec, positive receding)
TypeFloat (float,flt4)
Invalidnan
 
Descriptioncoordinate system name
TypeString (str,text)
Invalid?
 
Descriptioncoordinate system date
TypeFloat (float,flt4)
Invalidnan
 
Descriptionmagnitude
TypeFloat (float,flt4)
Invalidnan
ptScanSize
Descriptiondeprecated
Values1
 
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
received
DescriptionText string read from a port. See also Expected.
Values1
 
TypeString (str,text)
rejectedAxisErrCode
DescriptionAxis error codes for a move that was rejected. AxisErrCode would have had these values had the move been attempted, but the errors were too severe, so the move was rejected and the telescope was left doing whatever it was doing.
Values3
 
Descriptionazimuth
TypeString (str,text)
Invalid?
 
Descriptionaltitude
TypeString (str,text)
Invalid?
 
Descriptionrotator
TypeString (str,text)
Invalid?
rotDTime
DescriptionApproximate rotator controller clock time - TCC clock time. Warning: this has systematic error on the order of 0.1 seconds due to communication lag. It is primarily intended to indicate serious time discrepancies. Furthermore, some or all axes may show large error if any one axis controller delays the write or times out. To fix a time discrepancy, first set the TCC clock via the WWV clock (SET TIME), then set the controller clocks (AXIS INIT). has systematic error due to communication delays.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
rotErr
DescriptionRotator servo error statistics: maximum absolute value, mean and standard deviation.
Values3
 
Descriptionmaximum absolute value
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptionmean absolute value
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptionstandard deviation absolute value
TypeFloat (float,flt4)
Unitsas
Invalidnan
rotID
Descriptionrotator ID (0 if no rotator); new TCC outputs one value, old TCC outputs two
Values1-2
 
Repeated1-2 times
TypeUInt (long,int4)
Invalidnan
rotInstXYAng
DescriptionPosition of the center of the instrument rotator in instrument coordinate frame.
Values3
 
Descriptionx position in coordinate frame
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptiony position in coordinate frame
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionangle of instrument rotator x axis in coordinate frame.
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
rotLim
DescriptionRotator motion limits used by the TCC (which are more restrictive than the limits used by the axis controller).
Values5
 
Descriptionminimum position
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionmaximum position
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionmaximum speed
TypeFloat (float,flt4)
Unitsdeg/sec
Invalidnan
 
Descriptionmaximum acceleration
TypeFloat (float,flt4)
Unitsdeg/sec^2
Invalidnan
 
Descriptionmaximum jerk
TypeFloat (float,flt4)
Unitsdeg/sec^3
Invalidnan
rotMount
DescriptionAngle of the instrument rotator in mount coordinates. See also TelMount.
Values3
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
rotOffsetScale
DescriptionParameters to transform instrument rotator physical angle to mount: mount = offset + (physical * scale). Thus the units of offset are mount units (typically but not necessarily degrees) and the units of scale are mount units/degrees.
Values2
 
TypeFloat (float,flt4)
Unitsmount units
Invalidnan
 
TypeFloat (float,flt4)
Unitsmount units/deg
Invalidnan
rotPhys
DescriptionAngle of the instrument rotator in physical coordinates. See also TelPhys.
Values3
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
rotPos
DescriptionUser-specifiec position of rotator.
Values3
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
rotReply
DescriptionUnparsed reply from the rotator axis controller
Values1
 
TypeString (str,text)
rotStat
DescriptionStatus reported by the axis controller.
Values4
 
Descriptionposition
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionvelocity
TypeFloat (float,flt4)
Unitsdeg/sec
Invalidnan
 
Descriptiontime
TypeFloat (float,flt4)
UnitsTAI (MJD, sec)
Invalidnan
 
Descriptionstatus word
TypeUInt (long,int4)
Invalidnan
rotTrackAdvTime
DescriptionStatistics for how far in advance tracking updates are sent to the rotator controller
Values5
 
Descriptionnumber of samples
TypeInt (int,int4)
Invalidnan
 
Descriptionminimum
TypeFloat (float,flt4)
Unitssec
Invalidnan
 
Descriptionmaximum
TypeFloat (float,flt4)
Unitssec
Invalidnan
 
Descriptionmean
TypeFloat (float,flt4)
Unitssec
Invalidnan
 
Descriptionstandard deviation
TypeFloat (float,flt4)
Unitssec
Invalidnan
rotType
DescriptionMode (type of rotation) of instrument rotator. See TCC Commands: Rotate for more information.
Values1
 
TypeEnum (str,int2)
Value-0None
Value-1Obj
Value-2Horiz
Value-3Phys
Value-4Mount
rotWrapPref
DescriptionPreferred wrap for the rotator axis.
Values1
 
TypeEnum (str,int2)
Value-0None
Value-1Nearest
Value-2Negative
Value-3Middle
Value-4Positive
Value-5NoUnwrap
scaleFac
DescriptionCurrent scale factor, defined as actual focal plate scale / nominal scale, where larger scale (and hence larger scale factor) gives higher resolution, e.g. more pixels/arcsec.
Values1
 
TypeFloat (float,flt4)
Invalidnan
scaleFacRange
DescriptionAllowed range of scale factor. Note: at present, the TCC only permits specifying a maximum scale factor; the minimum is computed from this as follows: minimum = 1/maximum.
Values2
 
Descriptionmin
TypeFloat (float,flt4)
Invalidnan
 
Descriptionmax
TypeFloat (float,flt4)
Invalidnan
secActMount
DescriptionActuator lengths determined from secEncMount and the mirror model. This may not match secCmdMount, even if the actuators move as commanded, due to systematic errors in the mirror model.For an actuator without an encoder, the commanded actuator mount is used.
Values1 or more
 
Repeatedat least once
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
secCmdMount
Descriptioncommanded position of secondary mirror actuators
Values1 or more
 
Repeatedat least once
TypeFloat (float,flt4)
Invalidnan
secDesEncMount
DescriptionDesired encoder lengths, in actuator microsteps, based on secDesOrient and the mirror model. There is one entry per actuator, rather than per encoder: for an actuator without an encoder, the commanded actuator mount is used.
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
secDesOrient
Descriptiondesired orientation of secondary mirror
Values5-6
 
Descriptionpiston
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Descriptionx tilt
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptiony tilt
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptionx translation
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Descriptiony translation
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Repeated0-1 times
Descriptionrotation about z (new TCC only)
TypeFloat (float,flt4)
Unitsas
Invalidnan
secDesOrientAge
DescriptionTime elapsed since this orient was commanded.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
secEncMount
DescriptionMeasured encoder lengths, in actuator microsteps, based on secDesOrient and the mirror model. There is one entry per actuator, rather than per encoder; for an actuator without an encoder, the commanded actuator mount is used.
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
secF_BFTemp
Values2
 
Descriptionfront temperature
TypeFloat (float,flt4)
UnitsC
Invalidnan
 
Descriptionfront-back temperature difference
TypeFloat (float,flt4)
UnitsC
Invalidnan
secFocus
DescriptionUser-specified secondary mirror focus offset, as specified by the SET FOCUS command.
Values1
 
TypeFloat (float,flt4)
Unitsum
Invalidnan
secModelMount
DescriptionActuator mount position determined from desOrient the the mirror model
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
secMountErr
DescriptionError in mount position for a given iteration. Apply this delta to secCmdMount each iteration.
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
secNetMountOffset
DescriptionOffset applied to a model mount at the beginning of a move, to prevent motion for a null move and speed up convergence for a small move. It primarily compensates for systematic error in the mirror model.
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
secOrient
Descriptionactual orientation of secondary mirror
Values5-6
 
Descriptionpiston
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Descriptionx tilt
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptiony tilt
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptionx translation
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Descriptiony translation
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Repeated0-1 times
Descriptionrotation about z (new TCC only)
TypeFloat (float,flt4)
Unitsas
Invalidnan
secReply
DescriptionUnparsed reply from the secondary mirror controller
Values1
 
TypeString (str,text)
secState
Descriptionsummarizes current state of secondary galil and any remaning time or move iterations
Values5
 
DescriptionState of galil device, one of: Moving, Done, Homing, Failed, NotHomed
TypeString (str,text)
 
Descriptioncurrent iteration
TypeUInt (long,int4)
 
Descriptionmax iterations
TypeUInt (long,int4)
 
Descriptionremaining time on move or home
TypeFloat (float,flt4)
Unitsseconds
Invalidnan
 
Descriptiontotal time for move or home
TypeFloat (float,flt4)
Unitsseconds
Invalidnan
secStatus
Descriptionstatus word from the secondary mirror controller
Values1-6
 
Repeated1-6 times
TypeUInt (long,int4)
Invalidnan
secTrussTemp
DescriptionAverage temperature of the secondary truss elements. Used for automatic focus correction.
Values1
 
TypeFloat (float,flt4)
UnitsC
Invalidnan
slewAdvTime
DescriptionThe amount of time in advance a slew was sent, in seconds. For safety, this must be less than Tune.MaxClockErr (and if it is not, SlewAdvTime will be part of a warning message). The advance time of a slew segment is the time at which the segment was sent to the axis controller minus the end time of the segment. The reported SlewAdvTime is the minimum advance time of all segments of all axes.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
slewBeg
DescriptionIndicates that a slew has begun.
Values1
 
Descriptioncorrect, exact, and reliable time of the end of the slew
TypeDouble (float,flt8)
Unitssec
Invalidnan
slewDuration
DescriptionIndicates the duration of a slew.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
slewEnd
DescriptionIndicates the end of a slew.
Valuesnone
slewNumIter
Descriptionnumber of iterations for slew computation
Values1
 
TypeInt (int,int4)
slewSuperseded
DescriptionIndicates that a slew was aborted to make way for another slew.
Valuesnone
spiderInstAng
DescriptionOrientation of secondary spider on the instrument. Specifically, it is the angle from the instrument x axis to the secondary spider x axis, where the secondary spider x axis is the direction of increasing azimuth when the telescope is at the horizon. (Formerly AzInstAng, approximately).
Values3
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
started
DescriptionBackground command started. Warning: not reliably output and not intended for automated use; please use the command status instead.
Valuesnone
stInterval
DescriptionInterval between automatic status updates while tracking and while slewing. The intervals are in decimal seconds.
Values2-3
 
Repeated2-3 times
TypeFloat (float,flt4)
Unitssec
Invalidnan
superseded
DescriptionBackground command superseded by another command.
Valuesnone
tai
DescriptionInternational atomic time (TAI), in MJD seconds.
Values1
 
TypeDouble (float,flt8)
Unitssec
Invalidnan
tccDTime
DescriptionTCC clock adjustment, in seconds; new time = old time + TCCDTime. The TCC clock should only be adjusted when it is recalibrated to the radio clock, in which case TCCDTime indicates the clock error just before adjustment. The error should never exceed a few tenths of a second else the axis controller clocks may get mis-set.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
tccPos
DescriptionThe desired mount position as computed by the TCC. Not many digits past the decimal but very useful for status displays. Axes that are halted or not available are listed as 'nan'. The state of the axes is given by AxisCmdState. See also AxePos. During a slew TCCPos gives the end position of the slew, not the current predicted position.
Values3
 
Descriptionazimuth
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionaltitude
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
 
Descriptionrotator
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
telMount
DescriptionPosition of the telescope azimuth and altitude axes, in mount coordinates. See also RotMount
Values6
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
 
Subtype-0----------------------------------------
Nameposition
TypeFloat (float,flt4)
Unitsdeg
Subtype-1----------------------------------------
Namevelocity
TypeFloat (float,flt4)
Unitsdeg/s
Subtype-2----------------------------------------
Nametime
TypeDouble (float,flt8)
UnitsMJD-secs(TAI)
tertActMount
DescriptionActuator lengths determined from tertEncMount and the mirror model. This may not match tertCmdMount, even if the actuators move as commanded, due to systematic errors in the mirror model.For an actuator without an encoder, the commanded actuator mount is used.
Values1 or more
 
Repeatedat least once
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
tertCmdMount
Descriptioncommanded position of tertiary mirror actuators
Values1 or more
 
Repeatedat least once
TypeFloat (float,flt4)
Invalidnan
tertDesEncMount
DescriptionDesired encoder lengths, in actuator microsteps, based on tertDesOrient and the mirror model. There is one entry per actuator, rather than per encoder: for an actuator without an encoder, the commanded actuator mount is used.
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
tertDesOrient
Descriptiondesired orientation of tertiary mirror
Values5-6
 
Descriptionpiston
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Descriptionx tilt
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptiony tilt
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptionx translation
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Descriptiony translation
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Repeated0-1 times
Descriptionrotation about z (new TCC only)
TypeFloat (float,flt4)
Unitsas
Invalidnan
tertDesOrientAge
DescriptionTime elapsed since this orient was commanded.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
tertEncMount
DescriptionMeasured encoder lengths, in actuator microsteps, based on tertDesOrient and the mirror model. There is one entry per actuator, rather than per encoder; for an actuator without an encoder, the commanded actuator mount is used.
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
tertModelMount
DescriptionActuator mount position determined from desOrient the the mirror model
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
tertMountErr
DescriptionError in mount position for a given iteration. Apply this delta to tertCmdMount each iteration.
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
tertNetMountOffset
DescriptionOffset applied to a model mount at the beginning of a move, to prevent motion for a null move and speed up convergence for a small move. It primarily compensates for systematic error in the mirror model.
Values3-6
 
Repeated3-6 times
TypeFloat (float,flt4)
Unitsmicrosteps
Invalidnan
tertOrient
Descriptionactual orientation of tertiary mirror
Values5-6
 
Descriptionpiston
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Descriptionx tilt
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptiony tilt
TypeFloat (float,flt4)
Unitsas
Invalidnan
 
Descriptionx translation
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Descriptiony translation
TypeFloat (float,flt4)
Unitsum
Invalidnan
 
Repeated0-1 times
Descriptionrotation about z (new TCC only)
TypeFloat (float,flt4)
Unitsas
Invalidnan
tertReply
DescriptionUnparsed reply from the tertiary mirror controller
Values1
 
TypeString (str,text)
tertState
Descriptionsummarizes current state of tertiary galil and any remaning time or move iterations
Values5
 
DescriptionState of galil device, one of: Moving, Done, Homing, Failed, NotHomed
TypeString (str,text)
 
Descriptioncurrent iteration
TypeUInt (long,int4)
 
Descriptionmax iterations
TypeUInt (long,int4)
 
Descriptionremaining time on move or home
TypeFloat (float,flt4)
Unitsseconds
Invalidnan
 
Descriptiontotal time for move or home
TypeFloat (float,flt4)
Unitsseconds
Invalidnan
tertStatus
Descriptionstatus word from the tertiary mirror controller
Values1-6
 
Repeated1-6 times
TypeUInt (long,int4)
Invalidnan
text
DescriptionExplanatory text for a message.
Values1
 
TypeString (str,text)
timeStamp
DescriptionTimestamp of associated data.
Values1
 
TypeDouble (float,flt8)
Unitssec
Invalidnan
tLapse
Values1
 
TypeFloat (float,flt4)
UnitsC/km
Invalidnan
trackAdvTime
DescriptionA tracking update occurred. In other words, a new position, velocity, time triplet was issued to one or more axis controllers. The value is the number of seconds in advance that the update occurred before the previous pvt triplets expired. Too small a value triggers a warning and suggests that you may need to modify the tuning parameters.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
useCheby
DescriptionIf T then the track an object whose position is specified using Chebyshev polynomial coefficients. See also ChebyFile, ChebyCoeffsUser1, ChebyCoeffsUser2, ChebyCoeffsDist and ChebyBegEndTime. If F then the other Chebyshev keywords are meaningless and should be ignored.
Values1
 
TypeBool (int,int2)
FalseF
TrueT
userAdded
DescriptionThe associated user (indicated by UserNum) has started running the TCC software.
Valuesnone
userDeleted
DescriptionThe associated user (indicated by UserNum) has stopped running the TCC software.
Valuesnone
userInfo
DescriptionInformation about one user; new tcc outputs 2 values, 2nd is user's IP address; old TCC outputs 4 values, see docs for details
Values2-5
 
Descriptionuser ID
TypeUInt (long,int4)
Invalidnan
 
Repeated1-4 times
TypeString (str,text)
userNum
DescriptionUser ID number. Each user has a unique user ID number which is used to tag commands initiated by that user. UserNum generally appears with other data such as UserAdded or UserDeleted. See also YourUserNum.
Values1
 
TypeUInt (long,int4)
Invalidnan
ut1
DescriptionUniversal time (UT1), in MJD seconds.
Values1
 
TypeDouble (float,flt8)
Unitssec
Invalidnan
utc_TAI
DescriptionThe time difference: UTC - TAI, in seconds.
Values1
 
TypeFloat (float,flt4)
Unitssec
Invalidnan
version
DescriptionTCC software version.
Values1
 
TypeString (str,text)
warnAltStatus
DescriptionIndicates that a possibly bad bit is set in the altitude controller's status word. See also AxisWarnStatusMask and Bad<AxisName>Status.
Valuesnone
warnAzStatus
DescriptionIndicates that a possibly bad bit is set in the azimuth controller's status word. See also AxisWarnStatusMask and Bad<AxisName>Status.
Valuesnone
warnRotStatus
DescriptionIndicates that a possibly bad bit is set in the rotator controller's status word. See also AxisWarnStatusMask and Bad<AxisName>Status.
Valuesnone
windDir
DescriptionOutside wind direction (degrees, south = 0, east = 90).
Values1
 
TypeFloat (float,flt4)
Unitsdeg
Invalidnan
windSpeed
DescriptionOutside wind speed (m/s).
Values1
 
TypeFloat (float,flt4)
Unitsm/sec
Invalidnan
yourUserID
DescriptionYour user ID (use to identify messages meant for you); new TCC only
Values1
 
TypeUInt (long,int4)
yourUserNum
DescriptionSynonym for yourUserID; deprecated for new TCC but required for old TCC
Values1
 
TypeUInt (long,int4)