ZOOM HepTuple Package Release Notes

9/15/04

HepTuple v2.3.0 cvs rtag V02-03-00

Remove all references to STLUtility and let the (now) standard-conforming standard library containers do the work.

7/11/03

HepTuple v2.2.3 cvs rtag V02-02-03

Clarify the message text for the ZMHepCantMakeHist exception and update the documentation
• Update the documentation, adding a tutorial note on how and why to use the setTitle( string title ) member function. Note that this function is effective only for Root file managers.

5/15/03

HepTuple v2.2.1 cvs rtag V02-02-01

Independent Histogram titles update
• Re-do the logic of allowing different histogram object names and titles in a cleaner way. The original scheme worked but made histogram objects very hard to retrieve from a file.
  N. B. The user interface is unaffected by this change.

4/4/03

HepTuple v2.2.0 cvs rtag V02-02-00

Fix for variable-length ntuple arrays with more than one dimension. Too few data items were being moved to the internal buffer.
Independent Histogram titles
• Add the necessary machinery to allow the user to make the histogram title different from the histogram name. This was done for the Root manager only. Without this, Root macro files got very tricky for a TH1 object where the name contained whitespace. Now the user can give the object a simple name AND a descriptive title.
• Add to the setTitle documentation a note on how to use the function for Hist1DArray, Hist2DArray and HistProfArray objects.
Fix a glitch in a tests makefile
(extra space after a semicolon).
Resolve variable name clash in test program.
One of the test programs stopped compiling because of a type clash between one of its variables and something newly placed in ROOT. Rename our variable.
Proper use of ISOcxx for no-exception environment
The GNUmakefile for HepTuple/root never set USE_ISOCXX = true. This was OK for the D0 and ZOOM environments where we don't want -DDEFECT_NO_EXCEPTIONS but made a glorious mess for the CDF environment where that macro needs to be defined.
Avoid multiple versions of symbol at link time.
Explicitly declare a method coded in newManager.h as inline. We need to say so. Otherwise we get multiple copies and some linkers get upset.
Multiple index variables with the same names (Root manager only)
Fix another manifestation of the old bug about allowing multiple index variables by the same name in different blocks.
The whole issue of multiple columns with the same tag name (in distinct blocks) violates an original design percept (that files be usable with PAW and so forth). In consequence, changes to allow for this would need to percolate through the whole package. The issue of whether to backtrack on allowing this capability is on hold for now. In the meantime, we do not recommend using this incomplete "feature."
Link warning eliminations
• Shut off all those annoying link messages about multiple versions of libm.so in Examples
Test build corrections
• Make all of the HepTuple TBINS that require Root to be set up conditional on $ROOTSYS. These are hepAnonymous, hepTestHBtoR, tableToCWN and FileSwitch.

9/13/02

HepTuple v2.1.8 cvs rtag V02-01-08

Fix variable-length multi-dimensional arrays bug
When using capture(tag,&data,indexVal), to capture data for a variable length array with more than one dimension, too few data items were being moved to the internal buffer.
Independant Hisogram titles
• Add the necessary machinery to allow the user to make the histogram title different from the histogram name. This was done for the Root manager only. Without this, Root macro files got very tricky for a TH1 object where the name contained whitespace. Now the user can give the object a simple name AND a descriptive title.
• Add to the setTitle documentation a note on how to use the function for Hist1DArray, Hist2DArray and HistProfArray objects.
Fix a glitch in a tests makefile
(extra space after a semicolon).
Resolve variable clash in test program.
One of the test programs stopped compiling because of a type clash between one of its variables and something newly placed in ROOT. Rename our variable.
Proper use of ISOcxx for no-exception environment
The GNUmakefile for HepTuple/root never set USE_ISOCXX = true. This was OK for the D0 and ZOOM environments where we don't want -DDEFECT_NO_EXCEPTIONS but made a glorious mess for the CDF environment where that macro needs to be defined.
Avoid multiple versions of symbol at linking time.
Explicitly declare a method coded in newManager.h as inline, we need to say so. Otherwise we get multiple copies and some linkers get upset.
Multiple indices with similar names
Fix another manifestation of the old bug about allowing multiple index variables by the same name in different blocks.
The whole issue of multiple columns with the same tag name (in distinct blocks) violates an original design percept (that files be usable with PAW and so forth). In consequence, changes to allow for this would need to percolate through the whole package. The issue of whether to backtrack on allowing this capability is on hold for now.
Link warning eliminations
• Shut off all those annoying link messages about multiple versions of libm.so in Examples
Test build corrections
• Make all of the HepTuple TBINS that require Root to be set up conditional on $ROOTSYS. These are hepAnonymous, hepTestHBtoR, tableToCWN and FileSwitch.

7/24/02

HepTuple v2.1.7 cvs rtag V02-01-07

Check supplied indices against variable span.
Add a test to make sure the index variable span is declared with the same value as the (variable) dimension of the array it indexes. That test wasn't there earlier and improper indices are suspected to be the cause of some wierd and subtle error when the corresponding file is fed to Root.
Proper sums of squares in profile Histograms.
Fix HepRootHistProf.cc to compute sum W*Y^2 instead of sum (W*Y)^2 as advertised.
Updating and monitoring open files.
Put in the changes needed for updating an open file so that monitoring processes can see the updates. add an example job to demo this.
Improved cosmetics options in ROOT Histograms
• Add member functions to the Root inheritance branch to allow the user to supply text for a centered label for x and y axes of 1D, 2D and Profile histograms.
• Allow the user to set a text string label for the z axis as well as the x and y axes. Again, this is meaninfull with the Root manager and dummy for the others.
Validation suite.
Clean up and rationalize the test suite in preparation for making it into a (nearly) standalone process.

4/23/02

HepTuple v2.1.5 cvs rtag V02-01-05

Replace the standard but broken mktemp with the nonstandard mkstemp.
Use the nonstandard mkstemp everywhere it is available, instead of the standard but inferior mktemp. Eliminates warnings in gcc 3.
Correct an oversight in HepRootFileManager::write()
For a user-requested write NOT followed by a job shutdown, not quite enough was written out. In particular, some Root specific information about the file was omitted. It's there now.

02/07/02

HepTuple v2.1.3 cvs rtag V02-01-03

Make the HepRootNtuple library build ISOcxx-aware.
Use all the standard ISOcxx machinery when building the HepRootNtuple library. This allows portions of this code to be used in other contexts and allows processing with rootcint.

12/21/01

HepTuple v2.1.2 cvs rtag V02-01-02

Checking file open mode.
When a user specifies the OR of multiple mode bits when opening a file, the manager now checks that the specified combination makes sense and can be handled.
More corrections to rectify -Wall warnings
Changes in wording of Log Message for clarity.

HepTuple v2.1 cvs rtag V02-01-00

Add missing setColumnDefault() method for Ntuples
columnDefault() method is still used to retrieve default value.
Protection against trying to capture more data than array range
This is still an error, but the silent behavior of overrunning index limits and clobbering the internal buffer is replaced by a more friendly ZMthrow of an exception.
Corrections to rectify warnings
Due to new settings in SRT, compilations were done on gcc 3.0.1 using -Wall and -pedantic options; these revealed a host of warnings which have now been rectified.
Recovery of Root files after crash
Code in the Root file manager gives the users a (limited) chance to recover all or most of the data written to a Root file, after a crash had terminated the writing job.
Document signature of Ntuple::capture() that takes array length
capture(columnName,location,length)
Removal of a misimplemented test
Minor updates in the Heptuple/root subdirectory
Ability to OR various req_mode parameters
In the Root manager, when opening a file, the user can specify various `requested modes.' These are specified by values of an enum. It turns out that some of these logically can co-exist. The code was modified so that multiple modes can be requested by OR-ing the approriate enum values.
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
ISOcxx v1.1 or higher
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher for histoscope
• root v2_26_00 or higher for ROOT
Platforms
HepTuple curently compiles and runs on (at least) the following:
• KAI 4.0d on IRIX6
• KAI 4.0f on Linux FRHL6.x and 7.1
• KAI 4 on CDF's Sun server
• KAI 4 on an Alpha OSF/1
• gcc 2.95.2 on IRIX6
• gcc 2.95.2 on Linux
• gcc 3.0.1 on Linux
• KAI on NT MSVC++ 6

10/19/01

HepTuple v2.0.9 cvs rtag V02-00-09

Duplicate column names
HepTuple is not advertised to allow duplicate column names in different blocks, and in fact the HBook manager (and PAW down the road) will never accept that. However, the ROOT manager does accept identical names in different blocks, and the following related fixes were done:
• Add an update to the documentation saying that the condition of unique column names across the entire ntuple has been relaxed, but for the Root manager ONLY!
• add a warning that one must use the full nametag for all capture calls to avoid data storage ambiguities.
• A bug that had caused it to screw up the specification of the span for index variables was fixed.
• Code was inserted to allowed ROOT versions at or below 3.01.06 to work with duplicate column names
Fix a subtle error in the Root FileManager destructor.
Treatment of void* cast to int.
When capturing index variables, the code involved a C-style cast of a void* to int. OSF1 objected to this, since on that system these types are of different sizes. Instead, improved and correct code (using a small template) was substituted.
New checks and exceptions:
• When captures are made involving index variables, check that they are within their advertised span. Without this check, if a mistake were made the data buffer would silently get clobbered.
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
ISOcxx v1.1 or higher
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher for histoscope
• root v2_26_00 or higher for ROOT
Platforms
HepTuple curently compiles and runs on (at least) the following:
• KAI 4.0d on IRIX6
• KAI 4.0f on Linux FRHL6.x and 7.1
• KAI 4 on CDF's Sun server
• KAI 4 on an Alpha OSF/1
• gcc 2.95.2 on IRIX6
• gcc 2.95.2 on Linux
• gcc 3.0.1 on Linux
• KAI on NT MSVC++ 6

8/28/01

HepTuple v2.0.5 cvs rtag V02-00-05

New features in release.
New checks and exceptions:
• Added a new exception in several places in ColumnT to catch the case where the user has not specified a span for an index variable.
• Test for the user presenting a value for an index variable that is bigger than the previously advertised maximum value. ZMthrow if it occurs.
Problem fixes:
• Fix an obscure bug in HepHBookFileManager concerning a slight misfire in the implementation of HepFileManager::cd( string target ) when target was "//".
• Remove an ill-advised test on column name string length in HBookNameTag.cc. There is a requirement on block name string length but not column names.
Documentation improvements:
• Add some documentation for the Hist1DArray, Hist2DArray and HistProfArray classes.
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
ISOcxx v1.1 or higher
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher for histoscope
• root v2_26_00 or higher for ROOT

7/11/01

HepTuple v2.0.4 cvs rtag V02-00-04

New features in release.
Make HepTuple work using release 3.0 of ROOT as the file manager.
HepTuple will still also work using ROOT 2.26.
Documentation fix:
Improved a misleading example of making Ntuples.
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
ISOcxx v1.1 or higher
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher for histoscope
• root v2_26_00 or higher for ROOT

5/2/01

HepTuple v2.0.1 cvs rtag V02-00-01

New features in release.
Updates of LIBDEPS file.
Cleanup of examples and their documentation.
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
ISOcxx v1.1 or higher
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher for histoscope
• root v2_26_00 or higher for ROOT

4/4/01

HepTuple v2.0 cvs rtag V02-00-00

Production release (No longer beta.)

No new features in release.

• ProblemTracking
• FeatureLog
• SupportLog

  Dependencies:

  ZMutility v1.3.7 or higher
  Exceptions v1.2.1 or higher
  ISOcxx v1.1 or higher
  Optional:
  • Cernlib library must be linked in for HBOOK
  • histo v5_0_3a0 or higher for histoscope
  • root v2_26_00 or higher for ROOT

4/4/01

HepTuple v1.7.9 cvs rtag V01-07-09

New Features in release:
New values for opening mode:
• HEP_REMOVE blows away existing file of that name, if present.
• HEP_RENAME renames existing file of that name, if present.
Optional mode argument in newManager()
Read only, update (default), remove
Fix namespace typo in newManager()
Documentation clarifications and improvements
• clarification for ls() and list()
• documentation of missing routines in histogram pages
• a page gathering all the limitations information
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
ISOcxx v1.1 or higher
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher for histoscope
• root v2_26_00 or higher for ROOT
Restrictions:
Bug in HBOOK with regard to columns of doubles in N-tuples (as earlier)
Impractical to do static instantiation of nTuple and histogram objects (as earlier)
HBOOK Columwise Ntuples are restricted to 50 variables.

3/22/01

HepTuple v1.7.7 cvs rtag V01-07-07

New Features in release:
Modifications for usage on MSVC++ on NT.
Functions that open HepTuple files without knowing type.
• HepFileManager* newManager(name);
• HepTupleFileFormat hepFileType(name);
Fix so that KCC complier does not choke on long long declarations
Update on documentation
Web pages now reflect 2 features that were added a while back.
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
ISOcxx v1.1 or higher
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher for histoscope
• root v2_26_00 or higher for ROOT
Restrictions:
Bug in HBOOK with regard to columns of doubles in N-tuples (as earlier)
Impractical to do static instantiation of nTuple and histogram objects (as earlier)
HBOOK Columwise Ntuples are restricted to 50 variables.

3/16/01

HepTuple v1.7.5 cvs rtag V01-07-05

New Features in release:
Fix behavior when zero weight is encountered.
Avoid potential division by zero.
Minor documentation cleanups. Clean up a few lingering details in the examples.
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
ISOcxx v1.1 or higher
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher for histoscope
• root v2_26_00 or higher for ROOT
Restrictions:
Bug in HBOOK with regard to columns of doubles in N-tuples (as earlier)
Impractical to do static instantiation of nTuple and histogram objects (as earlier)
HBOOK Columwise Ntuples are restricted to 50 variables.

3/7/01

HepTuple v1.7.3 cvs rtag V01-07-03

New Features in release:
Add the combine member function to HepFileManager.
This allows you to combine the histogram contents of two files. The contents of corresponding histograms are added; any histogram appearing without a corresponding one will be added into the accumulating file.

Accomodations for MSVC++ in the example programs.
Makefile mod on IRIX to avoid table space crunch.
Clean up a few lingering details in the examples.
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
ISOcxx v1.1 or higher
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher for histoscope
• root v2_26_00 or higher for ROOT
Restrictions:
Bug in HBOOK with regard to columns of doubles in N-tuples (as earlier)
Impractical to do static instantiation of nTuple and histogram objects (as earlier)
HBOOK Columwise Ntuples are restricted to 50 variables.

2/23/01

HepTuple v1.7.2 cvs rtag V01-07-02

New Features in release:
Makefile mods to build under SRT on NT.
Repair of mixup in string passing conventions.
The wrong Fortran passing convention was used in one case. This had been causing the HBOOK mamanger to misbehave (core dump) in some circumstances.

Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
ISOcxx v1.1 or higher
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher for histoscope
• root v2_26_00 or higher for ROOT
Restrictions:
Bug in HBOOK with regard to columns of doubles in N-tuples (as earlier)
Impractical to do static instantiation of nTuple and histogram objects (as earlier)
HBOOK Columwise Ntuples are restricted to 50 variables.
HBOOK columnwise Ntuples are restricted to no more than 50 named variables per block. Each array -- either fixed length or variable length -- counts as a single named variable. In addition, the total number of items, counting each array element as a separate item, is limited to 50,000 for floats and 5,000 for doubles.
A good workaround is to have multiple blocks; each may have up to this many variables.

1/22/01

HepTuple v1.7 cvs rtag V01-07-00

New Features in release:
Make HepTuple work using release 2.26 of ROOT as the file manager.
Repair syntaxe error in HepHBookFileManager that was caught by KAI 4.0.
Fix problem with tagname containing an index name.
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
ISOcxx v1.1 or higher
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher for histoscope
• root v2_26_00 or higher for ROOT
  HepTuple 1.7 will not work with ROOT 2.25 or earlier
Restrictions:
Bug in HBOOK with regard to columns of doubles in N-tuples (as earlier)
Impractical to do static instantiation of nTuple and histogram objects (as earlier)
HBOOK Columwise Ntuples are restricted to 50 variables (as earlier)

9/12/00

HepTuple v1.6.22 cvs rtag V01-06-22

New Features in release:
Make HepTuple work using release 2.25 of ROOT as the file manager.
Raise the requested block quote (for columnwise Ntuples) to 65000.
This allows you to write as big an Ntuple as the current HBOOK will allow.
Adapt to work on gcc 2.95-2 and on Sun platforms.
Fix bug that was prevent users from writing output files into arbitrary directories.
Eliminate code flaws that were generating warnings under KAI 4.0.
Fix typo in documentation of HepHist1D, and augment other documentation.
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
ISOcxx v1.1 or higher
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher for histoscope
• root v2_23_00 or higher (including 2_25_00) for ROOT
Restrictions:
Bug in HBOOK with regard to columns of doubles in N-tuples (as earlier)
Impractical to do static instantiation of nTuple and histogram objects (as earlier)
HBOOK Columwise Ntuples are restricted to 50 variables (as earlier)

5/16/00

HepTuple v1.6.5, cvs rtag V01-06-05

Block New Features in release:
Ntuples
Fixed potential memory management problem that was not painful since most users rarely delete Ntuples during a job.
Root 2.24.04a
Support for Root 02_24_04a (but does not require this version).
Root branches
ROOT filemanger can elegantly support branches with TObject (was actually present in HepTuple 1.5).
Platforms checked:
KAI on d02ka with D0 environment
KAI on cdfsga with CDF environment
KAI on RedHat 5.0 (cdfpca) with CDF environment
NT with Microsoft C++ 5.0 with D0 environment
egcs 1.1.1 on fnpat1
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
ISOcxx v1.1 or higher
Optional:
Cernlib library must be linked in for HBOOK
histo v5_0_3a0 or higher for histoscope
root v2_22_06 or higher for ROOT
Restrictions:
Bug in HBOOK with regard to columns of doubles in N-tuples (as earlier)
Impractical to do static instantiation of nTuple and histogram objects (as earlier)
HBOOK Columwise Ntuples are restricted to 50 variables (as earlier)

3/14/00

HepTuple v1.6 cvs rtag V01-06-00

New Features in release:
Take advantage of ISOcxx portability
Remove contortitions that were there for old gcc.
These had been fouling up NT.
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
ISOcxx v1.1 or higher
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher for histoscope
• root v2_23_00 or higher for ROOT
Restrictions:
Bug in HBOOK with regard to columns of doubles in N-tuples (as earlier)
Impractical to do static instantiation of nTuple and histogram objects (as earlier)
HBOOK Columwise Ntuples are restricted to 50 variables.
HBOOK itself does not handle columnwise Ntuples with more than 50 variables in a block. A good workaround is to have multiple blocks; each may have up to 50 variables.

2/15/00

HepTuple beta release: v1.5.8; cvs rtag V01-05-08

New Features in release:
Rationalized the names of the bin and tbin test files.
In particular, toyz.cc and its output files are now named hepToyz.*.
Platforms checked:
KAI on d02ka with D0 environment
KAI on cdfsga with CDF environment
KAI under RedHat 5.0 on cdfpca with CDF environment
egcs 1.1.1 on fnpat1
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
Cernlib library must be linked in for HBOOK
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher
• root v2_22_06 or higher
Restrictions:
Bug in HBOOK with regard to columns of doubles in N-tuples (as earlier)
Impractical to do static instantiation of nTuple and histogram objects (as earlier)

9/29/99

HepTuple beta release: v1.5.3; cvs rtag V01-05-03

New Features in release:
Split of libHepTuple.a into a generic library (still libHepTuple.a) and an HBook specific directory and library libHBookHepTuple.a Fix a bug in disableling the versionning in the ROOT filemanager. Fix a few problem with column arrays of dimension 2 and more in the ROOT filemanager. Remedy, by a change in GNUmakefile, the annoying issueing of warnings about overiding one of several virtual signatures.
- Correct the LIBDEPS files.

Platforms checked:
KAI on d02ka with D0 environment
KAI on cdfsga with CDF environment
KAI under RedHat 5.0 on cdfpca with CDF environment
MSVC++ 5.0 under NT with D0 environment
egcs 1.1.1 on fnpat1
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
Cernlib library must be linked in for HBOOK
Optional:
• Cernlib library must be linked in for HBOOK
• histo v5_0_3a0 or higher
• root v2_22_06 or higher
Restrictions:
There is a bug in HBOOK with regard to columns of doubles in N-tuples:
These are NOT portable among platforms with different endian-ness (SGI vs Intel/Dec). This inconvenience will NOT be present with the Histoscope manager.
It is currently impractical to do static instantiation of nTuple and histogram objects.

8/5/99

HepTuple beta release: v1.5; cvs rtag V01-05-00

New Features in release:
Upgrade the ROOT filemanger to be able to elegantly support branches with TObject. In the case of split it will see it as a block of elementary type. A new column type will also be introduced and support only by the ROOT filemanager that will let the user create Columns of TObjects.
In the ROOT Filemanager add a constructor switch to select whether the object are versioned or not in the file.
The toyz program has been upgraded to work alternatively with HBook and ROOT (with a command line switch)
Fix behavior of ROOT with index arrays
Add '..' as manager-independent way to navigate directories
Insure that when using HBook, the index column is always read back with an index array.
Insure that the HBook limitation to 16 characters for a directory name is gracefully handled.
Change the internal debugging macro TRACE to HEP_DEBUG to avoid conflict with the microsoft libraries.
Gracefully fails when an illegal character is used in a title.
Update for KAI 3.4.

Platforms checked:
KAI on d02ka with D0 environment
KAI on cdfsga with CDF environment
KAI under RedHat 5.0 on cdfpca with CDF environment
MSVC++ 5.0 under NT with D0 environment
egcs 1.1.1 on fnpat1
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
Cernlib library must be linked in for HBOOK
Optional:
• histo v5_0_3a0 or higher
• root v2_22_06 or higher
Restrictions:
Bug in HBOOK with regard to columns of doubles in N-tuples (as earlier)
Impractical to do static instantiation of nTuple and histogram objects (as earlier)

6/3/99

HepTuple beta release: v1.4.9; cvs rtag V01-04-09

New Features in release:
Fixed Root manager's treatment of column arrays
Fixed Root manager's directory management
Cleanup of inappropriate CXXCFLAGS in makefile
Platforms checked:
KAI on d02ka with D0 environment
KAI on cdfsga with CDF environment
KAI under RedHat 5.0 on cdfpca with CDF environment
MSVC++ 5.0 under NT with D0 environment
egcs 1.1.1 on fnpat1
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
Cernlib library must be linked in for HBOOK
Optional:
• histo v5_0_3a0 or higher
• root v2_21_08 or higher
Restrictions:
Bug in HBOOK with regard to columns of doubles in N-tuples (as earlier)
Impractical to do static instantiation of nTuple and histogram objects (as earlier)

5/19/99

HepTuple beta release: v1.4.8; cvs rtag V01-04-08

New Features in release:
Minor bugfixes.
Correction of LIBDEPS file.

4/30/99

HepTuple beta release: v1.4.4; cvs rtag V01-04-04

New Features in release:
Arrays of Histograms.
See the include file HepHist1DArray.h for detailed information.
Implemented the HepNtuple class for the ROOT filemanager.
It is now as the same functionality as the HBook and Histo filemanager. However columns containing TObjects are not yet supported. Aee Warning and Coming soon for ROOT specific information.
Small bug fixes.
Port to work with egcs v1.1b
(Not an official ZOOM-supported platform
Platforms checked:
KAI on d02ka with D0 environment
KAI on cdfsga with CDF environment
KAI under RedHat 5.0 on cdfpca with CDF environment
MSVC++ 5.0 under NT with D0 environment
egcs 1.1.1 on fnpat1
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
Cernlib library must be linked in for HBOOK
Optional:
• histo v5_0_3a0 or higher
• root v2_21_08 or higher
Restrictions:
Bug in HBOOK with regard to columns of doubles in N-tuples (as earlier)
Impractical to do static instantiation of nTuple and histogram objects (as earlier)
Warning:
The ROOT filemanager uses TTree to implement HepNtuple. When reading a file with TTree that has not been created by HepTuple, we currently ignore ALL branches that have been created with a TObject. The only branch creation supported is the TTree::Branch call that take a leaflist as an argument.

3/16/99

HepTuple beta release: v1.4; cvs rtag V01-04-00

New Features in release:
Arithmetic on histograms.
You can now add, multiply and divide any histograms together (independently of their respective managers).
Appending ntuples.
You can append two ntuples with the same layout independently of their respective managers.
Cloning.
You can now duplicate the structure (makeEmpty) or both the structure and the content (makeClone) of any histogram or ntuples, of course independently of their respective managers.
The Root and HBook filemanagers are now fully available on nt.
Read Only Files.
HepTuple can now open (and read contents of) manager files that are protected as Read-only.
All methods which accept char* also now accept string arguments.
Bug fixes related to directory management in HBook
Platforms checked:
KAI on d0chb with D0 environment
KAI on cdfsga with CDF environment
KAI under RedHat 5.0 on cdfpca with CDF environment
gcc on cdfsga (6.2) and fncrdn (IRIX 5.3)
MSVC++ 5.0 under NT with D0 environment
Dependencies:
ZMutility v1.3.7 or higher
Exceptions v1.2.1 or higher
Cernlib library must be linked in for HBOOK
Optional:
• histo v5_0_3a0 or higher
• root v2_00_13 or higher
Restrictions:
There is a bug in HBOOK with regard to columns of doubles in N-tuples:
These are NOT portable among platforms with different endian-ness (SGI vs Intel/Dec). This inconvenience will NOT be present with the Histoscope manager.
Warning:
In a future release the HBOOK part of the HepTuple library WILL be separated from the manager independent part. Software using the hbook part of HepTuple will need to add -lHBookHepTuple to their link lines.
Coming soon:
• split of libHepTuple.a in a generic library (still libHepTuple.a) and a HBook specific library libHBookHepTuple.a
• Histogram arrays.
• Ntuples for the Root filemanager.

1/12/99

HepTuple beta release: v1.3; cvs rtag V01-03-00

(Note - actual rtag date for this version was 12/4/98; the release notification was inadvertently forgotten at that time.)
Beta release of full featured Histoscope file manager
Alpha release of minimal feature Root file manager.
The Root file manager currently only supports:
• all directory operations
• reading and writing histograms
  Output of some of the statistics is not yet exactly equivalent to the other managers
• writing very simple ntuples
Platforms checked:
KAI on d0chb with D0 environment
KAI on cdfsga with CDF environment
KAI under RedHat 5.0 on cdfpca with CDF environment
gcc on cdfsga (6.2) and fncrdn (IRIX 5.3)
MSVC++ 5.0 under NT with D0 environment
Dependencies:
ZMutility v1.3.5 or higher
Exceptions v1.7 or higher
(Cernlib library must be linked in for HBOOK)
Optional:
• histo v5_0_2a0 or higher
• root v2_00_13 or higher
Restrictions:
There is a bug in HBOOK with regard to columns of doubles in N-tuples:
These are NOT portable among platforms with different endian-ness (SGI vs Intel/Dec). This inconvenience will NOT be present with the Histoscope manager.
Warning:
HBOOK has been compiled and works on NT using Digital Fortran -- using the default calling conventions. DSPACK on NT evidently uses the (different) "unix" calling conventions (with the same compiler). For people using HBOOK via HepTuple, this should be fine. But when linking DSPACK-containing code with direct HBOOK calls, one would need to pay attention to this issue.

8/21/98

HepTuple beta release: v1.2; cvs rtag V01-02-00

Add HepFileManager::list which returns a vector of HepFileManager::Items representing the content of a directory
Updates to documentation.
Add statistics accessors to the Histogram classes. (accessors like entries(), sumX(), sumX2(), etc...)
Platforms checked:
KAI on d0chb with D0 environment
KAI on cdfsga with CDF environment
KAI under RedHat 5.0 on cdfpca with CDF environment
gcc on cdfsga (6.2) and fncrdn (IRIX 5.3)
MSVC++ 5.0 under NT with D0 environment
Dependencies:
ZMutility v1.2.3 or higher
Exceptions v1.1 or higher
(Cernlib library must be linked in for HBOOK)
Restrictions:
Coming to in a future release: Histoscope v5.0 file manager
There is a bug in HBOOK with regard to columns of doubles in N-tuples:
These are NOT portable among platforms with different endian-ness (SGI vs Intel/Dec). This inconvenience will NOT be present with the Histoscope manager.

7/29/98

HepTuple beta release: v1.1.9; cvs rtag V01-01-09

New Features:
Revised GNUmakefile for toyz
to circumvent KAI problem that was randomly breaking the build.

7/22/98

HepTuple beta release: v1.1.8; cvs rtag V01-01-08

New Features:
Strenghtened the object ownership model.
The HepFileManager is now completly responsible for creating and deleting the object. When the manager is detroyed, it automatically delete all its objects (Histogram, ntuple, etc...). A call to the member function release() for an object, instructs the manager that it can eventually delete the object if it wants to. (i.e the user is finished with this object and does not care what happen to its copy in memory)

Geant3
Fixed bug preventing the use of Geant3 and HepTuple in the same program.

Two HBook file managers.
Fixed bug in HBook and in HepTuple effectively preventing the use of two HBook file manager.

Fixed bug in rmdir
started Babar convergence
prepared for namespace
toyz test now uses PhysicsVector

Platforms checked:
KAI on d0chb with D0 environment
KAI on cdfsga with CDF environment
KAI under RedHat 5.0 on cdfpca with CDF environment
gcc on cdfsga (6.2) and fncrdn (IRIX 5.3)
MSVC++ 5.0 under NT with D0 environment
Dependencies:
ZMutility v1.2.3 or higher
Exceptions v1.1 or higher
(Cernlib library must be linked in for HBOOK)
Restrictions:
Coming to in a future release: Histoscope v5.0 file manager
There is a bug in HBOOK with regard to columns of doubles in N-tuples:
These are NOT portable among platforms with different endian-ness (SGI vs Intel/Dec). This inconvenience will NOT be present with the Histoscope manager.

4/21/98

HepTuple beta release: v1.1.5; cvs rtag V01-01-05

New features include a factor-of-two performance improvement, and a port to the NT environment.
Platforms checked:
gcc on IRIX 5.3 and 6.2 reference platforms
KAI on d0chb with D0 environment
KAI on cdfsga with CDF environment
KAI under RedHat 5.0 on cdfpca with CDF environment
MSVC++ 5.0 under NT with D0 environment (pending SoftRelTools merging)
KAI under Linux
Limitations and dependencies:
There is a bug in HBOOK with regard to columns of doubles in N-tuples: these are NOT portable among platforms with different endian-ness (e.g., SGI vs Intel/Dec). This inconvenience will NOT be present with the Histoscope manager.
Requires ZMutility v1.2.3 (or later) and Exceptions v1.1 (or later); also, Cernlib library must be linked in for HBOOK use.
Warning: HBOOK has been compiled and works on NT using the Digital Fortran -- using the default calling convention. DSPACK on NT evidently uses the (different) "unix" calling conventions (with the same compiler). For people using HBOOK via HepTuple, this should be fine. But when linking DSPACK-containing code with direct HBOOK calls, one would need to pay attention to this issue.

3/6/98

HepTuple: v1.1.2, cvs rtag V01-01-02

Uses the newer FixedTypes mechanism described in ZMutility above.
Platforms checked:
KAI on d0chb with D0 environment
KAI on cdfsga with CDF environment
gcc on cdfsga with CDF environment
HepTuple compiles on NT, but pending a choice of Fortran with which to make CERNLIB, does not link.
Requires ZMutility 1.2 or later, Exceptions 1.0 or later, and Cernlib library for HBook support.
Only HBook form of manager is currently supported. Currently working to create Histoscope manager as well.

2/5/98

HepTuple: Beta release v1.1; cvs rtag V01-01-00

ZOOM exception handling has been enabled;
Checked under: KAI on d0chb with D0 environment, KAI on cdfsga with CDF environment, and gcc on cdfsga (6.2) and fncrdn (IRIX 5.3);
Compiles under MSVC++ under NT but does not link (pending a choice of Fortran with which to make CERNLIB; does not link.
Requires: ZMutility v1.0 or later, Exceptions v1.0 or later, and Cernlib library (linked in for HBOOK);
Only HBOOK form of manager is currently supported;
A series of SHORT tutorial examples is being prepared; these will be incorporated in doc area without changing the release #.

Parent Pages: