fastNLO_reader version 2.1.0:
=============================

Installation of distribution package:
-------------------------------------
Via GNU autotools setup (NOT required for installation),
in unpacking directory of the *.tar.gz file do:

./configure --prefix=your_local_directory
(should contain LHAPDF installation, otherwise specify
 separate path via --with-lhapdf=path_to_lhapdf;
 see also ./configure --help)
make
make install
make check (not yet implemented)


Requirements:
-------------
For installation of reader package: LHAPDF
For running executable: fastNLO table, PDF set from LHAPDF


Content:
--------
Generic Fortran and C++ code to read and evaluate fastNLO v2 tables
(ATTENTION: Due to limitations in memory management with Fortran, the
            array sizes of the generic code need to be adapted to
            the investigated scenarios!
            Code dedicated to read particular scenarios (tables) can
            be made available.)


Features:
---------
Observable definition:
- Arbitrary number of dimensions for binning of observable,
  stored and printed out as one large linear array

Scale treatment:
Two ways of storing scale dependence:
- Scale interpolation much improved compared to v1.4 or
- Scale factors and functional form freely choosable a posteriori

Possible table content:
fastNLO v2 Tables can contain additional contributions like
- non-perturbative correction factors with uncertainties
  (simple print-out of stored info, available)
- data points with uncertainties
  (simple print-out of stored info, available)
- threshold corrections
  (dependence on coupling constants to be evaluated,
   available for inclusive jets)
- electroweak corrections
  (dependence on coupling constants to be evaluated)
- new physics contributions
  (dependence on coupling constants to be evaluated)
- normalization options
  (not used yet)


Example settings for work with environment variables for LHAPDF:
----------------------------------------------------------------
(Usually only LHAPDF needs to be set.)
#
# Add LHAPDF environment
#
setenv LHAPDF /home/rabbertz/local
setenv LHAPDFBINPATH /home/rabbertz/local/bin
setenv LHAPDFLIBPATH /home/rabbertz/local/lib
setenv LHAPDFINCLUDEPATH /home/rabbertz/local/include/LHAPDF
setenv LHAPDFSETPATH /home/rabbertz/local/share/lhapdf/PDFsets


For developers only: Reconfiguration, if required, with GNU autotools:
----------------------------------------------------------------------
With recent versions of autoconf/automake, e.g. versions 2.65/1.11.1:

In directory containing the configure.ac file type:
---------------------------------------------------
autoreconf --install
./configure --prefix=/your/install/directory --with-... further options
make -j #_of_cores
make install

With old versions of autoconf/automake as in SLC5, e.g. versions 2.59/1.9.6:

In directory containing the configure.ac file type:
---------------------------------------------------
#
# Provide initial versions of required auto-files (usually done via --install)
#
tar xvfz m4/reader_autoinstallfiles_ac-2.65_am-1.11.1.tar.gz -C .
# Reinitialize for present autoconf/automake versions
aclocal --force && autoconf && autoheader && automake && libtoolize --force -c
#
# Then continue as usual
./configure --prefix=/your/install/directory --with-... further options
make -j #_of_cores
make install


For maintainers only: Preparation of distribution package with GNU autotools:
-----------------------------------------------------------------------------
autoreconf --install
./configure --prefix=your_install_directory
make dist

Note: configure only terminates properly if mandatory requirements
are fulfilled even if this configuration is not foreseen to be installed!