$ analyzer -i /projects/ritt/run10229.mid -n 1000This analyzes the first 1000 events from that file. Next, you can analyze this file and create an HBOOK RZ file. By default, all banks (raw and calculated) are written to the RZ file which makes it very large. In most cases, you are only interested in the "physics" banks but not in the raw (encoded) data. Therefore, most banks can be turned off. This can be achieved by setting /Analyzer/Bank switches/
$ odbedit [local]> load bank_switches.odb [local]> ls /Analyzer/Bank switches ...Since the ODB is persistent, the settings are kept even after ODBEdit or the analyzer finish and will be used for the next runs.
Now, you can produce an RZ file with the banks TRIG, CADC, THIT, ASUM, MWPC and ACUM:
$ analyzer -i /projects/ritt/run10229.mid -o run10229.rz -n 1000This produces a column-wise N-tuple file run10229.rz. It has a HBOOK record size of 8190 words. Therefore, you have to load it in PAW with
PAW> hi/file 1 run10229.rz 8190With nt/print 1 you can see that all values from banks CADC, MWPC and THIT are present as N-tuple variables. Each bank was automatically converted to a "block".
To analyze your own files, get them from the archive to your own directory:
$ ftp psarchive 1021
ftp>cd pibeta98/data ftp>bin ftp>get runxxxxx.midwhere xxxxx is the run number. Since the disk space under /projects is limited, only very few runs can be kept there. If several people are working at the same time there, it might happen that someone else has already copied a file to /projects/ /. Since these files are group readable, one can easily use the file from someone else if it is available.
Command line parametersFollowing command line parameters are supported by the analyzer:
-h [hostname]MIDAS host to connect to when running the analyzer online. Not used during offline analysis.
-e [experiment]MIDAS experiment to connect to. Not used during offline analysis.
-i [filename1] [filename2] ...Input file name(s). Up to ten different file names can be specified in one -i statement. File names can contain the sequence '%d' which gets replaced by the current run number in conjunction with the -r flag. Following extensions are recognized by the analyzer: .mid (MIDAS binary), .asc (ASCII data), .mid.gz (MIDAS binary gnu-zipped) and .asc.gz (ASCII data gnu-zipped).
-o [filename]Output file name. The file names can contain the sequence '%d' which gets replaced by the current run number in conjunction with the -r flag. Following file formats can be generated: .mid (MIDAS binary), .asc (ASCII data), .rz (HBOOK rz file), .mid.gz (MIDAS binary gnu-zipped) and .asc.gz (ASCII data gnu-zipped). For HBOOK files, CWNT are used by default. RWNT can be produced by specifying the -w flag.
-r [range]Range of run numbers to be analyzee like "-r 120 125" to analyze runs 120 to 125 (inclusive). The "-r" flag must be used with a '%d' in the input file name.
-n [count]Analyze only "count" events. Since the number of events for all event types is considered, one might get less than "count" trigger events if some scaler or other events are present in the data.
-n [first] [last]Analyze only events from "first" to "last".
-n [first] [last] [n]Analyze every n-th event from "first" to "last".
-c [filename1] [filename2] ...Load configuration file name(s) before analyzing a run. File names may contain a '%d' to be replaced by the run number. If more than one file is specified, parameters from the first file get superseeded from the second file and so on. Parameters are stored in the ODB and can be read by the analyzer modules. They are conserved even after the analyzer has stopped. Therefore, only parameters which change between runs have to be loaded each time. To set a parameter like
"/Analyzer/Parameters/Global/ADC threshold"one would load a configuratin file which contains:[Analyzer/Parameters/Global] ADC threshold = FLOAT : 5Loaded parameters can be inspected with ODBEdit after the analyzer has been started.
-p [param=value]Set individual parameters to a specific value. Overrides any setting in configuration files. Parameter names are relative to the /Analyzer/Parameters directory. To set the key "/Analyzer/Parameters/Global/ADC threshold" to a specifig value, one uses
-p "global/ADC threshold"=12.5. The quotation marks are necessary since the key name contains a blank. To specify a parameter which is not under the /Analyzer/Parameters tree, one uses the full path (including the initial "/") of the parameter like
-p "/Experiment/Run Parameters/Theta Swing"=63.4.
-wProduce row-wise N-tuples in outpur .rz file. By default, column-wise N-tuples are used.
-vConvert only input file to output file. Useful for format conversions. No data analysis is performed.
-dDebug flag when started the analyzer from a debugger. Prevents the system to kill the analyzer when the debugger stops at a breakpoint.
S. Ritt, 2 May 1997