Class DCFactory

java.lang.Object

org.jlab.geom.detector.dc.DCFactory

All Implemented Interfaces:

Factory<DCDetector, DCSector, DCSuperlayer, DCLayer>, Showable

public class DCFactory
extends Object
implements Factory<DCDetector, DCSector, DCSuperlayer, DCLayer>

A Drift Chamber (DC) Factory.

Factory: DCFactory
Hierarchy: DCDetector → DCSector → DCSuperlayer → DCLayer → DriftChamberWire

The drift chambers are grouped into three regions, however this API does not support regions. Instead the drift chambers are grouped into six superlayers such that region = floor(superlayer/2). Note: The DC is not currently being constructed accurately. See midpointXOffset(int, double) for details.

Author:

jnhankins

Constructor Summary

Constructors

Constructor	Description
DCFactory()

Method Summary

Modifier and Type	Method	Description
DCDetector	createDetectorCLAS(ConstantProvider cp)	Constructs a new Detector in CLAS coordinates using the given constants.
DCDetector	createDetectorLocal(ConstantProvider cp)	Constructs a new Detector in Local coordinates using the given constants.
DCDetector	createDetectorSector(ConstantProvider cp)	Constructs a new Detector in Sector coordinates using the given constants.
DCDetector	createDetectorTilted(ConstantProvider cp)	Constructs a new Detector in Tilted coordinates using the given constants.
DCLayer	createLayer(ConstantProvider cp, int sectorId, int superlayerId, int layerId)	Constructs the specified Layer in Local coordinates using the given constants.
DCSector	createSector(ConstantProvider cp, int sectorId)	Constructs the specified Sector in Local coordinates using the given constants.
DCSuperlayer	createSuperlayer(ConstantProvider cp, int sectorId, int superlayerId)	Constructs the specified Superlayer in Local coordinates using the given constants.
DetectorTransformation	getDetectorTransform(ConstantProvider cp)
Transformation3D	getTransformation(ConstantProvider cp, int sector, int superlayer, int layer)	Returns a transformation object for given sector, superlayer and layer
String	getType()	Returns "DC Factory".
protected static double	midpointXOffset(int layer, double w_layer)	Returns the xoffset between the first guard wire of the first guard wire layer of the current superlayer and the the first sense wire of the current layer.
void	show()	Invokes System.out.println(this).
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Details

DCFactory

public DCFactory()

Method Details

createDetectorCLAS

public DCDetector createDetectorCLAS(ConstantProvider cp)

Description copied from interface: Factory

Constructs a new Detector in CLAS coordinates using the given constants.

Specified by:

createDetectorCLAS in interface Factory<DCDetector, DCSector, DCSuperlayer, DCLayer>

Parameters:

cp - the constant provider

Returns:

a detector in CLAS coordinates

createDetectorSector

public DCDetector createDetectorSector(ConstantProvider cp)

Description copied from interface: Factory

Constructs a new Detector in Sector coordinates using the given constants.

Specified by:

createDetectorSector in interface Factory<DCDetector, DCSector, DCSuperlayer, DCLayer>

Parameters:

cp - the constant provider

Returns:

a detector in Sector coordinates

createDetectorTilted

public DCDetector createDetectorTilted(ConstantProvider cp)

Description copied from interface: Factory

Constructs a new Detector in Tilted coordinates using the given constants.

Specified by:

createDetectorTilted in interface Factory<DCDetector, DCSector, DCSuperlayer, DCLayer>

Parameters:

cp - the constant provider

Returns:

a detector in Tilted coordinates

createDetectorLocal

public DCDetector createDetectorLocal(ConstantProvider cp)

Description copied from interface: Factory

Constructs a new Detector in Local coordinates using the given constants.

Specified by:

createDetectorLocal in interface Factory<DCDetector, DCSector, DCSuperlayer, DCLayer>

Parameters:

cp - the constant provider

Returns:

a detector in Local coordinates

createSector

public DCSector createSector(ConstantProvider cp,
 int sectorId)

Description copied from interface: Factory

Constructs the specified Sector in Local coordinates using the given constants.

Specified by:

createSector in interface Factory<DCDetector, DCSector, DCSuperlayer, DCLayer>

Parameters:

cp - the constant provider

sectorId - the sector id of the desired sector

Returns:

a sector in Local coordinates

createSuperlayer

public DCSuperlayer createSuperlayer(ConstantProvider cp,
 int sectorId,
 int superlayerId)

Description copied from interface: Factory

Constructs the specified Superlayer in Local coordinates using the given constants.

Specified by:

createSuperlayer in interface Factory<DCDetector, DCSector, DCSuperlayer, DCLayer>

Parameters:

cp - the constant provider

sectorId - the sector id of the desired superlayer

superlayerId - the superlayer id of the desired superlayer

Returns:

a superlayer in Local coordinates

createLayer

public DCLayer createLayer(ConstantProvider cp,
 int sectorId,
 int superlayerId,
 int layerId)

Description copied from interface: Factory

Constructs the specified Layer in Local coordinates using the given constants.

Specified by:

createLayer in interface Factory<DCDetector, DCSector, DCSuperlayer, DCLayer>

Parameters:

cp - the constant provider

sectorId - the sector id of the desired layer

superlayerId - the superlayer id of the desired layer

layerId - the layer id of the desired layer

Returns:

a layer in Local coordinates

midpointXOffset

protected static double midpointXOffset(int layer,
 double w_layer)

Returns the xoffset between the first guard wire of the first guard wire layer of the current superlayer and the the first sense wire of the current layer.

Developer's Note: The old geometry implementation produces this value incorrectly. It performs the layer staggering so that every other layer is shifted down towards the x-axis. However, it should shift every other layer up away from the x-axis. The correct and incorrect methods are both included. When ready, comment out the old method and uncomment the new method.

Parameters:

layer - the layer index within superlayer where the first sense wire layer has index 0

w_layer - the distance between midpoints of wires in the same layer in the x-axis

Returns:

the x-offset

getType

public String getType()

Returns "DC Factory".

Specified by:

getType in interface Factory<DCDetector, DCSector, DCSuperlayer, DCLayer>

Returns:

"DC Factory"

show

public void show()

Description copied from interface: Factory

Invokes System.out.println(this).

Specified by:

show in interface Factory<DCDetector, DCSector, DCSuperlayer, DCLayer>

Specified by:

show in interface Showable

toString

public String toString()

Overrides:

toString in class Object

getTransformation

public Transformation3D getTransformation(ConstantProvider cp,
 int sector,
 int superlayer,
 int layer)

Description copied from interface: Factory

Returns a transformation object for given sector, superlayer and layer

Specified by:

getTransformation in interface Factory<DCDetector, DCSector, DCSuperlayer, DCLayer>

Parameters:

cp -

sector -

superlayer -

layer -

Returns:

getDetectorTransform

public DetectorTransformation getDetectorTransform(ConstantProvider cp)

Specified by:

getDetectorTransform in interface Factory<DCDetector, DCSector, DCSuperlayer, DCLayer>