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

Class SVTAlignmentFactory

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

Geometry for the SVT

Processes fiducial survey data into alignment shifts, and applies those shifts to a given point or volume.
Version:
1.1.0
Author:
pdavies

  • Constructor Summary

    Constructors
    Constructor
    Description
    SVTAlignmentFactory()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    static void
    applyShift(Vector3d aPos, double[] aShift, Vector3d aNominalCenter)
    Applies the given alignment shift to the given point.
    static void
    applyShift(Geant4Basic aVol, double[] aShift, Vector3d aNominalCenter)
    Applies the given alignment shift to the given volume.
    static double[][]
    calcDeltas(double[][] aDataIdeal, double[][] aDataMeasured, String aOutputFile)
    Calculates the difference between two sets of fiducial data, and writes them to the given file.
    static double[][][]
    calcDistanceDeltas(double[][][] aDataIdeal, double[][][] aDataMeasured, String aOutputFile)
    Calculates the difference between two sets of distance data, and writes them to the given file.
    static double[][]
    calcShifts(double[][] aDataIdeal, double[][] aDataMeasured, String aOutputFile)
    Calculates the alignment shifts between two sets of fiducial data, and writes them to the given file.
    static double[][][]
    calcTriangleSides(double[][] aData, double aUncertainty, String aOutputFile)
    Calculates the distances between points for each triangle in a set of fiducial data, and writes them to the given file.
    static Vector3d
    createFiducial(int aFid)
    Returns a fiducial point on a sector module in the local frame.
    static double[][]
    getDataSurveyIdeal()
     
    static double[][]
    getDataSurveyMeasured()
     
    static double[][]
    getFactoryIdealFiducialData()
    Returns locations of nominal fiducial points.
    static Vector3d
    getIdealFiducialCenter(int aRegion, int aSector)
    Returns the fiducial center for a sector module before any alignment shifts been applied.
    static Vector3d[]
    getIdealFiducials(int aRegion, int aSector)
    Returns a set of fiducial points for a sector module before any alignment shifts been applied.
    static double[][]
    getShiftedFiducialData()
    Returns locations of shifted fiducial points.
    static Vector3d[]
    getShiftedFiducials(int aRegion, int aSector)
    Returns a set of fiducial points for a sector module after the alignment shifts been applied.
    static void
    setup(DatabaseConstantProvider cp, String aInputSurveyIdeal, String aInputSurveyMeasured)
    Sets up a new geometry factory to process fiducial survey data into alignment shifts.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • SVTAlignmentFactory

      public SVTAlignmentFactory()

  • Method Details

    • setup

      public static void setup(DatabaseConstantProvider cp, String aInputSurveyIdeal, String aInputSurveyMeasured)
      Sets up a new geometry factory to process fiducial survey data into alignment shifts. Please run SVTConstants.connect() first.
      Parameters:
      cp - a DatabaseConstantProvider that has loaded the necessary tables
      aInputSurveyIdeal - a filename for the ideal data of the fiducial survey
      aInputSurveyMeasured - a filename for the measured data of the fiducial survey

    • calcShifts

      public static double[][] calcShifts(double[][] aDataIdeal, double[][] aDataMeasured, String aOutputFile)
      Calculates the alignment shifts between two sets of fiducial data, and writes them to the given file.
      Parameters:
      aDataIdeal - fiducial data
      aDataMeasured - fiducial data
      aOutputFile - a filename
      Returns:
      double[][] translations and axis-angle rotations of the form { tx, ty, tz, rx, ry, rz, ra } relative to the first data set

    • calcDeltas

      public static double[][] calcDeltas(double[][] aDataIdeal, double[][] aDataMeasured, String aOutputFile)
      Calculates the difference between two sets of fiducial data, and writes them to the given file.
      Parameters:
      aDataIdeal - first set of fiducial data
      aDataMeasured - second set of fiducial data
      aOutputFile - a filename
      Returns:
      double[][] point differences relative to the first data set

    • calcDistanceDeltas

      public static double[][][] calcDistanceDeltas(double[][][] aDataIdeal, double[][][] aDataMeasured, String aOutputFile)
      Calculates the difference between two sets of distance data, and writes them to the given file.
      Parameters:
      aDataIdeal - first set of distance data
      aDataMeasured - second set of distance data
      aOutputFile - a filename
      Returns:
      double[][][] distance differences relative to the first data set in {value,uncertainty} pairs

    • calcTriangleSides

      public static double[][][] calcTriangleSides(double[][] aData, double aUncertainty, String aOutputFile)
      Calculates the distances between points for each triangle in a set of fiducial data, and writes them to the given file.
      Parameters:
      aData - the set of fiducial data
      aUncertainty - uncertainty in the measurement of the coordinates
      aOutputFile - a filename
      Returns:
      double[][][] distances in {value,uncertainty} pairs

    • applyShift

      public static void applyShift(Vector3d aPos, double[] aShift, Vector3d aNominalCenter)
      Applies the given alignment shift to the given point.
      Parameters:
      aPos - a volume in the lab frame
      aShift - a translation and axis-angle rotation of the form { tx, ty, tz, rx, ry, rz, ra }
      aNominalCenter - a point about which to rotate the first point (for example the midpoint of the nominal fiducials)

    • applyShift

      public static void applyShift(Geant4Basic aVol, double[] aShift, Vector3d aNominalCenter)
      Applies the given alignment shift to the given volume.
      Parameters:
      aVol - a volume in the lab frame
      aShift - a translation and axis-angle rotation of the form { tx, ty, tz, rx, ry, rz, ra }
      aNominalCenter - a point about which to rotate the first point (for example the midpoint of the nominal fiducials)

    • getShiftedFiducialData

      public static double[][] getShiftedFiducialData()
      Returns locations of shifted fiducial points.
      Returns:
      double[][] an array of data in fiducial survey format.

    • getFactoryIdealFiducialData

      public static double[][] getFactoryIdealFiducialData()
      Returns locations of nominal fiducial points.
      Returns:
      double[][] an array of data in fiducial survey format.

    • getShiftedFiducials

      public static Vector3d[] getShiftedFiducials(int aRegion, int aSector) throws IllegalArgumentException
      Returns a set of fiducial points for a sector module after the alignment shifts been applied. These indices start from 0.
      Parameters:
      aRegion - an index starting from 0
      aSector - an index starting from 0
      Returns:
      Point3D[] an array of fiducial points in the order Cu+, Cu-, Pk
      Throws:
      IllegalArgumentException - indices out of bounds

    • getIdealFiducials

      public static Vector3d[] getIdealFiducials(int aRegion, int aSector) throws IllegalArgumentException
      Returns a set of fiducial points for a sector module before any alignment shifts been applied.
      Parameters:
      aRegion - an index starting from 0
      aSector - an index starting from 0
      Returns:
      Point3D[] an array of fiducial points in the order Cu+, Cu-, Pk
      Throws:
      IllegalArgumentException - indices out of bounds

    • getIdealFiducialCenter

      public static Vector3d getIdealFiducialCenter(int aRegion, int aSector) throws IllegalArgumentException
      Returns the fiducial center for a sector module before any alignment shifts been applied.
      Parameters:
      aRegion - an index starting from 0
      aSector - an index starting from 0
      Returns:
      Point3D the mean average point of the 3 fiducial points (Cu+, Cu-, Pk)
      Throws:
      IllegalArgumentException - indices out of bounds

    • createFiducial

      public static Vector3d createFiducial(int aFid) throws IllegalArgumentException
      Returns a fiducial point on a sector module in the local frame.
      Parameters:
      aFid - an index for the desired point: 0, 1, 2
      Returns:
      Point3D one of 3 fiducial points: Cu+, Cu-, Pk
      Throws:
      IllegalArgumentException - indices out of bounds

    • getDataSurveyIdeal

      public static double[][] getDataSurveyIdeal()

    • getDataSurveyMeasured

      public static double[][] getDataSurveyMeasured()