The Go4 Analysis Framework
Introduction V3.4

New toolwindow DABC Monitor: For new GSI DAQ framework Data Acquisition Backbone Core (DABC). Allows to inspect all info services registered to any DIM server. Any DABC ratemeter service running on DABC or MBS nodes may be monitored and filled into trending and statistic histograms. This tool is build optionally if environment variable DIMDIR is set and DIM is installed there.
Added Support of Solaris with CC 5.x (without RFIO). Fixed different warnings from Solaris CC compiler.
Viewpanel menu: "File/Produce Graph From Markers" will generate new TGraph in local workspace containing the points of all Go4markers set in the current pad. May be used to fit function to manually selected positions.
Viewpanel: Correct work of marker class in case of superimposed histograms. Now newly created marker will be assigned to currently selected histogram.
FitPanel: in Wizard and Expert mode there is now possibility to clone existing model component. Especially usefull in case of TGo4FitModelFunction and TGo4FitModelFormula classes, which require a number of different settings.
Mbs event library: Added new event types for future GSI data acquisition framework DABC.
Bugfixes:

a. Mbs API: streamserver connection timeout was not working correctly (leads to hangup of analysis control when no data is delivered from streamserver).

b. Mbs API: several errors at reading of *.lmd files with new event format 100,1 (DABC)

c. MbsAPI , for f_stccomm.c file. Fixes problem with connecting 64 bit machine to MBS events/stream/trasnport server. False usage of select() function.

d. TreeViewer swapped x/y/z coordinates, convention is TTree::Draw("z:y:x"))

e. Viewpanel: "Produce Picture" did not save all draw options to picture

f. Viewpanel: Mismatch between Go4 viewpanel range (full visible range) and ROOT user range (referring to low edges of bins) could cause slight shift of x axis range on canvas refresh

g. TGo4Browser: Arrays fVisibleColumns and fIndexes has 1 item less than required

h. QRootApplication: in constructor numc argument must be delivered as reference.

i. TGo4MBSViewer: status record must be cleared in constructor.

j. Fit package concerning parameters handling when some parameters are fixed

Maintenance:

a. Modifications in makefiles - now only in one place in Makefile.config one should specify platform - Linux, Solaris or Win32. Other small changes in makefiles

b. Small adjustments for the new ROOT (5.17.05) browser.

c. Adjustments for modifications in ROOT signal-slot mechanism syntax (ROOT >=5.19/02); this caused viewpanel crash.

d. Two ROOT libraries (libTree and libGpad) added to Go4 rootmap file that user Go4 analysis library can be loaded in CINT session.

e. ThreadManager workaround for ROOT bug in TThread::Delete() (ROOT bug report 31085): for some compilers, Go4 GUI crashed when shutting down or disconnecting analysis.

2.2 New features in Go4 v3.03 (May07)

1. Viewpanel

a. Marker editor: A point- or region marker and its label will pop to the pad foreground when it is selected with left mouse button. Additionally, selection of a marker in the combo box of the editor will let it appear frontmost.

b. In superimpose mode selected histogram can be moved on the top of complete histogram stack via new menu command "Select/show histo on top".

c. Draw options enhanced: support for TGraph draw modes and TGraphErrors error style. Reorganization of draw options for TH1/TH2. New draw options tool for line, marker, and fill colours of histograms and graphs.

d. Menu "Select" to chose active object from superimposed histograms and graphs.

e. Autoscale checkbox as shortcut on top of each viewpanel

f. Improvement in speed of view panel redraw (up to factor of 2).

2. Fitpanel improvement: keep y-scaling when fitting on x subrange of histogram

3. New Zoom toolbar: added buttons for scaling z-axis of 2d histograms.

4. New icons for zoom toolbar and draw options toolbar.

5. New additional draw options toolbar to select commonly used drawing options by buttons (lin/log, line, histo, some 2d styles). The new toolbar is displayed via the RMB options pull down menu.

6. New example macro scalex.C to scale x-axis of histogram with linear calibration function

7. Settings menu: "Show event status" selectable as default pad option.
Settings menu: "Statistics Box..." dialog to define default pad options for histogram statistics.

8. TGo4Picture: new method AddSpecialObject() to add any ROOT graphical object (text labels, markers) to the picture

9. Improvement in TGo4MbsFile for partial read of lmd file: Corrected mismatch between first event index and real event number (before: index=event number-1).

10. TGo4MbsFile: now can also read list-mode data of old event formats type 4,1 and 4,2. Event will be converted implicitly into format 10,1 for further processing: User unpack processor gets TGo4MbsEvent with one TGo4MbsSubevent that contains all event data.

11. GUI command interface TGo4AbstractInterface. Added methods:
- GetViewPanelName() - returns view panel name
- SetViewPanelName() - changes view panel name
- RedrawPanel() - updates view panel view
- RedrawItem() - updates all views of specified items
- FindViewPanel() - searches for view panel of specified name
- GetActiveViewPanel() - returns currently active view panel

12. Maintenance:

a. Some Makefile and build skript improvements

b. Added missing includes for <math.h>, required by some compilers

c. Due to changes in ROOT in many Go4 files includes like TROOT.h, TMath.h, TList.h are missing. Sometimes user should also include these files in user code.

d. In latest ROOT TBuffer class becomes abstract, therefore one cannot use it directly in the code. Instead, TBufferFile class must be used.

e. Adjustment of Makefile because of changes in default libraries for ROOT >= 5.13/04 (separated libSpectrum.so)

f. Adjusted Go4ThreadManager package due to changes in TTimer copy constructor for ROOT versions > 5.12.00

g. Some bug fixes concerning compilation against old ROOT versions 4.08

13. Bug fix

a. for changes in ROOT>v5.14 pad cleanup: Viewpanel with go4 markers on subpads crashed when closed or cleared.

b. 1-d histogram drawing. Due to some features of ROOT histogram painter several draw options (lin, barchart and others) not working after TH1::SetSumw2() is called - in there Sumw2 array sum of squares of weights is accumulated. Modification in Go4 code were done to avoid Sumw2 arrays when it not necessary.

c. in Go4Socket library (missing include) because of changes in ROOT version 5.14-00

d. Problems with view panel scaling functionality when build with gcc4.0.x compiler (FC5); fixed.

2.3 New features in Go4 v3.02 (July06)

1. Analsis framework: TGo4EventElement now implements default method Fill() that calls virtual function TGo4EventSource::BuildEvent(). As a consequence, for a simple analysis the user only has to implement BuildEvent() method in his processor class. There is no need to develop a user output event class. Even if a user output event class shall be used, methods Fill() and Init() are not necessarily needed for a standard analysis. Go4ExampleSimple and Go4Example1Step were changed accordingly.

2. Analysis framework: TGo4EventProcessor now implements BuildEvent() and can be used in steps which are only used as handle for event input (branched steps).

3. Macro usage: Analysis defines __GO4ANAMACRO__ on startup to be used in any Go4 analysis script to check the current environment. In GUI, __GO4MACRO__ is defined and can be checked analogously. In analysis, pointer go4 is already set to TGo4Analysis::Instance(), in GUI to TGo4AbstractInterface::Instance(), i.e. all methods can be referenced by go4->. (see 6.4.3, page 49, and 6.17, page 81)

4. Parameter editor offers popup menu GetFromFitPanel for embedded fitters to update fitter settings from the current fit editor. Useful for calibration parameters that should be fitted interactively to spectra (see Go4Example2Step).

5. Rebin in GUI. Now when histogram will be rebinned via right-mouse menu or via ROOT graphical editor, rebinning will be kept when histogram will be updated next time from analysis. Many views of the same histogram with different binning are possible. Binning also kept in hot-start file. TGo4Picture has new SetRebinX(), SetRebinY() methods to configure rebinning of displayed histogram.

6. All Go4 macros put into new subfolder $GO4SYS/macros. This directory should be added to entry Unix.*.Root.MacroPath in .rootrc setup file.
New macros: savecond.C and saveparam.C to create macros to set conditions and parameters to their current values (see 4.5.6, page 26).

7. Bugfixes:

a. Access to RFIO root files from Go4 GUI browser was not possible (at GSI), since internal functions of libRFIO.so were shadowed by functions of GSI event lib with same names. Solved by separating Go4 event library package into different modules for analysis and GUI task.

b. Analysis server executed UserPostLoop() each time a GUI client was disconnected. Disabled.

c. Several changes concerning the cleanup mechanism in GUI object manager

d. AnalysisClient in CINT mode showed thread deadlock for ROOT versions> 5.02-00

e. Start client dialog selects correct analysis directory when choosing the analysis executable

2.4 New features in Go4 v3.01 (May06)

1. New script command line widget for GUI: Allows execution of ROOT commands or macros within Go4 GUI task. Moreover, Go4 hotstart scripts may be invoked here at any time. The widget offers a file dialog to search for *.C and *.hotstart files. It also has a selector dialog of preloaded commodity functions for histogram manipulation (rebinning, addition, projection, etc.). These function template calls may be completed with existing histogram names by dragging histogram items from the browser and dropping them on the empty command argument. The history of the command line may be saved to the current Go4 settings file .go4/go4localrc and is then restored on next startup. (See 6.17, page 81).

2. New GUI command interface class TGo4AbstractInterface. It can be accessed by handle "go4->" in GUI command line. This makes it possible to interact with Go4 GUI views and browser objects in a ROOT/Go4 script. Additionally, all remote analysis control commands are available here, like in the hot start scripts. Method reference of TGo4AbstractInterface is available in the Go4 help viewer (type "help" in GUI command line, or use Help►GUI commandline menu of Go4 main window). Example scripts using this interface are at $GO4SYS/Go4GUI/scripts (definitions of the preloaded command line histogram functions). Note: have been moved to $GO4SYS/macros in V3.2.

3. New general marker label settings dialog. In main window menu Settings►Panel Defaults►Marker labels.., a checkbox dialog offers to switch all label properties of the region and point markers (visibility and information displayed in the label). These settings have effect on all new markers of the view panel marker editor. They are saved in the go4 preferences file .go4/go4localrc. (see 6.7.6, page 64)

4. Plain ROOT canvases in files are better displayed.

5. New settings feature Settings►Preferences►Fetch when saving. If enabled, the save browser / save memory button of the file toolbar will refresh all browser item objects from analysis before saving. Thus the ROOT file will contain a snapshot of all analysis objects. Otherwise, only the already fetched objects are saved.

6. Zoom tools "set scale" dialog upgraded to non modal MDI widget. This will appear always on top of workspace widgets and refers to currently selected view panel pad. Changes include some bug fixes concerning the range settings of 2d histograms, and the auto-scale property.

7. MBS monitor tool: If monitoring switched on, calculation of rates is now done in Go4, averaged over update time. Parameters of MBS monitor are stored in Go4 settings file.

8. TGo4Interface: new method ExecuteLine to remotely do CINT call from Go4 master process in the remote slave process

9. View panel superimpose mode improvements:

a. is not changed anymore after superimposed draw of FitPanel results, i.e. fitter data histogram can now be replaced just by drag and drop on the view panel

b. existing axis labels of first histogram are kept

10. FitPanel settings are saved/restored in go4 settings file

11. Fit GUI: Enhanced draw styles for TGraph

12. Bugfixes:

a. Workaround for ROOT crash in histogram rebin editor: Selecting a histogram in view panel for rebin with the ROOT attributes editor leads to segmentation violation when original histogram was replaced or deleted.

b. Crash in Go4 markers/conditions when histogram in view panel was replaced by drag and drop.

c. Update of histogram in GUI failed when histogram dimensions (ranges) were changed in analysis

d. Position and size of histogram statistic label may now be saved in Go4 picture objects. Thus these properties can be restored on Go4 hot start.

e. Crash on closing last non-minimized window in view panel

f. Problem with empty TGraph as data source in Fitter

g. Crash when FitPanel histogram under work was replaced or deleted in view panel. FitPanel did not react automatically on changes, happening with histograms (or graphs), displayed on view panel. Therefore, when superimpose mode was switched off, fitted histogram disappeared from view panel (and also deleted), while fitter still has pointer on that histogram. Now FitPanel slot in object manager registered also against all histogram, used in fitting. If histogram is deleted, FitPanel will be automatically refreshed.

h. Histogram title could not be switched off in superimpose mode in view panel

13. Improvements in make files

14. Adjustments of includes due to changes in new ROOT version 5.10

2.5 New features in Go4 v3.00 (November05)

Redesign of the GUI with new internal object manager. Decoupling of controlling functionality from the Qt graphics layer. Effects many of the following features.
New Go4 browser. Instead of several tabs for remote analysis, local memory, monitoring list, now one browser with sub-branches for different data sources, such as remote analysis, histogram servers, root files, is used. Supports local memory workspace folder with copy and paste by drag and drop, clipboard, and renaming. All controls available via right mouse button context menu. Switchable columns for object properties. Filter for monitored, fetched, and all objects.
New view panel. Improved marker editor with lightweight condition editor. Additional options to display date and time of refresh, and full object path. Can display same object with different draw styles and ranges simultaneously. May store current setup as Go4 picture.
New condition editor: More compact layout, shares functionality with view panel marker editor.
Improved parameter editor: May display user parameter structure without loading the user analysis library into the GUI. Suppresses display of unknown components.
New dynamic list editor: More compact layout. Automatic resolving of event name and data member name when dragging and dropping from analysis event structure, in case of pointer entry. Dito for tree name and draw expression in case of tree entry.
New dockwindow for analysis terminal. If analysis is started in external shell, functionality of analysis output window (macro execution, etc.) shrinks to dockwindow.
Improved dialogs for analysis startup and connection.
Decoupling of libraries from GUI. GUI does not require all analysis libraries anymore due to changes in command pattern and dependency rearrangements. Will speed up GUI startup time and may reduce memory consumption.
Status monitor for remote MBS node. New dockwindow offering connection to the mbs status port. Frequently update of daq rates and status possible. Trending histograms in browser workspace. Full printout of mbs status and setup structures possible.
Go4 analysis status bar improved. Animated Go4 logo shows true running state of analysis, independent of current event rate. Current event source of first active step displayed per name in text field.
Remote control of Go4 analysis from regular ROOT session. Command interface to connect and control analysis process from CINT. Inspecting and retrieving Go4 objects with extended root TBrowser possible.

2.6 New features in Go4 v2.10 (June05)

Go4TaskHandler redesign: Decouple client and server tasks from master and slave role. This implies that analysis can run in the network both as server or client task (as in previous Go4 versions). Vice versa, gui can run either as client or as server (previous behavior). Additionally, TGo4AnalysisClient class now inherits TGo4Slave (previously TGo4ClientTask), and TGo4Display inherits TGo4Master (previously TGo4ServerTask). One analysis server can be connected by many Go4 GUIs (one controller/administrator GUI, and several observer GUIs).
Go4TaskHandler redesign: Password for login of master client to slave server with accounts for administrator, controller, and observer roles. Additionally, some Go4 commands are forbidden if master is logged in with a low priority account (observer e.g. may not reconfigure analysis, but only request objects for display). Default passwords may be changed in MainUserAnalysis code (see chapter 6.3.2 page 46).
Go4GUI prepared to run with analysis server: Command go4 -client will start the GUI master task in client mode. In this case, the Launch analysis dialogue requests for login account, password, node and connection port of the analysis server. Moreover, a client GUI may first launch a new analysis server in an xterm and connect to it afterwards (see chapter 6.3.2 page 46).
Example of analysis server in package Go4Example2Step: MainUserAnalysis may be started from command line with option –server as third argument (first arguments like batch, see 5.5.1,page 37), thus starting the analysis as server. Processing starts immediately (no submit from GUI necessary). Command line parameters of this example will set additional boolean arguments (servermode, autorun) of TGo4AnalysisClient constructor appropriately (see chapter 6.3.2 page 46).
ROOT macro execution with Go4 analysis server: A Go4 environment and analysis server can be started from any ROOT session in the background (.x go4Init.C). Go4 GUIs may connect to this server and request data from running analysis macros, or control macro via Start/Stop buttons. New methods TGo4Analysis::WaitForStart() to poll for the Go4 environment running state, and TGo4Analysis::Process() to invoke the Go4 analysis loop explicitely from ROOT macro (checks also for STOP). Example macros hsimple.C, hsimplego4.C and treedrawgo4.C. See chapter 7 page 82.
Analysis: UserPreLoop() and UserPostLoop() are only executed once when analysis running state is changing. In previous versions, each press on Start, or Stop button, respectively, would execute the corresponding method another time. Bugfix: postloop was called twice if analysis client was terminated in running state.
Bugfix: MbsAPI/f_evt.c (close of streamserver).