Ekos

Classes
class	Align

class	Analyze

class	ASTAPAstrometryParser

class	AstrometryParser

class	CameraProcess

class	Capture

class	DarkLibrary

class	DarkProcessor

class	Focus

class	FocusAlgorithmInterface

class	Guide

class	GuideInterface

class	LinGuider

class	ManualPulse

class	MosaicTilesModel

class	Mount

class	OpsCalibration

class	OpsDither

class	OpsGPG

class	OpsGuide

class	OpsLogs

class	OpticalTrainSettings

class	PHD2

class	PolarAlignmentAssistant

class	ProfileSettings

class	RemoteAstrometryParser

class	Scheduler

class	SchedulerProcess

Typedefs
typedef QMap< QString, uint16_t >	CapturedFramesMap

using	PAA = PolarAlignmentAssistant

Enumerations
enum	AlignState { ALIGN_IDLE , ALIGN_COMPLETE , ALIGN_FAILED , ALIGN_ABORTED , ALIGN_PROGRESS , ALIGN_SUCCESSFUL , ALIGN_SYNCING , ALIGN_SLEWING , ALIGN_ROTATING , ALIGN_SUSPENDED }

enum	AutofocusFailReason { FOCUS_FAIL_NONE , FOCUS_FAIL_NO_STARS , FOCUS_FAIL_MAX_ITERS , FOCUS_FAIL_FOCUSER_NO_MOVE , FOCUS_FAIL_R2 , FOCUS_FAIL_SMALL_HFR , FOCUS_FAIL_FOCUSER_OOB , FOCUS_FAIL_FLUCTUATIONS , FOCUS_FAIL_DEADLOCK , FOCUS_FAIL_TOLERANCE , FOCUS_FAIL_FOCUSER_ERROR , FOCUS_FAIL_FORCE_ABORT , FOCUS_FAIL_FILTER_MANAGER , FOCUS_FAIL_CAPTURE_TIMEOUT , FOCUS_FAIL_CAPTURE_FAILED , FOCUS_FAIL_NO_CAMERA , FOCUS_FAIL_NO_FOCUSER , FOCUS_FAIL_LOW_PULSE , FOCUS_FAIL_INTERNAL , FOCUS_FAIL_ABORT , FOCUS_FAIL_CURVEFIT , FOCUS_FAIL_ADVISOR_COMPLETE , FOCUS_FAIL_ADVISOR_RERUN , FOCUS_FAIL_OPTIMISED_OUT , FOCUS_FAIL_MAX_REASONS }

enum	AutofocusReason { FOCUS_NONE , FOCUS_MANUAL , FOCUS_FILTER , FOCUS_TIME , FOCUS_TEMPERATURE , FOCUS_HFR_CHECK , FOCUS_MERIDIAN_FLIP , FOCUS_FILTER_OFFSETS , FOCUS_ABERRATION_INSPECTOR , FOCUS_SCHEDULER , FOCUS_USER_REQUEST , FOCUS_FOCUS_ADVISOR , FOCUS_MAX_REASONS }

enum	CalibrationPreActions { CAPTURE_PREACTION_NONE = 1 << 0 , CAPTURE_PREACTION_WALL = 1 << 1 , CAPTURE_PREACTION_PARK_MOUNT = 1 << 2 , CAPTURE_PREACTION_PARK_DOME = 1 << 3 }

enum	CapState { CAP_IDLE , CAP_PARKING , CAP_UNPARKING , CAP_PARKED , CAP_ERROR , CAP_UNKNOWN }

enum	CaptureAfterPulses { StartCaptureAfterPulses , DontCaptureAfterPulses }

enum	CaptureContinueAction { CAPTURE_CONTINUE_ACTION_NONE , CAPTURE_CONTINUE_ACTION_NEXT_EXPOSURE , CAPTURE_CONTINUE_ACTION_CAPTURE_COMPLETE }

enum	CaptureResult { CAPTURE_OK , CAPTURE_FRAME_ERROR , CAPTURE_BIN_ERROR , CAPTURE_FOCUS_ERROR }

enum	CaptureState { CAPTURE_IDLE , CAPTURE_PROGRESS , CAPTURE_CAPTURING , CAPTURE_PAUSE_PLANNED , CAPTURE_PAUSED , CAPTURE_SUSPENDED , CAPTURE_ABORTED , CAPTURE_WAITING , CAPTURE_IMAGE_RECEIVED , CAPTURE_DITHERING , CAPTURE_FOCUSING , CAPTURE_FILTER_FOCUS , CAPTURE_CHANGING_FILTER , CAPTURE_GUIDER_DRIFT , CAPTURE_SETTING_TEMPERATURE , CAPTURE_SETTING_ROTATOR , CAPTURE_ALIGNING , CAPTURE_CALIBRATING , CAPTURE_MERIDIAN_FLIP , CAPTURE_COMPLETE }

enum	CaptureWorkflowActionType { CAPTURE_ACTION_NONE , CAPTURE_ACTION_START , CAPTURE_ACTION_PAUSE , CAPTURE_ACTION_SUSPEND , CAPTURE_ACTION_FILTER , CAPTURE_ACTION_TEMPERATURE , CAPTURE_ACTION_ROTATOR , CAPTURE_ACTION_PREPARE_LIGHTSOURCE , CAPTURE_ACTION_MOUNT_PARK , CAPTURE_ACTION_DOME_PARK , CAPTURE_ACTION_FLAT_SYNC_FOCUS , CAPTURE_ACTION_SCOPE_COVER , CAPTURE_ACTION_AUTOFOCUS , CAPTURE_ACTION_DITHER_REQUEST , CAPTURE_ACTION_DITHER , CAPTURE_ACTION_CHECK_GUIDING }

enum	CommunicationStatus { Idle , Pending , Success , Error }

enum	CompletionCondition { FINISH_SEQUENCE , FINISH_REPEAT , FINISH_LOOP , FINISH_AT }

enum	EkosState { EKOS_IDLE , EKOS_STARTING , EKOS_STOPPING , EKOS_READY }

enum	ErrorHandlingStrategy { ERROR_DONT_RESTART , ERROR_RESTART_AFTER_TERMINATION , ERROR_RESTART_IMMEDIATELY }

enum	ExtensionState { EXTENSION_START_REQUESTED , EXTENSION_STARTED , EXTENSION_STOP_REQUESTED , EXTENSION_STOPPED }

enum	FilenamePreviewType { FILENAME_NOT_PREVIEW , FILENAME_LOCAL_PREVIEW , FILENAME_REMOTE_PREVIEW }

enum	FilterState { FILTER_IDLE , FILTER_CHANGE , FILTER_OFFSET , FILTER_AUTOFOCUS }

enum	FocusState { FOCUS_IDLE , FOCUS_COMPLETE , FOCUS_FAILED , FOCUS_ABORTED , FOCUS_WAITING , FOCUS_PROGRESS , FOCUS_FRAMING , FOCUS_CHANGING_FILTER }

enum	GuideState { GUIDE_IDLE , GUIDE_ABORTED , GUIDE_CONNECTED , GUIDE_DISCONNECTED , GUIDE_CAPTURE , GUIDE_LOOPING , GUIDE_DARK , GUIDE_SUBFRAME , GUIDE_STAR_SELECT , GUIDE_CALIBRATING , GUIDE_CALIBRATION_ERROR , GUIDE_CALIBRATION_SUCCESS , GUIDE_GUIDING , GUIDE_SUSPENDED , GUIDE_REACQUIRE , GUIDE_DITHERING , GUIDE_MANUAL_DITHERING , GUIDE_DITHERING_ERROR , GUIDE_DITHERING_SUCCESS , GUIDE_DITHERING_SETTLE }

enum	HFRCheckAlgorithm { HFR_CHECK_LAST_AUTOFOCUS , HFR_CHECK_FIXED , HFR_CHECK_MEDIAN_MEASURE , HFR_CHECK_MAX_ALGO }

enum	INDIState { INDI_IDLE , INDI_CONNECTING , INDI_DISCONNECTING , INDI_PROPERTY_CHECK , INDI_READY }

enum	JOBStatus { JOB_IDLE , JOB_BUSY , JOB_ERROR , JOB_ABORTED , JOB_DONE }

enum	LightState { CAP_LIGHT_OFF , CAP_LIGHT_ON , CAP_LIGHT_UNKNOWN , CAP_LIGHT_BUSY }

enum	ParkWaitState { PARKWAIT_IDLE , PARKWAIT_PARK , PARKWAIT_PARKING , PARKWAIT_PARKED , PARKWAIT_UNPARK , PARKWAIT_UNPARKING , PARKWAIT_UNPARKED , PARKWAIT_ERROR }

enum	ProfileGroup { AlignProfiles , FocusProfiles , GuideProfiles , HFRProfiles }

enum	SchedulerAlgorithm { ALGORITHM_GREEDY = 1 }

enum	SchedulerJobStage { SCHEDSTAGE_IDLE , SCHEDSTAGE_SLEWING , SCHEDSTAGE_SLEW_COMPLETE , SCHEDSTAGE_FOCUSING , SCHEDSTAGE_FOCUS_COMPLETE , SCHEDSTAGE_ALIGNING , SCHEDSTAGE_ALIGN_COMPLETE , SCHEDSTAGE_RESLEWING , SCHEDSTAGE_RESLEWING_COMPLETE , SCHEDSTAGE_POSTALIGN_FOCUSING , SCHEDSTAGE_POSTALIGN_FOCUSING_COMPLETE , SCHEDSTAGE_GUIDING , SCHEDSTAGE_GUIDING_COMPLETE , SCHEDSTAGE_CAPTURING , SCHEDSTAGE_COMPLETE }

enum	SchedulerJobStatus { SCHEDJOB_IDLE , SCHEDJOB_EVALUATION , SCHEDJOB_SCHEDULED , SCHEDJOB_BUSY , SCHEDJOB_ERROR , SCHEDJOB_ABORTED , SCHEDJOB_INVALID , SCHEDJOB_COMPLETE }

enum	SchedulerState { SCHEDULER_IDLE , SCHEDULER_STARTUP , SCHEDULER_RUNNING , SCHEDULER_PAUSED , SCHEDULER_SHUTDOWN , SCHEDULER_ABORTED , SCHEDULER_LOADING }

enum	SchedulerTimerState { RUN_WAKEUP = 0 , RUN_SCHEDULER , RUN_JOBCHECK , RUN_SHUTDOWN , RUN_NOTHING }

enum	ScriptTypes { SCRIPT_PRE_JOB , SCRIPT_PRE_CAPTURE , SCRIPT_POST_CAPTURE , SCRIPT_POST_JOB , SCRIPT_N }

enum	ShutdownState { SHUTDOWN_IDLE , SHUTDOWN_PARK_CAP , SHUTDOWN_PARKING_CAP , SHUTDOWN_PARK_MOUNT , SHUTDOWN_PARKING_MOUNT , SHUTDOWN_PARK_DOME , SHUTDOWN_PARKING_DOME , SHUTDOWN_SCRIPT , SHUTDOWN_SCRIPT_RUNNING , SHUTDOWN_ERROR , SHUTDOWN_COMPLETE }

enum	ShutterStatus { SHUTTER_YES , SHUTTER_NO , SHUTTER_BUSY , SHUTTER_UNKNOWN }

enum	StartupCondition { START_ASAP = 0 , START_AT = 2 }

enum	StartupState { STARTUP_IDLE , STARTUP_SCRIPT , STARTUP_UNPARK_DOME , STARTUP_UNPARKING_DOME , STARTUP_UNPARK_MOUNT , STARTUP_UNPARKING_MOUNT , STARTUP_UNPARK_CAP , STARTUP_UNPARKING_CAP , STARTUP_ERROR , STARTUP_COMPLETE }

enum	tileID { TILE_TL = 0 , TILE_TM , TILE_TR , TILE_CL , TILE_CM , TILE_CR , TILE_BL , TILE_BM , TILE_BR , NUM_TILES }

Functions
QString	completionConditionString (CompletionCondition condition)

QString	ekosStateString (EkosState state)

const QString	getAlignStatusString (AlignState state, bool translated)

const QString	getCaptureStatusString (CaptureState state, bool translated)

QList< SSolver::Parameters >	getDefaultAlignOptionsProfiles ()

QList< Parameters >	getDefaultFocusOptionsProfiles ()

QList< SSolver::Parameters >	getDefaultGuideOptionsProfiles ()

QList< Parameters >	getDefaultHFROptionsProfiles ()

const QString	getExtensionStatusString (ExtensionState state, bool translated)

const QString	getFilterStatusString (FilterState state, bool translated)

SSolver::Parameters	getFocusOptionsProfileDefault ()

SSolver::Parameters	getFocusOptionsProfileDefaultDonut ()

const QString	getFocusStatusString (FocusState state, bool translated)

const QString	getGuideStatusString (GuideState state, bool translated)

const QString	getSchedulerStatusString (SchedulerState state, bool translated)

std::vector< double >	gsl_polynomial_fit (const double const data_x, const double const data_y, const int n, const int order, double &chisq)

QString	indiStateString (INDIState state)

bool	isEqual (double a, double b)

FocusAlgorithmInterface *	MakeLinearFocuser (const FocusAlgorithmInterface::FocusParams &params)

QString	parkWaitStateString (ParkWaitState state)

QString	shutdownStateString (ShutdownState state)

QString	stageString (Ekos::CalibrationProcess::CalibrationStage stage)

QString	startupConditionString (StartupCondition condition)

QString	startupStateString (StartupState state)

QString	timerStr (SchedulerTimerState state)

Variables
constexpr bool	ABINS_DEBUG { false }

static const QList< KLocalizedString >	alignStates

static const QString	AutofocusFailReasonStr [FOCUS_FAIL_MAX_REASONS]

static const QString	AutofocusReasonStr [FOCUS_MAX_REASONS]

static const QList< KLocalizedString >	captureStates

static const QList< KLocalizedString >	extensionStates = { ki18n("Starting"), ki18n("Started"), ki18n("Stopping"), ki18n("Stopped")}

static const QList< KLocalizedString >	filterStates

const int	FIND_STARS_MIN_STARS = 2

const QString	FOCUS_DEFAULT_DONUT_NAME = "1-Focus-Default-Donut"

const QString	FOCUS_DEFAULT_NAME = "1-Focus-Default"

const char *	FOCUSER_SIMULATOR = "Focuser Simulator"

static const QList< KLocalizedString >	focusStates

static const QList< KLocalizedString >	guideStates

constexpr double	HFR_CHECK_DEFAULT_THRESHOLD = 10.0

const double	INITIAL_MAXMIN_HFR_RATIO = 2.0

static double constexpr	INVALID_STAR_MEASURE = -1.0

const int	INVALID_VALUE = -1e6

const int	MAXIMUM_FOCUS_ADVISOR_ITERATIONS = 1001

const int	NUM_JUMPS_PER_SECTOR = 10

const int	NUM_STEPS_PRE_AF = 11

static const QList< KLazyLocalizedString >	ProfileGroupNames

static const QList< KLocalizedString >	schedulerStates

const double	TARGET_MAXMIN_HFR_RATIO = 3.0

static const QString	TILE_COLOUR [NUM_TILES] = {"red", "cyan", "green", "magenta", "blue", "grey", "darkGreen", "darkCyan", "darkRed"}

static const QString	TILE_LONGNAME [NUM_TILES] = {"Top Left", "Top", "Top Right", "Left", "Centre", "Right", "Bottom Left", "Bottom", "Bottom Right"}

static const QString	TILE_NAME [NUM_TILES] = {"TL", "T", "TR", "L", "C", "R", "BL", "B", "BR"}

Detailed Description

Ekos is an advanced Astrophotography tool for Linux.

A meridian flip is executed by issueing a scope motion to the target.

It is based on a modular extensible framework to perform common astrophotography tasks. This includes highly accurate GOTOs using astrometry solver, ability to measure and correct polar alignment errors , auto-focus & auto-guide capabilities, and capture of single or stack of images with filter wheel support.
Features:

Control your telescope, CCD (& DSLRs), filter wheel, focuser, guider, adaptive optics unit, and any INDI-compatible auxiliary device from Ekos.
Extremely accurate GOTOs using astrometry.net solver (both Online and Offline solvers supported).
Load & Slew: Load a FITS image, slew to solved coordinates, and center the mount on the exact image coordinates in order to get the same desired frame.
Measure & Correct Polar Alignment errors using astrometry.net solver.
Auto and manual focus modes using Half-Flux-Radius (HFR) method.
Automated unattended meridian flip. Ekos performs post meridian flip alignment, calibration, and guiding to resume the capture session.
Automatic focus between exposures when a user-configurable HFR limit is exceeded.
Automatic focus between exposures when the temperature has changed a lot since last focus.
Auto guiding with support for automatic dithering between exposures and support for Adaptive Optics devices in addition to traditional guiders.
Powerful sequence queue for batch capture of images with optional prefixes, timestamps, filter wheel selection, and much more!
Export and import sequence queue sets as Ekos Sequence Queue (.esq) files.
Center the telescope anywhere in a captured FITS image or any FITS with World Coordinate System (WCS) header.
Automatic flat field capture, just set the desired ADU and let Ekos does the rest!
Automatic abort and resumption of exposure tasks if guiding errors exceed a user-configurable value.
Support for dome slaving.
Complete integration with KStars Observation Planner and SkyMap
Integrate with all INDI native devices.
Powerful scripting capabilities via DBus.

The primary class is Ekos::Manager. It handles startup and shutdown of local and remote INDI devices, manages and orchesterates the various Ekos modules, and provides advanced DBus interface to enable unattended scripting.

Author: Jasem Mutlaq

Version: 1.9

Essentially, the meridian flip relies upon that the mount hardware selects the pier side of the scope on the appropriate side depending whether the scope points east or west of the meridian.

While tracking a certain object a pier side change is necessary as soon as the position crosses the meridian. As soon as this is detected, the meridian flip works as follows:

A meridian flip request is sent to Capture so that a currently running capture can be completed before the flip starts.
Capture completes the currently running capture, stops capturing and sends a confirmation so that the flip may start.
Now a slew command is issued to the current target (i.e. the last position where a slew has been executed). This will force the mount hardware to reconsider the pier side and slews to the same position but changing the pier side.
As soon as the slew has been completed alignment is executed, guiding restarted and Capture informed that capturing may continue.

Typedef Documentation

◆ CapturedFramesMap

typedef QMap<QString, uint16_t> Ekos::CapturedFramesMap

mapping signature --> frames count

Definition at line 16 of file capturetypes.h.

◆ PAA

using Ekos::PAA = PolarAlignmentAssistant

Definition at line 85 of file align.cpp.

Enumeration Type Documentation

◆ AlignState

enum Ekos::AlignState

Enumerator
ALIGN_IDLE	No ongoing operations.
ALIGN_COMPLETE	Alignment successfully completed. No operations pending.
ALIGN_FAILED	Alignment failed. No operations pending.
ALIGN_ABORTED	Alignment aborted by user or agent.
ALIGN_PROGRESS	Alignment operation in progress. This include capture and sovling.
ALIGN_SUCCESSFUL	Alignment Astrometry solver successfully solved the image.
ALIGN_SYNCING	Syncing mount to solution coordinates.
ALIGN_SLEWING	Slewing mount to target coordinates.
ALIGN_ROTATING	Rotating (Automatic or Manual) to target position angle.
ALIGN_SUSPENDED	Alignment operations suspended.

Definition at line 144 of file ekos.h.

◆ AutofocusFailReason

enum Ekos::AutofocusFailReason

Definition at line 51 of file focusutils.h.

◆ AutofocusReason

enum Ekos::AutofocusReason

Definition at line 18 of file focusutils.h.

◆ CalibrationPreActions

enum Ekos::CalibrationPreActions

Definition at line 55 of file capturetypes.h.

◆ CapState

enum Ekos::CapState

Definition at line 70 of file capturetypes.h.

◆ CaptureAfterPulses

enum Ekos::CaptureAfterPulses

Definition at line 112 of file guideinterface.h.

◆ CaptureContinueAction

enum Ekos::CaptureContinueAction

Definition at line 88 of file capturetypes.h.

◆ CaptureResult

enum Ekos::CaptureResult

Definition at line 96 of file capturetypes.h.

◆ CaptureState

enum Ekos::CaptureState

Capture states.

They can be divided into several stages:

No capturing is running (
See also
CAPTURE_IDLE,

CAPTURE_COMPLETE or

CAPTURE_ABORTED)
A capture sequence job is in preparation (
See also
CAPTURE_PROGRESS as state and

CAPTURE_SETTING_TEMPERATURE,

CAPTURE_SETTING_ROTATOR and

CAPTURE_CHANGING_FILTER as state events signaled to

Capture::updatePrepareState(Ekos::CaptureState))
Calibration activities to initialize the execution of a sequence job (
See also
CAPTURE_DITHERING,

CAPTURE_FOCUSING,

CAPTURE_ALIGNING and

CAPTURE_CALIBRATING)
Waiting for start of capturing (
See also
CAPTURE_PAUSE_PLANNED,

CAPTURE_PAUSED,

CAPTURE_SUSPENDED and

CAPTURE_WAITING)
Capturing (
See also
CAPTURE_CAPTURING and

CAPTURE_IMAGE_RECEIVED)

Enumerator
CAPTURE_IDLE	no capture job active
CAPTURE_PROGRESS	capture job sequence in preparation (temperature, filter, rotator)
CAPTURE_CAPTURING	CCD capture running
CAPTURE_PAUSE_PLANNED	user has requested to pause the capture sequence
CAPTURE_PAUSED	paused capture sequence due to a user request
CAPTURE_SUSPENDED	capture stopped since some limits are not met, but may be continued if all limits are met again
CAPTURE_ABORTED	capture stopped by the user or aborted due to guiding problems etc.
CAPTURE_WAITING	waiting for settling of the mount before start of capturing
CAPTURE_IMAGE_RECEIVED	image received from the CDD device
CAPTURE_DITHERING	dithering before starting to capture
CAPTURE_FOCUSING	focusing before starting to capture
CAPTURE_FILTER_FOCUS	not used
CAPTURE_CHANGING_FILTER	preparation event changing the filter
CAPTURE_GUIDER_DRIFT	preparation event waiting for the guider to settle
CAPTURE_SETTING_TEMPERATURE	preparation event setting the camera temperature
CAPTURE_SETTING_ROTATOR	preparation event setting the camera rotator
CAPTURE_ALIGNING	aligning before starting to capture
CAPTURE_CALIBRATING	startup of guiding running before starting to capture
CAPTURE_MERIDIAN_FLIP	only used as signal that a meridian flip is ongoing
CAPTURE_COMPLETE	capture job sequence completed successfully

Definition at line 91 of file ekos.h.

◆ CaptureWorkflowActionType

enum Ekos::CaptureWorkflowActionType

Definition at line 35 of file capturetypes.h.

◆ CommunicationStatus

enum Ekos::CommunicationStatus

Definition at line 202 of file ekos.h.

◆ CompletionCondition

enum Ekos::CompletionCondition

Conditions under which a SchedulerJob may complete.

Definition at line 79 of file schedulertypes.h.

◆ EkosState

enum Ekos::EkosState

Definition at line 52 of file schedulertypes.h.

◆ ErrorHandlingStrategy

enum Ekos::ErrorHandlingStrategy

options what should happen if an error or abort occurs

Definition at line 57 of file schedulertypes.h.

◆ ExtensionState

enum Ekos::ExtensionState

Definition at line 210 of file ekos.h.

◆ FilenamePreviewType

enum Ekos::FilenamePreviewType

Definition at line 18 of file capturetypes.h.

◆ FilterState

enum Ekos::FilterState

Definition at line 164 of file ekos.h.

◆ FocusState

enum Ekos::FocusState

Definition at line 123 of file ekos.h.

◆ GuideState

enum Ekos::GuideState

Definition at line 42 of file ekos.h.

◆ HFRCheckAlgorithm

enum Ekos::HFRCheckAlgorithm

Definition at line 26 of file capturetypes.h.

◆ INDIState

enum Ekos::INDIState

Definition at line 54 of file schedulertypes.h.

◆ JOBStatus

enum Ekos::JOBStatus

Definition at line 22 of file sequencejobstate.h.

◆ LightState

enum Ekos::LightState

Definition at line 80 of file capturetypes.h.

◆ ParkWaitState

enum Ekos::ParkWaitState

Definition at line 40 of file schedulertypes.h.

◆ ProfileGroup

enum Ekos::ProfileGroup

Definition at line 25 of file stellarsolverprofile.h.

◆ SchedulerAlgorithm

enum Ekos::SchedulerAlgorithm

Algorithms, in the same order as UI.

Definition at line 65 of file schedulertypes.h.

◆ SchedulerJobStage

enum Ekos::SchedulerJobStage

Running stages of a SchedulerJob.

Definition at line 111 of file schedulertypes.h.

◆ SchedulerJobStatus

enum Ekos::SchedulerJobStatus

States of a SchedulerJob.

Enumerator
SCHEDJOB_IDLE	Job was just created, and is not evaluated yet.
SCHEDJOB_EVALUATION	Job is being evaluated.
SCHEDJOB_SCHEDULED	Job was evaluated, and has a schedule.
SCHEDJOB_BUSY	Job is being processed.
SCHEDJOB_ERROR	Job encountered a fatal issue while processing, and must be reset manually.
SCHEDJOB_ABORTED	Job encountered a transitory issue while processing, and will be rescheduled.
SCHEDJOB_INVALID	Job has an incorrect configuration, and cannot proceed.
SCHEDJOB_COMPLETE	Job finished all required captures.

Definition at line 98 of file schedulertypes.h.

◆ SchedulerState

enum Ekos::SchedulerState

Definition at line 185 of file ekos.h.

◆ SchedulerTimerState

enum Ekos::SchedulerTimerState

IterationTypes, the different types of scheduler iterations that are run.

Definition at line 88 of file schedulertypes.h.

◆ ScriptTypes

enum Ekos::ScriptTypes

Enumerator
SCRIPT_PRE_JOB	Script to run before a sequence job is started.
SCRIPT_PRE_CAPTURE	Script to run before a sequence capture is started.
SCRIPT_POST_CAPTURE	Script to run after a sequence capture is completed.
SCRIPT_POST_JOB	Script to run after a sequence job is completed.

Definition at line 172 of file ekos.h.

◆ ShutdownState

enum Ekos::ShutdownState

Definition at line 26 of file schedulertypes.h.

◆ ShutterStatus

enum Ekos::ShutterStatus

Definition at line 62 of file capturetypes.h.

◆ StartupCondition

enum Ekos::StartupCondition

Conditions under which a SchedulerJob may start.

Definition at line 72 of file schedulertypes.h.

◆ StartupState

enum Ekos::StartupState

Definition at line 13 of file schedulertypes.h.

◆ tileID

enum Ekos::tileID

Definition at line 17 of file aberrationinspectorutils.h.

Function Documentation

◆ completionConditionString()

QString Ekos::completionConditionString ( CompletionCondition condition )

Definition at line 159 of file schedulertypes.cpp.

◆ ekosStateString()

QString Ekos::ekosStateString ( EkosState state )

Definition at line 13 of file schedulertypes.cpp.

◆ getAlignStatusString()

const QString Ekos::getAlignStatusString	(	AlignState	state,
		bool	translated )

Definition at line 30 of file ekos.cpp.

◆ getCaptureStatusString()

const QString Ekos::getCaptureStatusString	(	CaptureState	state,
		bool	translated )

Definition at line 22 of file ekos.cpp.

◆ getDefaultAlignOptionsProfiles()

QList< SSolver::Parameters > Ekos::getDefaultAlignOptionsProfiles ( )

Definition at line 185 of file stellarsolverprofile.cpp.

◆ getDefaultFocusOptionsProfiles()

QList< SSolver::Parameters > Ekos::getDefaultFocusOptionsProfiles ( )

Definition at line 16 of file stellarsolverprofile.cpp.

◆ getDefaultGuideOptionsProfiles()

QList< SSolver::Parameters > Ekos::getDefaultGuideOptionsProfiles ( )

Definition at line 117 of file stellarsolverprofile.cpp.

◆ getDefaultHFROptionsProfiles()

QList< SSolver::Parameters > Ekos::getDefaultHFROptionsProfiles ( )

Definition at line 236 of file stellarsolverprofile.cpp.

◆ getExtensionStatusString()

const QString Ekos::getExtensionStatusString	(	ExtensionState	state,
		bool	translated )

Definition at line 42 of file ekos.cpp.

◆ getFilterStatusString()

const QString Ekos::getFilterStatusString	(	FilterState	state,
		bool	translated )

Definition at line 34 of file ekos.cpp.

◆ getFocusOptionsProfileDefault()

SSolver::Parameters Ekos::getFocusOptionsProfileDefault ( )

Definition at line 78 of file stellarsolverprofile.cpp.

◆ getFocusOptionsProfileDefaultDonut()

SSolver::Parameters Ekos::getFocusOptionsProfileDefaultDonut ( )

Definition at line 98 of file stellarsolverprofile.cpp.

◆ getFocusStatusString()

const QString Ekos::getFocusStatusString	(	FocusState	state,
		bool	translated )

Definition at line 26 of file ekos.cpp.

◆ getGuideStatusString()

const QString Ekos::getGuideStatusString	(	GuideState	state,
		bool	translated )

Definition at line 18 of file ekos.cpp.

◆ getSchedulerStatusString()

const QString Ekos::getSchedulerStatusString	(	SchedulerState	state,
		bool	translated )

Definition at line 38 of file ekos.cpp.

◆ gsl_polynomial_fit()

std::vector< double > Ekos::gsl_polynomial_fit	(	const double *const	data_x,
		const double *const	data_y,
		const int	n,
		const int	order,
		double &	chisq )

Definition at line 48 of file ekos.cpp.

◆ indiStateString()

QString Ekos::indiStateString ( INDIState state )

Definition at line 29 of file schedulertypes.cpp.

◆ isEqual()

bool Ekos::isEqual	(	double	a,
		double	b )

Definition at line 87 of file align.cpp.

◆ MakeLinearFocuser()

FocusAlgorithmInterface * Ekos::MakeLinearFocuser ( const FocusAlgorithmInterface::FocusParams & params )

Definition at line 226 of file focusalgorithms.cpp.

◆ parkWaitStateString()

QString Ekos::parkWaitStateString ( ParkWaitState state )

Definition at line 105 of file schedulertypes.cpp.

◆ shutdownStateString()

QString Ekos::shutdownStateString ( ShutdownState state )

Definition at line 75 of file schedulertypes.cpp.

◆ stageString()

QString Ekos::stageString ( Ekos::CalibrationProcess::CalibrationStage stage )

Definition at line 13 of file calibrationprocess.cpp.

◆ startupConditionString()

QString Ekos::startupConditionString ( StartupCondition condition )

Definition at line 147 of file schedulertypes.cpp.

◆ startupStateString()

QString Ekos::startupStateString ( StartupState state )

Definition at line 47 of file schedulertypes.cpp.

◆ timerStr()

QString Ekos::timerStr ( SchedulerTimerState state )

Definition at line 129 of file schedulertypes.cpp.

Variable Documentation

◆ ABINS_DEBUG

bool Ekos::ABINS_DEBUG { false }

constexpr

Definition at line 40 of file aberrationinspectorutils.h.

◆ alignStates

const QList<KLocalizedString> Ekos::alignStates

static

Initial value:

= { ki18n("Idle"),    ki18n("Complete"),  ki18n("Failed"),
                                                 ki18n("Aborted"), ki18n("In Progress"), ki18n("Successful"),
                                                 ki18n("Syncing"), ki18n("Slewing"), ki18n("Rotating"),
                                                 ki18n("Suspended")
                                               }

Definition at line 138 of file ekos.h.

◆ AutofocusFailReasonStr

const QString Ekos::AutofocusFailReasonStr[FOCUS_FAIL_MAX_REASONS]

static

Initial value:

=
{
    "N/A",
    "No Stars",
    "Hit Max Iterations",
    "Unable to Move Focuser",
    "R2 Check",
    "Delta HFR too small",
    "Focuser Move Out-Of-Bounds",
    "Hit Max Fluctuations",
    "Deadlock",
    "Invalid Tolerance",
    "Focuser Error",
    "Focus Forced Abort",
    "Filter Mnaager Failed",
    "Capture Timeed Out",
    "Capture Failed",
    "No Camera",
    "No Focuser Device",
    "Pulse Value Too Low",
    "Internal Error",
    "Abort Requested",
    "Unable to Fit Curve",
    "Focus Advisor Complete",
    "Focus Advisor Rerun",
    "Focus Optimised Out"
}

Definition at line 79 of file focusutils.h.

◆ AutofocusReasonStr

const QString Ekos::AutofocusReasonStr[FOCUS_MAX_REASONS]

static

Initial value:

=
{
    "N/A",
    "User Initiated",
    "Filter Change",
    "Time",
    "Temperature",
    "HFR Check",
    "Meridian Flip",
    "Build Filter Offsets",
    "Aberration Inspector",
    "Scheduler Initiated",
    "User Request (In-Seq)",
    "Focus Advisor"
}

Definition at line 34 of file focusutils.h.

◆ captureStates

const QList<KLocalizedString> Ekos::captureStates

static

Initial value:

=
{
    ki18n("Idle"), ki18n("In Progress"), ki18n("Capturing"), ki18n("Pause Planned"), ki18n("Paused"),
    ki18n("Suspended"), ki18n("Aborted"), ki18n("Waiting"), ki18n("Image Received"),
    ki18n("Dithering"), ki18n("Focusing"), ki18n("Filter Focus"), ki18n("Changing Filter"), ki18n("Guider Settling"),
    ki18n("Setting Temperature"), ki18n("Setting Rotator"), ki18n("Aligning"), ki18n("Calibrating"),
    ki18n("Meridian Flip"), ki18n("Complete")
}

Definition at line 69 of file ekos.h.

◆ extensionStates

const QList<KLocalizedString> Ekos::extensionStates = { ki18n("Starting"), ki18n("Started"), ki18n("Stopping"), ki18n("Stopped")}

static

Definition at line 220 of file ekos.h.

◆ filterStates

const QList<KLocalizedString> Ekos::filterStates

static

Initial value:

= { ki18n("Idle"), ki18n("Changing Filter"), ki18n("Focus Offset"),
                                                  ki18n("Auto Focus")
                                                }

Definition at line 161 of file ekos.h.

◆ FIND_STARS_MIN_STARS

const int Ekos::FIND_STARS_MIN_STARS = 2

Definition at line 23 of file focusadvisor.cpp.

◆ FOCUS_DEFAULT_DONUT_NAME

const QString Ekos::FOCUS_DEFAULT_DONUT_NAME = "1-Focus-Default-Donut"

Definition at line 24 of file stellarsolverprofile.h.

◆ FOCUS_DEFAULT_NAME

const QString Ekos::FOCUS_DEFAULT_NAME = "1-Focus-Default"

Definition at line 23 of file stellarsolverprofile.h.

◆ FOCUSER_SIMULATOR

const char* Ekos::FOCUSER_SIMULATOR = "Focuser Simulator"

Definition at line 20 of file focusadvisor.cpp.

◆ focusStates

const QList<KLocalizedString> Ekos::focusStates

static

Initial value:

= { ki18n("Idle"),    ki18n("Complete"),       ki18n("Failed"),
                                                 ki18n("Aborted"), ki18n("User Input"),     ki18n("In Progress"),
                                                 ki18n("Framing"), ki18n("Changing Filter")
                                               }

Definition at line 118 of file ekos.h.

◆ guideStates

const QList<KLocalizedString> Ekos::guideStates

static

Initial value:

= { ki18n("Idle"),
                                                 ki18n("Aborted"),
                                                 ki18n("Connected"),
                                                 ki18n("Disconnected"),
                                                 ki18n("Capturing"),
                                                 ki18n("Looping"),
                                                 ki18n("Subtracting"),
                                                 ki18n("Subframing"),
                                                 ki18n("Selecting star"),
                                                 ki18n("Calibrating"),
                                                 ki18n("Calibration error"),
                                                 ki18n("Calibrated"),
                                                 ki18n("Guiding"),
                                                 ki18n("Suspended"),
                                                 ki18n("Reacquiring"),
                                                 ki18n("Dithering"),
                                                 ki18n("Manual Dithering"),
                                                 ki18n("Dithering error"),
                                                 ki18n("Dithering successful"),
                                                 ki18n("Settling")
                                               }

Definition at line 20 of file ekos.h.

◆ HFR_CHECK_DEFAULT_THRESHOLD

double Ekos::HFR_CHECK_DEFAULT_THRESHOLD = 10.0

constexpr

Definition at line 38 of file camerastate.h.

◆ INITIAL_MAXMIN_HFR_RATIO

const double Ekos::INITIAL_MAXMIN_HFR_RATIO = 2.0

Definition at line 25 of file focusadvisor.cpp.

◆ INVALID_STAR_MEASURE

double constexpr Ekos::INVALID_STAR_MEASURE = -1.0

staticconstexpr

Definition at line 228 of file ekos.h.

◆ INVALID_VALUE

const int Ekos::INVALID_VALUE = -1e6

Definition at line 226 of file ekos.h.

◆ MAXIMUM_FOCUS_ADVISOR_ITERATIONS

const int Ekos::MAXIMUM_FOCUS_ADVISOR_ITERATIONS = 1001

Definition at line 21 of file focusadvisor.cpp.

◆ NUM_JUMPS_PER_SECTOR

const int Ekos::NUM_JUMPS_PER_SECTOR = 10

Definition at line 22 of file focusadvisor.cpp.

◆ NUM_STEPS_PRE_AF

const int Ekos::NUM_STEPS_PRE_AF = 11

Definition at line 26 of file focusadvisor.cpp.

◆ ProfileGroupNames

const QList<KLazyLocalizedString> Ekos::ProfileGroupNames

static

Initial value:

=
 
 
 
{
    kde_translate("Align"),
    kde_translate("Focus"),
    kde_translate("Guide"),
    kde_translate("HFR")
}

Definition at line 34 of file stellarsolverprofile.h.

◆ schedulerStates

const QList<KLocalizedString> Ekos::schedulerStates

static

Initial value:

= { ki18n("Idle"), ki18n("Startup"), ki18n("Running"),
                                                     ki18n("Paused"), ki18n("Shutdown"), ki18n("Aborted"),
                                                     ki18n("Loading")
                                                   }

Definition at line 198 of file ekos.h.

◆ TARGET_MAXMIN_HFR_RATIO

const double Ekos::TARGET_MAXMIN_HFR_RATIO = 3.0

Definition at line 24 of file focusadvisor.cpp.

◆ TILE_COLOUR

const QString Ekos::TILE_COLOUR[NUM_TILES] = {"red", "cyan", "green", "magenta", "blue", "grey", "darkGreen", "darkCyan", "darkRed"}

static

Definition at line 35 of file aberrationinspectorutils.h.

◆ TILE_LONGNAME

const QString Ekos::TILE_LONGNAME[NUM_TILES] = {"Top Left", "Top", "Top Right", "Left", "Centre", "Right", "Bottom Left", "Bottom", "Bottom Right"}

static

Definition at line 34 of file aberrationinspectorutils.h.

◆ TILE_NAME

const QString Ekos::TILE_NAME[NUM_TILES] = {"TL", "T", "TR", "L", "C", "R", "BL", "B", "BR"}

static

Definition at line 33 of file aberrationinspectorutils.h.

KDE's Doxygen guidelines are available online.

Class Picker

Quick Links

About Kstars

Ekos

Classes

Typedefs

Enumerations

Functions

Variables

Detailed Description

Typedef Documentation

◆ CapturedFramesMap

◆ PAA

Enumeration Type Documentation

◆ AlignState

◆ AutofocusFailReason

◆ AutofocusReason

◆ CalibrationPreActions

◆ CapState

◆ CaptureAfterPulses

◆ CaptureContinueAction

◆ CaptureResult

◆ CaptureState

◆ CaptureWorkflowActionType

◆ CommunicationStatus

◆ CompletionCondition

◆ EkosState

◆ ErrorHandlingStrategy

◆ ExtensionState

◆ FilenamePreviewType

◆ FilterState

◆ FocusState

◆ GuideState

◆ HFRCheckAlgorithm

◆ INDIState

◆ JOBStatus

◆ LightState

◆ ParkWaitState

◆ ProfileGroup

◆ SchedulerAlgorithm

◆ SchedulerJobStage

◆ SchedulerJobStatus

◆ SchedulerState

◆ SchedulerTimerState

◆ ScriptTypes

◆ ShutdownState

◆ ShutterStatus

◆ StartupCondition

◆ StartupState

◆ tileID

Function Documentation

◆ completionConditionString()

◆ ekosStateString()

◆ getAlignStatusString()

◆ getCaptureStatusString()

◆ getDefaultAlignOptionsProfiles()

◆ getDefaultFocusOptionsProfiles()

◆ getDefaultGuideOptionsProfiles()

◆ getDefaultHFROptionsProfiles()

◆ getExtensionStatusString()

◆ getFilterStatusString()

◆ getFocusOptionsProfileDefault()

◆ getFocusOptionsProfileDefaultDonut()

◆ getFocusStatusString()

◆ getGuideStatusString()

◆ getSchedulerStatusString()

◆ gsl_polynomial_fit()

◆ indiStateString()

◆ isEqual()

◆ MakeLinearFocuser()

◆ parkWaitStateString()

◆ shutdownStateString()

◆ stageString()

◆ startupConditionString()

◆ startupStateString()

◆ timerStr()

Variable Documentation

◆ ABINS_DEBUG

◆ alignStates

◆ AutofocusFailReasonStr