HepInventor

HEPInventor is a graphical library providing an interface between the histogram data structures defined by the HTL package and graphics (MasterSuite). The aim of this package is to provide an easy to understand and easy to use way to present physics data.

HEPInventor is designed to be use in batch programs. Some examples of use are given in the HEPInventor manual (PS version). An installation guide is also available.

HepInventor has been presented in:

• LHC++ workshop, June 1997.
• LHC++ meeting (11-12-1997).
• LHC++ workshop (29-09-1998).

• HEP graphics requirements for data presentation
• Some guidelines for a HEP graphics strategy
• A document explaining how Mastersuite is used inside HEPInventor

• 10/10/97 HIPage: Mods to avoid loading the X11 Xt Xm etc .. libraries when HI routines are used in a IE module.
• 09/04/98 The convertion methods (cm to view) are now in the HIPage class.
• 17/04/98 Some 2D histogram representations are available (box, ellipse, color).
• 17/04/98 New class: HIPalette to defined the color palette used to draw 2D histograms with the option color.
• 17/04/98 It is possible to print the histogram statistics.
• 20/04/98 In case of log scale on data having a minimum negative or null and a maximum greater than zero, the minimum is set to maximum/1000.
• 05/05/98 Line width can be changed on 1D representations.
• 06/05/98 Line pattern can be changed on 1D representations.
• 07/05/98 Bug fixed in HIData (2D): npty was used instead of nptx for X values.
• 28/05/98 New method to set the zone position.
• 28/05/98 When a picture containing log scale was drawn several time we didn't get the same picture all the time.
• 28/05/98 HIZone allows to define the space coordinates at creation time.
• 18/06/98 DataDomain removed. Only 2 domains are now created for each HIZone: the CMDomain and the AxisDomain. This fixes the problem of data drawing shifted in case the aspect ratio of the window is not square.
• 29/06/98 New constructor for 2D matrices.
• 29/06/98 Faster drawing of 2d histograms in box mode.
• 03/07/98 Faster drawing of 2d histograms in color mode.
• 03/07/98 New methods in HIData : computeMinMax and setMinMax for 1d data sets.
• 08/07/98 HIData: Constructor for 2D matrix requires now x(nx) y(ny) z(nx*ny)
• 10/07/98 HIData: 2D matrices are read row by row
• 10/07/98 Axis titles are now available (see documentation)
• 08/09/98 Bug fixed: empty 2D histograms produced an infinite loop.
• 08/09/98 HIData: protection added in drawBox and drawColour in case zmin == zmax
• 23/09/98 New class HIComment to put comment in a zone in cm or zone coordinates.
• 24/09/98 New routine HIDrawtext.
• 20/10/98 New management of statistics. The original HIStats class has been split in three classes:
  • HITable - a base class for a table of values/labels
  • HIStats - derived from HITable, implements the values/labels for histogram statistics
  • HITableDrawer - A class to draw an HITable
  This new implementation clearly separates the drawing of a table from the management of its content, allowing for other table objects (e.g. table of fitting results).
• 25/11/98 New class HIPostScript to manage PS files.
• 08/12/98 The Draw method in HIPage creates the SceneGraph and do a ref() on it. The Draw method of HIPage has only two parameters now.
• 08/12/98 HIZone::Draw returns a scene graph. The addChild in the Page SceneGraph is done by HIPage::Draw.
• 21/01/99 New class HIPageManager to manage several zones in a Page.
• 05/02/99 Use HIDrawtText to draw statistics because the MasterSuite class PoLabelField (which is normally the more appropriate class to do that) is not able to use automatically Exponent format when needed (C format "g") :-( .
• 09/02/99 HIData: Mods to have the minimum of the histogram drawn equal to 0... like in PAW :-)
• 10/02/99 Possibility to move the axis in a Zone. Usefull to have several coordinates system in one "zone".
• 17/02/99 New attribute to set the error bars color (HIData).
• 17/02/99 Draw the error bars with PoErrorPointField to allow the X errors drawing (HIData).
• 18/02/99 Default error bars color was not set correctly (HIData).
• 19/02/99 HIData.setMinMax works now on 2d data.
• 19/02/99 Errors in log scale.
• 25/02/99 Support for the HTL package.
• 25/02/99 HIStats: Got rid of ALLCHAN. UNDFLW & OVRFLW are set only when != 0.
• 11/03/99 PbDomain was changed to PoDomain due to problems with IRIS Explorer.
• 17/03/99 New class HILego added
• 19/03/99 HIPageManager: getNextZone returns 0 for the last HIZone.
• 30/03/99 One more parameter to HIData HTL's constructor allows to select alternate error for profile histograms.
• 30/03/99 Linux Version.
• 30/03/99 First version of the scatter plot.
• 01/04/99 HIZone: New method ClearComments() which removes all comments from a zone.
• 09/04/99 Fixed some []delete vs delete.
• 09/04/99 Use fabs() rather than abs() on real values. Got rid of unused include of histogram stuff.
• 09/04/99 Statistics on 2D histos.
• 09/04/99 HIStats: Use label names to identify statistics items rather then enums.
• 12/04/99 Fixed bug in HTL constructor: was accessing the y partition using the no. of bins of the x partition (worked fine for symmetric histograms...).
• 12/04/99 Useless input parameter PbDomain removed in some drawing methods.
• 15/04/99 HILego: Fixed bug in HTL constructor: was accessing the y partition using the no. of bins of the x partition (worked fine for symmetric histograms...).
• 20/04/99 Changed constructor for vector with errors. The width of the 'x error' was too large and the artificial point at the right side was created with a unitary offset which caused the lattice to be shrunk when displayed in IE Render window. Now the 'x errors' are set to left bin width divided by two and the last 'artificial' point has x coordinate equal to the coordinate of the rightmost point of the last x error bar.
• 20/04/99 HIData: MIN and MAX set for Errors representations
• 23/04/99 Modifications to call unref() on the page scene graph.
• 17/05/99 First attempt to make switching to possible.
• 27/05/99 HILego: The limits on X and Y were taken as bin number rather than as values (i.e. [0,7] meant from bin 0 to bin 7...)
• 02/07/99 HIData: New methods to set separately min/max along x,y,z. Modified methods drawBox, drawColour and drawEllipse to properly take care of those limits (required by NA45).
• 05/08/99 HIData: manage x y z limits in the case of colour plots.
• 23/08/99 HILego: Fixed problems with memory management: pionter assignments of dynamic memory caused crashes on Linux HistOOgramLego module. Some indentation changed. The code does not work properly for 1D histos yet.
• 13/10/99 HIWindow: Modifications for NT only. Get rid of undefined symbol PoBaseView::viewingEventCB etc. when linking.
• 15/10/99 HIComment: Angle and justification added.