Warning, /EventFilter/SiStripRawToDigi/doc/SiStripRawToDigi.doc is written in an unsupported language. File is not indexed.
0001
0002 /*!
0003
0004 \page EventFilter_SiStripRawToDigi Package EventFilter/SiStripRawToDigi
0005
0006 <center>
0007 <small>
0008
0009 <!-- @PROJ_VERS@ will be substituted at build time, no need to touch -->
0010 <a href=http://cmsdoc.cern.ch/swdev/viewcvs/viewcvs.cgi/CMSSW/EventFilter/SiStripRawToDigi/?cvsroot=CMSSW&only_with_tag=@PROJ_VERS@>CVS</a> -
0011 <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>
0012 </small>
0013 </center>
0014
0015 \section desc Description
0016 <!-- Short description of what this package is supposed to provide -->
0017
0018 This package provides the SiStripRawToDigiModule and ancillary classes
0019 (SiStripRawToDigi) that read the strip tracker FED raw data buffers
0020 (IORawData/FEDRawData) and convert their payloads into digis
0021 (SiStripDigi and SiStripRawDigi), depending on the FED readout mode
0022 (one of four: zero suppressed, virgin raw, processed raw, scope mode).
0023
0024 The SiStripRawToDigiModule also handles the "Trigger FED" buffer
0025 provided by the DAQ when operating in local DAQ mode (only!). This
0026 buffer is interpreted as a normal FED buffer, but is identified by its
0027 identifier of 1023. The buffer contains information on run number,
0028 event number, etc, as well as commissioning-related parameters (that
0029 are used by the commissioning analysis).
0030
0031 Conversely, the OldSiStripDigiToRawModule and ancillary classes
0032 (OldSiStripDigiToRaw) take digis as input and create FED buffers (all
0033 contained within a FEDRawDataCollection), with the payloads reflecting
0034 one of the four FED readout modes.
0035
0036 Both the RawToDigi and DigiToRaw converters use the readout cabling
0037 map thast defines the connections between the front-end hybrids and
0038 the FEDs (SiStripFedCabling), accessible via the EventSetup interface.
0039
0040 An additional plug-in module is SiStripTrivialDigiSource, which
0041 creates dummy digis (with positions and ADC values according to a
0042 pseudo-random number generator) and attaches them to the Event. This
0043 provides a digi source for the DigiToRaw module and is for testing
0044 only.
0045
0046 SiStripTrivialDigiAnalysis provides a simple analysis of digi
0047 statistics, positions and "landau's", to be used as a debug tool only.
0048
0049 \subsection interface Public interface
0050 <!-- List the classes that are provided for use in other packages (if any) -->
0051
0052 OldSiStripDigiToRaw
0053 OldSiStripDigiToRawModule
0054 SiStripRawToDigi
0055 SiStripRawToDigiModule
0056 SiStripTrivialDigiAnalysis
0057 SiStripTrivialDigiSource
0058 TFHeaderDescription
0059
0060 \subsection modules Modules
0061 <!-- Describe modules implemented in this package and their parameter set -->
0062
0063 OldSiStripDigiToRawModule Takes FED buffers, wrapped by the FEDRawData
0064 class, as input and creates digis.
0065 SiStripRawToDigiModule Takes digis as input and creates FED buffers,
0066 wrapped by the FEDRawData class.
0067 SiStripTrivialDigiSource Generates "dummy" digis with positions and
0068 ADC values defined using a pseudo-random number generator.
0069
0070 \subsection tests Unit tests and examples
0071 <!-- Describe cppunit tests and example configuration files -->
0072 None.
0073
0074 \section status Status and planned development
0075 <!-- e.g. completed, stable, missing features -->
0076 Stable. Essentially complete. Run-time error handling to be developed further.
0077
0078 <hr>
0079 Last updated:
0080 @DATE@ Author: computer-generated.
0081 */
0082