Vincia is hosted by Hepforge, IPPP Durham

Download VINCIA
HTML User Reference
README & Update Notes
Subscribe to News
Email the Developers

P. Skands
N. Fischer
Additional Contributors:
W. T. Giele
L. Hartgring
D. A. Kosower
E. Laenen
A. J. Larkoski
A. Lifson
J. J. Lopez-Villarejo
S. Prestel
M. Ritzmann

VINCIA is supported by:


The VINCIA code is a plugin to the high-energy physics event generator PYTHIA 8. It is based on the dipole-antenna picture of Quantum Chromodynamics (QCD) and focusses on describing jets and jet substructure with high precision.

The current version includes both initial- and final-state showers, with some limitations; decays of coloured resonances (eg top) are not yet handled, nor are any non-QCD shower branchings included.

LO matrix elements can be incorporated in the evolution, as process-dependent 2→n antenna functions. In hard parts of phase space, these functions generate matrix-element corrections to the shower. In soft parts, they should improve the logarithmic accuracy of it, via unitarity.

The remaining perturbative uncertainties are estimated by systematic (and automated) variations of scales, shower functions, evolution variables, etc. In the automated mode, a vector of output weights is produced for each event, the central value of which is unity (for an ordinary unweighted event sample), with the uncertainty variations spreading out around it. The calculation is significantly faster than generating N separate samples, and there is only one event sample to analyse, pass through detector simulations, etc.

Event Generation. When activated, VINCIA replaces the internal PYTHIA parton cascades. Hadronisation is performed as usual in PYTHIA, with the Lund string fragmentation model. Instead of the PYTHIA initialisation step in the main program the same function is called on the VINCIA object. VINCIA modifies the input cross section for some processes; see e.g. examples/ on how to take this into account properly. Apart from that, the events are generated and analysed as in a normal PYTHIA 8 run. In addition, runtime displays with plots updated in realtime can be created using the VINCIAROOT interface.


The following simple steps set up a standalone VINCIA installation from scratch, complete with linking to PYTHIA 8 and ready-to-run example programs (assuming you have working C++ and F77 compilers which are mutually compatible):

  1. Download and compile PYTHIA 8.
  2. Download VINCIA. Place the tarball in your PYTHIA 8 main directory (e.g., pythia8215/), and untar it.
  3. Go to the thus created subfolder vincia-N.N.NN/ (with N.N.NN being the version number you downloaded) and run "./configure" (use "./configure --help" to see configuration options), then run "make".
  4. Move to the examples/ subfolder ("cd examples") and run "make" there. The default test program should now be ready to run: ./vincia01

Linking and initialization of VINCIA is done automatically when the VinciaPlugin object is created.

More examples, and more complete instructions on how to install, link, and use VINCIA also in more complicated setups can be found in the HTML User Reference and Manual and in the README.TXT.


User Guides and Reviews

VINCIA Articles & References

2017 Helicity Antenna Showers for Hadron Colliders. Initial-state showers and matrix-element corrections with helicity dependence.
Combining states without scale hierarchies with ordered parton showers. Iterated ME corrections for strongly ordered showers. Multi-leg merging with ME-corrected showers.
2016 Vincia for Hadron Colliders. Comprehensive reference for initial-state showers in VINCIA.
2013 Antenna Showers with One-Loop Matrix Elements. Original reference for (multileg) NLO matching with VINCIA. Incorporating the NLO correction to ee → 3 jets in the evolution from ee → 2 jets. Studies of dependence on evolution and renormalization scale choices. NLO-corrected tune to ee event-shape, jet-rate, and fragmentation data.
2013 Helicity-Dependent Showers and Matching with VINCIA. First paper on helicity-dependence in VINCIA. Using individual helicity amplitudes (squared) to drive the matrix-element corrections improves the speed of the matching algorithm. Comparisons to VINCIA without helicity dependence and to CKKW-based SHERPA.
2012 Antenna Showers with Hadronic Initial States. First VINCIA paper treating initial-state showers.
2011 Efficient Matrix-Element Matching with Sector Showers. First paper on sector-based final-state showers (and corresponding sector-based GKS matching). Speed comparison to CKKW-based SHERPA.
2011 Timelike Dipole-Antenna Showers with Massive Fermions. Mass corrections to final-state phase space and antenna functions. Comparisons to analytical resummation, b-quark fragmentation, and b-tagged events shapes.
2011 Higher-order Corrections to Timelike Jets. Original reference for unitarity-based "GKS" matching (iterated matrix-element corrections), smooth ordering, and automated uncertainty bands by Sudakov reweighting. Comparisons to LEP for massless quarks.
2008 Time-Like Showers Based on Dipole-Antenna Radiation Functions. Massless quarks + analytical comparisons to ARIADNE functions + numerical comparisons to PYTHIA 8 for Z decays
2007 A Simple Shower and Matching Algorithm. Original VINCIA antenna-shower reference. Basic shower formalism, gluons only + first comparison to PYTHIA 8
eXTReMe Tracker