class AliAnalysisTaskLinkToMC: public AliAnalysisTaskSE

 Sets the absolute maximum distance in centimetres between the cluster
 and track reference that is allowed in the X direction.

 Sets the absolute maximum distance in centimetres between the cluster
 and track reference that is allowed in the Y direction.

 Sets the absolute maximum distance in centimetres between the cluster
 and track reference that is allowed in the Z direction.

 Returns the maximum sigma value to allow for each X and Y dimension
 between clusters and track references.

 Returns the flag indicating if the ESD track cluster on the given
 chamber must match a corresponding track reference to be valid.
 \param chamber The chamber number must be in the range 1 to 14.

 Set the flag indicating if the ESD track cluster on the given chamber
 must match a corresponding track reference to be valid.
 \param chamber The chamber number must be in the range 1 to 14.
 \param value  The new value to set to.

 Returns the flag indicating if at least one ESD track cluster on the
 given station must match a corresponding track reference to be valid.
 \param station The station number must be in the range 1..7. Station
     1 to 5 are the tracking stations while 6 is MT1 and 7 is MT2.

 Sets the flag indicating if at least one ESD track cluster on the
 given station must match a corresponding track reference to be valid.
 \param station The station number must be in the range 1..7. Station
     1 to 5 are the tracking stations while 6 is MT1 and 7 is MT2.
 \param value  The new value to set to.

 Default constructor.
 Sets input slot 0 to TChain input for ESDs, output slot 0 to TTree
 for AODs and output slot 1 to TList for the list of output histograms.
 The output histograms generated are to cross check the quality of the
 correlation and their generation can be turned off with
 AliAnalysisTaskLinkToMC::GenerateHistograms(false).

 Constructor with a task name.
 Sets input slot 0 to TChain input for ESDs, output slot 0 to TTree
 for AODs and output slot 1 to TList for the list of output histograms
 storing histograms generated to cross check the quility of the
 correlation.
 \param name  The name of the task.

 Creates the output histograms containing findable tracks, found tracks
 and fake tracks. The binning range for all histograms is 30 bins along
 the pT dimension (X direction) from 0 to 20 GeV/c and 30 bins in the
 rapidity dimension (Y direction) form -4 to -2.4 units.

 This is the top level method that performs the work of the task.
 It will fill the histograms for quality checking with the Monte
 Carlo (MC) information if they are to be generated.
 The input event is then processed which must be of type AliESDEvent.
 For all the ESD muon tracks we try to find the corresponding MC
 track and build a TMap for the mapping.
 If the AOD output event is available then it is filled with AOD
 tracks which copy the information form the ESD track and the AOD
 track label is filled with the corresponding MC track label.
 If a corresponding MC track could not be found then the AOD track
 label is filled with -1.
 Finally the checking histograms are further filled with the ESD
 information based on the ESD to MC track map.

 The terminate method will draw the histograms filled by this task if
 they were filled by setting appropriate flag with the
 GenerateHistograms(true) method, which is the default.

 This method is used to identify if a Monte Carlo (MC) track is in principle
 findable in the muon spectrometer.
 This means the MC track must be a muon particle and leave at least one track
 reference point on either chamber in each tracking station.
 \param track  The MC track to check.
 \returns  true if the track is findable by the muon spectrometer
    and false otherwise.
 \note  The definition of track find-ability does not affect the correlation
    between ESD and MC tracks nor the generation of the AOD output tracks,
    only the histogram of findable tracks is effected if it is generated at all.

 Fills the histogram containing findable tracks from the MC event information.
 Only MC tracks for which the IsFindable method returns true are added
 to the histogram.

 Fills the histograms containing found tracks and fake tracks.
 Found tracks are all those that have a ESD muon track in the ESD event
 and for which a corresponding MC track could be found.
 Fake tracks are ESD muon tracks for which no corresponding MC track
 could be matched so it is considered a fake track.
 \param links  This contains the mapping between ESD muon tracks and
    MC tracks. ESD tracks for which no MC track could be matched should
    have the "value" of the key/value pair in the mapping set to NULL.

 This code is copied from AliAnalysisTaskESDMuonFilter::ConvertESDtoAOD with
 modifications to fill the MC track label using the ESD to MC track mapping.
 \param links  This is the mapping between ESD tracks and MC tracks.

 Finds all MC tracks that correspond to their ESD tracks and creates a
 mapping between the ESD tracks and MC tracks which is filled into the
 'links' TMap object.
 \param links  This will be filled with the ESD and MC track pairs which
    have been matched. Thus, for each ESD track which is set as the TMap key,
    the corresponding MC track is identified by the TMap value. If no
    MC track could be matched then the MC track value is set to NULL.

 Calculates the compatibility between a ESD and MC track pair.
 For each cluster of the ESD track, two track references are found
 which are spatially closest to it. If the distance between the cluster
 and track reference is larger than the HardCutLimit*() parameters then
 the track reference is not used. The average coordinate is calculated
 from the two track references found and the chi-square between the cluster
 and average coordinate is calculated. If only one track reference is
 found then it is used for the calculation without taking an average.
 If no track references are found then the cluster is not matched and
 we continue to the next cluster.
 If the chi-squared value for the cluster / track reference pair is
 larger than that allowed by the SigmaCut() parameter then the cluster
 is also considered not to be matched.
 The tracks are compatible if the ESD track has a minimum number of
 clusters matched with MC track references from the MC track.
 [in] \param esdTrack  The ESD track we are trying to match.
 [in] \param mcTrack  The MC track we are trying to match the ESD track to.
 [out] \param tracksCompatible  Filled with true if the given esdTrack
     and mcTrack are compatible.
 [out] \param chi2  Filled with the total chi-squared calculated for all
     matched clusters.
 [out] \param noOfClusters  Filled with the number of clusters that were
     matched to at least one track reference.

 Returns the absolute maximum distance in centimetres between the
 cluster and track reference that is allowed in the X direction.

 Returns the absolute maximum distance in centimetres between the
 cluster and track reference that is allowed in the Y direction.

 Returns the absolute maximum distance in centimetres between the
 cluster and track reference that is allowed in the Z direction.

 Returns the minimum number of clusters that must match between the
 ESD track clusters and track references.

 Sets the minimum number of clusters that must match between the ESD
 track clusters and track references.

 Returns the minimum number of clusters that must match between the
 ESD track clusters and track references in stations 1 and 2.

 Sets the minimum number of clusters that must match between the ESD
 track clusters and track references in stations 1 and 2.

 Returns the minimum number of clusters that must match between the
 ESD track clusters and track references in stations 4 and 5.

 Sets the minimum number of clusters that must match between the ESD
 track clusters and track references in stations 4 and 5.

 Returns the flag indicating if histograms should be generated for
 checking the quality of track matching.

 Set the flag indicating if histograms should be generated for checking
 the quality of track matching.

 Returns the flag indicating if the Z coordinate is to be used for
 track matching or not.

 Set the flag indicating if the Z coordinate should be used for track
 matching.