Welcome to pinefarm’s documentation!

pinefarm serves as common interface to several other external programs to compute PineAPPL grids [CNSZ20]. It is part of the Pineline framework [BCCM+23].

We currently support:

• MadGraph5_aMC@NLO [AFF+14] [FFH+18]

• yadism [CHM+23]

• NNLOJET [NNL25]

• Hawaiian Vrap [BCCM+23] (a modified version of Vrap [ADMP04])

• PDF positivity observables [CFGH23, CFH20, CRS22]

• PDF integrability observables

To run pinefarm you need two specify to sets of inputs:

1. a theory runcard, as is used by nnpdf. The theory runcard defines the general parameters of the QCD framework, such as perturbative orders, coupling strength or heavy quark masses. A list of example theory runcards is also available in the repository

2. a pinecard, as is described here. The pinecard describes the actual measurement that is performed, e.g. observable definitions, kinematic bins, or cuts. The pinecard will also determine which external program is executed. A list of already available observables can be inspected in the pinecards repository.

Given those two things you can run

pinefarm run <PINECARD> <THEORYCARD>

and the program will, if necessary, install the required external program and launch it’s execution.