Skip to content

Commit edc2663

Browse files
authored
Update Track tuner documentation
- q/pt smearing update
1 parent 4c9dfba commit edc2663

File tree

1 file changed

+11
-5
lines changed

1 file changed

+11
-5
lines changed

docs/basics-usage/HelperTasks.md

Lines changed: 11 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -772,21 +772,27 @@ The `TrackTuner` can be enabled only if the `processCovarianceMc` process functi
772772
```
773773
This object can be configured through the `Configurable<std::string> trackTunerParams` in the `trackPropagation` workflow. This configuration `std::string` must define the following parameters:
774774
* `bool debugInfo`: flag to switch on/off some debug outputs
775+
* `bool updateTrackDCAs`: flag to switch on/off the smearing of the dcaXY, dcaZ
775776
* `bool updateTrackCovMat`: flag to enable the update of the track covariance matrix, propagating the scaling on the dca resolution
776777
* `bool updatePulls`: flag to enable the update of the track covariance matrix updating also the pulls (if `updateTrackCovMat == true`)
777-
* `std::string pathInputFile`: path to browse to find the correction file
778-
* `std::string nameInputFile`: name of the correction file
778+
* `std::string pathInputFile`: path to browse to find the correction file for the dca smearing
779+
* `std::string nameInputFile`: name of the correction file for the dca smearing
779780
* `bool isInputFileFromCCDB`: the `pathInputFile/nameInputFile` is searched in CCDB if this flag is `true`, otherwise in the local file system (debug purposes)
780781
* `bool usePvRefitCorrections`: if this flag is `true`, the track smearing is performed using mean, resolution and pulls parametrizations vs. pt of dcaXY, dcaZ calculated w.r.t. primary collision vertex refitted w/o the current track, if this was originally a PV contributor
781782
```note
782783
In pp collisions, one should use `usePvRefitCorrections == true`
783784
This is not relevant in Pb-Pb collisions.
784785
```
785-
* `bool updateCurvature`: flag to enable the update of the track curvature, i.e. `q/pt` (see note below)
786-
* `float oneOverPtCurrent` (MC) and `float oneOverPtUpgr` (data): the ratio `oneOverPtUpgr/oneOverPtCurrent` defines the scaling factor to the `q/pt` residual to smear the track pt
786+
* `std::string pathFileQoverPt`: path to browse to find the correction file for the `q/pt` smearing
787+
* `std::string nameFileQoverPt`: name of the correction file for the `q/pt` smearing
788+
* `bool updateCurvature`: flag to enable the update of the track curvature, i.e. `q/pt`, at the particle production point
789+
* `bool updateCurvatureIU`: flag to enable the update of the track curvature, i.e. `q/pt`, at the innermost update (IU) point
790+
* `float oneOverPtMC` (MC) and `float oneOverPtData` (data): the ratio `oneOverPtData/oneOverPtMC` defines the scaling factor to the `q/pt` residual to smear the track pt
787791
788792
```note
789-
The `TrackTuner` allows also to smear the `q/pt` if `updateCurvature == true`. At the moment, this is possible only via a constant factor. More realistic strategies can be implemented.
793+
* The `TrackTuner` allows also to smear the `q/pt` if only one between `updateCurvature` and `updateCurvatureIU` is `true`
794+
* By default, the variables `oneOverPtData` and `oneOverPtMC` are initialized to `-1`
795+
* If `(qOverPtMC < 0) || (qOverPtData < 0)`, the `q/pt` correction is done wuering the file from CCDB. Otherwise, the input values of `qOverPtMC` and `qOverPtData` are used to defined the factor `oneOverPtData/oneOverPtMC`, which is a constant factor flat in transverse momentum.
790796
```
791797
The string `trackTunerParams` must follow the format: `<variable_name>=<value>|<variable_name>=<value>` (see the default configuration [here](https://github.com/AliceO2Group/O2Physics/blob/master/Common/TableProducer/trackPropagation.cxx#L62) as reference).
792798

0 commit comments

Comments
 (0)