Back to home page

EIC code displayed by LXR

 
 

    


Warning, /include/VecGeom/surfaces/conv/README.md is written in an unsupported language. File is not indexed.

0001 # Key Information about Surface Convertors
0002 
0003 ## Useful insights for all shapes
0004 
0005 - Quadrilateral and Triangle Masks require a certain order of the points given as parameters. The points should be entered counter-clockwise in the (xOy) plane. The normal vector of the surface will point according to the right-hand rule.
0006 
0007 ## Box
0008 A simple box.
0009 
0010 ### Variables:
0011 - *dx*  - half length of the *X* edge
0012 - *dy*  - half length of the *Y* edge
0013 - *dz*  - half length of the *Z* edge
0014 
0015 ## Parallelepiped
0016 Inclined prism having as top and bottom faces identical parallelograms parallel with the (xOy) plane, placed at +/-dz. Each parallelogram has two edges parallel with Ox and the other two inclined with the angle alpha with respect to Oy. The vector connecting the center of the bottom and top parallelograms crosses the origin of the reference frame and has theta/phi inclination with respect to the z axis in spherical coordinates.
0017 
0018 ### Variables:
0019 - *dx*    - half length of the top/bottom parallelogram edges parallel with *X*
0020 - *dy*    - half length of the projection of the top/bottom parallelogram edges over *Y*
0021 - *dz*    - half distance along *Oz* between the top and bottom planes
0022 - *theta* - polar angle of the parallelepiped axis in radians
0023 - *phi*   - azimuthal angle of the parallelepiped axis in radians
0024 - *alpha* - angle between *Oy* axis and the *Y* edge in radians.
0025 
0026 ## Tube
0027 A z-aligned tube segment having inner and outer radii, having a cut in a range of the azimuthal angle.
0028 
0029 ### Variables:
0030 - *z*    - half length along the z axis
0031 - *rmin* - inner radius
0032 - *rmax* - outer radius
0033 - *sphi* - starting phi angle of the segment in radians
0034 - *dphi* - delta angle of the segment in radians, the interval which contains the shape.
0035 
0036 ## Cone
0037 A z-aligned cone segment having inner and outer conical surfaces, having a cut in a range of the azimuthal angle.
0038 
0039 ### Variables:
0040 - *dz*    - half length along the z axis
0041 - *rmin1* - inner radius at *-dz*
0042 - *rmax1* - outer radius at *-dz*
0043 - *rmin2* - inner radius at *+dz*
0044 - *rmax2* - outer radius at *+dz*
0045 - *sphi*  - starting angle of the segment in radians;
0046 - *dphi*  - delta angle of the segment in radians, the interval which contains the shape.
0047 
0048 ## Trapezoid
0049 A trapezoidal inclined prism having as top and bottom faces similar trapezes parallel with the (xOy) plane, placed at +/-dz. Each trapeze has two edges parallel with Ox and the segment connecting their centers is inclined with the angle alpha with respect to Oy. The vector connecting the center of the bottom and top faces crosses the origin of the reference frame and has theta/phi inclination with respect to the z axis in spherical coordinates.
0050 
0051 ### Variables:
0052 - *dz*     - half length along the z axis
0053 - *theta*  - polar angle of the parallelepiped axis in radians
0054 - *phi*    - azimuthal angle of the parallelepiped axis in radians
0055 - *dy1*    - half length of the projection of the bottom trapeze on the y axis
0056 - *dx1*    - half length of the bottom trapeze x-parallel lower edge
0057 - *dx2*    - half length of the bottom trapeze x-parallel upper edge
0058 - *alpha1* - angle between the segment connecting the centers of the bottom trapeze parallel x edges with the y axis
0059 - *dy2*    - half length of the projection of the top trapeze on the y axis
0060 - *dx3*    - half length of the top trapeze x-parallel lower edge
0061 - *dx4*    - half length of the top trapeze x-parallel upper edge
0062 - *alpha2* - angle between the segment connecting the centers of the top trapeze parallel x edges with the y axis
0063 
0064 ### Important note
0065 The condition of validity for the trapezoids is that the bottom and top trapezes are similar (scaled). So not all combinations of parameters are valid, the following identities must hold:
0066 - dy1/dy2 = dx1/dx3 = dx2/dx4
0067 - alpha1 = alpha2
0068 The degenerated cases where one of these lengths is zero makes exception to the rule above.
0069 
0070 ## Extruded
0071 Extrusion solid created by translating and scaling a blueprint arbitrary polygon parallel with (xOy) to an arbitrary number of z positions. The blueprint polygon vertices are defined counter-clockwise in the xOy plane (as per PlanarPolygon::GetOrientation). The corresponding polygon vertices between any two consecutive z sections are connected with lines.
0072 
0073 ### Variables:
0074 - *nvertices* - number of vertices of the blueprint polygon
0075 - *vertices*  - (x,y) coordinates of each vertex of the blueprint polygon;
0076 - *nsections* - number of z sections;
0077 - *sections*  - origin vector and scaling factor for each section;
0078 
0079 ## Trd
0080 A simple right trapezoid prism having top and bottom rectangular faces parallel with (xOy).
0081 
0082 ### Variables:
0083 - *x1* - half length of the *X* edge at -dz
0084 - *x2* - half length of the *X* edge at +dz
0085 - *y1* - half length of the *Y* edge at -dz
0086 - *y2* - half length of the *Y* edge at +dz
0087 - *z*  - half length along *Z*
0088 
0089 ## Polyhedron
0090 A z-connected series of right prisms. The (xOy)-parallel faces are segments in a defined phi range of regular polygons having N edges. For each z section of cut of the shape, the polygon extends between an inner and an outer radii, i.e. the outer polygon has an inner hole. The radii of the outer and inned *inscribed* circles are given as parameters per section. The corresponding inner and outer vertices at each section are connected with straight lines.
0091 
0092 ### Variables:
0093 - *phiStart*    - starting angle in radians
0094 - *phiDelta*    - delta angle in radians, the interval which contains the shape
0095 - *sideCount*   - number of sides of the polygon
0096 - *zPlaneCount* - number of different z sections
0097 - *zPlanes*     - z positions of the sections
0098 - *rMin*        - radius of the inscribed circel of the inner polygons at each section
0099 - *rMax*        - radius of the inscribed circle of the outer polygons at each section
0100 
0101 ## Tet
0102 A simple tetrahedron defined by 4 vertices.
0103 
0104 ### Variables:
0105 - *fVertex[4]* - the four vertices, each vertex being its (x,y,z) coordinates.