Back to POOL Home

Learning POOL by examples

a mini tutorial

Purpose, scope and audience

Under these web pages you can find examples of usage of the POOL packages demonstrating the solutions to specific use case problems. They are complementary to the POOL User Guide. Like any other tutorial, concepts are introduced gradually and incrementally. The examples provide the reader with the full solution of a given problem and with proposals for possible extensions.

This tutorial is attempting to address both the individual beginners who develop simple applications requiring object persistency, and the experienced developers working on the integration of POOL into an experimental software framework.

Organization of an example

Every example is self-consistent, without requiring code or data from another one. It provides a short description of the current problem and the outline of its solution. In typical example one builds a user class library, a dictionary library, an application writing data, and another one reading them back.

Compilation, building and running of the applications can be done in two ways: Either with a Makefile, which has been written so that it can be easily customized, and a simple shell script with all the instructions fully unrolled. They both assume that the gcc v 3.2.3 compiler is used under the SLC3 (CERN distribution). The default values for the paths to the various software components needed to build and run the applications are set to the afs directories of the installations at CERN.

The examples

  1. Simple I/O
  2. Simple navigation
  3. Working with multiple data files
  4. Simple object collections
  5. Objects with transient data members

Contact : Ioannis Papadopoulos, IT Division, CERN.