opNavPoint#

Executive Summary#

This module implements a opNav point attitude guidance routine.

This algorithm is intended to be incredibly simple and robust: it finds the angle error between the camera boresight (or desired control axis in the camera frame) and the planet heading in the camera frame and brings them to zero. This is analoguous to sunSafePoint. The file PDF Description. contains further information on this module’s function, how to run it, as well as testing.

Message Connection Descriptions#

The following table lists all the module input and output messages. The module msg connection is set by the user from python. The msg type contains a link to the message structure definition, while the description provides information on what this message is used for.

Module I/O Messages#

Msg Variable Name

Msg Type

Description

attGuidanceOutMsg

AttGuidMsgPayload

name of the output guidance message

opnavDataInMsg

OpNavMsgPayload

name of the optical navigation input message

imuInMsg

NavAttMsgPayload

name of the incoming IMU message

cameraConfigInMsg

CameraConfigMsgPayload

name of the camera config message

Class OpNavPoint#

class OpNavPoint : public SysModel#

module configuration message definition

Public Functions

void reset(uint64_t callTime) override#

This method performs a complete reset of the module. Local module variables that retain time varying states between function calls are reset to their default values.

Parameters:

callTime – The clock time at which the function was called (nanoseconds)

Returns:

void

void updateState(uint64_t callTime) override#

This method takes the estimated camera-observed target vector and computes the current attitude/attitude rate errors to pass on to control.

Parameters:

callTime – The clock time at which the function was called (nanoseconds)

Returns:

void

Public Members

Message<AttGuidMsgPayload> attGuidanceOutMsg#

The name of the output message

ReadFunctor<OpNavMsgPayload> opnavDataInMsg#

The name of the Input message

ReadFunctor<NavAttMsgPayload> imuInMsg#

The name of the incoming IMU message

ReadFunctor<CameraConfigMsgPayload> cameraConfigInMsg#

The name of the camera config message.

double minUnitMag#

&#8212; The minimally acceptable norm of opNav body vector

double opNavAngleErr#

&#8212; rad The current error between cmd and obs opNav angle

double smallAngle#

&#8212; rad An angle value that specifies what is near 0 or 180 degrees

double eHat180_B[3]#

&#8212; Eigen axis to use if commanded axis is 180 from opNav axis

double opNavMnvrVec[3]#

&#8212; The eigen axis that we want to rotate on to see target

double lastTime#

&#8212; Last time a measurement came in to integrate pointing

double timeOut#

&#8212; If no images were seen in this much time, stop using past values

double alignAxis_C[3]#

&#8212; Desired camera vector to point at target

double currentHeading_N[3]#

&#8212; Previous heading command in intertial Frame

double omega_RN_B[3]#

&#8212; Desired body rate vector if no opNav direction is available

double opNavAxisSpinRate#

&#8212; r/s Desired constant spin rate about opNav vector

AttGuidMsgPayload attGuidanceOutBuffer#

&#8212; The output data that we compute

BSKLogger bskLogger = {}#

BSK Logging.