CERNLIBAdapter

CERNLIBAdapter 3.0.4 Release Notes

Release Notes Version: : 1.6 $.

The most recent version of this file is available here.
Release notes for all versions of CERNLIBAdapter are available here.

CERNLIBAdapter is a Java adapter for parts of the CERN Program Library CERNLIB. It includes HBOOK and MINUIT.

The CERNLIBAdapter distribution is an extension to the JAIDA library and cannot be used stand-alone.

In future we may distribute a version for stand-alone usage. This would allow Java programmers to use those parts of CERNLIB included in the Adapter.

JAS3 - Java Analysis Studio includes a copy of JAIDA and the CERNLIBAdapter.

Contents

• CERNLIB Version
• Supported Platforms
• Major changes in CERNLIBAdapter 3.0.4
• Documentation
• License
• Installing CERNLIBAdapter
• Compiling CERNLIBAdapter
• Building an Application with CERNLIBAdapter
• Running an Application with CERNLIBAdapter
• Features/Limitations of the Current Release
• Reporting Bugs
• Examples

CERNLIB Version

This adapter is compatible with version 2003 of CERNLIB, see CERNLIB's ReleaseNotes.

Supported Platforms

Binaries are available and supported for the following combinations of architectures and compilers:

• Windows NT/2000/XP
  • WIN32-VC7: Visual Studio .NET Professional 2003.
    Microsoft (R) 32-bit C/C++ Optimizing Compiler Version 13.10.3077 for 80x86
  • WIN32-VC: Visual Studio 6.0
    Microsoft (R) 32-bit C/C++ Optimizing Compiler Version 12.00.8804 for 80x86
  • WIN32-g++: gcc version 3.3.1 (cygming special)
    Using a cygwin shell.
• Linux
  • Linux-g++2: gcc version 2.95.3 20010315 (release)
  • Linux-g++: gcc version 3.2.2
• MacOS X 10.3
  • Darwin-g++: gcc version 3.3 20030304 (Apple Computer, Inc. build 1495)
• SUN Solaris
  • SUN-CC: CC: Forte Developer 7 C++ 5.4 Patch 111715-13 2003/12/11

Major changes in CERNLIBAdapter 3.0.4

• CLA-1: MINUIT: Internal jclass and JNIEnv were stored at the wrong time for usage in function(). This worked on most platforms, but on MacOSX this resulted in a core dump.
• CLA-2: MINUIT: Methods now throw RuntimeException when internal errors happen in the JNI functions.
• CLA-3: MINUIT: Exceptions thrown in function() are now caught, Minuit is stopped and the exception is forwarded to the original caller.
• CLA-4: Support for WIN32-g++ platform added.
• CLA-4: Support for WIN32-VC7 (Visual C++ 7) added.
• CLA-4: No more support for Darwin g++ 2.95.2.
• CLA-5: Support for MacOS X 10.3 g++ version 3.3 added.
• CLA-7: Distribution now untars in directory with  version number.
• 3.0.4.1 libs on Linux-g++ and Linux-icc are no longer dependent on C++, others were ok in 3.0.4

For a full list of changes in CERNLIBAdapter 3.0.4 see the CERNLIBAdapter change log.

Documentation

For the CERNLIBAdapter the following documents are useful:

• HBOOK User's Guide
• MINUIT User's Guide

License

The CERNLIBAdapter is part of the FreeHEP Java Library an "Open Source" library distributed under the terms of the LGPL. If you have questions about the licensing please send a mail to: developers@freehep.org.

Installing CERNLIBAdapter

Download CERNLIBAdapter for one or more platforms. These distributions overlay on top of each other, adding support for different architectures. The distribution creates the following directory structure:

CERNLIBAdapter-version            containing license and release notes
CERNLIBAdapter-version/lib        containing platform specific directories with libraries
                           	  (shareable and static)

Compilation

The current distributions do not contain source files.

To (re-)build CERNLIBAdapter for a particular platform you need to get the source of the FreeHEP library.

Building an Application with CERNLIBAdapter

Current support for CERNLIBAdapter is only as an add-on to JAIDA.

Running an Application with CERNLIBAdapter

Current support for CERNLIBAdapter is only as an add-on to JAIDA.

Features/Limitations of the Current Release

The following limitations exist:

• The distribution kits contain some CVS directories and files, please ignore.

Reporting Bugs

For discussion of features or problems related to CERNLIBAdapter please use the AIDA forum. To report bugs or request enhancements you can also use the CERNLIBAdapter bug database.

Examples

Current support for CERNLIBAdapter is only as an add-on to JAIDA. There are currently no examples.