PointPropagationParameter Class

Represents a Point which in turns represents the position and velocity in an integration state. This is used to define various geometries that depend on the state during integration.

Inheritance Hierarchy

SystemObject
  AGI.Foundation.InfrastructureDefinitionalObject
    AGI.Foundation.GeometryPoint
      AGI.Foundation.GeometryPointPropagationParameter

Namespace: AGI.Foundation.Geometry
Assembly: AGI.Foundation.Models (in AGI.Foundation.Models.dll) Version: 24.3.420.0 (24.3.420.0)

Syntax

C++

Copy

public sealed class PointPropagationParameter : Point, 
	IPartialDifferentiable, IEquatableDefinition

Public NotInheritable Class PointPropagationParameter
	Inherits Point
	Implements IPartialDifferentiable, IEquatableDefinition

public ref class PointPropagationParameter sealed : public Point, 
	IPartialDifferentiable, IEquatableDefinition

[<SealedAttribute>]
type PointPropagationParameter =  
    class
        inherit Point
        interface IPartialDifferentiable
        interface IEquatableDefinition
    end

The PointPropagationParameter type exposes the following members.

Constructors

	Name	Description
	PointPropagationParameter	Initializes a new instance.
	PointPropagationParameter(ReferenceFrame)	Initializes a new instance with the given frame of integration.

Top

Properties

	Name	Description
	Dimension	Gets the dimension of the values produced by the object. For example, Vectors would have a dimension of three, and Scalars of one. A PartialDerivativesEvaluator created by this type will have a "RowDimension" equal to this property, and a "ColumnDimension equal to the summation of the dimensions of the independent variables that this object is dependent on.
	IntegrationFrame	Gets or sets the ReferenceFrame used to define the state during integration.
	IsFrozen	Gets a value indicating whether this object is frozen. A frozen object cannot be modified and an ObjectFrozenException will be thrown if an attempt is made to do so. (Inherited from DefinitionalObject.)
	StateParameter	Gets or sets a parameter which represents the state during propagation. In general, users should never need to explicitly set this property. It should only be set in cases where elements of a state require additional instances of a NumericalPropagator inside their implementation in order to produce their values. In such cases, it may be necessary to distinguish between the state of the exterior propagator and the state of the interior propagator. In these cases, it is up to the user to ensure that both the state and all of its elements are configured with the same parameter. Otherwise, the state will throw an exception when creating its propagator.

Top

Methods

	Name	Description
	Clone	Clones this object using the specified context. (Overrides DefinitionalObjectClone(CopyContext).)
	ConfigureIndicesOnEvaluator	This is called by PropagationStateElement instances using PointPropagationParameter so that the element can update the indices used to identify the individual values corresponding to this point in the state during evaluation. In general, this should only be called from within the GetConverter(EvaluatorGroup, MotionInt32) method when configuring the indices provided by the NumericalPropagatorDefinition. The EvaluatorGroup will create an evaluator based on the StateParameter and the IntegrationFrame and cache it for future calls. This method updates the instance variables for the indices so that it will reflect the point's elements within the state during evaluation. In general, this breaks the "Evaluator Pattern" by altering data on an evaluator after construction. However, so long as it is done once and only once prior to any evaluation this is deemed as following the "Evaluator Pattern" which stipulates that an evaluator should always return the same value for a given time.
	CreateVectorAcceleration	Constructs a vector which represents the second derivative of this point's position. (Inherited from Point.)
	CreateVectorDerivative	Constructs a vector which represents the requested order of the derivative of this point's position. (Inherited from Point.)
	CreateVectorVelocity	Constructs a vector which represents the derivative of this point's position. (Overrides PointCreateVectorVelocity(ReferenceFrame).)
	EnumerateDependencies	Enumerates the dependencies of this object by calling EnumerateT(T) for each object that this object directly depends upon. Derived classes which contain additional dependencies MUST override this method, call the base implementation, and enumerate dependencies introduced by the derived class. (Overrides DefinitionalObjectEnumerateDependencies(DependencyEnumerator).)
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Freeze	Freezes this object. Further attempts to modify it will result in an ObjectFrozenException. (Inherited from DefinitionalObject.)
	GetDefinitionHashCode	Gets a hash code representing the definition of this object. (Inherited from DefinitionalObject.)
	GetEvaluator	Gets an evaluator that can be used to find the motion of this point in its parent reference frame at a given date. Consider using the methods of GeometryTransformer instead of calling this method directly. See GetEvaluator(EvaluatorGroup) for more details. (Inherited from Point.)
	GetEvaluator(EvaluatorGroup)	Gets an evaluator that can be used to find the motion of this point in its parent reference frame based on the state provided by evaluating the evaluator produced by the StateParameter. Consider using the methods of GeometryTransformer instead of calling this method directly. See GetEvaluator(EvaluatorGroup) for more details. This type will usually not be used directly. It is instead used by PropagationNewtonianPoint behind the scenes. If this type is used, such as during the implementation of a type similar to or deriving from PropagationNewtonianPoint, always call ConfigureIndicesOnEvaluator(EvaluatorGroup, PointPropagationParameter, MotionInt32) prior to this method. (Overrides PointGetEvaluator(EvaluatorGroup).)
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetPartialDerivativesEvaluator	This type does not have derivatives or partial derivatives with respect to any object with the exception of itself. Because of that the created PartialDerivativesEvaluator has a ColumnDimension of zero if this PointPropagationParameter is not in the generalized state, and if it is in the generalized state it returns a 3x3 identity matrix.
	GetScalarElement(CartesianElement, ReferenceFrame)	Returns a Scalar representing the X, Y, Z, or Magnitude of this point. (Inherited from Point.)
	GetScalarElement(CartesianElement, ReferenceFrame, Int32)	Returns a Scalar representing the X, Y, Z, or Magnitude, or any derivative of those elements of this point. (Inherited from Point.)
	GetService	Gets the service object of the specified type. (Inherited from Point.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	IsSameDefinition	Determines if this object has the same definition as another object. (Inherited from DefinitionalObject.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Reference

AGI.Foundation.Geometry Namespace