Naming conventions

Versioning scheme:
GENIE versions are numbered with 3 dot separated integers as i.j.k, where the integers i,j,k correspond to the major, minor and revision number respectively. The corresponding SVN tag for version i.j.k is R-i_j_k (for example, GENIE version 2.0.2 is tagged as R-2_0_2).

Version number semantics:

• Following the LINUX kernel versioning scheme, the versions with even minor number (eg 2.4.*) correspond to stable, fully validated physics/production releases.
• Versions with odd minor number (eg 2.3.*, 2.5.*) correspond to the development version or `candidate' releases tagged during the validation stage preceeding a physics release.
• Tagged versions always have an even revision number (eg 2.2.2 is a revision of the 2.2.0 physics / production release whereas 2.3.2, 2.3.4, 2.3.6,... are `candidate' releases for the 2.4.0 physics / production release).
• Odd revision numbers are used for the SVN trunk / development version.

Release codenames:
The major production-quality releases are code-named after modern extinct or endangered species (series of production releases: Auk, Blueback, Cheetah, Dodo, Elk, Fox, Gazelle, Hippo, Ibex,... ).

Release qualifiers:
The GENIE releases are marked as:

• physics :
  Validated production-quality versions recommended for physics studies.
• depreciated :
  Older `physics' versions that have been greatly superseeded by newer versions. Versions marked as `depreciated' become unsupported. We appreciate that experiments get highly attached on specific versions due to the enormous amount of work invested in generating high-statistics samples and in calculating MC-dependent corrections and systematics. We strive to support as many physics versions as reasonably possible. Typical lifetime of `physics' versions is of the order of 18-24 months.
• pre-release :
  Test releases you may not use for physics studies.
• special :
  Releases prepared for a particular reason or event, such as a) the evaluation of an experiment systematic with an appropriately tweaked version of GENIE, or b) a GENIE tutorial or summer school. You may not use `special' releases outside the intended context.

If you are downloading GENIE today...

For today, GENIE recommends:

      "For large productions, use the latest frozen physics-quality release 2.6.0"
      "To experiment with the generator and its latest models and features, use the development version (2.7.1)"

Release table

The cited supporting documentation, stored at the Fermilab Projects DocDB, is meant for internal reference and is kept private (publicly available notes are marked with a [pub]). Please consult the Physics and User Manual for up-to-date publicly available documentation.

Version	SVN Tag	Release Date (dd/mm/yyyy)	Status	Comments
3.0.0 (Blueback) and Blueback-based production releases
-	-	-	-	-
(planned) 3.0.0		target date for release: Sep 1, 2010 ?	physics	Highlights: Improvements over 2.6.0: INTRANUKE restructuring and deployment of the new hN model (gDocDB-?). Additions to the INTRANUKE hA model: Kaon rescattering,... (gDocDB-?). Deployment of new spectral function based nuclear model (gDocDB-?). Added low-energy extension, pushing the GENIE validity range down to the ~1 MeV scale (gDocDB-?) Added high-energy extension, pushing the GENIE validity range up to the ~1 PeV scale (gDocDB-?) Global cross section model re-tuning (gDocDB-?). Improved treatment of in-medium effects to hadronization: Updated formation zone model. (gDocDB-?) Finalized simulation of nucleon emission from short range nucleon-nucleon correlations (gDocDB-?). Added BBBA07 elastic form factors and non-dipole axial form factor (gDocDB-?). Updates to the BY model (gDocDB-?). Added the GiBUU resonance neutrino- and electro-production form factors (gDocDB-?). AGKY hadronization: Added option for W-dependent baryon (target fragment) xF distribution (gDocDB-?). Added option for non-isotropic 2-body resonance decays (gDocDB-?). Added interface to PYTHIA8 and removed the PYTHIA6 dependency. Included interface to the NEUT cascade as an alternative intranuclear hadron transport model (available only for T2K usage - general default is INTRANUKE) Revamped numerical algorithms making use of the GNU Scientific Library (via ROOT MathMore). Improved speed for given accuracy. Required level of numerical accuracy can be specified by the user. ...
2.0.0 (Auk) and Auk-based production releases
development (2.7.1)	-	-	-	Current development version. Some of the next version features already installed. The bleeding edge but no guarantees.
2.6.0	R-2_6_0	Mar 17, 2010	physics	Highlights: Improvements over 2.4.0: Included all bug-fixes and new features also installed in 2.4.2 and 2.4.4 revisions (see below). Added electron-nucleon/nucleus scattering simulation capabilities. Now can validate GENIE against electron scattering data using the exact same phyhsics framework that simulates neutrino interactions. Significant extension of the GENIE event reweighting capabilities. See Physics and User manual. Collected & released many of the GENIE physics validation and model fitting tools. AGKY hadronization: Improvements in strange particle production (gDocDB-890). Added interface to LHAPDF (gDocDB-763) - Note change in GENIE dependencies (We recommend using the light-weight LHAPDF library and scrapping CERNLIB) Users now have very fine control over which particles to decay and which decay modes to inhibit. See Physics and User manual. Significantly improved ROOT geometry navigation performance and ability to define arbitrary fiducial volume cuts. JPARC neutrino flux driver: Certified with version 10a fluxes and included additional flux pass-through info. Maintained compatobility with 07a fluxes. NuMI flux driver: Numerous improvements. FLUGG support. Improvements of atmospheric flux drivers. New generic ntuple flux driver Updated the `t2k_rootracker', `numi_rootracker' bare-ROOT event formats and the `t2k_tracker' SuperK text event format following communication with relevant detector and analysis groups. Added first experimental version of a diffractive scattering generator (gDocDB-?). Interfaced GENIE with GNU Scientific Library to access advanced multi-dimensional integration algorithms (experimental feature). Updated for use with the latest gcc and in 64-bit platforms.
2.4.4	R-2_4_4	Jun 19, 2009	physics	A minor 2.4 revision: primarily to support early-summer physics MC production plans (T2K/MDC1) while 2.6.0 is in the works. Bug-fix: Corrected Adler's PCAC CC suppression term in the coherent pion production model (mpi -> mpi^2) Bug-fix: Corrected pion kinematics in coherent pion production scattering (the transverse momentum randomization in the LAB^{prime} frame, z^{prime} is along \ver{q}, and the rotation from LAB^{prime} to LAB were taking place in reversed order). Bug-fix: Fixed problem with density-weighted path-lengths in the ROOT geometry navigation code. Bug-fix: Fixed problem with PYTHIA decay-products entering the GHEP record with different position 4-vector units than expected. Bug-fix: Fixed a minor problem with the search for the maximum coherent differential cross section, which was preventing coherent pion event kinematics from being generated for energies very close to the energy threshold. Requested feature: As per popular request, GENIE won't decay pi0's by default. If you need to restore the previous behaviour then toggle the `InhibitPi0Decay' flag. Requested feature: Tweaked the JPARC flux driver and the T2K event generation application to allow event generation for specific neutrino flavours only. Requested feature: Added option to generate events in specific geometry volumes only. Requested feature: Addded tool to generate NEUT-like cross section table for SK MC job normalization. Other: Updated Ar40 removal energy as per ArgoNEUT request. Updated the PDG table. Added snapshot of the NuMI flux driver (as of the v2.4.4 tagging date) for test runs by the NuMI expts. Backported a version of gntpc that includes the implementation of the `numi_rootracker' bare-ROOT format. Backported improvements to the gntpc code generating summary ntuples.
2.4.2	R-2_4_2	Dec 20, 2008	depreciated	A minor 2.4 revision: primarily to support MDC0 T2K/SuperK production plans Bug-fix: Fixed wrong Delta- code, affecting the Delta- decays and the produced final states in nubar RES events New feature: Finalized/extended the 't2k_tracker' format and the mapping to NEUT reaction codes.
2.4.0	R-2_4_0	June 8, 2008	depreciated	Highlights: Improvements over 2.2.*: Significant speed improvements (event generation ~ x3 faster than 2.2.2 for event generation for fixed initial state. ~ x1E+2 faster for event generation on ROOT geometries). Fixed a few remaining memory leaks. Added 'customized' event generation driver for T2K (gT2Kevgen: See code documetation and (gDocDB-761) including a driver for the JPARC neutrino flux and hooks for the nd280, 2km, ingrid and SuperK detector geometries and/or nuclear target mix. The customized event generation driver can be enabled by specifying --enable-t2k-evgen in the GENIE configuration. Can be trivially cloned & serve as a template for other experiments wishing to integrate their beam line simulations & detector geometry description with GENIE. Added new event file converter: from GENIE's native GHEP format to T2K/nd280's ROOT-only format (rootracker) Added simulation of nuclear de-excitation gamma rays for O16 (gDocDB-?). Added 0-th order implementation of anomaly mediated neutrino - photon interactions [Harvey, Hill and Hill, PRL99,261601(2007)] Added the V.Tvaskis et al. (PRL 98, 142301, 2007) parameterization of the longitudinal to transverse cross section ratio R as an alternative to the existing Whitlow parameterization. More carefull treatment of thresholds in the cross section splines. Bug fixes in algorithm navigating ROOT-based detector geometry descriptions. Added a flux driver for the Bartol atmospheric neutrino flux. The code reading the input XML cross section files has been switched from the tree-based libxml2 API to the XmlTextReader libxml2 API. Hugely better speed/memory performance when using large XML cross section files (eg ~100MB as when using all nuclear targers on nd280 & MINOS geometries). Requires libxml2 version ≥ 2.5.0 Note: Configuration script changes. Read the updated script documentation.
2.2.2	R-2_2_2	Dec 19, 2007	depreciated	A minor 2.2 revision: Updates the code converting events from the native GHEP/ROOT format to the tracker format used by T2K to better match what is expected by the T2K/nd280 detector mc.
2.2.0	R-2_2_0	Dec 12, 2007	depreciated	Highlights: Improvements over 2.0.*: Changes to the determination of the mean free path of hadrons in nuclear matter in INTRANUKE / hA model (gDocDB-760) Intranuclear vertex selection uses a realistic nuclear density profile. Added QE charm production (gDocDB-759) using the cross section model of S.G.Kovalenko, Sov.J.Nucl.Phys.52:934 (1990) Added elastic ve- scattering. Added GENIE tcp/ip event server for interfacing with legacy (fortran) MINOS detector MC (gminos) Added a cross section model re-weighting engine Added option to simulate multi-nucleon emission from N-N correlations (not fully developed yet and not enabled by default) Added a few modifications / flags so as to handle newer version of log4cpp and gcc versions > 4.1 and 64-bit systems.
2.0.0	R-2_0_0	Aug 17, 2007	depreciated	The first GENIE production release (Auk). The default physics in 2.0.0 is identical with the neugen/'daikon+' version (daikon+ is a bug fix revision of the MC used at the 2007 MINOS CC Analysis). A description of the physics model (cross section, hadronization and intranuclear rescattering can be found in gDocDB-756, 757 and 758). Various plots illustrating the GENIE-2.0.0 - neugen/daikon+ equivalence can be found in (gDocDB-755 [pub]). GENIE 2.0.0 supersedes neugen & future major model improvements will only be included in GENIE.
2.0.0 pre-releases Depreciated snapshots taken during 2.0.0 development. Do not use these pre-releases for physics studies. Please upgrade to a physics-production version. No further support is provided for the 1.99.* series.
1.99.12	R-1_99_12	July 18, 2007	pre-release
1.99.11	R-1_99_11	Jun 26, 2007	pre-release
1.99.10	R-1_99_10	June 21, 2007	pre-release
1.99.9	R-1_99_9	Mar 30, 2007	pre-release
1.99.8	R-1_99_8	Nov 10, 2006	pre-release
1.99.7	R-1_99_7	Jun 23, 2006	pre-release
1.99.6	R-1_99_6	May 15, 2006	pre-release
1.99.5	R-1_99_5	May 08, 2006	pre-release
Pre-releases <1.99.5 have been deleted.
-	-	May 02, 2005	-	Initial CVS import of the GENIE source. CVS history exists only after this date.
1.0.0 - 06/2003 - "The genesis" Version used for calculations in Costas' PhD thesis. GENIE development restarted at RAL in mid ~2004