feat: argument of latitude computation (#534)

* feat: argument of latitude computation

* feat: address remaining feedback

Author: vishwa2710

bindings/python/src/OpenSpaceToolkitAstrodynamicsPy/Trajectory/Orbit/Model/Kepler/COE.cpp

@@ -714,5 +714,16 @@ inline void OpenSpaceToolkitAstrodynamicsPy_Trajectory_Orbit_Model_Kepler_COE(py
             arg("element")
         )
 
+        .def(
+            "get_argument_of_latitude",
+            &COE::getArgumentOfLatitude,
+            R"doc(
+                Get the argument of latitude of the COE.
+
+                Returns:
+                    Angle: The argument of latitude (sum of argument of periapsis and true anomaly).
+            )doc"
+        )
+
         ;
 }

bindings/python/test/trajectory/orbit/models/kepler/test_coe.py

@@ -118,6 +118,7 @@ def test_getters(
         assert coe.get_raan() == raan
         assert coe.get_aop() == aop
         assert coe.get_true_anomaly() == true_anomaly
+        assert coe.get_argument_of_latitude() == aop + true_anomaly
         assert coe.get_mean_anomaly() is not None
         assert coe.get_eccentric_anomaly() is not None
         assert coe.get_mean_motion(Earth.EGM2008.gravitational_parameter) is not None

include/OpenSpaceToolkit/Astrodynamics/Trajectory/Orbit/Model/Kepler/COE.hpp

@@ -147,6 +147,11 @@ class COE
     /// @return Argument of periapsis
     Angle getAop() const;
 
+    /// @brief Get Argument of latitude
+    ///
+    /// @return Argument of latitude
+    Angle getArgumentOfLatitude() const;
+
     /// @brief Get True anomaly
     ///
     /// @return True anomaly

src/OpenSpaceToolkit/Astrodynamics/Trajectory/Orbit/Model/Kepler/COE.cpp

@@ -167,6 +167,16 @@ Angle COE::getTrueAnomaly() const
     return anomaly_;
 }
 
+Angle COE::getArgumentOfLatitude() const
+{
+    if (!this->isDefined())
+    {
+        throw ostk::core::error::runtime::Undefined("COE");
+    }
+
+    return aop_ + anomaly_;
+}
+
 Angle COE::getMeanAnomaly() const
 {
     if (!this->isDefined())

test/OpenSpaceToolkit/Astrodynamics/Trajectory/Orbit/Model/Kepler/COE.test.cpp

@@ -418,6 +418,17 @@ TEST_F(OpenSpaceToolkit_Astrodynamics_Trajectory_Orbit_Model_Kepler_COE, Compute
 
 // }
 
+TEST_F(OpenSpaceToolkit_Astrodynamics_Trajectory_Orbit_Model_Kepler_COE, GetArgumentOfLatitude)
+{
+    {
+        EXPECT_EQ(defaultAop_ + defaultTrueAnomaly_, coe_.getArgumentOfLatitude());
+    }
+
+    {
+        EXPECT_ANY_THROW(COE::Undefined().getArgumentOfLatitude());
+    }
+}
+
 TEST_F(OpenSpaceToolkit_Astrodynamics_Trajectory_Orbit_Model_Kepler_COE, GetNodalPrecessionRate)
 {
     {