Next: Contents
  Contents
SGV 2.31- Simulation a Grande Vitesse, ver 2.31
A fast and simple program for simulating high
energy physics experiments at colliding beam detectors.
REFERENCE MANUAL
by
M. Berggren, LPNHE, Paris
With mayor contributions from P. Billoir, LPNHE Paris,
M. A. Do Vale, UFRJ Rio de Janeiro. Other contributions
from Ch. de la Vaissiere, S. Hoorelbeke, K. Hultquist,
P. Johansson and A. de Angelis, among others.
- Contents
- 1.
PATCHY structure of SGV.
- 2.
Data flow
- 3.
Structure of SGV.
- 4.
Description of Routines.
- 4.1
Patch SGVSTEER : Over-all steering of the execution
- 4.2
Patch SGVEVSIM : Event generator
- 4.2.1
SUBROUTINE ZEUGEN(I, STEER, IERR) : User GENerator
- 4.2.2
SUBROUTINE ZEUGEN(I, STEER, IERR) : User GENerator
- 4.2.3
SUBROUTINE ZEUGEN(I, STEER, IERR) : User GENerator
- 4.2.4
SUBROUTINE ZEUGEN(I, STEER, IERR) :
User GENerator, External read version.
- 4.2.5
SUBROUTINE ZEUGEN(I, STEER, IERR) :
User GENerator,single particel version
- 4.2.6
SUBROUTINE ZEUGEN(I, STEER, IERR) :
User GENerator,single particle scan version
- 4.2.7
SUBROUTINE ZEPVTX(XYZV, SIGV, XYZS) : Primary VerTeX
- 4.2.8
SUBROUTINE ZEORD(MODE, STEER) :
Event generator ORDers, default JETSET version
- 4.2.9
SUBROUTINE ZEORD(MODE, STEER) :
Event generator ORDers, PYTHIA version
- 4.2.10
SUBROUTINE ZEORD(MODE, STEER) :
Event generator ORDers, SUSYGEN version
- 4.2.11
SUBROUTINE ZEORD(MODE, STEER) :
Event generator ORDers, External read version
- 4.2.12
SUBROUTINE ZEORD(MODE, STEER) :
Event generator ORDers, single particle version.
- 4.2.13
SUBROUTINE ZEORD(MODE, STEER) :
Event generator ORDers, single particle scan version.
- 4.2.14
SUBROUTINE ZEEVTP(EVTYPE) : EVent TyPe
- 4.2.15
SUBROUTINE ZEQCNT(LUNPR, I, MAXPR) : Quark CouNTing
- 4.3
Patch SGVDETSIM : Detector simulation
- 4.3.1
SUBROUTINE ZDETSI(I, STEER, IERR) : DETector SImulation
- 4.3.2
SUBROUTINE ZDORD(MODE, STEER) : Detector simulation ORDers
- 4.3.3
SUBROUTINE ZDTRSP(X, IXF, JXF, IXL, JXL,
X1DIM, Y, IYF, JYF, Y1DIM) :
TRanSPose
- 4.3.4
SUBROUTINE ZDEFFI(SEEN, PP, LAYLIS) : Detector EFFIciency
- 4.3.5
SUBROUTINE ZDIDEN(CDSEEN, PP, CODE, LAYLIS) : Detector EFFIciency
- 4.3.6
SUBROUTINE ZDSMTP( TYPSUR, CGIVEN, TPAR, ERRARR, PAR, ERROR) :
SMear Track Parameters
- 4.3.7
SUBROUTINE ZDDHIT(PIN, VIN, MSEEN, IGEOM, NLAY, ILMV,
POUT, XOUT, DOTKR, TKRP, TKR,
RFLOC, Z, MODNR, IHIT, NNEW, NEWTRK, LAYLIS ) :
Make DETector hit PoiNTs
- 4.3.8
SUBROUTINE ZDKLCL( LAYLIS) : KiLl Calorimter Layers
- 4.3.9
SUBROUTINE ZDBREM(LAYLIS, PP, VERT, PMINBR, PTLOSLIM,
IPRF, IPZ, PHIIP,
KKK, IGEO, DST, NNEW)
generate BREMsstrahlung
- 4.3.10
SUBROUTINE ZDPAIR(LAYLIS, PP, PMINPA,
KKK, DST, NNEW)
generate PAIR production
- 4.3.11
SUBROUTINE ZDLBRM(MOM, PMINBR, ATMNB, LAMBDA) : Lambda for BRemsStrahlung
- 4.3.12
SUBROUTINE ZDLPAR(EGAMMA, ATMNB, LAMBDA) : Lambda for PAiR-production
- 4.3.13
SUBROUTINE ZDMBRM(P, PMINBR, ATMNB, NEWTRK, ERROR) :
Make BReMsstrahlung
- 4.3.14
SUBROUTINE ZDMPAR(P, ATMNB, NEWTRK, ERROR) : Make e+e- PAiR
- 4.3.15
SUBROUTINE ZDROPA(FIRST, PB, ABSPA, COSTHE, SINTHE, POUT) :
ROtate PAir
- 4.3.16
SUBROUTINE ZDELLY(REFPSD, LL, LAYLIS) : DELete LaYers
- 4.3.17
SUBROUTINE ZDCALO(IGEOM, PP, VERT, DSTMAX, CODE,
SHOAX, PSMEAR, ESMEAR, CDSEEN, TCAL, IERR) :
CALOrimeter simulation
- 4.3.18
SUBROUTINE ZDCLSA (ICAL,CTYP,SHOAXT,SHOAX) :
CaLorimeter Shower Axis
- 4.3.19
SUBROUTINE ZDCCVL(ICAL,CTYP,SHOAX,VAL) : Calorimeter Cell VaLue
- 4.3.20
SUBROUTINE ZDCCCC(ICAL,CTYP,CELLCENT,SHOAX) :
Calorimeter Cell Centre Coordinates
- 4.4
Patch SGVTRKER : Tracking routines
- 4.4.1
SUBROUTINE ZTTRAK( FIRST, PIN, XIN, CFIRST, CLAST, ZLAST,
RPROD, ZPROD,
IGEOM, PAR, TRIPRP, TIPZ, PHIIP, LAYLIS, ERROR) :
TRAcK a particle through the detector
- 4.4.2
SUBROUTINE ZTERRM(TYPSUR, LAYLIS, RELOAD, INCR, WGTINT, ERRARR, ERROR) :
calculate ERRor Matrix
- 4.4.3
SUBROUTINE ZTFOLN(IGEOM, PP, VERT, LAYLIS) : FOLlow Neutral particle
- 4.4.4
SUBROUTINE ZTCALO(IGEOM, PP, VERT, DIST, CTYP, X0, LAMBDA,
SHOAX, CALTYP, NLAY, IERR)
: Track to CALOrimeter
- 4.4.5
SUBROUTINE ZTTISC(P, V, REND, FIRST, SIPRP, IPZ, PHI0,
PEND, VEND, DST, RCYL,
TRACK, REQX0, X0INT, IGEOM, ERROR) :
TRacK InterSection with Cylinder
- 4.4.6
SUBROUTINE ZTTCYL(P, V, SRAD, FIRST, SIPRP, IPZ, PHI0,
PEND, VEND, DST, TRACK, ERROR) :
Track intersect with CYLinder
- 4.4.7
SUBROUTINE ZTTISP(P, V, ZEND, FIRST, SIPRP, IPZ, PHI0,
PEND, VEND, DST, ZPLA,
TRACK, REQX0, X0INT, IGEOM, ERROR) :
TRacK InterSection with Plane
- 4.4.8
SUBROUTINE ZTTPLA(P, V, ZPLA, FIRST, IPRP, IPZ, PHI0,
PEND, VEND, DST, TRACK, ERROR) : Track intersect with PLAne
- 4.4.9
SUBROUTINE ZTTDST(P, V, DST, FIRST, IPRP, IPZ, PHI,
PEND, VEND, TRACK, ERROR) :
Follow Track helix a DiSTance
- 4.4.10
SUBROUTINE ZTTRIP(P, V, TRIPRP, TIPZ, PHIIP) :
calculate Impact Parameter
- 4.4.11
SUBROUTINE ZTINVM(MATRIX, INVRED, IERR) : INVert Matrix
- 4.4.12
SUBROUTINE ZTREFL(P, THT, OTHSID) : REFLect a track in the x-y plane
- 4.4.13
INTEGER FUNCTION ZTCNBL(IGEO) : Cylinder NumBer of Layers
- 4.4.14
INTEGER FUNCTION ZTPNBL(IGEO) : Plane NumBer of Layers
- 4.4.15
CHARACTER*14 FUNCTION ZTCNAM( ICYL, TYP) : Cylinder NAMe
- 4.4.16
CHARACTER*14 FUNCTION ZTPNAM(IPLA, TYP) : Plane NAMe
- 4.4.17
REAL FUNCTION ZTCRAD( ICYL, TYP) : Cylinder RADius
- 4.4.18
REAL FUNCTION ZTCLEN(ICYL, TYP) : Cylinder LENgth
- 4.4.19
REAL FUNCTION ZTCZED(ICYL, TYP) : Cylinder ZED limits
- 4.4.20
REAL FUNCTION ZTPLAZ( IPLA, TYP) : PLAne Z
- 4.4.21
REAL FUNCTION ZTPRAD( IPLA, MINMAX, TYP) : Plane RADius
- 4.4.22
REAL FUNCTION ZTCERF( ICYL) : Cylinder Error in R Fi
- 4.4.23
REAL FUNCTION ZTCEZ(ICYL) : Cylinder Error in Z
- 4.4.24
REAL FUNCTION ZTPERX(IPLA) : Plane ERror in X
- 4.4.25
REAL FUNCTION ZTPERY( IPLA) : Plane ERror in Y
- 4.4.26
LOGICAL FUNCTION ZTISCB(ICYL) : IS Calorimeter (Barrel)
- 4.4.27
LOGICAL FUNCTION ZTISCF( IPLA) : IS Calorimeter (Forward)
- 4.4.28
INTEGER FUNCTION ZTCBNL(IGEO) : Calo (Barrel) Number of Layers
- 4.4.29
INTEGER FUNCTION ZTCFNL(IGEO) : Calo (Fwd) Number of Layers
- 4.4.30
INTEGER FUNCTION ZTCSMC( ICAL, CTYP) :
Calorimeter Shower Meassurement Code
- 4.4.31
REAL FUNCTION ZTCSDE( ICAL, ERRTYP, CTYP) :
Calorimeter Shower Direction Error
- 4.4.32
REAL FUNCTION ZTCFCP( ICAL, CTYP) :
Calorimeter First Cell Phi
- 4.4.33
INTEGER FUNCTION ZTCNCL( ICAL,COORD, CTYP) :
Calorimeter Number of CeLls
- 4.4.34
SUBROUTINE ZTCMOS(ICAL,CTYP,ZSIGN,CMIN,CMAX,CWID) :
Calorimeter MOdule Size.
- 4.4.35
REAL FUNCTION ZTCTHR( ICAL, CTYP): Calorimeter THReshold
- 4.4.36
REAL FUNCTION ZTCEFF( ICAL, CTYP): Calorimeter EFFiciency
- 4.4.37
FUNCTION ZTCRES( ICAL, CTYP, NRG) : Calorimeter resolution
- 4.4.38
REAL FUNCTION ZTCTHM( ICAL, CTYP): Calorimeter THReshold for Mips
- 4.4.39
REAL FUNCTION ZTCEFM( ICAL, CTYP): Calorimeter EFficiency for Mips
- 4.4.40
REAL FUNCTION ZTCMSI( ICAL, CTYP ) : Calorimeter Mip ave. SIgnal
- 4.4.41
REAL FUNCTION ZTCMWI( ICAL, CTYP) : Calorimeter Mip resp. WIdth
- 4.4.42
FUNCTION ZTCTYP( ICAL, CTYP) : Calorimeter TYPe
- 4.4.43
CHARACTER*14 FUNCTION ZTCALN( CTYP ) : CALorimeter Name
- 4.4.44
REAL FUNCTION ZTCX0(ICYL) : Cylinder X0
- 4.4.45
REAL FUNCTION ZTPX0(IPLA) : Plane X0
- 4.4.46
INTEGER FUNCTION ZTCANB(ICYL) : Cylinder Atom number
- 4.4.47
INTEGER FUNCTION ZTPANB( IPLA) : Plane Atom number
- 4.4.48
SUBROUTINE ZTTINF(LL, ZVRTXO, AMASSO, PMOMO, THETAO, PHI0O,
DISTO, RO, ZO, PHIO, BETAO) : Track INFormation
- 4.4.49
SUBROUTINE ZTDTGE(NAME,ILAY,GEOPAR,IDET,CALTYP) :
DeTector GEometry
- 4.4.50
SUBROUTINE ZTDTPM(NAME,ILAY,MESPAR,IDET) :
DeTector Position Measurement parameters
- 4.4.51
SUBROUTINE ZTCSEP(NAME,ILAY,ENE,EMES,IDET) :
Calorimeter Shower Energy Parameters
- 4.4.52
SUBROUTINE ZTCMPA(NAME,ILAY,MMES,IDET) :
Calorimeter Mip PArameters
- 4.4.53
SUBROUTINE ZTDTLL(NAME,LS,IDET)
DeTector Layer-List
- 4.4.54
SUBROUTINE ZTNOLM(ON_OFF) : NO z LiMit
- 4.4.55
SUBROUTINE ZTINI(STEER, RR,PRDET,PLDET) : Tracking Initialisation
- 4.4.56
SUBROUTINE ZTFOLL(MOMENT, CHA, POLANG, IPRP, IPZ, PHIIP,
MASS, RREFIN, RR, RV, REND, ZV, ZEND,
TRACK, IFLG, IERR) :
FOLLow track through detector
- 4.4.57
SUBROUTINE ZTTRWT(INCR, IERR) : calc. TRacK WeiGhT matrix
- 4.4.58
SUBROUTINE ZTREFE(DSTR, IERR) : intersection with REFErence surface
- 4.4.59
SUBROUTINE ZTREF2(DSTR, IPRP, IPZ, PHIIP, IERR) :
intersection with REFErence surface
- 4.4.60
SUBROUTINE ZTFOLW(DSTR, INCR, IERR) : FOLlow track to
intersections with surfaces
- 4.4.61
SUBROUTINE ZTFOL2(DSTR, INCR, IPRP, IPZ, PHIIP, IERR) :
FOLlow track to intersections with surfaces
- 4.4.62
SUBROUTINE ZTWGTC(INCR) : WeiGhT CALculation
- 4.5
Patch SGVANA : Event analysis
- 4.5.1
SUBROUTINE ZAPRCS(DATA, IREC, ARRAY , NW) : Analysis PRoCeSsing
- 4.5.2
SUBROUTINE ZAORD(MODE, STEER) : Analysis ORDers
- 4.5.3
SUBROUTINE ZAINI(STEER, MGEOM) : Analysis Initialisation
- 4.5.4
SUBROUTINE ZAUINI(STEER, MGEOM) : Analysis User Initialisation
- 4.5.5
SUBROUTINE ZADECD(DATA, IREC, ARRAY , NW) : DECoDe data
- 4.5.6
INTEGER FUNCTION ZADCHC(PARCL, PARCD): Decay CHain Coding
- 4.5.7
INTEGER FUNCTION ZAPTYP(ICD) : Particle TYPe
- 4.5.8
SUBROUTINE ZATRLD : TRack LoaD
- 4.5.9
SUBROUTINE ZAMKTK(ERROR) : MaKe TracK fit result
- 4.5.10
SUBROUTINE ZAUSER(STEER) : USER routine
- 4.5.11
SUBROUTINE ZARUEN(STEER) : Analysis RUn ENd
- 4.6
Patch SGVANAUTL : Utilities for event analysis
- 4.6.1
SUBROUTINE ZAUVF1(FRCREJ, ERROR) : Vertex Fit 1
- 4.6.2
SUBROUTINE ZAUVF2(TYPE, MTRK, PAR, WGT, INVTX, PCUT,
XYZ, VCOV, VCOVS, TRWT,
SFACT, NSIGM, CHI2VX, NVTRK, ERROR) : Vertex FIT 2
- 4.6.3
SUBROUTINE ZAURST(FORCE_REJECT) : Reject STrange particle decay
products
- 4.6.4
LOGICAL FUNCTION ZAUSTP(ITRK) : STrange particle decay Product
- 4.6.5
SUBROUTINE ZAUCIP(RFVTX, IPRFX, IPZX, EIPRFX, EIPZX, IPCORR,
XYZRED, VCOVR) :
Calculate Impact Parameter
- 4.6.6
SUBROUTINE ZAUIMP(PAR, WGT, XYZ, VCOV, THJET, PHIJET, SIGNTP,
IPRF, IPZ, EIPRF, EIPZ, CORREL) : IMPact parameter
- 4.6.7
SUBROUTINE ZAUBOS ( BS ) : BOosted Sphericity
- 4.6.8
SUBROUTINE ZAUPRN : PaReNts
- 4.6.9
REAL FUNCTION ZAMVAL(CD) : Mass VALue
- 4.6.10
SUBROUTINE ZAUSHO(LIMPRO) : SHOWer merging
- 4.6.11
REAL FUNCTION ZAUSDI(I, J) : Shower DIstance
- 4.6.12
SUBROUTINE ZAUCSS( I, WSUM, OOWSUM) :
Collect Shower Statistics-counters
- 4.6.13
SUBROUTINE ZAUSHS : SHower Sorting
- 4.6.14
SUBROUTINE ZAUSIC : Shower Identity and Charge assignment
- 4.6.15
SUBROUTINE ZAUCSH(DELTA) : Charged part to SHower assoc.
- 4.6.16
SUBROUTINE ZAUCLU(MET, METPAR, PARSEL, PARLIS, NBJETS, ERROR) :
Do jet clustering
- 4.6.17
SUBROUTINE ZAUJSF(PARSEL, ORDER, PARLIS) : JetSet commons Fill
- 4.6.18
SUBROUTINE ZAUJID( JETFL1, JETFL2) : Jet IDentity
- 4.6.19
SUBROUTINE ZAUSPH : SPHericity
- 4.6.20
SUBROUTINE ZAUTHR : THRust
- 4.6.21
SUBROUTINE ZAUFWO : Fox-WOlfram moments.
- 4.6.22
INTEGER FUNCTION ZAUNHT(NAME,ITR)
Number of Hits
- 4.6.23
SUBROUTINE ZAUDHL(NAME,ITR,HITDET) :
Detector HitList
- 4.7
Patch GENUTL : General utility routines
- 4.7.1
SUBROUTINE ZULETD(ABSP, MASS, X0, SIGMA) :
calculate multiple-scattering
s.d. using Lynch ET Dahls formulae
- 4.7.2
SUBROUTINE ZUI2PI(PHIIN, PHIOUT) : bring angle Into the
interval 0 to 2PI
- 4.7.3
SUBROUTINE ZUINPI(PHIIN, PHIOUT) : bring angle INto the interval 0 to PI
- 4.7.4
SUBROUTINE PXTCPX(RADIUS, PAR, P, X) :
transform Track parameters on Cylinder to PXpypz
- 4.7.5
SUBROUTINE PXTPPX(Z, PAR, P, X) :
transform Track parameters on Plan to PXpypz
- 4.7.6
SUBROUTINE ZUINTS (ELEM, SET) : INto Set
- 4.7.7
SUBROUTINE ZUOUTS (ELEM, SET) : OUT of Set
- 4.7.8
LOGICAL FUNCTION ZUCINS ( ELEM, SET ) : Check if IN Set
- 4.7.9
INTEGER FUNCTION ZUCARS ( SET , N ) : CARdinal number of Set
- 4.7.10
LOGICAL FUNCTION ZUSEQV(S1, S2, N) : Set EQuiValence
- 4.7.11
SUBROUTINE ZUSAND(S1, S2, S3, N) : Set AND
- 4.7.12
SUBROUTINE ZUSOR(S1, S2, S3, N) : Set OR
- 4.7.13
REAL FUNCTION ZUGAUS (MEAN, SD) : generate GAUSsian random number
- 4.7.14
REAL FUNCTION ZURECT (DUMMY) : generate RECTangular random number
- 4.7.15
SUBROUTINE ZUCODS(D,S,N) : COpy Double prec to Single prec
- 4.7.16
SUBROUTINE ZUCOSD(S,D,N) : COpy Single prec. to Double prec
- 4.7.17
INTEGER FUNCTION ZULOCR(X, VECT, N) : LOCate Real
- 4.7.18
INTEGER FUNCTION ZULOCI(X, VECT, N) : LOCate Integer
- About this document ...
Mikael Berggren
2003-03-27