Specialized Minimal PDFs tools.
##Citation
If you use this code in your publication, please cite:
Specialized minimal PDFs for optimized LHC calculations http://arxiv.org/abs/1602.00005
##Existing results
The compressed sets quoted in the paper above can be found here:
http://pcteserver.mi.infn.it/~nnpdf/smpdf_output/
The APPLGrids used to generate these sets can be found here:
http://pcteserver.mi.infn.it/~nnpdf/smpdf-applgrids/
Clone the master development repository by running the following command:
$ git clone https://github.com/scarrazza/smpdf.gitOr download the compressed archive without using git here.
SMPDF requires APPlgrid and LHAPDF. Make sure the following commands can be executed and give valid results:
$ lhapdf-config
$ applgrid-config
```
The default Applgrid installation **will not work**: **All** header files must
be copied to the appromiate include path, and not only those copied by
`make install`, which is insufficient. For example, for a default
Ubuntu installation:
````Shell
applgrid-1.4.70/src $ sudo cp *.h /usr/local/include/appl_grid/Python 3.4 is also required.
In order to manage the Python dependencies,
Anaconda (with a Python
3.4 environment) is the recommended way. After setting it up,
cd into the directory of SMPDF and:
$ conda install --file environment.yml
```
Once all dependencies are satisfied, run:
````Shell
$ python setup.py install
```
Note that the installer script does _not_ check for dependencies. This will
install the `smpdf` program and the `smpdflib` Python library in the appropiate
paths.
## Usage
The configuration is specified in YAML files (see `examples/`). A file consists
of a list of observables (file paths to applgrids and specification of the
perturbative order, where 0 is LO and 1 NLO), a list of PDF sets (valid LHAPDF
grids in the correct path) and a list of actions (see `--help` for a
description).
See
````Shell
$ smpdf --help
```
for the full list of options. Note that you will probably want to
run with the `--use-db` flag.
Generating documentation
------------------------
[Sphinx](http://sphinx-doc.org/) version 1.3.1 or greater is required.
In order to build the documentation, go into the `docs` directory, and
type:
````bash
make api
make htmlYou can use the other build targets allowed by Sphinx. Note that the
--help flag provides an overview of the most useful options.