Contents

• Chapter ‍1 Introduction
  • 1.1 Disclaimer
  • 1.2 Overview
  • 1.3 Historical remarks
  • 1.4 About examples in this manual
• Chapter ‍2 Installation
  • 2.1 Package Structure
  • 2.2 Prerequisites
    • 2.2.1 No Binary Distribution
    • 2.2.2 Tarball Distribution
    • 2.2.3 SVN Repository Version
    • 2.2.4 Public Git Repository Version
    • 2.2.5 Nightly development snapshots
    • 2.2.6 Fortran Compilers
    • 2.2.7 LHAPDF
    • 2.2.8 HOPPET
    • 2.2.9 HepMC
    • 2.2.10 PYTHIA6
    • 2.2.11 PYTHIA8
    • 2.2.12 FastJet
    • 2.2.13 STDHEP
    • 2.2.14 LCIO
  • 2.3 Installation
    • 2.3.1 Central Installation
    • 2.3.2 Installation in User Space
    • 2.3.3 Configure Options
    • 2.3.4 Details on the Configure Process
    • 2.3.5 Building on Darwin/macOS
    • 2.3.6 Building on Windows
    • 2.3.7 WHIZARD self tests/checks
• Chapter ‍3 Working with WHIZARD
  • 3.1 Hello World
  • 3.2 A Simple Calculation
  • 3.3 WHIZARD in a Computing Environment
    • 3.3.1 Working on a Single Computer
    • 3.3.2 Working Parallel on Several Computers
    • 3.3.3 Stopping and Resuming WHIZARD Jobs
    • 3.3.4 Files and Directories: default and customization
    • 3.3.5 Batch jobs on a different machine
    • 3.3.6 Static Linkage
  • 3.4 Troubleshooting
    • 3.4.1 Possible (uncommon) build problems
    • 3.4.2 What happens if WHIZARD throws an error?
    • 3.4.3 Debugging, testing, and validation
• Chapter ‍4 Steering WHIZARD: SINDARIN Overview
  • 4.1 The command language for WHIZARD
  • 4.2 SINDARIN scripts
  • 4.3 Errors
  • 4.4 Statements
    • 4.4.1 Process Configuration
    • 4.4.2 Parameters
    • 4.4.3 Integration
    • 4.4.4 Events
  • 4.5 Control Structures
    • 4.5.1 Conditionals
    • 4.5.2 Loops
    • 4.5.3 Including Files
  • 4.6 Expressions
    • 4.6.1 Numeric
    • 4.6.2 Logical and String
    • 4.6.3 Special
  • 4.7 Variables
• Chapter ‍5 SINDARIN in Details
  • 5.1 Data and expressions
    • 5.1.1 Real-valued objects
    • 5.1.2 Integer-valued objects
    • 5.1.3 Complex-valued objects
    • 5.1.4 Logical-valued objects
    • 5.1.5 String-valued objects and string operations
  • 5.2 Particles and (sub)events
    • 5.2.1 Particle aliases
    • 5.2.2 Subevents
    • 5.2.3 Subevent functions
    • 5.2.4 Calculating observables
    • 5.2.5 Cuts and event selection
    • 5.2.6 More particle functions
  • 5.3 Physics Models
  • 5.4 Processes
    • 5.4.1 Process definition
    • 5.4.2 Particle names
    • 5.4.3 Options for processes
    • 5.4.4 Process components
    • 5.4.5 Compilation
    • 5.4.6 Process libraries
    • 5.4.7 Stand-alone WHIZARD with precompiled processes
  • 5.5 Beams
    • 5.5.1 Beam setup
    • 5.5.2 Asymmetric beams and Crossing angles
    • 5.5.3 LHAPDF
    • 5.5.4 Built-in PDFs
    • 5.5.5 HOPPET b parton matching
    • 5.5.6 Lepton Collider ISR structure functions
    • 5.5.7 Lepton Collider Beamstrahlung
    • 5.5.8 Beam events
    • 5.5.9 Gaussian beam-energy spread
    • 5.5.10 Equivalent photon approximation
    • 5.5.11 Effective W approximation
    • 5.5.12 Energy scans using structure functions
    • 5.5.13 Photon collider spectra
    • 5.5.14 Concatenation of several structure functions
  • 5.6 Polarization
    • 5.6.1 Initial state polarization
    • 5.6.2 Final state polarization
  • 5.7 Cross sections
    • 5.7.1 Integration
    • 5.7.2 Integration run IDs
    • 5.7.3 Controlling iterations
    • 5.7.4 Phase space
    • 5.7.5 Cuts
    • 5.7.6 QCD scale and coupling
    • 5.7.7 Reweighting factor
  • 5.8 Events
    • 5.8.1 Simulation
    • 5.8.2 Decays
    • 5.8.3 Event formats
  • 5.9 Analysis and Visualization
    • 5.9.1 Observables
    • 5.9.2 The analysis expression
    • 5.9.3 Histograms
    • 5.9.4 Plots
    • 5.9.5 Analysis Output
  • 5.10 Custom Input/Output
    • 5.10.1 Output Files
    • 5.10.2 Printing Data
  • 5.11 WHIZARD at next-to-leading order
    • 5.11.1 Prerequisites
    • 5.11.2 NLO cross sections
    • 5.11.3 Fixed-order NLO events
    • 5.11.4 POWHEG matching
    • 5.11.5 Separation of finite and singular contributions
• Chapter ‍6 Random number generators
  • 6.1 General remarks
  • 6.2 The TAO Random Number Generator
  • 6.3 The RNGStream Generator
• Chapter ‍7 Integration Methods
  • 7.1 The Monte-Carlo integration routine: VAMP
  • 7.2 The next generation integrator: VAMP2
    • 7.2.1 Multichannel integration
    • 7.2.2 VEGAS
    • 7.2.3 Channel equivalences
• Chapter ‍8 Phase space parameterizations
  • 8.1 General remarks
  • 8.2 The flat method: rambo
  • 8.3 The default method: wood
  • 8.4 A new method: fast_wood
  • 8.5 Phase space respecting restrictions on subdiagrams
  • 8.6 Phase space for processes forbidden at tree level
• Chapter ‍9 Methods for Hard Interactions
  • 9.1 Internal test matrix elements
  • 9.2 Template matrix elements
  • 9.3 The O’Mega matrix elements
  • 9.4 Interface to GoSam
  • 9.5 Interface to Openloops
  • 9.6 Interface to Recola
  • 9.7 Special applications
• Chapter ‍10 Implemented physics
  • 10.1 The hard interaction models
    • 10.1.1 The Standard Model and friends
    • 10.1.2 Beyond the Standard Model
  • 10.2 The SUSY Les Houches Accord (SLHA) interface
  • 10.3 Lepton Collider Beam Spectra
    • 10.3.1 CIRCE1
    • 10.3.2 CIRCE2
    • 10.3.3 Photon Collider Spectra
  • 10.4 Transverse momentum for ISR photons
  • 10.5 Transverse momentum for the EPA approximation
  • 10.6 Resonances and continuum
    • 10.6.1 Complete matrix elements
    • 10.6.2 Processes restricted to resonances
    • 10.6.3 Factorized processes
    • 10.6.4 Resonance insertion in the event record
  • 10.7 Parton showers and Hadronization
    • 10.7.1 The k_T-ordered parton shower
    • 10.7.2 The analytic parton shower
    • 10.7.3 Parton shower and hadronization from PYTHIA6
    • 10.7.4 Parton shower and hadronization from PYTHIA8
    • 10.7.5 Other tools for parton shower and hadronization
  • 10.8 Simulation of low-p_T hadrons at lepton colliders
  • 10.9 Loop-induced processes
• Chapter ‍11 More on Event Generation
  • 11.1 Event generation
  • 11.2 Unweighted and weighted events
  • 11.3 Choice on event normalizations
  • 11.4 Event selection
  • 11.5 Supported event formats
  • 11.6 Interfaces to Parton Showers, Matching and Hadronization
    • 11.6.1 Parton Showers and Hadronization
    • 11.6.2 Parton shower – Matrix Element Matching
  • 11.7 Rescanning and recalculating events
  • 11.8 Negative weight events
• Chapter ‍12 Internal Data Visualization
  • 12.1 GAMELAN
    • 12.1.1 User-specific changes
  • 12.2 Histogram Display
  • 12.3 Plot Display
  • 12.4 Graphs
  • 12.5 Drawing options
• Chapter ‍13 Fast Detector Simulation and External Analysis
  • 13.1 Interfacing ROOT
  • 13.2 Interfacing RIVET
  • 13.3 Fast Detector Simulation with DELPHES
• Chapter ‍14 User Interfaces for WHIZARD
  • 14.1 Command Line and SINDARIN Input Files
  • 14.2 WHISH – The WHIZARD Shell/Interactive mode
  • 14.3 Graphical user interface
  • 14.4 WHIZARD as a library
    • 14.4.1 Fortran main program
    • 14.4.2 C main program
    • 14.4.3 C++ main program
    • 14.4.4 Python main program
• Chapter ‍15 Examples
  • 15.1 Z lineshape at LEP I
  • 15.2 W pairs at LEP II
  • 15.3 Higgs search at LEP II
  • 15.4 Deep Inelastic Scattering at HERA
  • 15.5 W endpoint at LHC
  • 15.6 SUSY Cascades at LHC
  • 15.7 Polarized WW at ILC
• Chapter ‍16 Technical details – Advanced Spells
  • 16.1 Efficiency and tuning
• Chapter ‍17 New External Physics Models
  • 17.1 New physics models via SARAH
    • 17.1.1 WHIZARD/O’Mega model files from SARAH
    • 17.1.2 Linking SPheno and WHIZARD
    • 17.1.3 BSM Toolbox
  • 17.2 New physics models via FeynRules
    • 17.2.1 Installation and Usage of the WHIZARD-FeynRules interface
    • 17.2.2 Options of the WHIZARD-FeynRules interface
    • 17.2.3 Validation of the interface
    • 17.2.4 Examples for the WHIZARD-/FeynRules interface
  • 17.3 New physics models via the UFO file format
• Appendix ‍A SINDARIN Reference
  • A.1 Commands and Operators
  • A.2 Variables
    • A.2.1 Rebuild Variables
    • A.2.2 Standard Variables