org.lcsim.recon.tracking.vsegment.geom

Class AbstractSegmenter

java.lang.Object

org.lcsim.recon.tracking.vsegment.geom.AbstractSegmenter

All Implemented Interfaces:

Segmenter

Direct Known Subclasses:

ForwardingSegmenter, RegionSegmenter

public abstract class AbstractSegmenter
extends Object
implements Segmenter

Base class for ForwardingSegmenters and RegionSegmenters that can be chained together to describe virtual segmentation of the entire detector.

A ForwardingSegmenter can have any number of daughter segmenters, each handling a particular part of the detector. Each daughter is either another ForwardingSegmenter, or a RegionSegmenter that does the actual Sensor object creation, and assigns an integer ID (postfix) to each Sensor within the region it is responsible for. The result is a tree of segmenters, with ForwardingSegmenters at its top and intermediate nodes, and RegionSegmenters as its leaves. SegmentationManager automatically assigns prefixes to all RegionSegmenters, making sure that SensorID they assign to Sensors are unique within the whole detector.

See org.lcsim.contrib.onoprien.tracking.ExampleDriver1 for an example of chaining several different segmenters.

Version:

$Id: AbstractSegmenter.java,v 1.1 2008/12/06 21:53:43 onoprien Exp $

Author:

D. Onoprienko

Field Summary

Fields

Modifier and Type	Field and Description
protected int	_postfixLength
protected int	_postfixMask
protected int	_prefix
protected int	_prefixTemplate

Constructor Summary

Constructors

Constructor and Description
AbstractSegmenter()

Method Summary

Methods

Modifier and Type	Method and Description
(package private) static int	getIdSize(int maxID) Returns the number of bits required to hold an integer between 0 and maxID.
static List<IDetectorElement>	getLeaves(IDetectorElement del) Returns a list of sensitive lowest-level decendents of the diven detector element.
protected abstract int	getNativePostfixLength() Returns minimum number of bits required to hold any postfix that can be used by this Segmenter.
protected int	getPrefix() Get prefix used by this OldSegmenter.
protected int	idToPostfix(int sensorID) Extract postfix from full SensorID.
protected int	postfixToID(int postfix) Convert postfix to full SensorID.
(package private) void	setPrefix(int prefix) Set prefix for this Segmenter.
(package private) void	setPrefix(int prefix, int postfixLength) Set pretfix value and postfix length for this Segmenter.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.lcsim.recon.tracking.vsegment.geom.Segmenter

detectorChanged, getSensor, getSensorID, getSensorIDs, getStereoPartners

Field Detail

_prefix

protected int _prefix

_postfixLength

protected int _postfixLength

_postfixMask

protected int _postfixMask

_prefixTemplate

protected int _prefixTemplate

Constructor Detail

AbstractSegmenter

AbstractSegmenter()

Method Detail

setPrefix

void setPrefix(int prefix)

Set prefix for this Segmenter. The number of bits reserved for postfix will be calculated automatically. For the top level Segmenter, this method will be called by SegmentationManager with prefix equal to zero.

setPrefix

void setPrefix(int prefix,
             int postfixLength)

Set pretfix value and postfix length for this Segmenter.

getNativePostfixLength

protected abstract int getNativePostfixLength()

Returns minimum number of bits required to hold any postfix that can be used by this Segmenter.

getPrefix

protected final int getPrefix()

Get prefix used by this OldSegmenter.

postfixToID

protected final int postfixToID(int postfix)

Convert postfix to full SensorID.

idToPostfix

protected final int idToPostfix(int sensorID)

Extract postfix from full SensorID.

getIdSize

static int getIdSize(int maxID)

Returns the number of bits required to hold an integer between 0 and maxID.

getLeaves

public static List<IDetectorElement> getLeaves(IDetectorElement del)

Returns a list of sensitive lowest-level decendents of the diven detector element. FIXME: This should be a DetectorElement method !