This is the README file for ColorFull 1.1

ColorFull is a C++ program for color summed calculations in QCD color
space.

=============================== Install ===============================

To compile and install ColorFull in stand-alone mode follow these steps:

1) Run the configure script:

  ./configure 
     --prefix=[installation prefix, defaults to /usr/local]

   For example, to install to a different path, run:  
   ./configure --prefix="/dir/to/install/to"
   If you do not give a prefix, you may get errors due to lacking
   privileges in the install step. However, for only trying 
   ColorFull, you can skip the install step, see "Run" below.
   
   (Try ./configure --help for more options.)

2) Build:
   make

3) Install to the path specified by prefix in the configure step:
   make install

   (Specifying a prefix and running "make install", is not needed
   for trying ColorFull in stand-alone mode, see Run below.)

Since ColorFull is included in Herwig from version 7.0, no special
action is needed to use ColorFull from within Herwig.

================================ Run =================================

To try out the functionality of ColorFull, test to run ColorPlay in 
the Examples directory and try commenting in and out lines in 
ColorPlay.cc.


============================== Manual =================================

The ColorFull manual is available at http://arxiv.org/abs/1412.3967,
and published in Eur.Phys.J. C75 (2015) no.5, 236. For full details,
see the Doxygen-generated documentation of the classes at 
http://colorfull.hepforge.org/doxygen/.

Very briefly ColorFull is built on the classes:

* Monomial: 
	Nc^pow_Nc*CF^pow_CF*TR^pow_TR*int_part*cnum_part
	
* Polynomial: 
	a sum of Monomials

* Poly_vec: 
	a vector of Polynomials

* Poly_matr: 
	a matrix of Polynomials

* Quark_line: 
	a Polynomial times a closed (1,2,3,4) or an open {1,3,4,2} 
	quark-line.

* Col_str: 
	a Polynomial*(product of Quark_lines).

* Col_amp: 
	a sum of Col_strs + Scalar.
	Scalar is a Polynomial and is used for containing the 
	Polynomial resulting after having contracted all color indices.

* Col_basis, Trace_basis, Tree_level_gluon_basis, Orthogonal_basis:
	These are basis classes for containing QCD color bases.

* Col_functions:
	This is a library class with functions for:
	- numerical evaluation
	- leading Nc evaluation
	- scalar products 
	- gluon exchange 
	- gluon emission
	- color correlator < c | T_i T_j | c >
	- soft anomalous dimension color matrices 	  


============================ License ==================================

    ColorFull
    Copyright (C) 2010-2017 Malin Sjödahl, Simon Plätzer

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License version 2 as 
    published by the Free Software Foundation.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

