merged AI doc, some new pages

libs/main/geo/piellipsoidmodel.h

@@ -1,9 +1,8 @@
-/*! \file piellipsoidmodel.h
- * \ingroup Geo
- * \~\brief
- * \~english Geographical ellipsoid Earth models
- * \~russian Географическая эллипсоидная модель Земли
- */
+//! \~\ingroup Geo
+//! \~\file piellipsoidmodel.h
+//! \brief
+//! \~english Geographical ellipsoid Earth models
+//! \~russian Географическая эллипсоидная модель Земли
 /*
     PIP - Platform Independent Primitives
     Contains geo ellipsoid models
@@ -29,21 +28,60 @@
 
 #include "pimathbase.h"
 
+//! \~\ingroup Geo
+//! \~\brief
+//! \~english Reference ellipsoid parameters used by geographic calculations.
+//! \~russian Параметры опорного эллипсоида для географических вычислений.
+//! \details
+//! \~english This module provides Earth ellipsoid models used in geodesy and navigation systems. It includes standard models like WGS84,
+//! PZ90, GPS, and Krasovskiy.
+//! \~russian Этот модуль предоставляет модели эллипсоидов Земли, используемые в геодезии и навигационных системах. Он включает стандартные
+//! модели WGS84, ПЗ-90, GPS и Красовского.
 class PIP_EXPORT PIEllipsoidModel {
 public:
+	//! \~english Constructs an empty ellipsoid description.
+	//! \~russian Создает пустое описание эллипсоида.
 	PIEllipsoidModel();
-	double eccSquared() const { return eccentricity * eccentricity; } // eccentricity squared
+
+	//! \~english Returns squared eccentricity.
+	//! \~russian Возвращает квадрат эксцентриситета.
+	double eccSquared() const { return eccentricity * eccentricity; }
+
+	//! \~english Returns semi-minor axis in meters.
+	//! \~russian Возвращает малую полуось в метрах.
 	double b() const { return a * sqrt(1 - eccSquared()); }
 
+	//! \~english Returns the WGS84 reference ellipsoid.
+	//! \~russian Возвращает опорный эллипсоид WGS84.
 	static PIEllipsoidModel WGS84Ellipsoid();
+
+	//! \~english Returns the PZ-90 reference ellipsoid.
+	//! \~russian Возвращает опорный эллипсоид ПЗ-90.
 	static PIEllipsoidModel PZ90Ellipsoid();
+
+	//! \~english Returns the GPS ellipsoid variant used by this module.
+	//! \~russian Возвращает вариант GPS-эллипсоида, используемый в этом модуле.
 	static PIEllipsoidModel GPSEllipsoid();
+
+	//! \~english Returns the Krasovskiy reference ellipsoid.
+	//! \~russian Возвращает опорный эллипсоид Красовского.
 	static PIEllipsoidModel KrasovskiyEllipsoid();
 
-	double a;            /// Major axis of Earth in meters
-	double flattening;   /// Flattening (ellipsoid parameter)
-	double eccentricity; /// Eccentricity (ellipsoid parameter)
-	double angVelocity;  /// Angular velocity of Earth in radians/sec
+	//! \~english Semi-major axis in meters.
+	//! \~russian Большая полуось в метрах.
+	double a;
+
+	//! \~english Flattening coefficient.
+	//! \~russian Коэффициент сжатия.
+	double flattening;
+
+	//! \~english First eccentricity.
+	//! \~russian Первый эксцентриситет.
+	double eccentricity;
+
+	//! \~english Angular velocity in radians per second.
+	//! \~russian Угловая скорость в радианах в секунду.
+	double angVelocity;
 };