Click or drag to resize

Telescope Class

Implements a telescope class to access any registered ASCOM telescope
Inheritance Hierarchy
SystemObject
  ASCOM.DriverAccessAscomDriver
    ASCOM.DriverAccessTelescope

Namespace: ASCOM.DriverAccess
Assembly: ASCOM.DriverAccess (in ASCOM.DriverAccess.dll) Version: 6.0.0.0 (6.6.9999.9999)
Syntax
Copy
public class Telescope : AscomDriver, ITelescopeV3

The Telescope type exposes the following members.

Constructors
 NameDescription
Public methodTelescope Creates an instance of the telescope class.
Top
Properties
 NameDescription
Public propertyAlignmentMode The alignment mode of the mount.
Public propertyAltitude The Altitude above the local horizon of the telescope's current position (degrees, positive up)
Public propertyApertureArea The area of the telescope's aperture, taking into account any obstructions (square meters)
Public propertyApertureDiameter The telescope's effective aperture diameter (meters)
Public propertyAtHome True if the telescope is stopped in the Home position. Set only following a FindHome() operation, and reset with any slew operation. This property must be False if the telescope does not support homing.
Public propertyAtPark True if the telescope has been put into the parked state by the see Park method. Set False by calling the Unpark() method.
Public propertyAzimuth The azimuth at the local horizon of the telescope's current position (degrees, North-referenced, positive East/clockwise).
Public propertyCanCallBack True if the device supports asynchronous operations event notifications.
Public propertyCanFindHome True if this telescope is capable of programmed finding its home position (FindHome method).
Public propertyCanPark True if this telescope is capable of programmed parking (Parkmethod)
Public propertyCanPulseGuide True if this telescope is capable of software-pulsed guiding (via the PulseGuide(GuideDirections, Int32) method)
Public propertyCanSetDeclinationRate True if the DeclinationRate property can be changed to provide offset tracking in the declination axis.
Public propertyCanSetGuideRates True if the guide rate properties used for PulseGuide(GuideDirections, Int32) can be adjusted.
Public propertyCanSetPark True if this telescope is capable of programmed setting of its park position (SetPark method)
Public propertyCanSetPierSide True if the SideOfPier property can be set, meaning that the mount can be forced to flip.
Public propertyCanSetRightAscensionRate True if the RightAscensionRate property can be changed to provide offset tracking in the right ascension axis.
Public propertyCanSetTracking True if the Tracking property can be changed, turning telescope sidereal tracking on and off.
Public propertyCanSlew True if this telescope is capable of programmed slewing (synchronous or asynchronous) to equatorial coordinates
Public propertyCanSlewAltAz True if this telescope is capable of programmed slewing (synchronous or asynchronous) to local horizontal coordinates
Public propertyCanSlewAltAzAsync True if this telescope is capable of programmed asynchronous slewing to local horizontal coordinates
Public propertyCanSlewAsync True if this telescope is capable of programmed asynchronous slewing to equatorial coordinates.
Public propertyCanSync True if this telescope is capable of programmed syncing to equatorial coordinates.
Public propertyCanSyncAltAz True if this telescope is capable of programmed syncing to local horizontal coordinates
Public propertyCanUnpark True if this telescope is capable of programmed unparking (Unpark method).
Public propertyConnected Set True to connect to the device hardware. Set False to disconnect from the device hardware. You can also read the property to check whether it is connected. This reports the current hardware state.
(Inherited from AscomDriver)
Public propertyDeclination The declination (degrees) of the telescope's current equatorial coordinates, in the coordinate system given by the EquatorialSystem property. Reading the property will raise an error if the value is unavailable.
Public propertyDeclinationRate The declination tracking rate (arcseconds per SI second, default = 0.0)
Public propertyDescription Returns a description of the device, such as manufacturer and model number. Any ASCII characters may be used.
(Inherited from AscomDriver)
Public propertyDoesRefraction True if the telescope or driver applies atmospheric refraction to coordinates.
Public propertyDriverInfo Descriptive and version information about this ASCOM driver.
(Inherited from AscomDriver)
Public propertyDriverVersion A string containing only the major and minor version of the driver.
(Inherited from AscomDriver)
Public propertyEquatorialSystem Equatorial coordinate system used by this telescope.
Public propertyFocalLength The telescope's focal length, meters
Public propertyGuideRateDeclination The current Declination movement rate offset for telescope guiding (degrees/sec)
Public propertyGuideRateRightAscension The current Right Ascension movement rate offset for telescope guiding (degrees/sec)
Public propertyInterfaceVersion The interface version number that this device supports.
(Inherited from AscomDriver)
Public propertyIsPulseGuiding True if a PulseGuide(GuideDirections, Int32) command is in progress, False otherwise
Public propertyName The short name of the driver, for display purposes
(Inherited from AscomDriver)
Public propertyRightAscension The right ascension (hours) of the telescope's current equatorial coordinates, in the coordinate system given by the EquatorialSystem property
Public propertyRightAscensionRate The right ascension tracking rate offset from sidereal (seconds per sidereal second, default = 0.0)
Public propertySideOfPier Indicates the pointing state of the mount.
Public propertySiderealTime The local apparent sidereal time from the telescope's internal clock (hours, sidereal)
Public propertySiteElevation The elevation above mean sea level (meters) of the site at which the telescope is located
Public propertySiteLatitude The geodetic(map) latitude (degrees, positive North, WGS84) of the site at which the telescope is located.
Public propertySiteLongitude The longitude (degrees, positive East, WGS84) of the site at which the telescope is located.
Public propertySlewing True if telescope is currently moving in response to one of the Slew methods or the MoveAxis(TelescopeAxes, Double) method, False at all other times.
Public propertySlewSettleTime Specifies a post-slew settling time (sec.).
Public propertySupportedActionsReturns the list of custom action names supported by this driver.
(Inherited from AscomDriver)
Public propertyTargetDeclination The declination (degrees, positive North) for the target of an equatorial slew or sync operation
Public propertyTargetRightAscension The right ascension (hours) for the target of an equatorial slew or sync operation
Public propertyTracking The state of the telescope's sidereal tracking drive.
Public propertyTrackingRate The current tracking rate of the telescope's sidereal drive
Public propertyTrackingRates Returns a collection of supported DriveRates values that describe the permissible values of the TrackingRate property for this telescope type.
Public propertyUTCDate The UTC date/time of the telescope's internal clock
Top
Methods
 NameDescription
Public methodAbortSlew Stops a slew in progress.
Public methodActionInvokes the specified device-specific custom action.
(Inherited from AscomDriver)
Public methodAxisRates A collection of rates at which the telescope may be moved about the specified axis by the MoveAxis(TelescopeAxes, Double) method.
Public methodCanMoveAxis Shows whether the telescope can be controlled about the specified axis via the MoveAxis() method.
Public methodStatic memberChoose The Choose() method returns the DriverID of the selected driver. Choose() allows you to optionally pass the DriverID of a "current" driver (you probably save this in the registry), and the corresponding telescope type is pre-selected in the Chooser's list. In this case, the OK button starts out enabled (lit-up); the assumption is that the pre-selected driver has already been configured.
Public methodCommandBlind Transmits an arbitrary string to the device and does not wait for a response. Optionally, protocol framing characters may be added to the string before transmission.
(Inherited from AscomDriver)
Public methodCommandBool Transmits an arbitrary string to the device and waits for a boolean response. Optionally, protocol framing characters may be added to the string before transmission.
(Inherited from AscomDriver)
Public methodCommandString Transmits an arbitrary string to the device and waits for a string response. Optionally, protocol framing characters may be added to the string before transmission.
(Inherited from AscomDriver)
Public methodDestinationSideOfPier Predict side of pier for German equatorial mounts
Public methodDispose This method is a "clean-up" method that is primarily of use to drivers that are written in languages such as C# and VB.NET where resource clean-up is initially managed by the language's runtime garbage collection mechanic. Driver authors should take care to ensure that a client or runtime calling Dispose() does not adversely affect other connected clients. Applications should not call this method.
(Inherited from AscomDriver)
Public methodFindHome Locates the telescope's "home" position (synchronous)
Public methodMoveAxis Move the telescope in one axis at the given rate.
Public methodPark Move the telescope to its park position, stop all motion (or restrict to a small safe range), and set AtPark to True.
Public methodPulseGuide Moves the scope in the given direction for the given interval or time at the rate given by the corresponding guide rate property
Public methodSetPark Sets the telescope Park position to the current telescope position.
Public methodSetupDialog Launches a configuration dialogue box for the driver. The call will not return until the user clicks OK or cancel manually.
(Inherited from AscomDriver)
Public methodSlewToAltAz Move the telescope to the given local horizontal coordinates, return when slew is complete
Public methodSlewToAltAzAsync This Method must be implemented if CanSlewAltAzAsync returns True.
Public methodSlewToCoordinates Move the telescope to the given equatorial coordinates, return when slew is complete
Public methodSlewToCoordinatesAsync Move the telescope to the given equatorial coordinates, return immediately after starting the slew.
Public methodSlewToTarget Move the telescope to the TargetRightAscension and TargetDeclination coordinates, return when slew complete.
Public methodSlewToTargetAsync Move the telescope to the TargetRightAscension and TargetDeclination coordinates, returns immediately after starting the slew.
Public methodSyncToAltAz Matches the scope's local horizontal coordinates to the given local horizontal coordinates.
Public methodSyncToCoordinates Matches the scope's equatorial coordinates to the given equatorial coordinates.
Public methodSyncToTarget Matches the scope's equatorial coordinates to the given equatorial coordinates.
Public methodUnpark Takes telescope out of the Parked state.
Top
See Also