|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
|
/*!
\page EventFilter_Phase2TrackerRawToDigi Package EventFilter/Phase2TrackerRawToDigi
<center>
<small>
<!-- @PROJ_VERS@ will be substituted at build time, no need to touch -->
<a href=http://cmsdoc.cern.ch/swdev/viewcvs/viewcvs.cgi/CMSSW/EventFilter/Phase2TrackerRawToDigi/?cvsroot=CMSSW&only_with_tag=@PROJ_VERS@>CVS</a> -
<a href=http://cmsdoc.cern.ch/swdev/viewcvs/viewcvs.cgi/CMSSW/EventFilter/Phase2TrackerRawToDigi/.admin/developers?rev=HEAD&cvsroot=CMSSW&content-type=text/vnd.viewcvs-markup>Administrative privileges</a>
</small>
</center>
\section desc Description
<!-- Short description of what this package is supposed to provide -->
This package provides the Phase2TrackerRawToDigiModule and ancillary classes
(Phase2TrackerRawToDigi) that read the strip tracker FED raw data buffers
(IORawData/FEDRawData) and convert their payloads into digis
(Phase2TrackerDigi and Phase2TrackerRawDigi), depending on the FED readout mode
(one of four: zero suppressed, virgin raw, processed raw, scope mode).
The Phase2TrackerRawToDigiModule also handles the "Trigger FED" buffer
provided by the DAQ when operating in local DAQ mode (only!). This
buffer is interpreted as a normal FED buffer, but is identified by its
identifier of 1023. The buffer contains information on run number,
event number, etc, as well as commissioning-related parameters (that
are used by the commissioning analysis).
Conversely, the OldPhase2TrackerDigiToRawModule and ancillary classes
(OldPhase2TrackerDigiToRaw) take digis as input and create FED buffers (all
contained within a FEDRawDataCollection), with the payloads reflecting
one of the four FED readout modes.
Both the RawToDigi and DigiToRaw converters use the readout cabling
map thast defines the connections between the front-end hybrids and
the FEDs (Phase2TrackerFedCabling), accessible via the EventSetup interface.
An additional plug-in module is Phase2TrackerTrivialDigiSource, which
creates dummy digis (with positions and ADC values according to a
pseudo-random number generator) and attaches them to the Event. This
provides a digi source for the DigiToRaw module and is for testing
only.
Phase2TrackerTrivialDigiAnalysis provides a simple analysis of digi
statistics, positions and "landau's", to be used as a debug tool only.
\subsection interface Public interface
<!-- List the classes that are provided for use in other packages (if any) -->
OldPhase2TrackerDigiToRaw
OldPhase2TrackerDigiToRawModule
Phase2TrackerRawToDigi
Phase2TrackerRawToDigiModule
Phase2TrackerTrivialDigiAnalysis
Phase2TrackerTrivialDigiSource
TFHeaderDescription
\subsection modules Modules
<!-- Describe modules implemented in this package and their parameter set -->
OldPhase2TrackerDigiToRawModule Takes FED buffers, wrapped by the FEDRawData
class, as input and creates digis.
Phase2TrackerRawToDigiModule Takes digis as input and creates FED buffers,
wrapped by the FEDRawData class.
Phase2TrackerTrivialDigiSource Generates "dummy" digis with positions and
ADC values defined using a pseudo-random number generator.
\subsection tests Unit tests and examples
<!-- Describe cppunit tests and example configuration files -->
None.
\section status Status and planned development
<!-- e.g. completed, stable, missing features -->
Stable. Essentially complete. Run-time error handling to be developed further.
<hr>
Last updated:
@DATE@ Author: computer-generated.
*/
|