BmnCSCLayer.cxx

Go to the documentation of this file.

#include "BmnCSCLayer.h"
 
Int_t BmnCSCLayer::fUniqueIdL = 0;
Int_t BmnCSCLayer::fUniqueIdU = 0;
 
BmnCSCLayer::BmnCSCLayer() {
 
    Verbosity = true;
 
    LayerZoneNumber = 0;
    LayerType = LowerStripLayer;
 
    XMinLayer = 0.0;
    XMaxLayer = 10.0;
    YMinLayer = 0.0;
    YMaxLayer = 10.0;
 
    Pitch = 0.25; //cm
    AngleDeg = 14.87; //in degrees from a vertical line where a plus value is clockwise
    AngleRad = AngleDeg*Pi()/180;  //in radians
 
    StripOrder = LeftToRight;
 
    if(AngleDeg <= 0.0 && AngleDeg >= -90.0) {
        SetStripNumberingBorders(LeftBottom, RightTop);
    }
    else {
        if(AngleDeg > 0.0 && AngleDeg <= 90.0) {
            SetStripNumberingBorders(LeftTop, RightBottom);
        }
    }
 
    ClusterFindingThreshold = 0.0;
}
 
BmnCSCLayer::BmnCSCLayer(Int_t zone_number, StripLayerType layer_type,
                         Double_t xsize, Double_t ysize,
                         Double_t xorig, Double_t yorig,
                         Double_t pitch, Double_t adeg) {
 
    Verbosity = true;
 
    LayerZoneNumber = zone_number;
    LayerType = layer_type;
 
    XMinLayer = xorig;
    XMaxLayer = xorig + xsize;
    YMinLayer = yorig;
    YMaxLayer = yorig + ysize;
 
    Pitch = pitch;
    AngleDeg = adeg; //in degrees from a vertical line where a plus value is clockwise
    AngleRad = AngleDeg*Pi()/180;  //in radians
 
    StripOrder = LeftToRight;
 
    if(AngleDeg <= 0.0 && AngleDeg >= -90.0) {
        SetStripNumberingBorders(LeftBottom, RightTop);
    }
    else {
        if(AngleDeg > 0.0 && AngleDeg <= 90.0) {
            SetStripNumberingBorders(LeftTop, RightBottom);
        }
    }
 
    ClusterFindingThreshold = 0.0;
}
 
BmnCSCLayer::~BmnCSCLayer() {
 
}
 
void BmnCSCLayer::InitializeLayer() {
    Int_t NStrips = GetNStrips();
 
    //strips
    Strips.clear();
    Strips.resize(NStrips, 0.0);
 
    //strip matches
    ResetStripMatches();
    ResetStripDigitNumberMatches();
 
    //strip hits
    ResetStripHits();
 
    BmnCSCLayer::fUniqueIdL = 0;
    BmnCSCLayer::fUniqueIdU = 0;
}
 
void BmnCSCLayer::ResetLayer() {
    InitializeLayer();
}
 
Int_t BmnCSCLayer::GetNStrips() {
    Double_t xleft_layer = ConvertNormalPointToStripX(XLeftPointOfStripNumbering, YLeftPointOfStripNumbering);
    Double_t xright_layer = ConvertNormalPointToStripX(XRightPointOfStripNumbering, YRightPointOfStripNumbering);
    Double_t n_strips = (xright_layer - xleft_layer)/Pitch;
 
    if( (n_strips - (Int_t)n_strips) < 1E-10 ) {
        return (Int_t)n_strips;
    }
    else {
        return (Int_t)(n_strips+1);
    }
}
 
void BmnCSCLayer::SetPitch(Double_t pitch) {
    Pitch = pitch;
 
    InitializeLayer();
}
 
void BmnCSCLayer::SetLayerSizes(Double_t xsize, Double_t ysize, Double_t xorig, Double_t yorig) {
    XMinLayer = xorig;
    XMaxLayer = xorig + xsize;
    YMinLayer = yorig;
    YMaxLayer = yorig + ysize;
 
    InitializeLayer();
}
 
void BmnCSCLayer::SetAngleDeg(Double_t deg) {
    if(Abs(deg) <= 90.0) {
         AngleDeg = deg;
    }
    else {
        AngleDeg = 0.0;
        if(Verbosity) cerr << "WARNING: BmnCSCLayer::SetAngleDeg(): the strip angle is incorrect and has been set to zero\n";
    }
 
    AngleRad = AngleDeg*Pi()/180;
 
    InitializeLayer();
}
 
Bool_t BmnCSCLayer::SetStripNumberingBorders(Double_t x_left, Double_t y_left, Double_t x_right, Double_t y_right) {
    if(x_right < x_left) return false;
 
    XLeftPointOfStripNumbering = x_left;
    YLeftPointOfStripNumbering = y_left;
    XRightPointOfStripNumbering = x_right;
    YRightPointOfStripNumbering = y_right;
 
    ResetLayer();
 
    return true;
}
 
Bool_t BmnCSCLayer::SetStripNumberingBorders(StripBorderPoint left, StripBorderPoint right) {
 
    if( left != LeftTop && left != LeftBottom )  {
        if(Verbosity) cerr << "WARNING: SetStripNumberingBorders: left strip border point is incorrect\n";
        return false;
    }
    if( right != RightTop && right != RightBottom ) {
        if(Verbosity) cerr << "WARNING: SetStripNumberingBorders: right strip border point is incorrect\n";
        return false;
    }
 
    XLeftPointOfStripNumbering = XMinLayer;
    XRightPointOfStripNumbering = XMaxLayer;
 
    switch (left) {
        case LeftTop:
            YLeftPointOfStripNumbering = YMaxLayer;
            break;
        case LeftBottom:
            YLeftPointOfStripNumbering = YMinLayer;
            break;
        default:
            return false;
    }
 
    switch (right) {
        case RightTop:
            YRightPointOfStripNumbering = YMaxLayer;
            break;
        case RightBottom:
            YRightPointOfStripNumbering = YMinLayer;
            break;
        default:
            return false;
    }
 
    ResetLayer();
 
    return true;
}
 
Bool_t BmnCSCLayer::SetStripNumberingOrder(StripNumberingDirection strip_direction) {
    StripOrder = strip_direction;
 
    ResetLayer();
 
    return true;
}
 
Bool_t BmnCSCLayer::AddDeadZone(Int_t n_points, Double_t *x_points, Double_t *y_points) {
    DeadZoneOfStripLayer dead_zone;
    Bool_t status = dead_zone.SetDeadZone(n_points, x_points, y_points);
    if(status == true) {
        DeadZones.push_back(dead_zone);
        return true;
    }
    else {
        return false;
    }
}
 
Bool_t BmnCSCLayer::AddDeadZone(DeadZoneOfStripLayer dead_zone) {
    if(dead_zone.GetNPoints() > 2) {
        DeadZones.push_back(dead_zone);
        return true;
    }
    else {
        return false;
    }
}
 
Bool_t BmnCSCLayer::IsPointInsideDeadZones(Double_t x, Double_t y) {
    for(size_t izone = 0; izone < DeadZones.size(); ++izone) {
        if(DeadZones[izone].IsInside(x,y)) return true;
    }
 
    return false;
}
 
Bool_t BmnCSCLayer::IsPointInsideStripLayer(Double_t x, Double_t y) {
    if( x >= XMinLayer && x <= XMaxLayer &&
        y >= YMinLayer && y <= YMaxLayer &&
        !IsPointInsideDeadZones(x, y) ) return true;
    else
        return false;
}
 
Bool_t BmnCSCLayer::SetStripSignal(Int_t strip_num, Double_t signal) {
    if (strip_num >= 0 && strip_num < (Int_t)Strips.size())
    {
        Strips[strip_num] = signal;
        return true;
    }
    else return false;
}
 
Bool_t BmnCSCLayer::AddStripSignal(Int_t strip_num, Double_t signal) {
    if(strip_num >= 0 && strip_num < (Int_t)Strips.size()) {
        Strips[strip_num] += signal;
        return true;
    }
    else return false;
}
 
Double_t BmnCSCLayer::GetStripSignal(Int_t strip_num) {
    if(strip_num >= 0 && strip_num < (Int_t)Strips.size()) {
        return Strips[strip_num];
    }
    else return -1;
}
 
Bool_t BmnCSCLayer::SetStripMatch(Int_t strip_num, BmnMatch strip_match) {
    if(strip_num >= 0 && strip_num < (Int_t)StripMatches.size()) {
        StripMatches[strip_num] = strip_match;
        return true;
    }
    else return false;
}
 
Bool_t BmnCSCLayer::AddLinkToStripMatch(Int_t strip_num, Double_t weight, Int_t refID) {
    if(strip_num >= 0 && strip_num < (Int_t)StripMatches.size()) {
        StripMatches[strip_num].AddLink(weight, refID);
        return true;
    }
    else return false;
}
 
Bool_t BmnCSCLayer::SetStripDigitNumberMatch(Int_t strip_num, BmnMatch digit_num_match) {
    if(strip_num >= 0 && strip_num < (Int_t)StripDigitNumberMatches.size()) {
        StripDigitNumberMatches[strip_num] = digit_num_match;
        return true;
    }
    else return false;
}
 
Bool_t BmnCSCLayer::AddLinkToStripDigitNumberMatch(Int_t strip_num, Double_t weight, Int_t digit_num) {
    if(strip_num >= 0 && strip_num < (Int_t)StripDigitNumberMatches.size()) {
        StripDigitNumberMatches[strip_num].AddLink(weight, digit_num);
        return true;
    }
    else return false;
}
 
BmnMatch BmnCSCLayer::GetStripMatch(Int_t strip_num) {
    if(strip_num >= 0 && strip_num < (Int_t)StripMatches.size()) {
        return StripMatches[strip_num];
    }
    else return BmnMatch(); //return an empty match
}
 
BmnMatch BmnCSCLayer::GetStripDigitNumberMatch(Int_t strip_num) {
    if(strip_num >= 0 && strip_num < (Int_t)StripDigitNumberMatches.size()) {
        return StripDigitNumberMatches[strip_num];
    }
    else return BmnMatch(); //return an empty match
}
 
void BmnCSCLayer::ResetStripMatches() {
    Int_t NStrips = GetNStrips();
 
    StripMatches.clear();
    StripMatches.resize(NStrips, BmnMatch());
}
 
void BmnCSCLayer::ResetStripDigitNumberMatches() {
    Int_t NStrips = GetNStrips();
 
    StripDigitNumberMatches.clear();
    StripDigitNumberMatches.resize(NStrips, BmnMatch());
}
 
Double_t BmnCSCLayer::GetStripHitPos(Int_t num) {
    if(num >= 0 && num < (Int_t)StripHits.size()) {
        return StripHits[num];
    }
    return -1.0;
}
 
Double_t BmnCSCLayer::GetStripHitTotalSignal(Int_t num) {
    if(num >= 0 && num < (Int_t)StripHitsTotalSignal.size()) {
        return StripHitsTotalSignal[num];
    }
    return -1.0;
}
 
Double_t BmnCSCLayer::GetStripHitError(Int_t num) {
    if(num >= 0 && num < (Int_t)StripHitsErrors.size()) {
        return StripHitsErrors[num];
    }
    return -1.0;
}
 
Int_t BmnCSCLayer::GetStripHitClusterSize(Int_t num) {
    if(num >= 0 && num < (Int_t)StripHitsClusterSize.size()) {
        return StripHitsClusterSize[num];
    }
    return -1.0;
}
 
void BmnCSCLayer::ResetStripHits() {
    StripHits.clear();
    StripHitsTotalSignal.clear();
    StripHitsErrors.clear();
    StripHitsClusterSize.clear();
    StripClusters.clear();
}
 
Double_t BmnCSCLayer::ConvertNormalPointToStripX(Double_t x, Double_t y) {
    Double_t XRotationCenter;
    Double_t YRotationCenter;
 
    if(StripOrder == LeftToRight) {
        XRotationCenter =  XLeftPointOfStripNumbering;
        YRotationCenter =  YLeftPointOfStripNumbering;
    }
    else {
        if(StripOrder == RightToLeft) {
            XRotationCenter =  XRightPointOfStripNumbering;
            YRotationCenter =  YRightPointOfStripNumbering;
        }
    }
    Double_t StripX = (x - XRotationCenter)*Cos(-AngleRad) + (y - YRotationCenter)*Sin(-AngleRad) + XRotationCenter;//see
    return StripX;
}
 
Double_t BmnCSCLayer::ConvertNormalPointToStripY(Double_t x, Double_t y) {
    Double_t XRotationCenter;
    Double_t YRotationCenter;
 
    if(StripOrder == LeftToRight) {
        XRotationCenter =  XLeftPointOfStripNumbering;
        YRotationCenter =  YLeftPointOfStripNumbering;
    }
    else {
        if(StripOrder == RightToLeft) {
            XRotationCenter =  XRightPointOfStripNumbering;
            YRotationCenter =  YRightPointOfStripNumbering;
        }
    }
    Double_t StripY = -(x - XRotationCenter)*Sin(-AngleRad) + (y - YRotationCenter)*Cos(-AngleRad) + YRotationCenter;//see
    return StripY;
}
 
Double_t BmnCSCLayer::ConvertPointToStripPosition(Double_t x, Double_t y) {
    //This function returns real(double) value,
    //where integer part - number of a strip, fractional part - position on this strip (as ratio from begin)
 
    if(StripOrder == LeftToRight) {
        return (ConvertNormalPointToStripX(x, y)-XLeftPointOfStripNumbering)/Pitch;
    }
    else {
        if(StripOrder == RightToLeft) {
            return (XRightPointOfStripNumbering-ConvertNormalPointToStripX(x, y))/Pitch;
        }
    }
 
    return -1;
}
 
Double_t BmnCSCLayer::CalculateStripEquationB(Double_t strip_pos) {
 
    Double_t b;
 
    if(Abs(AngleDeg) != 90.0) { //case: y=a*x+b
        Double_t x_strip_shift = (strip_pos*Pitch)/Cos(Abs(AngleRad));
        Double_t xcoord;
 
        if(StripOrder == LeftToRight) {
            xcoord = XLeftPointOfStripNumbering + x_strip_shift;
            b = YLeftPointOfStripNumbering - Tan(PiOver2()-AngleRad)*xcoord;
        }
        else {
            if(StripOrder == RightToLeft) {
                xcoord = XRightPointOfStripNumbering-x_strip_shift;
                b = YRightPointOfStripNumbering - Tan(PiOver2()-AngleRad)*xcoord;
            }
        }
    }
    else { //case: y=b
        Double_t y_strip_shift = strip_pos*Pitch*Sin(AngleRad);
 
        if(StripOrder == LeftToRight) {
            b = YLeftPointOfStripNumbering - y_strip_shift;
        }
        else {
            if(StripOrder == RightToLeft) {
                b = YRightPointOfStripNumbering + y_strip_shift;
            }
        }
    }
 
    return b;
}
 
void BmnCSCLayer::FindClustersAndStripHits() {
 
    ResetStripHits();
 
    Double_t threshold = ClusterFindingThreshold;
    //Double_t threshold = 500.0;
 
    StripCluster cluster;
 
    Bool_t ascent = false;
    Bool_t descent = false;
 
    //Processing strips
    vector<Double_t> AnalyzableStrips = Strips;
 
    //Smooth strip signal ------------------------------------------------------
    //if(Pitch > 0.079) SmoothStripSignal(AnalyzableStrips, 1, 1, 1.0);
    //else SmoothStripSignal(AnalyzableStrips, 2, 1, 1.0);
    //--------------------------------------------------------------------------
 
    for (Int_t is = 0; is < (Int_t)AnalyzableStrips.size(); is++)
    {
        if(AnalyzableStrips.at(is) <= threshold) {
            if(descent || ascent) {
                descent = false;
                ascent = false;
                //make strip hit
                MakeStripHit(cluster, AnalyzableStrips, is);
            }
            continue;
        }
 
        if( cluster.GetClusterSize() > 0 ) {
            if( AnalyzableStrips.at(is) >= (cluster.Signals.at(cluster.GetClusterSize()-1)) ) {
                if(descent) {
                    ascent = false;
                    descent = false;
                    //make strip hit
                    MakeStripHit(cluster, AnalyzableStrips, is);
                    //continue;
                }
                ascent = true;
                descent = false;
            }
            else {
                ascent = false;
                descent = true;
            }
        }
        else {
            ascent = true;
            descent = false;
        }
 
        cluster.AddStrip(is, AnalyzableStrips.at(is));
    }
 
    if(cluster.GetClusterSize() != 0) {
        //make strip hit
        Int_t lastnum = AnalyzableStrips.size()-1;
        MakeStripHit(cluster, AnalyzableStrips, lastnum);
    }
}
 
 void BmnCSCLayer::MakeStripHit(StripCluster &cluster, vector<Double_t> &AnalyzableStrips, Int_t &curcnt) {
 
    Double_t mean_strip_position = 0.0;
    Double_t total_cluster_signal = 0.0;
    Double_t cluster_rms = 0.0;
 
    Int_t NStripsInCluster = cluster.GetClusterSize();
 
    //Share the common strip signal of two adjacent clusters in half
    if(true) {
        if(AnalyzableStrips.at(curcnt) >= AnalyzableStrips.at(curcnt-1)) {
            cluster.Signals.at(cluster.Signals.size()-1) *= 0.5;
            AnalyzableStrips.at(curcnt-1) *= 0.5;
        }
    }
 
    //mean position and cluster signal -----------------------------------------
    for(Int_t i = 0; i < NStripsInCluster; ++i) {
        Double_t strip_num = cluster.Strips.at(i);
        Double_t signal = cluster.Signals.at(i);
        total_cluster_signal += signal;
        mean_strip_position += (strip_num+0.5)*signal;
    }
    mean_strip_position /= total_cluster_signal;
 
    if(mean_strip_position < 0.0) mean_strip_position = 0.0;
    if(mean_strip_position >= AnalyzableStrips.size()) mean_strip_position = AnalyzableStrips.size() - 0.001;
    //--------------------------------------------------------------------------
 
    //cluster standard deviation (sigma): RMS ----------------------------------
//    if(NStripsInCluster > 1) {
//        for(Int_t i = 0; i < NStripsInCluster; ++i) {
//            Double_t strip_num = cluster.Strips.at(i);
//            Double_t signal = cluster.Signals.at(i);
//            Double_t residual = (strip_num+0.5) - mean_strip_position;
//            cluster_rms += residual*residual*signal;
//        }
//        cluster_rms /= total_cluster_signal;
//        cluster_rms = TMath::Sqrt(cluster_rms);
//    }
//    else {
//        cluster_rms = 1.0/TMath::Sqrt(12.0);
//    }
//
 
     // AZ, STS, method2
    Double_t sumW = total_cluster_signal;
    Double_t sumWX = 0.;
    Double_t sumWX2 = 0.;
    if(NStripsInCluster > 1) {
        for(Int_t i = 0; i < NStripsInCluster; ++i) {
           Double_t strip_num = cluster.Strips.at(i);
           Double_t signal = cluster.Signals.at(i);
           sumWX += strip_num * signal;
           sumWX2 += strip_num * strip_num * signal;
        }
        cluster_rms = (sumWX2 - sumWX * sumWX / sumW) / sumW;
    }
 
    else {
        cluster_rms = 1.0 /TMath::Sqrt(12.0);
    }
 
//     // AZ, STS, Real CF, method3
//    Double_t sumW = total_cluster_signal;
//    Double_t maxStripSignal = 0.;
//
//    if(NStripsInCluster > 0) {
//        for(Int_t i = 0; i < NStripsInCluster; ++i) {
//           Double_t signal = cluster.Signals.at(i);
//           if (signal > maxStripSignal)
//               maxStripSignal = signal;
//
//        }
//        cluster_rms = sumW / maxStripSignal;
//    }
    //--------------------------------------------------------------------------
 
    StripHits.push_back(mean_strip_position);
    StripHitsTotalSignal.push_back(total_cluster_signal);
    StripHitsErrors.push_back(cluster_rms);
    StripHitsClusterSize.push_back(NStripsInCluster);
 
    cluster.SetWidth(NStripsInCluster);
    cluster.MeanPosition = mean_strip_position;
    cluster.TotalSignal = total_cluster_signal;
    cluster.Error = cluster_rms;
    if (LayerType == LowerStripLayer) {
        cluster.SetType(0);
        cluster.SetUniqueID(fUniqueIdL++);
    } else {
        cluster.SetType(1);
        cluster.SetUniqueID(fUniqueIdU++);
    }
 
    StripClusters.push_back(cluster);
 
    //return to a previous strip
    curcnt--;
    if( curcnt < 0 ) curcnt = 0;
 
    cluster.Clear();
 }
 
 void BmnCSCLayer::SmoothStripSignal(vector<Double_t>& AnalyzableStrips, Int_t NIterations, Int_t SmoothWindow, Double_t Weight) {
     //It's the Simple Moving Average (SMA) method
    //AnalyzableStrips - analyzable strip layer (ref)
    //NIterations - number of smooth iterations (usually 1)
    //SmoothWindow - number of strips on the left-right of the current strip (usually 1)
    //Weight - weight of the current strip (usually 1.0 - for simplicity, greater - for weighted value))
 
    SmoothStrips.clear();
    Int_t NStrips = AnalyzableStrips.size();
 
    for(Int_t iteration = 0; iteration < NIterations; ++iteration) {
        SmoothStrips.clear();
        for(Int_t istrip = 0; istrip < NStrips; ++istrip) {
            Double_t mean_value = 0.0;
            for(Int_t iw = istrip-SmoothWindow; iw <= istrip+SmoothWindow; ++iw) {
                if(iw >= 0 && iw < NStrips) {
                    if(iw == istrip) mean_value += AnalyzableStrips[iw]*Weight;
                    else mean_value += AnalyzableStrips[iw];
                }
            }
            mean_value /= 2.0*SmoothWindow + Weight;
            SmoothStrips.push_back(mean_value);
        }
        AnalyzableStrips = SmoothStrips;
    }
 
    return;
}