pixelCPEforDevice Namespace Reference

Classes
struct	ClusParamsT
struct	CommonParams
struct	DetParams
struct	LayerGeometryT
struct	ParamsOnDeviceT

Typedefs
using	ClusParams = ClusParamsT< MaxHitsInIter >
using	Frame = SOAFrame< float >
using	Rotation = SOARotation< float >
using	Status = SiPixelHitStatus

Functions
constexpr void	computeAnglesFromDet (DetParams const &__restrict__ detParams, float const x, float const y, float &cotalpha, float &cotbeta)
constexpr float	correction (int sizeM1, int q_f, int q_l, uint16_t upper_edge_first_pix, uint16_t lower_edge_last_pix, float lorentz_shift, float theThickness, float cot_angle, float pitch, bool first_is_big, bool last_is_big)
template<typename TrackerTraits >
constexpr void	errorFromDB (CommonParams const &__restrict__ comParams, DetParams const &__restrict__ detParams, ClusParams &cp, uint32_t ic)
template<>
constexpr void	errorFromDB< pixelTopology::Phase2 > (CommonParams const &__restrict__ comParams, DetParams const &__restrict__ detParams, ClusParams &cp, uint32_t ic)
template<typename TrackerTraits >
constexpr void	errorFromSize (CommonParams const &__restrict__ comParams, DetParams const &__restrict__ detParams, ClusParams &cp, uint32_t ic)
template<typename TrackerTraits >
constexpr void	position (CommonParams const &__restrict__ comParams, DetParams const &__restrict__ detParams, ClusParams &cp, uint32_t ic)

Variables
constexpr int	kGenErrorQBins = 5
constexpr int	kNumErrorBins = 16
constexpr int32_t	MaxHitsInIter = pixelClustering::maxHitsInIter()
constexpr float	micronsToCm = 1.0e-4f

Typedef Documentation

ClusParams

using pixelCPEforDevice::ClusParams = typedef ClusParamsT<MaxHitsInIter>

Definition at line 111 of file pixelCPEforDevice.h.

Frame

using pixelCPEforDevice::Frame = typedef SOAFrame<float>

Definition at line 29 of file pixelCPEforDevice.h.

Rotation

using pixelCPEforDevice::Rotation = typedef SOARotation<float>

Definition at line 30 of file pixelCPEforDevice.h.

Status

using pixelCPEforDevice::Status = typedef SiPixelHitStatus

Definition at line 28 of file pixelCPEforDevice.h.

Function Documentation

computeAnglesFromDet()

constexpr void pixelCPEforDevice::computeAnglesFromDet ( DetParams const &__restrict__  detParams, float const  x, float const  y, float &  cotalpha, float &  cotbeta  )

inline

Definition at line 113 of file pixelCPEforDevice.h.

References x.

Referenced by position().

                                                                                                              {
    // x,y local position on det
    auto gvx = x - detParams.x0;
    auto gvy = y - detParams.y0;
    auto gvz = -1.f / detParams.z0;
    // normalization not required as only ratio used...
    // calculate angles
    cotalpha = gvx * gvz;
    cotbeta = gvy * gvz;
  }

correction()

constexpr float pixelCPEforDevice::correction ( int  sizeM1, int  q_f, int  q_l, uint16_t  upper_edge_first_pix, uint16_t  lower_edge_last_pix, float  lorentz_shift, float  theThickness, float  cot_angle, float  pitch, bool  first_is_big, bool  last_is_big  )

inline

Parameters

q_f	Charge in the first pixel.
q_l	Charge in the last pixel.
upper_edge_first_pix	As the name says.
lower_edge_last_pix	As the name says.
lorentz_shift	L-shift at half thickness
cot_angle	cot of alpha_ or beta_
pitch	thePitchX or thePitchY
first_is_big	true if the first is big
last_is_big	true if the last is big

Definition at line 125 of file pixelCPEforDevice.h.

References funct::abs(), and nano_mu_digi_cff::float.

Referenced by position().

  {
    if (0 == sizeM1)  // size 1
      return 0;

    float w_eff = 0;
    bool simple = true;
    if (1 == sizeM1) {  // size 2
      //--- Width of the clusters minus the edge (first and last) pixels.
      //--- In the note, they are denoted x_F and x_L (and y_F and y_L)
      // assert(lower_edge_last_pix >= upper_edge_first_pix);
      auto w_inner = pitch * float(lower_edge_last_pix - upper_edge_first_pix);  // in cm

      //--- Predicted charge width from geometry
      auto w_pred = theThickness * cot_angle  // geometric correction (in cm)
                    - lorentz_shift;          // (in cm) &&& check fpix!

      w_eff = std::abs(w_pred) - w_inner;

      //--- If the observed charge width is inconsistent with the expectations
      //--- based on the track, do *not* use w_pred-w_inner.  Instead, replace
      //--- it with an *average* effective charge width, which is the average
      //--- length of the edge pixels.

      // this can produce "large" regressions for very small numeric differences
      simple = (w_eff < 0.0f) | (w_eff > pitch);
    }

    if (simple) {
      //--- Total length of the two edge pixels (first+last)
      float sum_of_edge = 2.0f;
      if (first_is_big)
        sum_of_edge += 1.0f;
      if (last_is_big)
        sum_of_edge += 1.0f;
      w_eff = pitch * 0.5f * sum_of_edge;  // ave. length of edge pixels (first+last) (cm)
    }

    //--- Finally, compute the position in this projection
    float qdiff = q_l - q_f;
    float qsum = q_l + q_f;

    //--- Temporary fix for clusters with both first and last pixel with charge = 0
    if (qsum == 0)
      qsum = 1.0f;

    return 0.5f * (qdiff / qsum) * w_eff;
  }

errorFromDB()

template<typename TrackerTraits >

constexpr void pixelCPEforDevice::errorFromDB ( CommonParams const &__restrict__  comParams, DetParams const &__restrict__  detParams, ClusParams &  cp, uint32_t  ic  )

inline

Definition at line 341 of file pixelCPEforDevice.h.

References newFWLiteAna::bin, f, nano_mu_digi_cff::float, kGenErrorQBins, kNumErrorBins, SiStripPI::min, fftjetcommon_cfi::sx, fftjetcommon_cfi::sy, and x.

                                                 {
    // Edge cluster errors
    cp.xerr[ic] = 0.0050f;
    cp.yerr[ic] = 0.0085f;

    auto sx = cp.maxRow[ic] - cp.minRow[ic];
    auto sy = cp.maxCol[ic] - cp.minCol[ic];

    // is edgy ?  (size is set negative: see above)
    bool isEdgeX = cp.xsize[ic] < 1;
    bool isEdgeY = cp.ysize[ic] < 1;
    // is one and big?
    bool isOneX = (0 == sx);
    bool isOneY = (0 == sy);
    bool isBigX = TrackerTraits::isBigPixX(cp.minRow[ic]);
    bool isBigY = TrackerTraits::isBigPixY(cp.minCol[ic]);

    auto ch = cp.charge[ic];
    auto bin = 0;
    for (; bin < kGenErrorQBins - 1; ++bin)
      // find first bin which minimum charge exceeds cluster charge
      if (ch < detParams.minCh[bin + 1])
        break;

    // in detParams qBins are reversed bin0 -> smallest charge, bin4-> largest charge
    // whereas in CondFormats/SiPixelTransient/src/SiPixelGenError.cc it is the opposite
    // so we reverse the bin here -> kGenErrorQBins - 1 - bin
    cp.status[ic].qBin = kGenErrorQBins - 1 - bin;
    cp.status[ic].isOneX = isOneX;
    cp.status[ic].isBigX = (isOneX & isBigX) | isEdgeX;
    cp.status[ic].isOneY = isOneY;
    cp.status[ic].isBigY = (isOneY & isBigY) | isEdgeY;

    auto xoff = -float(TrackerTraits::xOffset) * comParams.thePitchX;
    int low_value = 0;
    int high_value = kNumErrorBins - 1;
    int bin_value = float(kNumErrorBins) * (cp.xpos[ic] + xoff) / (2 * xoff);
    // return estimated bin value truncated to [0, 15]
    int jx = std::clamp(bin_value, low_value, high_value);

    auto toCM = [](uint8_t x) { return float(x) * 1.e-4f; };

    if (not isEdgeX) {
      cp.xerr[ic] = isOneX ? toCM(isBigX ? detParams.sx2 : detParams.sigmax1[jx])
                           : detParams.xfact[bin] * toCM(detParams.sigmax[jx]);
    }

    auto ey = cp.ysize[ic] > 8 ? detParams.sigmay[std::min(cp.ysize[ic] - 9, 15)] : detParams.sy1;
    if (not isEdgeY) {
      cp.yerr[ic] = isOneY ? toCM(isBigY ? detParams.sy2 : detParams.sy1) : detParams.yfact[bin] * toCM(ey);
    }
  }

errorFromDB< pixelTopology::Phase2 >()

template<>

constexpr void pixelCPEforDevice::errorFromDB< pixelTopology::Phase2 > ( CommonParams const &__restrict__  comParams, DetParams const &__restrict__  detParams, ClusParams &  cp, uint32_t  ic  )

inline

Definition at line 399 of file pixelCPEforDevice.h.

References CommonMethods::cp().

                                                                        {
    errorFromSize<pixelTopology::Phase2>(comParams, detParams, cp, ic);
  }

errorFromSize()

template<typename TrackerTraits >

constexpr void pixelCPEforDevice::errorFromSize ( CommonParams const &__restrict__  comParams, DetParams const &__restrict__  detParams, ClusParams &  cp, uint32_t  ic  )

inline

Definition at line 283 of file pixelCPEforDevice.h.

References ALPAKA_ACCELERATOR_NAMESPACE::brokenline::constexpr(), fftjetcommon_cfi::sx, fftjetcommon_cfi::sy, HLT_2024v13_cff::xerr_barrel_l1, HLT_2024v13_cff::xerr_barrel_l1_def, HLT_2024v13_cff::xerr_barrel_ln, HLT_2024v13_cff::xerr_barrel_ln_def, HLT_2024v13_cff::xerr_endcap, HLT_2024v13_cff::xerr_endcap_def, HLT_2024v13_cff::yerr_barrel_l1, HLT_2024v13_cff::yerr_barrel_l1_def, HLT_2024v13_cff::yerr_barrel_ln, HLT_2024v13_cff::yerr_barrel_ln_def, HLT_2024v13_cff::yerr_endcap, and HLT_2024v13_cff::yerr_endcap_def.

                                                   {
    // Edge cluster errors
    cp.xerr[ic] = 0.0050;
    cp.yerr[ic] = 0.0085;

    // FIXME these are errors form Run1
    float xerr_barrel_l1_def = TrackerTraits::xerr_barrel_l1_def;
    float yerr_barrel_l1_def = TrackerTraits::yerr_barrel_l1_def;
    float xerr_barrel_ln_def = TrackerTraits::xerr_barrel_ln_def;
    float yerr_barrel_ln_def = TrackerTraits::yerr_barrel_ln_def;
    float xerr_endcap_def = TrackerTraits::xerr_endcap_def;
    float yerr_endcap_def = TrackerTraits::yerr_endcap_def;

    constexpr float xerr_barrel_l1[] = {0.00115, 0.00120, 0.00088};  //TODO MOVE THESE SOMEWHERE ELSE
    constexpr float yerr_barrel_l1[] = {
        0.00375, 0.00230, 0.00250, 0.00250, 0.00230, 0.00230, 0.00210, 0.00210, 0.00240};
    constexpr float xerr_barrel_ln[] = {0.00115, 0.00120, 0.00088};
    constexpr float yerr_barrel_ln[] = {
        0.00375, 0.00230, 0.00250, 0.00250, 0.00230, 0.00230, 0.00210, 0.00210, 0.00240};
    constexpr float xerr_endcap[] = {0.0020, 0.0020};
    constexpr float yerr_endcap[] = {0.00210};

    auto sx = cp.maxRow[ic] - cp.minRow[ic];
    auto sy = cp.maxCol[ic] - cp.minCol[ic];

    // is edgy ?
    bool isEdgeX = cp.xsize[ic] < 1;
    bool isEdgeY = cp.ysize[ic] < 1;

    // is one and big?
    bool isBig1X = ((0 == sx) && TrackerTraits::isBigPixX(cp.minRow[ic]));
    bool isBig1Y = ((0 == sy) && TrackerTraits::isBigPixY(cp.minCol[ic]));

    if (!isEdgeX && !isBig1X) {
      if (not detParams.isBarrel) {
        cp.xerr[ic] = sx < std::size(xerr_endcap) ? xerr_endcap[sx] : xerr_endcap_def;
      } else if (detParams.layer == 1) {
        cp.xerr[ic] = sx < std::size(xerr_barrel_l1) ? xerr_barrel_l1[sx] : xerr_barrel_l1_def;
      } else {
        cp.xerr[ic] = sx < std::size(xerr_barrel_ln) ? xerr_barrel_ln[sx] : xerr_barrel_ln_def;
      }
    }

    if (!isEdgeY && !isBig1Y) {
      if (not detParams.isBarrel) {
        cp.yerr[ic] = sy < std::size(yerr_endcap) ? yerr_endcap[sy] : yerr_endcap_def;
      } else if (detParams.layer == 1) {
        cp.yerr[ic] = sy < std::size(yerr_barrel_l1) ? yerr_barrel_l1[sy] : yerr_barrel_l1_def;
      } else {
        cp.yerr[ic] = sy < std::size(yerr_barrel_ln) ? yerr_barrel_ln[sy] : yerr_barrel_ln_def;
      }
    }
  }

position()

template<typename TrackerTraits >

constexpr void pixelCPEforDevice::position ( CommonParams const &__restrict__  comParams, DetParams const &__restrict__  detParams, ClusParams &  cp, uint32_t  ic  )

inline

Definition at line 185 of file pixelCPEforDevice.h.

References funct::abs(), cms::cuda::assert(), computeAnglesFromDet(), ALPAKA_ACCELERATOR_NAMESPACE::brokenline::constexpr(), correction(), f, nano_mu_digi_cff::float, createfilelist::int, reco_skim_cfg_mod::maxSize, SiStripPI::min, Calorimetry_cff::thickness, xsize, and ysize.

                                              {
    constexpr int maxSize = TrackerTraits::maxSizeCluster;
    //--- Upper Right corner of Lower Left pixel -- in measurement frame
    uint16_t llx = cp.minRow[ic] + 1;
    uint16_t lly = cp.minCol[ic] + 1;

    //--- Lower Left corner of Upper Right pixel -- in measurement frame
    uint16_t urx = cp.maxRow[ic];
    uint16_t ury = cp.maxCol[ic];

    uint16_t llxl = llx, llyl = lly, urxl = urx, uryl = ury;

    llxl = TrackerTraits::localX(llx);
    llyl = TrackerTraits::localY(lly);
    urxl = TrackerTraits::localX(urx);
    uryl = TrackerTraits::localY(ury);

    auto mx = llxl + urxl;
    auto my = llyl + uryl;

    int xsize = int(urxl) + 2 - int(llxl);
    int ysize = int(uryl) + 2 - int(llyl);
    assert(xsize >= 0);  // 0 if bixpix...
    assert(ysize >= 0);

    if (TrackerTraits::isBigPixX(cp.minRow[ic]))
      ++xsize;
    if (TrackerTraits::isBigPixX(cp.maxRow[ic]))
      ++xsize;
    if (TrackerTraits::isBigPixY(cp.minCol[ic]))
      ++ysize;
    if (TrackerTraits::isBigPixY(cp.maxCol[ic]))
      ++ysize;

    int unbalanceX = 8.f * std::abs(float(cp.q_f_X[ic] - cp.q_l_X[ic])) / float(cp.q_f_X[ic] + cp.q_l_X[ic]);
    int unbalanceY = 8.f * std::abs(float(cp.q_f_Y[ic] - cp.q_l_Y[ic])) / float(cp.q_f_Y[ic] + cp.q_l_Y[ic]);

    xsize = 8 * xsize - unbalanceX;
    ysize = 8 * ysize - unbalanceY;

    cp.xsize[ic] = std::min(xsize, maxSize);
    cp.ysize[ic] = std::min(ysize, maxSize);

    if (cp.minRow[ic] == 0 || cp.maxRow[ic] == uint32_t(detParams.nRows - 1))
      cp.xsize[ic] = -cp.xsize[ic];

    if (cp.minCol[ic] == 0 || cp.maxCol[ic] == uint32_t(detParams.nCols - 1))
      cp.ysize[ic] = -cp.ysize[ic];

    // Compute the position relative to the center of the module, taking into account the corrections for
    // the Phase 1 big pixels, the module pitch, and the Lorentz shift.
    // Use an explicit FMA instruction instead of simply (position * pitch + shift) to make sure that
    // different compiler optimizations do not produce different code on different architectures.
    float xPos = std::fmaf(0.5f * ((float)mx - (float)detParams.nRows) - TrackerTraits::bigPixXCorrection,
                           comParams.thePitchX,
                           detParams.shiftX);
    float yPos = std::fmaf(0.5f * ((float)my - (float)detParams.nCols) - TrackerTraits::bigPixYCorrection,
                           comParams.thePitchY,
                           detParams.shiftY);

    float cotalpha = 0, cotbeta = 0;

    computeAnglesFromDet(detParams, xPos, yPos, cotalpha, cotbeta);

    auto thickness = detParams.isBarrel ? comParams.theThicknessB : comParams.theThicknessE;

    auto xCorr = correction(cp.maxRow[ic] - cp.minRow[ic],
                            cp.q_f_X[ic],
                            cp.q_l_X[ic],
                            llxl,
                            urxl,
                            detParams.chargeWidthX,  // lorentz shift in cm
                            thickness,
                            cotalpha,
                            comParams.thePitchX,
                            TrackerTraits::isBigPixX(cp.minRow[ic]),
                            TrackerTraits::isBigPixX(cp.maxRow[ic]));

    auto yCorr = correction(cp.maxCol[ic] - cp.minCol[ic],
                            cp.q_f_Y[ic],
                            cp.q_l_Y[ic],
                            llyl,
                            uryl,
                            detParams.chargeWidthY,  // lorentz shift in cm
                            thickness,
                            cotbeta,
                            comParams.thePitchY,
                            TrackerTraits::isBigPixY(cp.minCol[ic]),
                            TrackerTraits::isBigPixY(cp.maxCol[ic]));

    cp.xpos[ic] = xPos + xCorr;
    cp.ypos[ic] = yPos + yCorr;
  }

Variable Documentation

kGenErrorQBins

constexpr int pixelCPEforDevice::kGenErrorQBins = 5

Definition at line 22 of file pixelCPEforDevice.h.

Referenced by errorFromDB(), and PixelCPEFastParamsHost< TrackerTraits >::fillParamsForDevice().

kNumErrorBins

constexpr int pixelCPEforDevice::kNumErrorBins = 16

Definition at line 24 of file pixelCPEforDevice.h.

Referenced by errorFromDB(), and PixelCPEFastParamsHost< TrackerTraits >::fillParamsForDevice().

MaxHitsInIter

constexpr int32_t pixelCPEforDevice::MaxHitsInIter = pixelClustering::maxHitsInIter()

Definition at line 110 of file pixelCPEforDevice.h.

Referenced by gpuPixelRecHits::__attribute__(), and ALPAKA_ACCELERATOR_NAMESPACE::pixelRecHits::GetHits< TrackerTraits >::operator()().

micronsToCm

constexpr float pixelCPEforDevice::micronsToCm = 1.0e-4f

Definition at line 26 of file pixelCPEforDevice.h.

Referenced by PixelCPEClusterRepair::callTempReco1D(), PixelCPEClusterRepair::callTempReco2D(), PixelCPEFast< TrackerTraits >::errorFromTemplates(), PixelCPEFastParamsHost< TrackerTraits >::errorFromTemplates(), PixelCPEGenericBase::initializeLocalErrorVariables(), PixelCPEClusterRepair::localError(), PixelCPETemplateReco::localError(), PixelCPEGeneric::localPosition(), and PixelCPETemplateReco::localPosition().