...

cxx/mcc_mount_astrom.h

@@ -0,0 +1,65 @@
+#pragma once
+
+/*  MOUNT CONTROL COMPONENTS LIBRARY  */
+
+
+/*  ASTROMETRY ENGINE CONCEPT  */
+
+
+#include <concepts>
+
+#include "mcc_traits.h"
+
+namespace mcc::traits
+{
+
+template <typename T>
+concept mcc_astrom_engine_c = requires(T t) {
+    typename T::engine_err_t;
+    typename T::engine_state_t;
+
+    typename T::meteo_t;
+
+    { t.updateState() };
+
+    /*    coordinates conversional methods    */
+
+    // ICRS RA and DEC to observed place: icrs2obs(ra, dec, time_point, ra_app, dec_app, ha, az, alt, eo)
+    { t.icrs2obs() } -> std::same_as<typename T::engine_err_t>;
+
+    // compute hour angle and declination from azimuth and altitude: hadec2azalt(ha, dec, az, alt)
+    {
+        t.hadec2azalt(std::declval<double>(), std::declval<double>(), std::declval<double&>(), std::declval<double&>())
+    } -> std::same_as<typename T::engine_err_t>;
+
+    // compute azimuth and altitude from hour angle and declination: azalt2hadec(az, alt, ha, dec)
+    {
+        t.azalt2hadec(std::declval<double>(), std::declval<double>(), std::declval<double&>(), std::declval<double&>())
+    } -> std::same_as<typename T::engine_err_t>;
+
+    // compute paralactic angle: hadec2pa(ha, dec, pa)
+    {
+        t.hadec2pa(std::declval<double>(), std::declval<double>(), std::declval<double&>())
+    } -> std::same_as<typename T::engine_err_t>;
+
+
+    /*   time-related methods    */
+
+    // Gregorian Calendar time point to Julian Date: greg2jul(time_point, mjd)
+    // { t.greg2jul() } -> std::same_as<typename T::engine_err_t>;
+    requires mcc_systime_c<mcc_func_arg1_t<decltype(&T::greg2jul)>>;
+    requires std::constructible_from<mcc_func_argN_t<decltype(&T::greg2jul), 2>, double>;
+
+    // apparent sideral time at given longitude (positive to the East): apparentSiderTime(utc, gst)
+    { t.apparentSiderTime(std::declval<const double&>()) } -> std::same_as<typename T::engine_err_t>;
+
+
+    /*   atmospheric refraction-related methods   */
+
+    typename T::refract_result_t;
+    {
+        t.refraction(std::declval<const typename T::meteo_t&>(), std::declval<typename T::refract_result_t&>())
+    } -> std::same_as<typename T::engine_err_t>;
+};
+
+}  // namespace mcc::traits

cxx/mcc_mount_coord.h

@@ -193,6 +193,31 @@ public:
         return degrees<double>();
     }
 
+
+    template <typename T>
+    T arcmins() const
+    {
+        return degrees<T>() * 60.0;
+    }
+
+    double arcmins() const
+    {
+        return arcmins<double>();
+    }
+
+
+    template <typename T>
+    T arcsecs() const
+    {
+        return degrees<T>() * 3600.0;
+    }
+
+    double arcsecs() const
+    {
+        return arcsecs<double>();
+    }
+
+
     template <traits::mcc_output_char_range T>
     T sexagesimal(bool hms = false, int prec = 2) const
     {

cxx/mcc_mount_telemetry.h

@@ -6,6 +6,9 @@
 /*  MOUNT TELEMETRY OBJECT CONCEPT AND POSSIBLE IMPLEMENTATION  */
 
 #include <chrono>
+#include <mutex>
+
+#include "mcc_mount_config.h"
 
 namespace mcc
 {
@@ -15,9 +18,11 @@ namespace traits
 {
 
 template <typename T>
-concept mcc_mount_telemetry_c = requires(T t) {
+concept mcc_mount_telemetry_c = requires(T t, const T t_const) {
     typename T::mount_telemetry_data_t;
-    { t.update() } -> std::same_as<typename T::mount_telemetry_data_t>;
+    { t.update() };
+
+    { t_const.data() } -> std::same_as<typename T::mount_telemetry_data_t>;
 };
 
 }  // namespace traits
@@ -31,6 +36,7 @@ public:
         typedef double mnt_coord_t;
         typedef double mnt_speed_t;
         typedef double time_point_t;
+        typedef std::vector<double> refr_coeff_t;
 
         // time-related
         std::chrono::system_clock::time_point utc;
@@ -56,7 +62,9 @@ public:
         mnt_coord_t mntPosX, mntPosY;
         mnt_speed_t mntSpeedX, mntSpeedY;
 
-        // current refraction coefficient (for tagZD)
+        // current refraction coefficients
+        refr_coeff_t currRefrCoeffs;
+        // current refraction correction (for tagZD)
         mnt_coord_t currRefr;
 
         // PCS (pointing correction system) corrections
@@ -64,16 +72,48 @@ public:
         mnt_coord_t pcsX, pcsY;
     };
 
+    template <MccMountType MOUNT_TYPE>
+    MccMountTelemetry(MccMountConfig<MOUNT_TYPE>& mount_config)
+    {
+        // to be sure that mount_config is captured by reference
+        const auto config_ptr = &mount_config;
+
+        _updateImpl = [config_ptr, this]() {
+            mount_telemetry_data_t current_data;
+
+            // computing ...
+
+
+            std::scoped_lock lock{_updateMutex};
+
+            _data = current_data;
+        };
+    }
+
     virtual ~MccMountTelemetry() = default;
 
     // update current data method
-    mount_telemetry_data_t update()
+    void update()
     {
-        return _data;
+        _updateImpl();
     }
 
+    mount_telemetry_data_t data(this auto&& self)
+    {
+        using self_t = decltype(self);
+
+        std::scoped_lock lock{std::forward<self_t>(self)._updateMutex};
+
+        return std::move(std::forward<self_t>(self)._data);
+    }
+
+
 protected:
-    mount_telemetry_data_t _data;
+    mount_telemetry_data_t _data{};
+
+    std::function<void()> _updateImpl{};
+
+    std::mutex _updateMutex;
 };
 
 }  // namespace mcc

cxx/mcc_traits.h

@@ -130,6 +130,9 @@ using mcc_retval_t = typename mcc_func_traits<T>::ret_t;
 template <typename T>
 using mcc_func_arg1_t = typename mcc_func_traits<T>::arg1_t;
 
+template <typename T, size_t N = 1>
+using mcc_func_argN_t = std::
+    conditional_t<N >= mcc_func_traits<T>::arity, std::tuple_element_t<N, typename mcc_func_traits<T>::args_t>, void>;
 
 namespace details
 {