|
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_SiStripRawToDigi Package EventFilter/SiStripRawToDigi
<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/SiStripRawToDigi/?cvsroot=CMSSW&only_with_tag=@PROJ_VERS@>CVS</a> -
<a href=http://cmsdoc.cern.ch/swdev/viewcvs/viewcvs.cgi/CMSSW/EventFilter/SiStripRawToDigi/.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 SiStripRawToDigiModule and ancillary classes
(SiStripRawToDigi) that read the strip tracker FED raw data buffers
(IORawData/FEDRawData) and convert their payloads into digis
(SiStripDigi and SiStripRawDigi), depending on the FED readout mode
(one of four: zero suppressed, virgin raw, processed raw, scope mode).
The SiStripRawToDigiModule 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 OldSiStripDigiToRawModule and ancillary classes
(OldSiStripDigiToRaw) 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 (SiStripFedCabling), accessible via the EventSetup interface.
An additional plug-in module is SiStripTrivialDigiSource, 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.
SiStripTrivialDigiAnalysis 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) -->
OldSiStripDigiToRaw
OldSiStripDigiToRawModule
SiStripRawToDigi
SiStripRawToDigiModule
SiStripTrivialDigiAnalysis
SiStripTrivialDigiSource
TFHeaderDescription
\subsection modules Modules
<!-- Describe modules implemented in this package and their parameter set -->
OldSiStripDigiToRawModule Takes FED buffers, wrapped by the FEDRawData
class, as input and creates digis.
SiStripRawToDigiModule Takes digis as input and creates FED buffers,
wrapped by the FEDRawData class.
SiStripTrivialDigiSource 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.
*/
|