TRestDetectorReadoutPlane.cxx

 
 
#include "TRestDetectorReadoutPlane.h"
 
using namespace std;
 
ClassImp(TRestDetectorReadoutPlane);
TRestDetectorReadoutPlane::TRestDetectorReadoutPlane() { UpdateAxes(); }
 
TRestDetectorReadoutPlane::~TRestDetectorReadoutPlane() = default;
 
Int_t TRestDetectorReadoutPlane::GetNumberOfChannels() {
    Int_t nChannels = 0;
    for (size_t md = 0; md < GetNumberOfModules(); md++) {
        nChannels += fReadoutModules[md].GetNumberOfChannels();
    }
    return nChannels;
}
 
void TRestDetectorReadoutPlane::SetNormal(const TVector3& normal) {
    fNormal = normal.Unit();
    // prevent user from declaring the zero vector as normal
    if (TMath::Abs(fNormal.Mag2() - 1.0) > 1E-6) {
        // only the zero vector will have a magnitude different from 1.0 after normalization
        RESTError << "TRestDetectorReadoutPlane::SetNormal : normal vector cannot be zero." << RESTendl;
        exit(1);
    }
    UpdateAxes();
}
 
void TRestDetectorReadoutPlane::SetHeight(Double_t height) {
    if (height < 0) {
        fHeight = 0;
        RESTError << "TRestDetectorReadoutPlane::SetHeight : height cannot be negative." << RESTendl;
        exit(1);
    } else {
        fHeight = height;
    }
}
 
TRestDetectorReadoutModule* TRestDetectorReadoutPlane::GetModuleByID(Int_t modID) {
    for (size_t md = 0; md < GetNumberOfModules(); md++) {
        if (fReadoutModules[md].GetModuleID() == modID) return &fReadoutModules[md];
    }
 
    cout << "REST ERROR (GetReadoutModuleByID) : Module ID : " << modID << " was not found" << endl;
    return nullptr;
}
 
Double_t TRestDetectorReadoutPlane::GetX(Int_t modID, Int_t chID) {
    TRestDetectorReadoutModule* rModule = GetModuleByID(modID);
 
    TRestDetectorReadoutChannel* rChannel = rModule->GetChannel(chID);
 
    Double_t x = numeric_limits<Double_t>::quiet_NaN();
 
    if (rChannel->GetNumberOfPixels() == 1) {
        Double_t sX = rChannel->GetPixel(0)->GetSize().X();
        Double_t sY = rChannel->GetPixel(0)->GetSize().Y();
 
        if (sX > 2 * sY) return x;
 
        x = rModule->GetPixelCenter(chID, 0).X();
 
        return x;
    }
 
    if (rChannel->GetNumberOfPixels() > 1) {
        Int_t nPix = rChannel->GetNumberOfPixels();
 
        // We check the origin of consecutive pixels to check if it goes X or Y
        // direction. Perhaps more complex readouts need some changes here
        Double_t x1 = rChannel->GetPixel(0)->GetCenter().X();
        Double_t x2 = rChannel->GetPixel(nPix - 1)->GetCenter().X();
 
        Double_t y1 = rChannel->GetPixel(0)->GetCenter().Y();
        Double_t y2 = rChannel->GetPixel(nPix - 1)->GetCenter().Y();
 
        /*
        cout << "Pixel 0. X : " << x1 << " Y : " << y1 endl;
        cout << "Pixel N. X : " << x2 << " Y : " << y2 endl;
        */
 
        Double_t deltaX = abs(x2 - x1);
        Double_t deltaY = abs(y2 - y1);
 
        Int_t rotation = (Int_t)(std::round(rModule->GetRotation() * units("degrees")));
        if (rotation % 90 == 0) {
            if (rotation / 90 % 2 == 0)  // rotation is 0, 180, 360...
            {
                if (deltaY > deltaX) x = rModule->GetPixelCenter(chID, 0).X();
            } else  // rotation is 90, 270... We need to invert x and y
            {
                if (deltaY < deltaX) x = rModule->GetPixelCenter(chID, 0).X();
            }
        } else {
            // we choose to output x only when deltaY > deltaX under non-90 deg rotation
            // otherwise it is a y channel and should return nan
            if (deltaY > deltaX) x = rModule->GetPixelCenter(chID, 0).X();
        }
    }
 
    return x;
}
 
Double_t TRestDetectorReadoutPlane::GetY(Int_t modID, Int_t chID) {
    TRestDetectorReadoutModule* rModule = GetModuleByID(modID);
 
    TRestDetectorReadoutChannel* rChannel = rModule->GetChannel(chID);
 
    Double_t y = numeric_limits<Double_t>::quiet_NaN();
 
    if (rChannel->GetNumberOfPixels() == 1) {
        Double_t sX = rChannel->GetPixel(0)->GetSize().X();
        Double_t sY = rChannel->GetPixel(0)->GetSize().Y();
 
        if (sY > 2 * sX) return y;
 
        y = rModule->GetPixelCenter(chID, 0).Y();
 
        return y;
    }
 
    if (rChannel->GetNumberOfPixels() > 1) {
        Int_t nPix = rChannel->GetNumberOfPixels();
 
        // We check the origin of consecutive pixels to check if it goes X or Y
        // direction. Perhaps more complex readouts need some changes here
        Double_t x1 = rChannel->GetPixel(0)->GetCenter().X();
        Double_t x2 = rChannel->GetPixel(nPix - 1)->GetCenter().X();
 
        Double_t y1 = rChannel->GetPixel(0)->GetCenter().Y();
        Double_t y2 = rChannel->GetPixel(nPix - 1)->GetCenter().Y();
 
        /*
           cout << "Pix id : " << rChannel->GetPixel(0)->GetID() << " X1 : " << x1
           << endl; cout << "Pix id : " << rChannel->GetPixel(1)->GetID() << " X2 :
           " << x2 << endl; cout << "Pix id : " << rChannel->GetPixel(0)->GetID() <<
           " Y1 : " << y1 << endl; cout << "Pix id : " <<
           rChannel->GetPixel(1)->GetID() << " Y2 : " << y2 << endl;
           */
 
        Double_t deltaX = abs(x2 - x1);
        Double_t deltaY = abs(y2 - y1);
 
        Int_t rotation = (Int_t)std::round(rModule->GetRotation() * units("degrees"));
        if (rotation % 90 == 0) {
            if (rotation / 90 % 2 == 0)  // rotation is 0, 180, 360...
            {
                if (deltaY < deltaX) y = rModule->GetPixelCenter(chID, 0).Y();
            } else  // rotation is 90, 270... We need to invert x and y
            {
                if (deltaY > deltaX) y = rModule->GetPixelCenter(chID, 0).Y();
            }
        } else {
            // we choose to output y only when deltaY < deltaX under non-90 deg rotation
            // otherwise it is a x channel and should return nan
            if (deltaY < deltaX) y = rModule->GetPixelCenter(chID, 0).Y();
        }
    }
 
    return y;
}
 
Int_t TRestDetectorReadoutPlane::FindChannel(Int_t module, const TVector2& position) {
    const auto relativePosition = position - TVector2{fPosition.X(), fPosition.Y()};
 
    // TODO : check first if (modX,modY) is inside the module.
    // If not return error.
    // FindChannel will take a long time to search for the channel if it is not
    // there. It will be faster
 
    return fReadoutModules[module].FindChannel(relativePosition);
}
 
Double_t TRestDetectorReadoutPlane::GetDistanceTo(const TVector3& pos) const {
    return (pos - GetPosition()).Dot(GetNormal());
}
 
Int_t TRestDetectorReadoutPlane::isZInsideDriftVolume(Double_t z) {
    TVector3 pos = TVector3(0, 0, z);
 
    return isZInsideDriftVolume(pos);
}
 
Bool_t TRestDetectorReadoutPlane::isDaqIDInside(Int_t daqId) {
    for (size_t m = 0; m < GetNumberOfModules(); m++)
        if (fReadoutModules[m].isDaqIDInside(daqId)) return true;
 
    return false;
}
 
Int_t TRestDetectorReadoutPlane::isZInsideDriftVolume(const TVector3& position) {
    TVector3 posNew = TVector3(position.X() - fPosition.X(), position.Y() - fPosition.Y(), position.Z());
 
    Double_t distance = GetDistanceTo(posNew);
 
    if (distance > 0 && distance < fHeight) return 1;
 
    return 0;
}
 
Int_t TRestDetectorReadoutPlane::GetModuleIDFromPosition(Double_t x, Double_t y, Double_t z) {
    TVector3 pos = TVector3(x, y, z);
 
    return GetModuleIDFromPosition(pos);
}
Int_t TRestDetectorReadoutPlane::GetModuleIDFromPosition(const TVector3& pos) {
    TVector3 posNew = TVector3(pos.X() - fPosition.X(), pos.Y() - fPosition.Y(), pos.Z());
 
    Double_t distance = GetDistanceTo(posNew);
 
    if (distance > 0 && distance < fHeight) {
        for (size_t m = 0; m < GetNumberOfModules(); m++) {
            if (fReadoutModules[m].isInside(posNew.X(), posNew.Y())) {
                return fReadoutModules[m].GetModuleID();
            }
        }
    }
 
    return -1;
}
 
void TRestDetectorReadoutPlane::Print(Int_t DetailLevel) {
    if (DetailLevel >= 0) {
        RESTMetadata << "-- Readout plane : " << GetID() << RESTendl;
        RESTMetadata << "----------------------------------------------------------------" << RESTendl;
        RESTMetadata << "-- Position : X = " << fPosition.X() << " mm, "
                     << " Y : " << fPosition.Y() << " mm, Z : " << fPosition.Z() << " mm" << RESTendl;
        RESTMetadata << "-- Normal vector : X = " << fNormal.X() << " mm, "
                     << " Y : " << fNormal.Y() << " mm, Z : " << fNormal.Z() << " mm" << RESTendl;
        RESTMetadata << "-- X-axis vector : X = " << fAxisX.X() << " mm, "
                     << " Y : " << fAxisX.Y() << " mm, Z : " << fAxisX.Z() << " mm" << RESTendl;
        RESTMetadata << "-- Y-axis vector : Y = " << fAxisY.X() << " mm, Y : " << fAxisY.Y()
                     << " mm, Z : " << fAxisY.Z() << " mm" << RESTendl;
        RESTMetadata << "-- Cathode Position : X = " << GetCathodePosition().X() << " mm, "
                     << " Y : " << GetCathodePosition().Y() << " mm, Z : " << GetCathodePosition().Z()
                     << " mm" << RESTendl;
        RESTMetadata << "-- Height : " << fHeight << " mm" << RESTendl;
        RESTMetadata << "-- Charge collection : " << fChargeCollection << RESTendl;
        RESTMetadata << "-- Total modules : " << GetNumberOfModules() << RESTendl;
        RESTMetadata << "-- Total channels : " << GetNumberOfChannels() << RESTendl;
        RESTMetadata << "----------------------------------------------------------------" << RESTendl;
 
        for (size_t i = 0; i < GetNumberOfModules(); i++) {
            fReadoutModules[i].Print(DetailLevel - 1);
        }
    }
}
 
void TRestDetectorReadoutPlane::Draw() { this->GetReadoutHistogram()->Draw(); }
 
TH2Poly* TRestDetectorReadoutPlane::GetReadoutHistogram() {
    Double_t x[4];
    Double_t y[4];
 
    double xmin, xmax, ymin, ymax;
 
    GetBoundaries(xmin, xmax, ymin, ymax);
 
    TH2Poly* readoutHistogram = new TH2Poly("ReadoutHistogram", "ReadoutHistogram", xmin, xmax, ymin, ymax);
 
    for (size_t mdID = 0; mdID < this->GetNumberOfModules(); mdID++) {
        TRestDetectorReadoutModule* module = &fReadoutModules[mdID];
 
        int nChannels = module->GetNumberOfChannels();
 
        for (int ch = 0; ch < nChannels; ch++) {
            TRestDetectorReadoutChannel* channel = module->GetChannel(ch);
            Int_t nPixels = channel->GetNumberOfPixels();
 
            for (int px = 0; px < nPixels; px++) {
                for (int v = 0; v < 4; v++) {
                    x[v] = module->GetPixelVertex(ch, px, v).X();
                    y[v] = module->GetPixelVertex(ch, px, v).Y();
                }
 
                readoutHistogram->AddBin(4, x, y);
            }
        }
    }
 
    readoutHistogram->SetStats(false);
 
    return readoutHistogram;
}
 
void TRestDetectorReadoutPlane::GetBoundaries(double& xmin, double& xmax, double& ymin, double& ymax) {
    Double_t x[4];
    Double_t y[4];
 
    xmin = 1E9, xmax = -1E9, ymin = 1E9, ymax = -1E9;
 
    for (size_t mdID = 0; mdID < this->GetNumberOfModules(); mdID++) {
        TRestDetectorReadoutModule* module = &fReadoutModules[mdID];
 
        for (int v = 0; v < 4; v++) {
            x[v] = module->GetVertex(v).X();
            y[v] = module->GetVertex(v).Y();
 
            if (x[v] < xmin) xmin = x[v];
            if (y[v] < ymin) ymin = y[v];
            if (x[v] > xmax) xmax = x[v];
            if (y[v] > ymax) ymax = y[v];
        }
    }
}
 
void TRestDetectorReadoutPlane::UpdateAxes() {  // idempotent
    const TVector3 zUnit = {0, 0, 1};
    fAxisX = {1, 0, 0};
    fAxisY = {0, 1, 0};
 
    constexpr double tolerance = 1E-6;
 
    // Check if fNormal is different from (0,0,1)
    if ((fNormal - zUnit).Mag2() < tolerance) {
        // do nothing
    } else if ((fNormal + zUnit).Mag2() < tolerance) {
        // normal vector is opposite to (0,0,1), we must also flip the axes
        fAxisX = {0, -1, 0};
        fAxisY = {-1, 0, 0};
    } else {
        // Calculate the rotation axis by taking the cross product between the original normal and fNormal
        TVector3 rotationAxis = zUnit.Cross(fNormal);
 
        // Calculate the rotation angle using the dot product between the original normal and fNormal
        double rotationAngle = acos(zUnit.Dot(fNormal) / (zUnit.Mag() * fNormal.Mag()));
 
        // Rotate the axes around the rotation axis by the rotation angle
        fAxisX.Rotate(rotationAngle, rotationAxis);
        fAxisY.Rotate(rotationAngle, rotationAxis);
    }
 
    // rotate around normal by rotation angle (angle in radians)
    fAxisX.Rotate(fRotation, fNormal);
    fAxisY.Rotate(fRotation, fNormal);
 
    // verify that fNormal, fAxisX and fAxisY are orthogonal and unitary
    if (TMath::Abs(fNormal.Mag2() - 1.0) > tolerance || TMath::Abs(fAxisX.Mag2() - 1.0) > tolerance ||
        TMath::Abs(fAxisY.Mag2() - 1.0) > tolerance) {
        RESTError << "TRestDetectorReadoutPlane::UpdateAxes() : "
                  << "The normal vector, the X-axis vector and the Y-axis vector must be unitary."
                  << RESTendl;
        exit(1);
    }
    if (TMath::Abs(fNormal.Dot(fAxisX)) > tolerance || TMath::Abs(fNormal.Dot(fAxisY)) > tolerance ||
        TMath::Abs(fAxisX.Dot(fAxisY)) > tolerance) {
        RESTError << "TRestDetectorReadoutPlane::UpdateAxes() : "
                  << "The normal vector, the X-axis vector and the Y-axis vector must be orthogonal."
                  << RESTendl;
        exit(1);
    }
    // verify that the correct order of axes is being used: X cross Y = normal (and not - normal)
    if ((fAxisX.Cross(fAxisY) - fNormal).Mag2() > tolerance) {
        RESTError
            << "TRestDetectorReadoutPlane::UpdateAxes() : "
            << "The normal vector is not the cross product between the X-axis vector and the Y-axis vector."
            << RESTendl;
        exit(1);
    }
}
 
void TRestDetectorReadoutPlane::SetRotation(Double_t radians) {
    // sets fRotation modulo 2pi
    fRotation = TVector2::Phi_0_2pi(radians);
    UpdateAxes();
}
 
TVector2 TRestDetectorReadoutPlane::GetPositionInPlane(const TVector3& point) const {
    // Given a point in space, returns the position of the point in the plane using the plane's axes
    // The position is returned in the plane's local coordinates (in mm)
    return {fAxisX.Dot(point - fPosition),
            fAxisY.Dot(point - fPosition)};  // dot product between vectors is the projection
}
 
TVector3 TRestDetectorReadoutPlane::GetPositionInWorld(const TVector2& point, Double_t height) const {
    return fPosition + point.X() * fAxisX + point.Y() * fAxisY + height * fNormal;
}
 
Double_t TRestDetectorReadoutPlane::GetDistanceToPlane(const TVector3& point) const {
    return (point - fPosition).Dot(fNormal);
}
 
void TRestDetectorReadoutPlane::SetAxisX(const TVector3& axis) {
    const TVector3 axisInPlane = (axis - axis.Dot(fNormal) * fNormal).Unit();
    if (axisInPlane.Mag2() < 1E-6) {
        RESTError << "TRestDetectorReadoutPlane::SetAxisX() : "
                  << "The X-axis vector must not be parallel to the normal vector." << RESTendl;
        exit(1);
    }
 
    // compute the angle between the new axis and the old axis
    const Double_t angle = fAxisX.Angle(axisInPlane);
 
    SetRotation(fRotation - angle);
}