P6DofForceAndMomentsObject.hpp

Go to the documentation of this file.

// ****************************************************************************
// CUI
//
// The Advanced Framework for Simulation, Integration, and Modeling (AFSIM)
//
// Copyright 2003-2015 The Boeing Company. All rights reserved.
//
// The use, dissemination or disclosure of data in this file is subject to
// limitation or restriction. See accompanying README and LICENSE for details.
// ****************************************************************************
 
#ifndef P6DOFFORCEANDMOMENTOBJECT_H
#define P6DOFFORCEANDMOMENTOBJECT_H
 
#include "p6dof_export.h"
 
#include "UtVec3dX.hpp"
 
// The P6DofForceAndMomentsObject class provides a means to "build-up" forces
// and moments (F&M) provides a collection of state data for P6DofObjects.
// It should be noted that the class assumes that forces and moments are in
// body-coordinates.
class P6DOF_EXPORT P6DofForceAndMomentsObject
{
public:
   P6DofForceAndMomentsObject();
 
   P6DofForceAndMomentsObject* Clone() const;
 
   // This adds aSrc F&M to the current F&M object, transforming the aSrc F&M
   // as required for the current reference point
   P6DofForceAndMomentsObject& operator+=(const P6DofForceAndMomentsObject& aSrc);
 
   // This clears the force and moment but leaves the reference point unchanged
   void ClearForcesAndMoments();
 
   // This clears the force, moment, and reference point
   void ClearReferenceAndForceAndMoment();
 
   // This moves the reference point to the specified point, and modifies
   // the current F&M accordingly
   void MoveRefPoint_ft(const UtVec3dX& aSpecifiedPoint_ft);
 
   // This moves the reference point to the specified point, and modifies
   // the current F&M accordingly. This version uses attitude data.
   void RelocateForce_ft(const UtVec3dX& aSpecifiedPoint_ft, const UtVec3dX& aAngRelToParentYPR_rad);
 
   // This adds the specified force and moment applied at the specified point.
   // The function calculates the new F&M at the internal reference point.
   void AddForceAndMomentAtSpecifiedPoint(UtVec3dX& aForceVec_lbs, UtVec3dX& aMomentVec_ftlbs, UtVec3dX& aSpecifiedPoint_ft);
 
   // This adds the specified force and moment applied at the reference point.
   void AddForceAndMomentAtReferencePoint(const UtVec3dX& aForceVec_lbs, const UtVec3dX& aMomentVec_ftlbs);
 
   // This adds the specified force at the specified point. The function calculates
   // the new F&M at the internal reference point.
   void AddForceAtSpecifiedPoint(UtVec3dX& aForceVec_lbs, UtVec3dX& aSpecifiedPoint_ft);
 
   // This adds the specified force at the reference point.
   void AddForceAtReferencePoint(UtVec3dX& aForceVec_lbs);
 
   // This adds the specified moment. The function calculates the new F&M at
   // the internal reference point.
   void AddMoment(UtVec3dX& aMomentVec_ftlbs);
 
   // This returns (via references) the current force and moment at the specified
   // point, using the current F&M at the internal reference point.
   void GetForceAndMomentAtSpecifiedPoint(UtVec3dX& aForceVec_lbs,
                                          UtVec3dX& aMomentVec_ftlbs,
                                          UtVec3dX& aSpecifiedPoint_ft) const;
 
   // This returns (via references) the current force and moment at the current
   // internal reference point.
   void GetForceAndMomentAtCurrentRefPoint(UtVec3dX& aForceVec_lbs, UtVec3dX& aMomentVec_ftlbs) const;
 
   // This returns the magnitude of the force in lbs
   double GetForceMagnitude_lbs() const;
 
   // This returns the vector of the force in lbs
   UtVec3dX GetForceAtRefPoint_lbs() const;
 
   // This returns the vector of the moment in ft-lbs
   UtVec3dX GetMomentAtRefPoint_ftlbs() const;
 
   // This limits the magnitude of the force in lbs, reducing it, if needed
   void LimitMaxForceMagnitude_lbs(double aMaxForce_lbs);
 
   // This limits the magnitude of the moment in ft-lbs, reducing it, if needed
   void LimitMomentMagnitude_ftlbs(double aMaxMoment_ftlbs);
 
   // This returns a P6DofForceAndMomentsObject that is the "average" of
   // the "this" F&M object and the specified F&M object (argument object)
   P6DofForceAndMomentsObject CalcAverageWith(P6DofForceAndMomentsObject& aOtherFM) const;
 
   // This returns the vector of the force in lbs
   UtVec3dX GetReferencePoint_ft() const;
 
protected:
   UtVec3dX mForceVec_lbs;
   UtVec3dX mMomentVec_ftlbs;
   UtVec3dX mRefPoint_ft;
};
 
#endif