1 #ifndef SimTK_SimTKCOMMON_MEASURE_H_ 2 #define SimTK_SimTKCOMMON_MEASURE_H_ 64 #define SimTK_MEASURE_HANDLE_PREAMBLE_BASE(MH,PH) \ 65 class Implementation; \ 66 explicit MH(Implementation* imp) : PH(imp) {} \ 67 MH(SimTK::Subsystem& sub, Implementation* imp, \ 68 const SimTK::AbstractMeasure::SetHandle& sh) \ 70 MH& operator=(const MH& src) {PH::operator=(src); return *this;}\ 71 MH& shallowAssign(const MH& src) {PH::shallowAssign(src); return *this;}\ 72 MH& deepAssign(const MH& src) {PH::deepAssign(src); return *this;} 78 #define SimTK_MEASURE_HANDLE_PREAMBLE(MH,PH) \ 79 SimTK_MEASURE_HANDLE_PREAMBLE_BASE(MH,PH) \ 80 MH() : PH(new Implementation()) {} \ 81 explicit MH(SimTK::Subsystem& sub) \ 82 : PH(sub,new Implementation(), typename PH::SetHandle()) {} 88 #define SimTK_MEASURE_HANDLE_PREAMBLE_ABSTRACT(MH,PH) \ 89 SimTK_MEASURE_HANDLE_PREAMBLE_BASE(MH,PH) \ 111 #define SimTK_MEASURE_HANDLE_POSTSCRIPT(MH,PH) \ 112 static bool isA(const SimTK::AbstractMeasure& m) \ 113 { return dynamic_cast<const Implementation*>(&m.getImpl()) != 0; } \ 114 static const MH& getAs(const SimTK::AbstractMeasure& m) \ 115 { assert(isA(m)); return static_cast<const MH&>(m); } \ 116 static MH& updAs(SimTK::AbstractMeasure& m) \ 117 { assert(isA(m)); return static_cast<MH&>(m); } \ 118 const Implementation& getImpl() const \ 119 { return SimTK_DYNAMIC_CAST_DEBUG<const Implementation&> \ 120 (SimTK::AbstractMeasure::getImpl());} \ 121 Implementation& updImpl() \ 122 { return SimTK_DYNAMIC_CAST_DEBUG<Implementation&> \ 123 (SimTK::AbstractMeasure::updImpl());} 180 {
return shallowAssign(source); }
206 int getNumTimeDerivatives()
const;
216 Stage getDependsOnStage(
int derivOrder=0)
const;
221 {
return impl && impl==other.impl;}
226 bool isInSubsystem()
const;
234 MeasureIndex getSubsystemMeasureIndex()
const;
244 int getRefCount()
const;
275 {
return getImpl().getValue(s,derivOrder); }
289 {
return getImpl().getDefaultValue(); }
357 { updImpl().
setValue(value);
return *
this; }
378 explicit Zero(
int size);
398 explicit One(
int size);
433 { getImpl().setValue(state, value); }
520 {
return getImpl().getIsPresumedValidAtDependsOnStage(); }
529 {
return getImpl().updValue(state); }
542 bool isValid(
const State& state)
const {
return getImpl().isValid(state);}
552 { getImpl().markAsNotValid(state); }
558 { updValue(state) = value; markAsValid(state); }
603 ( this->getSubsystem().isSameSubsystem(left.
getSubsystem())
604 && this->getSubsystem().isSameSubsystem(right.
getSubsystem()),
605 "Measure_<T>::Plus::ctor()",
606 "Arguments must be in the same Subsystem as this Measure.");
628 ( this->getSubsystem().isSameSubsystem(left.
getSubsystem())
629 && this->getSubsystem().isSameSubsystem(right.
getSubsystem()),
630 "Measure_<T>::Minus::ctor()",
631 "Arguments must be in the same Subsystem as this Measure.");
653 (this->getSubsystem().isSameSubsystem(operand.
getSubsystem()),
654 "Measure_<T>::Scale::ctor()",
655 "Argument must be in the same Subsystem as this Measure.");
660 {
return getImpl().getOperandMeasure(); }
688 const T& initAlloc=T(0))
695 {
return getImpl().setValue(s, value); }
700 {
return getImpl().getDerivativeMeasure(); }
704 {
return getImpl().getInitialConditionMeasure(); }
759 {
return getImpl().isUsingApproximation(); }
764 {
return getImpl().getOperandMeasure(); }
776 { updImpl().setForceUseApproximation(mustApproximate); }
783 {
return getImpl().getForceUseApproximation(); }
866 {
return getImpl().getTimeOfExtremeValue(state); }
869 {
return getImpl().setValue(s, value); }
872 {
return getImpl().getOperandMeasure(); }
887 : Super(sub, operand, Super::
Minimum) {}
897 : Super(sub, operand, Super::
Maximum) {}
907 : Super(sub, operand, Super::
MaxAbs) {}
918 : Super(sub, operand, Super::
MinAbs) {}
1013 { updImpl().
setDelay(delay);
return *
this; }
1017 {
return getImpl().getUseLinearInterpolationOnly(); }
1021 {
return getImpl().getCanUseCurrentValue(); }
1025 {
return getImpl().getSourceMeasure(); }
1030 {
return getImpl().getDelay(); }
1063 void setValue(
State& s,
const T& value)
const;
1066 void sample(
State& s)
const;
1079 #endif // SimTK_SimTKCOMMON_MEASURE_H_ const Measure_< T > & getDerivativeMeasure() const
Get the integrand (derivative) measure for this integral.
Definition: Measure.h:698
Definition: MeasureImplementation.h:2031
Definition: MeasureImplementation.h:613
A Subsystem is expected to be part of a larger System and to have interdependencies with other subsys...
Definition: Subsystem.h:55
Constant(const T &value)
Create a constant measure that is not part of any Subsystem, and provide the constant value...
Definition: Measure.h:345
Plus(Subsystem &sub, const Measure_< T > &left, const Measure_< T > &right)
Definition: Measure.h:599
#define SimTK_SimTKCOMMON_EXPORT
Definition: SimTKcommon/include/SimTKcommon/internal/common.h:218
Variable(Subsystem &sub, Stage invalidates, const T &defaultValue)
Definition: Measure.h:427
SimTK_DEFINE_UNIQUE_INDEX_TYPE(AssemblyConditionIndex)
bool isUsingApproximation() const
Test whether the derivative returned as the value of this measure is being estimated numerically...
Definition: Measure.h:758
Integrate & setDerivativeMeasure(const Measure_< T > &d)
Definition: Measure.h:706
Extreme & setOperation(Operation op)
Set the operation to be performed.
Definition: Measure.h:854
This is the top-level SimTK namespace into which all SimTK names are placed to avoid collision with o...
Definition: Assembler.h:37
Definition: Measure.h:840
bool getCanUseCurrentValue() const
Return the value of the "can use current value" flag.
Definition: Measure.h:1020
This creates a Measure whose value is a discrete State variable of any type T.
Definition: Measure.h:420
Result & setIsPresumedValidAtDependsOnStage(bool presume)
Normally a Result measure's value is not considered valid unless we are notified explicitly that it i...
Definition: Measure.h:514
This class is basically a glorified enumerated type, type-safe and range checked but permitting conve...
Definition: Stage.h:50
const Measure_< T > & getSourceMeasure() const
Obtain a reference to the source Measure.
Definition: Measure.h:1024
Extreme(Subsystem &sub, const Measure_< T > &operand, Operation op=MaxAbs)
Default behavior for the Extreme measure is to find the operand's value that is of maximum absolute v...
Definition: Measure.h:849
Track the value of the operand that is of maximum absolute value.
Definition: Measure.h:903
The abstract parent of all Measure Implementation classes.
Definition: MeasureImplementation.h:48
Measure_ & setDefaultValue(const T &defaultValue)
Change the default value associated with this Measure.
Definition: Measure.h:283
Definition: MeasureImplementation.h:793
This Measure is the sum of two Measures of the same type T.
Definition: Measure.h:595
void setForceUseApproximation(bool mustApproximate)
Force use of numerical approximation for the derivative, even if the operand measure can supply its o...
Definition: Measure.h:775
const T & getDefaultValue() const
Obtain a reference to the default value associated with this Measure.
Definition: Measure.h:288
const Measure_< T > & getOperandMeasure() const
Definition: Measure.h:871
Stage getInvalidatedStage() const
Get the invalidated stage for this measure's value.
Definition: Measure.h:484
This is the base class for all Measure handle classes.
Definition: Measure.h:151
This Measure operator returns the time derivative of its operand measure, or a numerical approximatio...
Definition: Measure.h:742
SimTK_Real Real
This is the default compiled-in floating point type for SimTK, either float or double.
Definition: SimTKcommon/include/SimTKcommon/internal/common.h:593
#define SimTK_ERRCHK_ALWAYS(cond, whereChecked, msg)
Definition: ExceptionMacros.h:281
This Measure tracks extreme values attained by the elements of its source operand since the last init...
Definition: Measure.h:835
(CAUTION: still under development) This is a Measure whose value at time t is the value that its sour...
Definition: Measure.h:971
bool getUseLinearInterpolationOnly() const
Return the value of the "use linear interpolation only" flag.
Definition: Measure.h:1016
void markAsNotValid(const State &state) const
Manually mark the contained value as invalid.
Definition: Measure.h:551
Track the minimum value of the operand (signed).
Definition: Measure.h:883
Result & setInvalidatedStage(Stage invalidated)
Change the invalidated stage for this measure's value, which must be strictly greater than the curren...
Definition: Measure.h:499
bool isEmptyHandle() const
Definition: Measure.h:223
This object is intended to contain all state information for a SimTK::System, except topological info...
Definition: State.h:276
This creates a Measure::Time whose value is always T(time).
Definition: Measure.h:407
Definition: MeasureImplementation.h:1026
This creates a Measure::Constant whose value is always T(0) and can't be changed. ...
Definition: Measure.h:369
Real getDelay() const
Get the amount of time by which this Measure is delaying its source Measure.
Definition: Measure.h:1029
void markAsValid(const State &state) const
Mark the current value as valid.
Definition: Measure.h:537
void setValue(const State &state, const T &value) const
Set a new value and mark it as valid.
Definition: Measure.h:557
Measure_< Real > Measure
This typedef is a convenient abbreviation for the most common kind of Measure – one that returns a s...
Definition: Measure.h:328
Implementation & updImpl()
Definition: Measure.h:241
Delay(Subsystem &sub, const Measure_< T > &source, Real delay)
Create a Measure whose output is the same as the given source measure but delayed by a time delay...
Definition: Measure.h:979
Real getTimeOfExtremeValue(const State &state) const
Return the time at which the reported extreme value first occurred.
Definition: Measure.h:865
bool isSameMeasure(const AbstractMeasure &other) const
There can be multiple handles on the same Measure.
Definition: Measure.h:220
Definition: MeasureImplementation.h:973
Definition: Measure.h:842
Minus(Subsystem &sub, const Measure_< T > &left, const Measure_< T > &right)
Definition: Measure.h:624
Definition: MeasureImplementation.h:1079
This Measure multiplies some other Measure by a Real scale factor.
Definition: Measure.h:645
bool hasImpl() const
Definition: Measure.h:242
Delay & setDelay(Real delay)
Change the delay time.
Definition: Measure.h:1012
#define SimTK_MEASURE_HANDLE_PREAMBLE(MH, PH)
Definition: Measure.h:78
const Subsystem & getSubsystem() const
Return a reference to the Subsystem that owns this Measure.
Definition: MeasureImplementation.h:233
MaxAbs(Subsystem &sub, const Measure_< T > &operand)
Definition: Measure.h:906
bool isValid(const State &state) const
Check whether the value contained in this Measure is currently valid.
Definition: Measure.h:542
This creates a Measure whose value is a Topology-stage constant of any type T.
Definition: Measure.h:339
Scale(Subsystem &sub, Real factor, const Measure_< T > &operand)
Definition: Measure.h:649
const Measure_< T > & getOperandMeasure() const
Get the operand (thing being scaled) measure for this measure.
Definition: Measure.h:659
Constant(Subsystem &sub, const T &value)
Create a constant measure with the given value and install it into the given Subsystem.
Definition: Measure.h:350
MinAbs(Subsystem &sub, const Measure_< T > &operand)
Definition: Measure.h:917
Extreme & setOperandMeasure(const Measure_< T > &s)
Definition: Measure.h:874
This creates a Measure::Constant whose value is always T(1) and can't be changed. ...
Definition: Measure.h:389
AbstractMeasure & operator=(const AbstractMeasure &source)
Shallow assignment operator results in this handle referencing the same Implementation object as does...
Definition: Measure.h:179
Definition: MeasureImplementation.h:909
#define SimTK_MEASURE_HANDLE_PREAMBLE_ABSTRACT(MH, PH)
Definition: Measure.h:88
Operation getOperation() const
Return the operation currently being performed by this measure.
Definition: Measure.h:858
void setValue(State &s, const T &value) const
Set the current value of this measure by modifying the state variables that hold the integral...
Definition: Measure.h:694
Definition: MeasureImplementation.h:1446
const Measure_< T > & getOperandMeasure() const
Get a reference to the measure that is being differentiated by this measure.
Definition: Measure.h:763
NOT IMPLEMENTED YET – This is a Measure operator which, upon occurrence of a designated event...
Definition: Measure.h:1055
Sinusoid(Subsystem &sub, const T &litude, const T &frequency, const T &phase=T(0))
Definition: Measure.h:577
Definition: Measure.h:841
The implementation for Integrate measures allocates a continuous state variable or variables from the...
Definition: MeasureImplementation.h:1148
This Measure is the difference of two Measures of the same type T.
Definition: Measure.h:620
void setValue(State &state, const T &value) const
Definition: Measure.h:432
Stage getDependsOnStage() const
Get the dependsOn stage for this measure's value.
Definition: Measure.h:482
T & updValue(const State &state) const
Obtain write access to the Measure's value in order to modify it.
Definition: Measure.h:528
Differentiate(Subsystem &subsystem, const Measure_< T > &operand)
Create a measure whose value is the time derivative of the given operand measure. ...
Definition: Measure.h:750
This measure produces a sinusoidal function of time:
Definition: Measure.h:573
const T & getValue(const State &s, int derivOrder=0) const
Retrieve the Value of this Measure or one of its time derivatives, assuming the supplied State has be...
Definition: Measure.h:274
#define SimTK_MEASURE_HANDLE_POSTSCRIPT(MH, PH)
Every measure handle class "MH" derived directly or indirectly from the abstract measure handle class...
Definition: Measure.h:111
Track the maximum value of the operand (signed).
Definition: Measure.h:893
Integrate & setInitialConditionMeasure(const Measure_< T > &ic)
Definition: Measure.h:708
This Measure holds the result of some externally-determined computation, and helps to coordinate the ...
Definition: Measure.h:455
const Implementation & getImpl() const
Definition: Measure.h:240
bool getIsPresumedValidAtDependsOnStage() const
Return the value of the "presumed valid at dependsOn stage" flag.
Definition: Measure.h:519
Maximum(Subsystem &sub, const Measure_< T > &operand)
Definition: Measure.h:896
Minimum(Subsystem &sub, const Measure_< T > &operand)
Definition: Measure.h:886
Result(Subsystem &sub, Stage dependsOn, Stage invalidated)
Create a new Result measure and add it to the indicated subsystem.
Definition: Measure.h:477
Operation
Definition: Measure.h:839
Track the value of the operand that is of minimum absolute value (not very useful).
Definition: Measure.h:914
An object of this type is used as a dummy argument to make sure the automatically-generated handle co...
Definition: Measure.h:156
Delay & setCanUseCurrentValue(bool canUseCurrentValue)
(Advanced) Allow the Delay measure to refer to the current value when estimating the delayed value...
Definition: Measure.h:1004
Definition: MeasureImplementation.h:713
Constant & setValue(const T &value)
Change the value returned by this Measure.
Definition: Measure.h:356
This is the header which should be included in user programs that would like to make use of all the S...
Includes internal headers providing declarations for the basic SimTK Core classes.
const Measure_< T > & getInitialConditionMeasure() const
Get the measure whose value is used as an initial condition for the integral at the start of an integ...
Definition: Measure.h:703
Differentiate & setOperandMeasure(const Measure_< T > &operand)
Set the measure that is to be differentiated by this measure.
Definition: Measure.h:769
bool getForceUseApproximation() const
Check the current value of the flag which forces this measure to use numerical approximation regardle...
Definition: Measure.h:782
Integrate(Subsystem &subsystem, const Measure_< T > &deriv, const Measure_< T > &ic, const T &initAlloc=T(0))
Create a new measure that will use Measure ic's value for initial conditions, and then integrate the ...
Definition: Measure.h:685
Delay & setUseLinearInterpolationOnly(bool linearOnly)
(Advanced) Restrict the Delay measure to use only linear interpolation to estimate delayed values...
Definition: Measure.h:988
Definition: MeasureImplementation.h:1306
Result & setDependsOnStage(Stage dependsOn)
Change the dependsOn stage for this measure's value, which must be strictly less than the current set...
Definition: Measure.h:492
void setValue(State &s, const T &value) const
Definition: Measure.h:868
This is the base handle class for all Measures whose value type is known, including all the Simbody b...
Definition: Measure.h:261
Delay & setSourceMeasure(const Measure_< T > &source)
Replace the source measure.
Definition: Measure.h:1008
This measure yields the time integral of a given derivative measure, initializing with an initial con...
Definition: Measure.h:675
This is a class to represent unique IDs for events in a type-safe way.