# N-tuples

This chapter describes functions for creating and manipulating ntuples, sets of values associated with events. The ntuples are stored in files. Their values can be extracted in any combination and booked in an histogram using a selection function.

The values to be stored are held in a user-defined data structure, and an ntuple is created associating this data structure with a file. The values are then written to the file (normally inside a loop) using the ntuple functions described below.

A histogram can be created from ntuple data by providing a selection function and a value function. The selection function specifies whether an event should be included in the subset to be analyzed or not. The value function computes the entry to be added to the histogram entry for each event.

All the ntuple functions are defined in the header file ``gsl_ntuple.h'`

- The ntuple struct
- Creating ntuples
- Opening an existing ntuple file
- Writing ntuples
- Reading ntuples
- Closing an ntuple file
- Histogramming ntuple values
- Example ntuple programs
- Ntuple References and Further Reading