TWIST MOFIA MANUAL Running MOFIA As mentioned in the introduction, the framework for MOFIA was not changed from the previous versions. The commands in this section are therefore identical to previous versions of MOFIA. 1 General Commands MTIN "argument": Assigns the input file/device to argument. For example, MOFIA> MTIN "/ralph1/usr/data8/TWIST/data/run00092.dat" assigns the input file to run00092.dat in directory /ralph1/usr/data8/TWIST/data. Similarly, the command MOFIA> MTIN "/dev/mx3d" assigns the input to the tape drive /dev/mx3d. analyze "argument": Starts the analysis process. The number of events to be analyzed may be used as an argument; for example MOFIA> analyze 1000 analyzes 1000 events. If no argument is specified the entire file will be analyzed. event "argument": Moves FORWARD to the event specified and analyze it. For example MOFIA> event 237 moves forward to event 237 and analyzes it. show "argument": Shows the current contents of the argument. For example MOFIA> show MTIN shows the name of the file/device that MTIN is assigned to. If no argument is provided, a listing of possible arguments is displayed. @filename: Executes the command file specified by filename. Command files may include any MOFIA command that may be otherwise issued at the MOFIA command line. If the file extension is not specified the extension .kcm is assumed. Command files may also be nested (so that a command file may call another) up to 10 layers deep. For more information on command (.kcm) files please see the NAMELISTS section below. show fail: prints out statistics showing the number of events failing a given event filter. exit: Exit MOFIA. help: Run the MOFIA help facility. 2 Flags Several flags have been installed in MOFIA. To view these flags type show flags at the MOFIA command line. The set command is used to change the contents of these flags. For example, to turn on the PHOTO_FLAG type set photo on at the MOFIA command line. To turn on the decoding for the DC detector subsystem type set dc on. To turn on the tracking and/or the cuts, a qualifier following the subsystem name is needed. For example to turn on the cuts for the DC subsystem type set dc/cuts on. Currently six subsystems are defined in MOFIA: (DC) drift chamber, (PC) proportional chamber, (SC) scintillators, (AP) proportional chambers ADCs, (AS) scintillator ADCs, and (PU) pulsars. Each subsystem is a CHARACTER(LEN=2). The command show subsystems allows the user to see the defined subsystems 3 Namelists Several namelists have been installed in MOFIA. The following commands are used to access these namelists. (Note that the word "namelist" can be shortened to "name".) show namelist "argument": Shows the namelist and its description. If no argument is provided all namelists and their descriptions are shown. If an argument is provided the contents of the namelist specified by the argument are shown as well as their respective description and default settings. For example MOFIA> show namelist DCCUTS shows the contents of the namelist DCCUTS. show namelist all: Display the contents of all known namelists. namelist "namelist" "variable" = "value": Set the "namelist"'s "variable" to "value". (Has the advantage that these lines show up in the log files.) namelist "argument": Accesses the namelist specified by argument for purposes of checking and/or modifying the current settings. Invoking this command puts the user inside the namelist editor. Once inside the editor, the user may check the current values of the namelist by entering "?", exit the editor by entering "&", or change the value of a namelist variable by entering "variable = value". Below is an example: MOFIA> name DCSET Enter Drift Chamber SETtingings: ? &NLDCSET FIRSTPLANEDC = 1, LASTPLANEDC = 44, / LASTPLANEDC = 22 & MOFIA> While these commands may be typed in interactively (on the MOFIA command line), it is more convenient to have them in a command file so that the user can execute the appropriate command file (which contains the appropriate settings, flags, cuts, as well as pointers to the appropriate calibration files) for the desired analysis. Several sample files are provided (and may be checked out from the ../source/kcm directory in CVS). See the comments at the tops of these files to learn what they're for. (Tip: the command head *.kcm will show the first 10 lines of each KCM file in the current directory. The command head -n 25 *.kcm will show the first 25 lines of each KCM file in the current directory.) To execute any of these files type @filename at the MOFIA command line. The commands in the file will show up on the screen and will also be saved to the log file mofialog.dat. Command files used to analyze MC data (such as helix_mc.kcm) should have the two namelist variables MonteCarlo and UnpackMC in the namelist GLOBAL set to true. Calibration files to be used in analyzing MC data can also be specified in these command files, although the calibration files used to generate the MC data are stored in the data files themselves. 4 Functions Several functions have also been installed in MOFIA The command: func "argument" allows the user to execute these functions. For example executing the command func 6 prints out the drift and proportional chambers geometry files. If no argument is provided a listing of all functions and their descriptions is provided. 5 Environment variables Environment variables may also be assigned before executing MOFIA. A (more or less) complete list of MOFIA environment variables can be found here: http://twist.triumf.ca/private/offline/mofia/general/mofia_env.txt Two convenient environment variables that come in handy for MOFIA are worth mentioning here: MTIN which specifies the input file/device as explained above, and MHIST which specifies the directory to which the hbook histograms should be written. If MHIST is not specified, the hbook histograms will be written to the current directory in which MOFIA is running. Some environment variables may be best to assign through the .login file. If multiple users are sharing the same account and wish to have their own definitions of environment variables, a file of the form .user (where user stands for the user name) would be handy. Each user would then have to source .user before running MOFIA. When MOFIA is run, a log file is created with the default filename mofialog.dat and is written to the same directory in which MOFIA is running. The user may wish to change this default and can do so by assigning the environment variable MOFIALOG to the desired filename (which may include a directory name if the user wishes to write the log file to a different directory). This is particularly useful when the user wishes to save the log file, since otherwise this file will be overwritten the next time MOFIA is run. The environment variable MOFIA_INIT provides yet another handy tool. When this variable is assigned to a MOFIA command file (for example, helix.kcm) MOFIA will automatically execute this file upon entering. It is therefore handy for the user to assign this variable to a command file that contains the user customized settings.