Click or drag to resize

ITelescopeV4DeclinationRate Property

The declination tracking rate (arcseconds per SI second, default = 0.0)

Namespace: ASCOM.DeviceInterface
Assembly: ASCOM.DeviceInterfaces (in ASCOM.DeviceInterfaces.dll) Version: 7.0.0-rc.0+0
Syntax
double DeclinationRate { get; set; }

Property Value

Double
Exceptions
ExceptionCondition
PropertyNotImplementedExceptionIf DeclinationRate Write is not implemented.
InvalidValueExceptionIf an invalid DeclinationRate is specified
NotConnectedExceptionIf the device is not connected
DriverExceptionAn error occurred that is not described by one of the more specific ASCOM exceptions. Include sufficient detail in the message text to enable the issue to be accurately diagnosed by someone other than yourself.
Remarks

DeclinationRate Read must be implemented and must not throw a PropertyNotImplementedException.

DeclinationRate Write can throw a PropertyNotImplementedException.

This property, together with RightAscensionRate, provides support for "offset tracking". Offset tracking is used primarily for tracking objects that move relatively slowly against the equatorial coordinate system. It also may be used by a software guiding system that controls rates instead of using the PulseGuide method.

NOTES:

  • The property value represents an offset from zero motion.
  • If CanSetDeclinationRate is False, this property will always return 0.
  • To discover whether this feature is supported, test the CanSetDeclinationRate property.
  • The supported range of this property is telescope specific, however, if this feature is supported, it can be expected that the range is sufficient to allow correction of guiding errors caused by moderate misalignment and periodic error.
  • If this property is non-zero when an equatorial slew is initiated, the telescope should continue to update the slew destination coordinates at the given offset rate.
  • This will allow precise slews to a fast-moving target with a slow-slewing telescope.
  • When the slew completes, the TargetRightAscension and TargetDeclination properties should reflect the final (adjusted) destination.
  • The units of this property are arcseconds per SI (atomic) second. Please note that for historic reasons the units of the RightAscensionRate property are seconds of RA per sidereal second.

ITelescopeV4 clarification - DeclinationRate is an offset from sidereal tracking rate and must only be applied when tracking at sidereal rate. It must not be applied when tracking at solar, lunar, King or other non-sidereal rates.

Revision History
DateVersionDescription
ITelescopePlatform 3.0Member added.
ITelescopeV4Platform 7.0This only applies when tracking at sidereal rate, see note above.
See Also