Core Authors: Luke Pickering, Callum Wilkinson, Clarence Wret, Patrick Stowell
Previous Core Authors: Ryan Terri
Contact: (luke[dot]pickering[at]rhul[dot]ac[dot]uk, cwilkinson[at]lbl[dot]gov, c[dot]wret[at]rochester[dot]edu)
The following instructions should be used to build the fitter after checking out.
- Make sure environmental variables required for the generators you wish to build against are set.
- In the top nuisance directory make a new build directory:
$ mkdir build && cd build
- Configure the build with CMake:
$ cmake [-DEXPERIMENTS_ENABLED=ON -DT2K_ENABLED=ON ...] [-DNEUT_ENABLED=ON ...] ../
All arguments are optional. The build will search for configured generators and reweight libraries and enabled them if found. The experiment libraries (containing the publish data comparisons) take a few minutes to build and so can be disabled for convenience with -DEXPERIMENTS_ENABLED=OFF. Individual experimental libraries can then be re-enabled with e.g. -DMINERvA_ENABLED=ON. Generators or reweight libraries that are explicitly enabled are considered requirements and the configuring process will fail if they are not successfully set up. Explicitly disabling a dependency with e.g. -DNOvARwgt_ENABLED=OFF will disable the attempt to configure the given dependency.
List of optional dependencies: NEUT, NuWro, GENIE (v2 or v3), T2KReWeight, NOvARwgt, nusystematics
- Build and install
$ make install
- Source the setup script
$ source Linux/setup.sh
If you prefer, most configure variables can be entered through a cmake UI, such as ccmake. e.g. "$ mkdir build && cd build && ccmake ../"
NUISANCE will build nusystematics for you if you configure with -Dnusystematics_BUILTIN=ON, this implies -Dnusystematics_ENABLED=ON.
The fitter is designed to be easily extended by adding new measurement classes whilst keeping the input convertors and tuning functionality the same.
The Devel module folder is setup with some examples of how to add new classes into the framework. Feel free to email me if there are difficulties adding new measurements.
Whilst running fits is relatively quick and simple, there are now a large range of possible options. Doxygen Documentation is being added to the $NUISANCE/doc/html folder.
Refer thre for guidance on how to properly formulate a card file.