To customise the program for the particular process and detector wanted certain steps should the be taken. First, make a personal copy of the default user environment as described in chapter 3.1 , then test this default version following chapter 3.2 .
Three things needs to be specified by the user: The event generator to use, the detector to use, and how to analyse the results. In chapter 3.3 , the steps to to go through to create the the user-environment are outlined.
In chapter 4.1 it is described how to make the interface to the event-generator. First consider using one of those included in SGV. If this is the case, just follow the instructions, and the disregard the rest of this section.
If none of these are apt to the process to be studied, see chapter 4.1.7 on how to interface in general. This section also indicates how to organise the code for easy interface into SGV if You consider writing a new generator.
Even if You want to use a different generator, we suggest You initially use one of the supplied interfaces, to check that other aspects of the program work correctly, and go back to chapter 4.1.7 only when the rest of the environment has be verified to be working.
Subsequently, read chapter 4.2 to learn how to organise the analysis code. We strongly suggest using the template ZAUSER as a start point, as it includes examples on how to loop tracks, and call utility routines. It also contains all the user common-blocks. Study the contents of these in chapter 4.3 . In particular, study the description of ZATRS, ZACLU and ZAEVT very carefully, as these are the by far most important ones, and contains almost all the information produced by SGV.
For the utility routines, more complete information can be found in the reference manual , chapter 4.6 (analysis utilities), and chapter 4.7 (general utilities). Use the table of contents of these sections as an index of utilities available, and read only the descriptions for the routines You need.
For histogram-filling in the analysis code, please study the explanation under 'step 6' in chapter 3 , and how it is done in the template.
The third point in the setting up of the specific experimental situation is the detector description. How to do this is described in detail in chapter 4.4 and chapter 6 . This is by far the most delicate part of setting up the environment. We strongly suggest that You initially use the example geometry, which is a simplified description of the DELPHI detector at LEP. Only when all other parts are working properly should You consider implementing the geometry of Your detector. When doing so, carefully read chapter 6 , including the examples, and use the example as a template.
The contents two chapters not mentioned above are not fundamental to running SGV correctly. In chapter 5 , You can study the principles used for the detector simulation of SGV. It also contains some details on things like secondary interactions in the detector ( chapter 5.1 ), and on how calorimetric showers are seen by the detector ( chapter 5.3.3 ). In chapter 7 You can find a description of how to interface the SGV analysis code to other sources of data (full simulation or real data). Read this only if You encounter this problem.