gtsam
Loading...
Searching...
No Matches
gtsam::PoseRotationPrior< POSE > Class Template Reference
Inheritance diagram for gtsam::PoseRotationPrior< POSE >:

Public Member Functions

 PoseRotationPrior ()
 default constructor - only use for serialization
 PoseRotationPrior (Key key, const Rotation &rot_z, const SharedNoiseModel &model)
 standard constructor
 PoseRotationPrior (Key key, const POSE &pose_z, const SharedNoiseModel &model)
 Constructor that pulls the translation from an incoming POSE.
gtsam::NonlinearFactor::shared_ptr clone () const override
const Rotation & measured () const
bool equals (const NonlinearFactor &expected, double tol=1e-9) const override
 equals specialized to this factor
void print (const std::string &s="", const KeyFormatter &keyFormatter=DefaultKeyFormatter) const override
 print contents
Vector evaluateError (const Pose &pose, OptionalMatrixType H) const override
 h(x)-z
virtual Vector evaluateError (const ValueTypes &... x, OptionalMatrixTypeT< ValueTypes >... H) const =0
 Override evaluateError to finish implementing an n-way factor.
Vector evaluateError (const ValueTypes &... x, MatrixTypeT< ValueTypes > &... H) const
 If all the optional arguments are matrices then redirect the call to the one which takes pointers.
Vector evaluateError (const ValueTypes &... x) const
 No-Jacobians requested function overload.
AreAllMatrixRefs< Vector, OptionalJacArgs... > evaluateError (const ValueTypes &... x, OptionalJacArgs &&... H) const
 Some (but not all) optional Jacobians are omitted (function overload) and the jacobians are l-value references to matrices.
Public Member Functions inherited from gtsam::NoiseModelFactorT< Vector, ValueTypes... >
Key key () const
 Returns a key.
Vector unwhitenedError (const Values &x, std::vector< Matrix > &H) const
 support taking in the actual vector instead of the pointer as well to get access to this version of the function from derived classes one will need to use the "using" keyword and specify that like this: public: using NoiseModelFactor::unwhitenedError;
 NoiseModelFactorT ()
 Default Constructor for I/O.
 NoiseModelFactorT (const SharedNoiseModel &noiseModel, KeyType< ValueTypes >... keys)
 Constructor.
 NoiseModelFactorT (const SharedNoiseModel &noiseModel, CONTAINER keys)
 Constructor.
virtual Vector evaluateError (const ValueTypes &... x, OptionalMatrixTypeT< ValueTypes >... H) const=0
 Override evaluateError to finish implementing an n-way factor.
Vector evaluateError (const ValueTypes &... x, MatrixTypeT< ValueTypes > &... H) const
 If all the optional arguments are matrices then redirect the call to the one which takes pointers.
Vector evaluateError (const ValueTypes &... x) const
 No-Jacobians requested function overload.
AreAllMatrixRefs< Vector, OptionalJacArgs... > evaluateError (const ValueTypes &... x, OptionalJacArgs &&... H) const
 Some (but not all) optional Jacobians are omitted (function overload) and the jacobians are l-value references to matrices.
AreAllMatrixPtrs< Vector, OptionalJacArgs... > evaluateError (const ValueTypes &... x, OptionalJacArgs &&... H) const
 Some (but not all) optional Jacobians are omitted (function overload) and the jacobians are pointers to matrices.
Key key1 () const
Key key2 () const
Key key3 () const
Key key4 () const
Key key5 () const
Key key6 () const
std::shared_ptr< GaussianFactor > linearize (const Values &values) const override
 Linearize factors whose error and argument dimensions are all fixed to an arbitrary-arity FixedJacobianFactor.
Vector unwhitenedError (const Values &x, OptionalMatrixVecType H=nullptr) const override
 This implements the unwhitenedError virtual function by calling the n-key specific version of evaluateError, which is pure virtual so must be implemented in the derived class.
Public Member Functions inherited from gtsam::NoiseModelFactor
 NoiseModelFactor ()
 Default constructor for I/O only.
 ~NoiseModelFactor () override
 Destructor.
template<typename CONTAINER>
 NoiseModelFactor (const SharedNoiseModel &noiseModel, const CONTAINER &keys)
 Constructor.
size_t dim () const override
 get the dimension of the factor (number of rows on linearization)
const SharedNoiseModelnoiseModel () const
 access to the noise model
Vector unwhitenedError (const Values &x, std::vector< Matrix > &H) const
 support taking in the actual vector instead of the pointer as well to get access to this version of the function from derived classes one will need to use the "using" keyword and specify that like this: public: using NoiseModelFactor::unwhitenedError;
Vector whitenedError (const Values &c) const
 Vector of errors, whitened This is the raw error, i.e., i.e.
Vector unweightedWhitenedError (const Values &c) const
 Vector of errors, whitened, but unweighted by any loss function.
double weight (const Values &c) const
 Compute the effective weight of the factor from the noise model.
double error (const Values &c) const override
 Calculate the error of the factor.
shared_ptr cloneWithNewNoiseModel (const SharedNoiseModel newNoise) const
 Creates a shared_ptr clone of the factor with a new noise model.
double error (const HybridValues &c) const override
 All factor types need to implement an error function.
 NonlinearFactor ()
 Default constructor for I/O only.
template<typename CONTAINER>
 NonlinearFactor (const CONTAINER &keys)
 Constructor from a collection of the keys involved in this factor.
double error (const HybridValues &c) const override
 All factor types need to implement an error function.
virtual bool active (const Values &c) const
 Checks whether a factor should be used based on a set of values.
virtual void qcqpFactors (NonlinearFactorGraph *costs, NonlinearEqualityConstraints *constraints, size_t columnDimension=1) const
 Add this factor's QCQP cost and constraints over matrix-valued QCQP variables with the given column dimension.
virtual shared_ptr rekey (const std::map< Key, Key > &rekey_mapping) const
 Creates a shared_ptr clone of the factor with different keys using a map from old->new keys.
virtual shared_ptr rekey (const KeyVector &new_keys) const
 Clones a factor and fully replaces its keys.
virtual bool sendable () const
 Should the factor be evaluated in the same thread as the caller This is to enable factors that has shared states (like the Python GIL lock).
Public Member Functions inherited from gtsam::Factor
virtual ~Factor ()=default
 Default destructor.
bool empty () const
 Whether the factor is empty (involves zero variables).
Key front () const
 First key.
Key back () const
 Last key.
const_iterator find (Key key) const
 find
const KeyVectorkeys () const
 Access the factor's involved variable keys.
const_iterator begin () const
 Iterator at beginning of involved variable keys.
const_iterator end () const
 Iterator at end of involved variable keys.
size_t size () const
virtual void printKeys (const std::string &s="Factor", const KeyFormatter &formatter=DefaultKeyFormatter) const
 print only keys
bool equals (const This &other, double tol=1e-9) const
 check equality
KeyVectorkeys ()
iterator begin ()
 Iterator at beginning of involved variable keys.
iterator end ()
 Iterator at end of involved variable keys.

Static Public Attributes

static const int xDim = FixedDimension<POSE>::value
static const int rDim = FixedDimension<typename POSE::Rotation>::value
Static Public Attributes inherited from gtsam::NoiseModelFactorT< Vector, ValueTypes... >
static constexpr auto N
 N is the number of variables (N-way factor).

Public Types

typedef PoseRotationPrior< POSE > This
typedef NoiseModelFactorN< POSE > Base
typedef POSE Pose
typedef POSE::Translation Translation
typedef POSE::Rotation Rotation
Public Types inherited from gtsam::NoiseModelFactorT< Vector, ValueTypes... >
using ValueType
 The type of the I'th template param can be obtained as ValueType.
Public Types inherited from gtsam::NoiseModelFactor
typedef std::shared_ptr< This > shared_ptr
 Noise model.
Public Types inherited from gtsam::NonlinearFactor
typedef std::shared_ptr< This > shared_ptr
Public Types inherited from gtsam::Factor
typedef KeyVector::iterator iterator
 Iterator over keys.
typedef KeyVector::const_iterator const_iterator
 Const iterator over keys.

Protected Attributes

Rotation measured_
Protected Attributes inherited from gtsam::NoiseModelFactor
SharedNoiseModel noiseModel_
Protected Attributes inherited from gtsam::Factor
KeyVector keys_
 The keys involved in this factor.

Additional Inherited Members

Protected Types inherited from gtsam::NoiseModelFactorT< Vector, ValueTypes... >
using Base
using This
using OptionalMatrixTypeT
using KeyType
using MatrixTypeT
using IsConvertible
using IndexIsValid
using ContainerElementType
using IsContainerOfKeys
using AreAllMatrixRefs
 A helper alias to check if a list of args are all references to a matrix or not.
using IsMatrixPointer
using IsNullpointer
using AreAllMatrixPtrs
 A helper alias to check if a list of args are all pointers to a matrix or not.
Protected Types inherited from gtsam::NoiseModelFactor
typedef NonlinearFactor Base
typedef NoiseModelFactor This
Protected Types inherited from gtsam::NonlinearFactor
typedef Factor Base
typedef NonlinearFactor This
Protected Member Functions inherited from gtsam::NoiseModelFactor
 NoiseModelFactor (const SharedNoiseModel &noiseModel)
 Constructor - only for subclasses, as this does not set keys.
 Factor ()
 Default constructor for I/O.
template<typename CONTAINER>
 Factor (const CONTAINER &keys)
 Construct factor from container of keys.
template<typename ITERATOR>
 Factor (ITERATOR first, ITERATOR last)
 Construct factor from iterator keys.
template<typename CONTAINER>
static Factor FromKeys (const CONTAINER &keys)
 Construct factor from container of keys.
template<typename ITERATOR>
static Factor FromIterators (ITERATOR first, ITERATOR last)
 Construct factor from iterator keys.

Member Function Documentation

◆ clone()

template<class POSE>
gtsam::NonlinearFactor::shared_ptr gtsam::PoseRotationPrior< POSE >::clone ( ) const
inlineoverridevirtual
Returns
a deep copy of this factor

Reimplemented from gtsam::NonlinearFactor.

◆ equals()

template<class POSE>
bool gtsam::PoseRotationPrior< POSE >::equals ( const NonlinearFactor & expected,
double tol = 1e-9 ) const
inlineoverridevirtual

equals specialized to this factor

Reimplemented from gtsam::NoiseModelFactor.

◆ evaluateError() [1/4]

template<class POSE>
Vector gtsam::NoiseModelFactorT< Vector, ValueTypes >::evaluateError ( const ValueTypes &... x) const
inline

No-Jacobians requested function overload.

This specializes the version below to avoid recursive calls since this is commonly used.

e.g. const Vector error = factor.evaluateError(pose, point);

◆ evaluateError() [2/4]

template<class POSE>
Vector gtsam::NoiseModelFactorT< Vector, ValueTypes >::evaluateError ( const ValueTypes &... x,
MatrixTypeT< ValueTypes > &... H ) const
inline

If all the optional arguments are matrices then redirect the call to the one which takes pointers.

To get access to this version of the function from derived classes one will need to use the "using" keyword and specify that like this: public: using NoiseModelFactorT<list the value types here>::evaluateError;

◆ evaluateError() [3/4]

template<class POSE>
AreAllMatrixRefs< Vector, OptionalJacArgs... > gtsam::NoiseModelFactorT< Vector, ValueTypes >::evaluateError ( const ValueTypes &... x,
OptionalJacArgs &&... H ) const
inline

Some (but not all) optional Jacobians are omitted (function overload) and the jacobians are l-value references to matrices.

e.g. const Vector error = factor.evaluateError(pose, point, Hpose);

◆ evaluateError() [4/4]

template<class POSE>
virtual Vector gtsam::NoiseModelFactorT< Vector, ValueTypes >::evaluateError ( const ValueTypes &... x,
OptionalMatrixTypeT< ValueTypes >... H ) const

Override evaluateError to finish implementing an n-way factor.

Both the x and H arguments are written here as parameter packs, but when overriding this method, you probably want to explicitly write them out. For example, for a 2-way factor with variable types Pose3 and Point3, you should implement:

const Pose3& x1, const Point3& x2,
OptionalMatrixType H2 = OptionalNone) const override { ... }
#define OptionalNone
These typedefs and aliases will help with making the evaluateError interface independent of boost TOD...
Definition NonlinearFactor.h:51
Matrix * OptionalMatrixType
This typedef will be used everywhere boost::optional<Matrix&> reference was used previously.
Definition NonlinearFactor.h:57
Vector3 Point3
As of GTSAM 4, in order to make GTSAM more lean, it is now possible to just typedef Point3 to Vector3...
Definition Point3.h:38
A 3D pose (R,t) : (Rot3,Point3).
Definition Pose3.h:42
Vector evaluateError(const Pose &pose, OptionalMatrixType H) const override
h(x)-z
Definition PoseRotationPrior.h:83

If any of the optional Matrix reference arguments are specified, it should compute both the function evaluation and its derivative(s) in the requested variables.

Parameters
xThe values of the variables to evaluate the error for. Passed in as separate arguments.
[out]HThe Jacobian with respect to each variable (optional).

◆ print()

template<class POSE>
void gtsam::PoseRotationPrior< POSE >::print ( const std::string & s = "",
const KeyFormatter & keyFormatter = DefaultKeyFormatter ) const
inlineoverridevirtual

print contents

Reimplemented from gtsam::NoiseModelFactor.


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