!Converted with LaTeX2HTML 95.1 (Fri Jan 20 1995) by Nikos Drakos (firstname.lastname@example.org), CBLU, University of Leeds >
There are 2 ways to customize the run: run-time customization uses the default executables; compile-time customization requires relinking your own version of gsim.
Run-time customization will work for you if the standard geometry is acceptable, the built-in kinematics generators are acceptable or you can supply a BOS/FPACK or `Liz-format' input kinematics file, and all you want to do is turn on or off some physics processes, turn off some detectors, modify the B field strength, etc. Here you analyze the run using the BOS/FPACK output file.
See the appendix on kinematics generators for information on the built-in kinematics generators. All possible run-time customization options are listed in the gsim help file ($CLAS_DOC/gsim.hlp), or type: gsim_bat -help), and in the CERN Geant manual in section BASE040. See also the appendices on command line flags, environment variables, ffread flags, and switch usage.
Compile-time customization is required if you want to modify the geometry, provide a custom kinematics generator, spy on the internal workings of GSIM, fill histograms during the simulation, etc. Linking your own personal copy of GSIM involves use of the CLAS code management system. For full details see CLAS-NOTE-95-007 by Dieter Cords.
See also the appendix on user routines for a list of routines than can be modified by the user.
Briefly (see CLAS-NOTE-95-007), after:
setup gnu(the above can be done in your own .cshrc file).
cloneGsimto create a new directory tree gsim/ in the current directory.
co guser_book.F guser_hist.FALL routines in this directory will be compiled and linked into the executable, so you may place additional source routines here.
make dependsto generate an include file dependency list from the fortran source files in gsim.lib/s and gsim_bat/s or gsim_int/s (for make). This must be redone only when the list of include files used in the source files changes.
make RCS_UPD=yes fullor
make_upd fullto compile and link with the production or test libraries, respectively. The executables are named gsim_bat and gsim_int.
make cleanto clean up all object files and core files, leaving only the executables.