Guider

Role

The Guider module provides automatic telescope guiding. It detects and tracks a reference star field, measures drift in real time, and sends correction pulses to the mount to maintain pointing.

Guider module screenshot Guider module screenshot

Required devices

DeviceRole
Guide cameraImage acquisition for the guide field
ST4 interfaceReception of correction pulses — can be the mount or a camera equipped with an ST4 port

Operating phases

Guiding proceeds through three sequential phases.

Phase 1 — Initialization

The module acquires a reference image and identifies the stars in the field. These stars serve as the reference for the entire guiding session.

Phase 2 — Calibration

The module measures the mount’s response to correction pulses:

  1. Pulses are sent in four directions (N, S, E, W)
  2. The pixel displacement caused by each pulse series is measured
  3. A pixels/ms conversion factor is computed for each axis
  4. RA and DEC correction directions are detected automatically

Before the North and before the South pulse series, an extra DEC backlash kick pulse is sent first to take up the DEC axis’ mechanical backlash — otherwise the first measurement pulses of each series would be partially wasted re-engaging the gears, making the computed ms/px rate unreliable. Its own resulting movement is discarded, not included in the rate calculation.

The calibration result is saved and reused automatically across sessions, provided the pier side and camera orientation have not changed.

Phase 3 — Guiding

Continuous correction loop:

  1. Acquire an image
  2. Match stars using triangle matching (see dedicated section)
  3. Compute drift relative to the reference position
  4. Apply aggressivity coefficients
  5. If DEC backlash compensation is enabled and the DEC pulse direction has reversed since the last correction, add the current compensation estimate on top of the calculated pulse
  6. Send correction pulses to the mount
  7. Update statistics (RMS RA, DEC, total)
  8. If a compensated reversal pulse was sent on the previous cycle, compare the drift reduction it actually achieved against what the calculation alone predicted, and nudge the compensation estimate up (undershoot) or down (overshoot), within the configured bounds
DEC backlash compensation

Mount gears have some mechanical play: whenever DEC guiding reverses direction, the first pulses partly take up that play instead of producing real movement, causing a temporary drift spike. Since the true backlash amount varies with pointing position and mechanical load, a fixed compensation value tends to under- or over-correct depending on where the mount is pointing. The adaptive estimate self-tunes instead: each reversal is both a correction and a measurement, so it converges toward whatever backlash currently exists rather than a value fixed once and left to drift out of tune.

Triangle matching algorithm

Star matching between two images relies on the geometry of triangles formed by the stars, which is invariant under translation, rotation, and scaling.

For each triangle:

ratio = surface / perimeter

This ratio acts as a unique fingerprint to identify the same triangles between the reference image and the current image. The drift is then computed as the mean translation across all matched star pairs.

DEC compensation

RA correction pulses are multiplied by cos(mount_DEC) to compensate for meridian convergence at high declinations.

Parameters

Devices

These parameters are accessible from the module Parameters menu. A set of parameters can be saved as a profile.

ParameterDescription
ExposureExposure duration in seconds
GainCamera gain
OffsetCamera offset

Calibration

ParameterDescription
Pulse durationDuration in ms of each pulse sent during calibration
Calibration stepsNumber of pulses per axis and direction
DEC backlash kickExtra pulse (ms) sent before the North and before the South pulse series, to take up mechanical backlash first — 0 disables it

Guiding

ParameterDescription
Max pulseMaximum correction pulse duration (ms)
Min pulseMinimum correction pulse duration (ms)
RA aggressivityFraction of the computed RA correction that is applied (0–100 %)
DEC aggressivityFraction of the computed DEC correction that is applied (0–100 %)
RMS thresholdMultiplier of the current RMS beyond which a correction is discarded
Pier-side RA reverseEnables automatic RA correction reversal when crossing the meridian
Dither (pixels)Dithering amplitude in pixels

DEC backlash compensation

ParameterDescription
EnableAdds an adaptive extra pulse whenever the DEC guide direction reverses, to take up mechanical backlash before the real correction takes effect
Current compensation (ms)Adaptive estimate, adjusted automatically after each DEC direction reversal — set an initial guess if you know it, otherwise leave at 0 and let it learn
Minimum compensation (ms)Lower bound for the adaptive estimate
Maximum compensation (ms)Upper bound for the adaptive estimate
Adjustment step (ms)How much the estimate is nudged up or down after each reversal, based on measured over/undershoot

Manual reversals

ParameterDescription
Reverse RAManually reverses the RA correction direction
Reverse DECManually reverses the DEC correction direction

Disable corrections

ParameterDescription
Disable RA+Disables correction pulses in the positive RA direction
Disable RA−Disables correction pulses in the negative RA direction
Disable DEC+Disables correction pulses in the positive DEC direction
Disable DEC−Disables correction pulses in the negative DEC direction

Live values

ValueDescription
Pulse NDuration of the last North pulse (ms)
Pulse SDuration of the last South pulse (ms)
Pulse EDuration of the last East pulse (ms)
Pulse WDuration of the last West pulse (ms)
RMS RARoot mean square of the RA drift (pixels)
RMS DECRoot mean square of the DEC drift (pixels)
RMS totalCombined RA + DEC RMS (pixels)

Graphs

Drift (scatter)

XY scatter plot showing the drift of each correction relative to the reference position.

Guiding (time series)

PHD2-style graph displaying for each correction:

CurveDescription
RA driftMeasured drift in RA (pixels)
DEC driftMeasured drift in DEC (pixels)
RA pulseRA correction pulse duration (ms)
DEC pulseDEC correction pulse duration (ms)
SNRSignal-to-noise ratio of the star detection
RMSCurrent total RMS (pixels)

Actions

ActionDescription
Calibrate and guideRuns all three phases: initialization → calibration → guiding
CalibrateRuns initialization then calibration only
GuideStarts guiding (uses existing calibration, or calibrates if none)
AbortImmediately stops the current sequence
Reset calibrationClears the saved calibration data
DitherRandomly offsets the guiding position by Dither (pixels)