Annotation of /PamelaDigitizer/README

Welcome to the first prototype of the gPamela digitizer.

The "library" consists of 

the main routine:

Pamelagp2Digits.cxx

the class:

Digitizer.cxx

the header file:

Digitizer.h

The Digitizer class contains methods such as

Loop()
DigitizeAC()
DigitizeDummy()

Loop() loops over the events, calls the Digitize methods and writes the result 
to a file.

The digitization methods have access to the entries in the gpamela ntuple and
calculate from the variables contained therein (for example released energy etc.etc.) PAMELA raw data, which is filled in data members, such as:

UShort_t fDataAC[fACbuffer];
UShort_t fDataDummy[fDummybuffer];

The task for the subdetector experts is to write  own DigitizeXYZ() routinewhich calculate their own digits in the format which front end produces.


Installing:

Prerequesits:
- CERNLIB
- ROOT with libHbook.so

Installation:
- inflate Pamelagp2Digits.tar.gz
- in directory PamelaDigitizer
- make

Usage:
Pamelagp2Digits gpam.hbook gpam.root gpam.pam

The code is heavily commented. 


Please let me know all bugs, critizism, sugestions.


Known issues:
- if we produce a Pamela Raw file it seems difficult (impossible) to 
  add MC information. We will have access to it as the gpamela root 
  file, and once event structure (instead of yoda structure) is restored
  we might be able to use it by making the DarthVader tree and gpamela root 
  tree friends.
1	silvio	1.1	Welcome to the first prototype of the gPamela digitizer.
2
3			The "library" consists of
4
5			the main routine:
6
7			Pamelagp2Digits.cxx
8
9			the class:
10
11			Digitizer.cxx
12
13			the header file:
14
15			Digitizer.h
16
17			The Digitizer class contains methods such as
18
19			Loop()
20			DigitizeAC()
21			DigitizeDummy()
22
23			Loop() loops over the events, calls the Digitize methods and writes the result
24			to a file.
25
26			The digitization methods have access to the entries in the gpamela ntuple and
27			calculate from the variables contained therein (for example released energy etc.etc.) PAMELA raw data, which is filled in data members, such as:
28
29			UShort_t fDataAC[fACbuffer];
30			UShort_t fDataDummy[fDummybuffer];
31
32			The task for the subdetector experts is to write own DigitizeXYZ() routinewhich calculate their own digits in the format which front end produces.
33
34
35			Installing:
36
37			Prerequesits:
38			- CERNLIB
39			- ROOT with libHbook.so
40
41			Installation:
42			- inflate Pamelagp2Digits.tar.gz
43			- in directory PamelaDigitizer
44			- make
45
46			Usage:
47			Pamelagp2Digits gpam.hbook gpam.root gpam.pam
48
49			The code is heavily commented.
50
51
52			Please let me know all bugs, critizism, sugestions.
53
54
55			Known issues:
56			- if we produce a Pamela Raw file it seems difficult (impossible) to
57			add MC information. We will have access to it as the gpamela root
58			file, and once event structure (instead of yoda structure) is restored
59			we might be able to use it by making the DarthVader tree and gpamela root
60			tree friends.