Package org.jlab.detector.geant4.v2.SVT

Class SVTStripFactory

java.lang.Object
org.jlab.detector.geant4.v2.SVT.SVTStripFactory
public class SVTStripFactory extends Object

Geometry for the SVT

length unit: mm (3D Primitives), cm (Geant4Basic volume positions)
angle unit: deg
Conventions:
  • svt = four concentric regions / superlayers
  • region / superlayer = ring of a variable number of sectors
  • sector = pair of sensor modules and backing structure, connected and stabilised by copper and peek supports
  • module = triplet of sensors
  • sensor = silicon with etched strips in active region
  • layer = plane of sensitive strips, spanning active regions of module
  • strip = sensitive line
Version:
1.1.1
Author:
pdavies

  • Constructor Summary

    Constructors
    Constructor
    Description
    SVTStripFactory(DatabaseConstantProvider cp, boolean applyAlignmentShifts)
    Constructs a new geometry factory for sensor strips.

  • Method Summary

    Modifier and Type
    Method
    Description
    Vector3d[]
    createIdealLayerCorners(int aModule)
    Returns the corners of a sensor layer in the local frame.
    Line3d
    createIdealStrip(int aStrip, int aModule)
    Returns a sensor strip before any alignment shifts been applied.
    Vector3d[]
    createShiftedLayerCorners(int aRegion, int aSector, int aModule)
    Returns the corners of a sensor layer in the local frame after the alignment shifts have been applied.
    Line3d
    createShiftedStrip(int aRegion, int aSector, int aModule, int aStrip)
    Returns a sensor strip after the alignment shifts have been applied.
    Vector3d[]
    getIdealLayerCorners(int aLayer, int aSector)
    Returns the corners of a sensor layer in the detector frame.
    Vector3d[]
    getIdealLayerCorners(int aRegion, int aSector, int aModule)
    Returns the corners of a sensor layer in the detector frame.
    Line3d
    getIdealStrip(int aLayer, int aSector, int aStrip)
    Returns a sensor strip before any alignment shifts been applied.
    Line3d
    getIdealStrip(int aRegion, int aSector, int aModule, int aStrip)
    Returns a sensor strip before any alignment shifts been applied.
    Vector3d[]
    getLayerCorners(int aLayer, int aSector)
    Returns the corners of a sensor layer in the lab frame, depending on this factory's setup.
    Vector3d[]
    getLayerCorners(int aRegion, int aSector, int aModule)
    Returns the corners of a sensor layer in the lab frame, depending on this factory's setup.
    Line3d
    getModuleEndPoints(int aLayer, int aSector)
    Returns the end points of the module in the lab frame, depending on this factory's setup.
    Vector3d
    getModuleNormal(int aLayer, int aSector)
    Returns the normal the module in the lab frame, depending on this factory's setup.
    Vector3d[]
    getShiftedLayerCorners(int aLayer, int aSector)
    Returns the corners of a sensor layer in the lab frame after the alignment shifts have been applied.
    Vector3d[]
    getShiftedLayerCorners(int aRegion, int aSector, int aModule)
    Returns the corners of a sensor layer in the lab frame after the alignment shifts have been applied.
    Line3d
    getShiftedStrip(int aLayer, int aSector, int aStrip)
    Returns a sensor strip after the alignment shifts have been applied.
    Line3d
    getShiftedStrip(int aRegion, int aSector, int aModule, int aStrip)
    Returns a sensor strip after the alignment shifts have been applied.
    Line3d
    getStrip(int aLayer, int aSector, int aStrip)
    Returns either an ideal or shifted strip, depending on this factory's setup.
    Line3d
    getStrip(int aRegion, int aSector, int aModule, int aStrip)
    Returns either an ideal or shifted strip, depending on this factory's setup.
    boolean
    isSetApplyAlignmentShifts()
    Returns whether alignment shifts are applied.
    void
    setAlignmentShiftScale(double aScaleTranslation, double aScaleRotation)
    Sets scale factors to amplify alignment shifts for visualisation purposes.
    void
    setApplyAlignmentShifts(boolean b)
    Manually sets whether alignment shifts should be applied.
    Vector3d
    transformToLab(int aLayer, int aSector, double x, double y, double z)
    Transform the (x,y,z) point from the local to the lab frame
    Vector3d
    transformToLab(int aRegion, int aSector, int aModule, Vector3d pLoc)
    Transform the pLab point from the strip to the lab frame
    Vector3d
    transformToLab(int aLayer, int aSector, Vector3d pLoc)
    Transform the pLoc point from the strip to the lab frame
    Vector3d
    transformToLocal(int aLayer, int aSector, double x, double y, double z)
    Transform the (x,y,z) point from the lab to the local frame
    Vector3d
    transformToLocal(int aRegion, int aSector, int aModule, Vector3d pLab)
    Transform the pLab point from the lab to the local frame
    Vector3d
    transformToLocal(int aLayer, int aSector, Vector3d pLab)
    Transform the pLab point from the lab to the local frame

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Constructor Details

  • Method Details

    • getStrip

      public Line3d getStrip(int aLayer, int aSector, int aStrip)
      Returns either an ideal or shifted strip, depending on this factory's setup.
      Parameters:
      aLayer - an index starting from 0
      aSector - an index starting from 0
      aStrip - an index starting from 0
      Returns:
      Line3D a strip in the lab frame
      See Also:

    • getStrip

      public Line3d getStrip(int aRegion, int aSector, int aModule, int aStrip)
      Returns either an ideal or shifted strip, depending on this factory's setup.
      Parameters:
      aRegion - an index starting from 0
      aSector - an index starting from 0
      aModule - an index starting from 0
      aStrip - an index starting from 0
      Returns:
      Line3D a strip in the lab frame
      See Also:

    • getIdealStrip

      public Line3d getIdealStrip(int aLayer, int aSector, int aStrip) throws IllegalArgumentException
      Returns a sensor strip before any alignment shifts been applied.
      Parameters:
      aLayer - an index starting from 0
      aSector - an index starting from 0
      aStrip - an index starting from 0
      Returns:
      Line3D a strip in the lab frame
      Throws:
      IllegalArgumentException - indices out of bounds

    • getIdealStrip

      public Line3d getIdealStrip(int aRegion, int aSector, int aModule, int aStrip) throws IllegalArgumentException
      Returns a sensor strip before any alignment shifts been applied.
      Parameters:
      aRegion - an index starting from 0
      aSector - an index starting from 0
      aModule - an index starting from 0
      aStrip - an index starting from 0
      Returns:
      Line3D a strip in the lab frame
      Throws:
      IllegalArgumentException - indices out of bounds

    • createIdealStrip

      public Line3d createIdealStrip(int aStrip, int aModule) throws IllegalArgumentException
      Returns a sensor strip before any alignment shifts been applied.
      Parameters:
      aStrip - an index starting from 0
      aModule - an index starting from 0
      Returns:
      Line3D a strip in the local frame, relative to the upstream edge along z, and the centre along x.
      Throws:
      IllegalArgumentException - index out of bounds

    • getShiftedStrip

      public Line3d getShiftedStrip(int aLayer, int aSector, int aStrip) throws IllegalArgumentException
      Returns a sensor strip after the alignment shifts have been applied.
      Parameters:
      aLayer - an index starting from 0
      aSector - an index starting from 0
      aStrip - an index starting from 0
      Returns:
      Line3D a strip in the lab frame
      Throws:
      IllegalArgumentException - indices out of bounds

    • getShiftedStrip

      public Line3d getShiftedStrip(int aRegion, int aSector, int aModule, int aStrip)
      Returns a sensor strip after the alignment shifts have been applied.
      Parameters:
      aRegion - an index starting from 0
      aSector - an index starting from 0
      aStrip - an index starting from 0
      aModule - an index starting from 0
      Returns:
      Line3D a strip in the lab frame

    • createShiftedStrip

      public Line3d createShiftedStrip(int aRegion, int aSector, int aModule, int aStrip)
      Returns a sensor strip after the alignment shifts have been applied.
      Parameters:
      aRegion - an index starting from 0
      aSector - an index starting from 0
      aStrip - an index starting from 0
      aModule - an index starting from 0
      Returns:
      Line3D a strip in the local frame

    • getModuleNormal

      public Vector3d getModuleNormal(int aLayer, int aSector)
      Returns the normal the module in the lab frame, depending on this factory's setup.
      Parameters:
      aLayer - an index starting from 0
      aSector - an index starting from 0
      Returns:
      Vector3d unit vector, normal to the plane, pointing radially outwards
      See Also:

    • getModuleEndPoints

      public Line3d getModuleEndPoints(int aLayer, int aSector)
      Returns the end points of the module in the lab frame, depending on this factory's setup.
      Parameters:
      aLayer - an index starting from 0
      aSector - an index starting from 0
      Returns:
      Line3d going from origin to e end of modules
      See Also:

    • getLayerCorners

      public Vector3d[] getLayerCorners(int aLayer, int aSector)
      Returns the corners of a sensor layer in the lab frame, depending on this factory's setup.
      Parameters:
      aLayer - an index starting from 0
      aSector - an index starting from 0
      Returns:
      Point3D[] array of corners in order ( origin, max width, max width and max length, max length )
      See Also:

    • getLayerCorners

      public Vector3d[] getLayerCorners(int aRegion, int aSector, int aModule)
      Returns the corners of a sensor layer in the lab frame, depending on this factory's setup.
      Parameters:
      aRegion - an index starting from 0
      aSector - an index starting from 0
      aModule - an index starting from 0
      Returns:
      Point3D[] array of corners in order ( origin, max width, max width and max length, max length )
      See Also:

    • getIdealLayerCorners

      public Vector3d[] getIdealLayerCorners(int aLayer, int aSector) throws IllegalArgumentException
      Returns the corners of a sensor layer in the detector frame.
      Parameters:
      aLayer - an index starting from 0
      aSector - an index starting from 0
      Returns:
      Point3D[] array of corners in order ( origin, max width, max width and max length, max length )
      Throws:
      IllegalArgumentException - indices out of bounds

    • getIdealLayerCorners

      public Vector3d[] getIdealLayerCorners(int aRegion, int aSector, int aModule)
      Returns the corners of a sensor layer in the detector frame.
      Parameters:
      aRegion - an index starting from 0
      aSector - an index starting from 0
      aModule - an index starting from 0
      Returns:
      Point3D[] array of corners in order ( origin, max width, max width and max length, max length )

    • createIdealLayerCorners

      public Vector3d[] createIdealLayerCorners(int aModule) throws IllegalArgumentException
      Returns the corners of a sensor layer in the local frame.
      Parameters:
      aModule - an index starting from 0
      Returns:
      Point3D[] array of corners in order ( origin, max width, max width and max length, max length )
      Throws:
      IllegalArgumentException - index out of bounds

    • getShiftedLayerCorners

      public Vector3d[] getShiftedLayerCorners(int aLayer, int aSector) throws IllegalArgumentException
      Returns the corners of a sensor layer in the lab frame after the alignment shifts have been applied.
      Parameters:
      aLayer - an index starting from 0
      aSector - an index starting from 0
      Returns:
      Point3D[] array of corners in order ( origin, max width, max width and max length, max length )
      Throws:
      IllegalArgumentException - indices out of bounds

    • getShiftedLayerCorners

      public Vector3d[] getShiftedLayerCorners(int aRegion, int aSector, int aModule)
      Returns the corners of a sensor layer in the lab frame after the alignment shifts have been applied.
      Parameters:
      aRegion - an index starting from 0
      aSector - an index starting from 0
      aModule - an index starting from 0
      Returns:
      Point3D[] array of corners in order ( origin, max width, max width and max length, max length )

    • createShiftedLayerCorners

      public Vector3d[] createShiftedLayerCorners(int aRegion, int aSector, int aModule)
      Returns the corners of a sensor layer in the local frame after the alignment shifts have been applied.
      Parameters:
      aRegion - an index starting from 0
      aSector - an index starting from 0
      aModule - an index starting from 0
      Returns:
      Point3D[] array of corners in order ( origin, max width, max width and max length, max length )

    • transformToLocal

      public Vector3d transformToLocal(int aLayer, int aSector, double x, double y, double z)
      Transform the (x,y,z) point from the lab to the local frame
      Parameters:
      aLayer - an index starting from 0
      aSector - an index starting from 0
      x -
      y -
      z -
      Returns:
      Vector3d of point coordinate in the module local frame
      Throws:
      IllegalArgumentException - indices out of bounds

    • transformToLocal

      public Vector3d transformToLocal(int aLayer, int aSector, Vector3d pLab)
      Transform the pLab point from the lab to the local frame
      Parameters:
      aLayer - an index starting from 0
      aSector - an index starting from 0
      pLab - a point in the lab frame
      Returns:
      Vector3d of point coordinate in the module local frame
      Throws:
      IllegalArgumentException - indices out of bounds

    • transformToLocal

      public Vector3d transformToLocal(int aRegion, int aSector, int aModule, Vector3d pLab)
      Transform the pLab point from the lab to the local frame
      Parameters:
      aRegion - an index starting from 0
      aSector - an index starting from 0
      aModule - an index starting from 0
      pLab - a point in the lab frame
      Returns:
      Vector3d of point coordinate in the module local frame
      Throws:
      IllegalArgumentException - indices out of bounds

    • transformToLab

      public Vector3d transformToLab(int aLayer, int aSector, double x, double y, double z)
      Transform the (x,y,z) point from the local to the lab frame
      Parameters:
      aLayer - an index starting from 0
      aSector - an index starting from 0
      x -
      y -
      z -
      Returns:
      Vector3d of point coordinate in the module local frame
      Throws:
      IllegalArgumentException - indices out of bounds

    • transformToLab

      public Vector3d transformToLab(int aLayer, int aSector, Vector3d pLoc)
      Transform the pLoc point from the strip to the lab frame
      Parameters:
      aLayer - an index starting from 0
      aSector - an index starting from 0
      pLoc - a point in the lab frame
      Returns:
      Vector3d of point coordinate in the module local frame
      Throws:
      IllegalArgumentException - indices out of bounds

    • transformToLab

      public Vector3d transformToLab(int aRegion, int aSector, int aModule, Vector3d pLoc)
      Transform the pLab point from the strip to the lab frame
      Parameters:
      aRegion - an index starting from 0
      aSector - an index starting from 0
      aModule - an index starting from 0
      pLoc - a point in the local frame
      Returns:
      Vector3d of point coordinate in the module local frame
      Throws:
      IllegalArgumentException - indices out of bounds

    • setApplyAlignmentShifts

      public void setApplyAlignmentShifts(boolean b)
      Manually sets whether alignment shifts should be applied. Use this to override the setting made at time of construction.
      Parameters:
      b - true/false

    • isSetApplyAlignmentShifts

      public boolean isSetApplyAlignmentShifts()
      Returns whether alignment shifts are applied.
      Returns:
      boolean true/false

    • setAlignmentShiftScale

      public void setAlignmentShiftScale(double aScaleTranslation, double aScaleRotation)
      Sets scale factors to amplify alignment shifts for visualisation purposes.
      Parameters:
      aScaleTranslation - a scale factor for translation shifts
      aScaleRotation - a scale factor for rotation shifts