Correlation Analysis Tool using the Schrödinger equation (CATS)

  1. What is CATS?
    CATS is a femtoscopy analysis tool, capable of computing the correlation function C(k) given a source and a strong interaction potetnial. The wave-function is evaluated by solving the Schroedinger equation numerically. => the tool is non-relativistic and will only work for particles with masses of more then c.a. 500 MeV (light mesons are off-limits).
  2. How to download/compile 
    You can download CATS from here.
    --Option 1--
    There are 3 folders included: CATS, DLM_CppTools and CATS_Example1. CATS contains the main source-code for CATS. DLM_CppTools contains some functions used by CATS, developed by the authors for previous projects. You need to include and compile all *.cpp and *.h files from those folders in your own code. By default we do not offer any specific option for compilation or installation, except for the macro included in the CATS_Example folder.

    --Option 2 - From version 2.12 onwards--
    We offer the user the opportunity to use extended functions that were developed for our analysis, as well as our own compilation scripts using CMake. These were never extensively tested and hence bug prone, please use and modify at your own risk!
  3. How to use it 
    --Option 1--
    You can see some example code using CATS in the folders named CATS_Example#. With the help of the comments you should be capable of understanding how to run CATS. Nevertheless there a few thinks that we would like to bring your attention on: 
    * Both the potential and the analytic source should be defined as functions in your code and passed on to CATS 
    * The arrays used together with those potential are both memory-holders and a way to connect CATS to the "outer world" 
    * For the potential: The first 2 arguments sould be the variables "r" and "k". The array passed to CATS should have a minimum size of 2. 
    * For the source: The first 3 arguments sould be the variables "k","r","θ". The array passed to CATS should have a minimum size of 3. 
    * Any arguments beyond the default minimum can be used as a link between CATS and external functions, an example is available in the macro. 
    * The PdgId parameter is currently used to determine if the particles are identical or not and when sampling the source from a data file. 

    --Option 2 - From version 2.12 onwards--
    The extended version includes two scripts for compilation using CMake. The first is in ./CMake and can be used to compile CATS itself at a custom location. The second one is in ./CATS_ExampleFitter1. This folders contains an example of how CATS can be used together with ROOT to fit data. The CMake example can be used as a template to compile your own code.
  4. Prerequisites
    GSL - GNU Scientific Library (https://www.gnu.org/software/gsl/)

    In case you would like to use our CMake examples, please make sure you have CMake installed To check out the ./CATS_ExampleFitter1 you will also need to install ROOT

Download a specific version: 
 CATS 2.12 CATS 2.8 CATS 2.7 CATS 2.6 CATS 2.4 CATS 2.3 CATS 2.2