Plugin to install measurement surfaces on a generic sliced detector. More...

Detailed Description

Plugin to install measurement surfaces on a generic sliced detector.

Takes up to 13 arguments:

dimension: A property of the surface that determines whether the resulting measurement is 1-D, e.g. strips (dimension=1) or 2-D, e.g. pixels (dimension=2).
u_x, u_y, and u_z: The x, y, and z components of the u vector, usually associated with the "good" (i.e. best resolution) measurement direction.
v_x, v_y, and v_z: The x, y, and z components of the v vector, usually associated with the "bad" (i.e. worst resolution) measurement direction.
n_x, n_y, and n_z: The x, y, and z components of the vector perpendicular to the surface plane and usually pointing outwards of the detector.
o_x, o_y, and o_z: The x, y, and z components of the origin vector, used to shift the origin of the surface from where it is placed within the volume (usually in the center of a sensitive volume.

All the arguments are conveniently initialized to zero by default, therefore only the non-zero components need to be provided. For example, to use this plugin for the VertexEndcap detector, put this snippet in the relevant compact file:

<plugins>
      <plugin name="DD4hep_GenericSurfaceInstallerPlugin">
          <argument value="VertexEndcap"/>
          <argument value="dimension=2"/>
          <argument value="u_x=-1."/>
          <argument value="v_z=1."/>
          <argument value="n_y=1."/>
      </plugin>
</plugins>

The plugin assumes boxes are stacked along one of the primary axes, x,y or z The normal vector (n) must be along one of the axes (i.e. only one non-zero component). The inner/outer thicknesses are calculated according to n.

Note: Assumes module and component volumes are boxes. For Trapezoids, a fitting box is built around the trapezoid which means dx1=dx2=dx1 and dy1=dy2=dy. This is in principle fine, since we only access the thicknesses (DY in the TrackerEncapSurfacePlugin example) which is supposed to be the same.

For more information, please consult with GenericSurfaceInstaller.cpp