planetrelutils.h

Go to the documentation of this file.

/******************************************************************************
* Copyright (c) ATTX LLC 2024. All Rights Reserved.
*
* This software and associated documentation (the "Software") are the 
* proprietary and confidential information of ATTX, LLC. The Software is 
* furnished under a license agreement between ATTX and the user organization 
* and may be used or copied only in accordance with the terms of the agreement.
* Refer to 'license/attx_license.adoc' for standard license terms.
*
* EXPORT CONTROL NOTICE: THIS SOFTWARE MAY INCLUDE CONTENT CONTROLLED UNDER THE
* INTERNATIONAL TRAFFIC IN ARMS REGULATIONS (ITAR) OR THE EXPORT ADMINISTRATION 
* REGULATIONS (EAR99). No part of the Software may be used, reproduced, or 
* transmitted in any form or by any means, for any purpose, without the express 
* written permission of ATTX, LLC.
******************************************************************************/
/*
Planet relative state Utils header file
---------------------------------------
The planet relative state utilities header file contains
utiltities for converting between planet-based spherical 
coordinates and planet-centered rotating frame coordinates.
 
Author: Alex Reynolds
 
Update Log
----------
May 9, 2024, Gabriel A. Heredia Acevedo
Jun 16, 2025, James Tabony - added llaDeticToPCR
Jan 19, 2026, Alex Jackson - Added nedToLlaDetic function
 
Update tools to support planet (celestial) relative states model
*/
 
#ifndef GNCUTILS_STATES_PLANET_REL_UTILS_H
#define GNCUTILS_STATES_PLANET_REL_UTILS_H
 
#include "types.h"
#include "core/CartesianVector.hpp"
#include "core/mathmacros.h"
#include "dynamics/DCM.h"
#include "core/safemath.h"
 
namespace warpos {

    int16 pcrToDeticLla(CartesianVector3 pos__pcr, 
                        floating_point r_planet_equatorial,
                        floating_point flattening, 
                        floating_point& lat_rad, 
                        floating_point& lon_rad, 
                        floating_point& alt); 

    int16 llaDeticToPCR(double r_planet_equitorial,
                        double flattening,
                        double lat_rad,
                        double lon_rad,
                        double alt,
                        clockwerk::CartesianVector<3> &pos__pcr);
    int16 llaDeticToPCR(float r_planet_equitorial,
                        float flattening,
                        float lat_rad,
                        float lon_rad,
                        float alt,
                        clockwerk::CartesianVector<3> &pos__pcr);

    clockwerk::DCM enuFromLatLonDetic(floating_point lat_rad, 
                                      floating_point lon_rad);

    clockwerk::DCM nedFromLatLonDetic(floating_point lat_rad, 
                                      floating_point lon_rad);

    int16 nedToLlaDetic(floating_point lat_origin_deg, 
                        floating_point lon_origin_deg, 
                        floating_point alt_origin, 
                        CartesianVector3 pos__ned, 
                        floating_point r_planet_equatorial, 
                        floating_point flattening, 
                        floating_point &lat_deg, 
                        floating_point &lon_deg, 
                        floating_point &alt);   
 
}
 
#endif