WarpTwin
Documentation for WarpTwin models and classes.
Loading...
Searching...
No Matches
warpos::TwoAxisPointingGuidance Class Reference

Two-axis constrained pointing guidance method guidance. More...

#include <TwoAxisPointingGuidance.h>

Inheritance diagram for warpos::TwoAxisPointingGuidance:

Classes

struct  Inputs
struct  Outputs

Public Member Functions

 TwoAxisPointingGuidance (FlightExecutive &executive)
virtual ~TwoAxisPointingGuidance ()
int16 activate () override
 Activate the app. The app will step when active.
int16 deactivate () override
 Deactivate the app. The app will not step when deactivated.
int16 command (uint16 apid, uint8 *buffer, uint16 size) override
 Process commands issued to the app.
Public Member Functions inherited from warpos::App
 App (FlightExecutive &executive, const char *name, uint16 apid, uint8 instance=0)
 Executive-based constructor for the task.
virtual ~App ()
 Destructor. Doesn't really do anything.
int16 startup ()
 Initialize the app. Should be called once before step.
int16 step ()
 Step the app by a single step. Maps params, inputs, etc. to outputs.
log_level_e logLevel ()
 Get the log level set for the executive.
void logLevel (log_level_e log_level)
 Set the executive log level.
bool isStarted ()
 Return whether task startup has been run.
uint16 apid ()
 Get the apid for this app.
uint8 & instance ()
 Get the instance of this app (used to differentiate between multiple instances of the same app).
Public Member Functions inherited from clockwerk::GraphTreeObject
 GraphTreeObject (const char *gt_nme="", GraphTreeObject **storage_array=nullptr, uint32 storage_size=0)
 Name-based constructor for GraphTreeObject which will have no children by default.
virtual ~GraphTreeObject ()
 Destructor.
GraphTreeObjectparent ()
 Functions to get object's parent/children.
GraphTreeObject ** children ()
GraphTreeObjectchildAtIndex (uint8 i) const
int16 parent (GraphTreeObject *new_parent)
 Function to assign the node's parent via pointer.
int16 parent (GraphTreeObject &new_parent)
 Function to assign the node's parent via reference.
uint8 nChildren () const
 Getters for number of children and descendants.
uint16 nDescendants () const
uint8 capacity () const
const char * name () const
 Getter and setter for object name.
int16 name (const char *new_name)
uint8 rank ()
 Getter for the object rank.
int8 type ()
 Function to indicate type – -1 by default unless implemented downstream.
bool loggable ()
 Getter for object logability flag – note no setter because should only be set by this or a derived class in its definition.
GraphTreeObjectgetRootDataPointer ()
 Get the pointer to the highest object in the graph tree.
virtual int16 str (char *output, size_t size) const
 Get object represented as string.
virtual int16 fromStr (const char *val)
 Set value of graphtreeobject from string.

Public Attributes

Inputs inputs = Inputs(this, "inputs")
Outputs outputs = Outputs(this, "outputs")
Public Attributes inherited from warpos::App
clockwerk::DataIO< bool > active = clockwerk::DataIO<bool>(this, "active", true)
 The active flag for the task – set to true by default.

Protected Member Functions

int16 start () override
int16 execute () override
Protected Member Functions inherited from clockwerk::GraphTreeObject
int16 _setStorage (GraphTreeObject **storage_array, uint8 storage_size)
 Getter for object's string address.
void _recalculateDescendants ()
 Function to recursively re-calculate the number of descendants of a given node on the tree.
void _recalculateRank ()
 Function to recursively re-calculate the rank of a given node on the tree.
int16 _addChild (GraphTreeObject *child)
 Function to decompose a string into a series of substrings via indexing.
int16 _removeChild (GraphTreeObject *child)
 Function to remove a child from the graph node's children.

Protected Attributes

clockwerk::CartesianVector< 3 > _body_triadx
clockwerk::CartesianVector< 3 > _body_triady
clockwerk::CartesianVector< 3 > _body_triadz
clockwerk::CartesianVector< 3 > _ref_triadx
clockwerk::CartesianVector< 3 > _ref_triady
clockwerk::CartesianVector< 3 > _ref_triadz
clockwerk::DCM _dcm_body_ref
 Local variables for DCM body/ref to Quaternion conversion.
clockwerk::Quaternion _quat_body_ref
clockwerk::DCM _body_triad
clockwerk::DCM _ref_triad
tlm_gnc_two_axis_pnt_data _tlm_pkt
Protected Attributes inherited from warpos::App
FlightExecutiveexc
 Override our executive to include the FlightExecutive instead.
int16 _error = 0
 Internal variable to track and return error on app step through.
uint16 _apid = 0
 Internal variable to hold the APID for this app.
bool _is_started = false
 Flag indicating whether app has been started or not.
log_level_e _local_log_level = log_level_e::LOG_WARNING
 The log level for this particular app.
GraphTreeObject_app_children [MAXIMUM_APP_CHILDREN]
 Local storage for App children so it can live on the graph tree.
uint8 _instance
 Instance number of this app. Used to differentiate between multiple instances of the same app.
Protected Attributes inherited from clockwerk::GraphTreeObject
GraphTreeObject_parent = nullptr
GraphTreeObject ** _children_ptr = nullptr
uint32 _max_num_children = 0
uint16 _num_descendants = 0
char _name [MAXIMUM_NAME_CHARS] = ""
 String name for object.
uint8 _num_children = 0
 Number of direct children of the tree (not including the tree itself).
uint8 _rank = 0
int8 _graph_tree_type = BASE_GRAPH_TREE
 Variable to store graph tree object type.
bool _loggable = false
 Variable to indicate whether the selected object is loggable. Set to false by default.
uint32 _index = 0
 Index pointing to the next write location for the graph tree children.

Detailed Description

Two-axis constrained pointing guidance method guidance.

This task applies a simple pointing guidance based on the Triad method for attitude determination. In this approach, two body axes are selected, along with desired vectors in the reference frame to which they should point. The task calculates the attitude body/reference which fully meets the primary pointing constraint and attempts a best effort at the secondary pointing constraint.

Constructor & Destructor Documentation

◆ TwoAxisPointingGuidance()

warpos::TwoAxisPointingGuidance::TwoAxisPointingGuidance ( FlightExecutive & executive)

◆ ~TwoAxisPointingGuidance()

virtual warpos::TwoAxisPointingGuidance::~TwoAxisPointingGuidance ( )
inlinevirtual

Member Function Documentation

◆ activate()

int16 warpos::TwoAxisPointingGuidance::activate ( )
overridevirtual

Activate the app. The app will step when active.

Returns
Flag indicating success/failure

Reimplemented from warpos::App.

◆ command()

int16 warpos::TwoAxisPointingGuidance::command ( uint16 apid,
uint8 * buffer,
uint16 size )
overridevirtual

Process commands issued to the app.

Parameters
apidThe APID of the command sent
bufferPointer to the location of the buffer holding the command
sizeThe size of the command being sent
Returns
Flag indicating success/failure

Reimplemented from warpos::App.

◆ deactivate()

int16 warpos::TwoAxisPointingGuidance::deactivate ( )
overridevirtual

Deactivate the app. The app will not step when deactivated.

Returns
Flag indicating success/failure

Reimplemented from warpos::App.

◆ execute()

int16 warpos::TwoAxisPointingGuidance::execute ( )
overrideprotectedvirtual

Reimplemented from warpos::App.

◆ start()

int16 warpos::TwoAxisPointingGuidance::start ( )
overrideprotectedvirtual

Reimplemented from warpos::App.

Member Data Documentation

◆ _body_triad

clockwerk::DCM warpos::TwoAxisPointingGuidance::_body_triad
protected

◆ _body_triadx

clockwerk::CartesianVector<3> warpos::TwoAxisPointingGuidance::_body_triadx
protected

◆ _body_triady

clockwerk::CartesianVector<3> warpos::TwoAxisPointingGuidance::_body_triady
protected

◆ _body_triadz

clockwerk::CartesianVector<3> warpos::TwoAxisPointingGuidance::_body_triadz
protected

◆ _dcm_body_ref

clockwerk::DCM warpos::TwoAxisPointingGuidance::_dcm_body_ref
protected

Local variables for DCM body/ref to Quaternion conversion.

◆ _quat_body_ref

clockwerk::Quaternion warpos::TwoAxisPointingGuidance::_quat_body_ref
protected

◆ _ref_triad

clockwerk::DCM warpos::TwoAxisPointingGuidance::_ref_triad
protected

◆ _ref_triadx

clockwerk::CartesianVector<3> warpos::TwoAxisPointingGuidance::_ref_triadx
protected

◆ _ref_triady

clockwerk::CartesianVector<3> warpos::TwoAxisPointingGuidance::_ref_triady
protected

◆ _ref_triadz

clockwerk::CartesianVector<3> warpos::TwoAxisPointingGuidance::_ref_triadz
protected

◆ _tlm_pkt

tlm_gnc_two_axis_pnt_data warpos::TwoAxisPointingGuidance::_tlm_pkt
protected

◆ inputs

Inputs warpos::TwoAxisPointingGuidance::inputs = Inputs(this, "inputs")

◆ outputs

Outputs warpos::TwoAxisPointingGuidance::outputs = Outputs(this, "outputs")

The documentation for this class was generated from the following files: