TimedImpulsiveBurnModel.h

/******************************************************************************
* 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.
******************************************************************************/
/*
Impulse model header file
 
Author: Alex Reynolds
*/
 
#ifndef MODELS_ACTUATORS_TIMED_IMPULSIVE_BURN_MODEL_H
#define MODELS_ACTUATORS_TIMED_IMPULSIVE_BURN_MODEL_H
 
#include "core/macros.h"
#include "simulation/Model.h"
#include "core/CartesianVector.hpp"
#include "six_dof_dynamics/Frame.hpp"
#include "six_dof_dynamics/Body.hpp"
#include "six_dof_dynamics/Node.hpp"
#include "models/actuators/ImpulseModel.h"
#include "monitors/TimeTriggerMonitor.h"
 
namespace modelspace {
 
    /**
     * @brief   Timed Impulsive Burn Model
     * 
     * This model is used for mission planning to program an impulsive burn to occur
     * at a specific time and in a specific frame. The model internally uses a 
     * time trigger monitor, ImpulseModel, and node to apply a force to a specific
     * body in the simulation. 
     * 
     * Once triggered, the impulsive burn model will not trigger again until reset.
     * 
     * Author: Alex Reynolds <alex.reynolds@attx.tech>
    */
    class TimedImpulsiveBurnModel : public Model {
    public:
        // Model params
        //         NAME                     TYPE                    DEFAULT VALUE
        START_PARAMS
            /** The body frame of the spacecraft which will be performing the burn */
            SIGNAL(body_frame,              BodyD*,                 nullptr)
            /** The frame in which the burn will be executed. If null, will execute in the body frame */
            SIGNAL(burn_frame,              FrameD*,                nullptr)
            /** The time of ignition of the burn in the selected timescale. Default is to not trigger */
            SIGNAL(time_of_ignition,        clockwerk::Time,        clockwerk::Time(999999999999, 0))
            /** The delta V of the burn to be executed at time_of_ignition */
            SIGNAL(deltav__burn,            CartesianVector3D,      CartesianVector3D({0.0, 0.0, 0.0}))
        END_PARAMS
 
        // Model inputs
        //         NAME                     TYPE                    DEFAULT VALUE
        START_INPUTS
            /** The current time in the same timescale as the parameterized TIG */
            SIGNAL(current_time,            clockwerk::Time,        clockwerk::Time())
        END_INPUTS
 
        // Model outputs
        //         NAME                     TYPE                    DEFAULT VALUE
        START_OUTPUTS
 
        END_OUTPUTS
 
        TimedImpulsiveBurnModel(Model &pnt, const std::string &m_name="impulse");
        TimedImpulsiveBurnModel(SimulationExecutive &e, const std::string &m_name="impulse");
        TimedImpulsiveBurnModel(Model &pnt, int schedule_slot, const std::string &m_name="impulse");
        TimedImpulsiveBurnModel(SimulationExecutive &e, int schedule_slot, const std::string &m_name="impulse");
        ~TimedImpulsiveBurnModel() {}
 
        /// @brief Function to get a handle to the time trigger monitor contained within this model
        /// @return Pointer to the time trigger monitor
        modelspace::TimeTriggerMonitor* timeTriggerMonitor() {return &_time_trigger;}
        /// @brief Function to get a handle to the impulse model contained within this model
        /// @return Pointer to the impulse model
        modelspace::ImpulseModel* impulseModel() {return &_impulse;}
    protected:
        int start();
        int execute();
 
        // Internal models and monitors
        TimeTriggerMonitor _time_trigger;
        ImpulseModel _impulse;
 
        // Node at which forces will be applied
        NodeD _force_node;
 
        // Boolean indicating whether trigger has happened before
        bool _triggered = false;
    };
}
 
#endif