ResidualPullCalculator.cxx: added experimental new method to handle AEOTs...

ResidualPullCalculator.cxx: added experimental new method to handle AEOTs (TrkResidualPullCalculator-01-01-00)

    * ResidualPullCalculator.cxx: added experimental new method to handle AEOTs
    * tag as TrkResidualPullCalculator-01-01-00


Former-commit-id: e7d73795cbfeb71eadb1936b2522552ef8cc62c1

Tracking/TrkTools/TrkResidualPullCalculator/src/ResidualPullCalculator.h

@@ -26,6 +26,7 @@ class AtlasDetectorID;
 namespace Trk {
 
   class MeasurementBase;
+  class AlignmentEffectsOnTrack;
 
 /** @brief AlgTool to calculate the residual and pull of a measurement and the
     related track state independently of the detector type.
@@ -65,6 +66,22 @@ public:
                         const Trk::ResidualPull::ResidualType resType,
                         const Trk::TrackState::MeasurementType) const;
 
+    /**This function returns (creates!) a Trk::ResidualPull object, which contains the values
+    * of residual and pull for the given measurement and track state, and the Alignment effects.
+    * The track state can be an unbiased one (which can be retrieved by the Trk::IUpdator),
+    * a biased one (which contains the measurement),
+    * or a truth state.
+    * The enum residualTyp must be set according to this, otherwise the pulls will be wrong.
+    * Residuals differ in all three cases; please be aware of this.
+    *
+    * This function determines the sub-detector type itself by using the ID helper*/
+    virtual const Trk::ResidualPull* residualPull(
+                          const Trk::MeasurementBase* measurement,
+                          const Trk::TrackParameters* trkPar,
+                          const Trk::ResidualPull::ResidualType resType,
+                          const Trk::TrackState::MeasurementType, 
+                          const std::vector<Trk::AlignmentEffectsOnTrack*>& ) const;
+
     /** This function is a light-weight version of the function above, designed for track fitters
      * where speed is critical. The user has to provide a std::vector of size 5, which gets
      * filled with the residuals.