_______                      _   ____
   --->---+--- |__   __| ------------------ | | |  _ \ ---+--->---
           \      | |   __    ____     __   | | | | \ \   |
            +     | |  /  \  |  _ \   /  \  | | | |  \ \  |
            |\    | | / /\ \ | | \ \ / /\ \ | | | |  / /  +--->---
            | \   | | \ \/ / | |_/ / \ \/ / | | | |_/ /  /
            |  \  |_|  \__/  |  __/   \__/  |_| |____/  +
            |   \            | |                       / \
   --->-----+----+---------- |_| ---------------------+---+--->---


TopoID is a Mathematica package capable of [Topo]logy [ID]entification
and related tasks appearing in multiloop calculations.

Starting from Feynman diagrams, the underlying generic topologies are
identified and their set is minimized.  These generic topologies can
then be decomposed into (linearly independent) Laporta topologies.  FORM
code can be generated in order to map diagrams onto generic topologies
and to process both types of topologies.  Afterwards emerging sets of
master integrals can also be minimized, including generic base changes.

Webpage
-------

"https://www.ttp.kit.edu/~jens/" or
"https://github.com/thejensemann/TopoID/".


Contact
-------

"jens.hoff@kit.edu" or "jens.hoff@desy.de".


Publications
------------

- Alexey Pak, "The Toolbox of modern multi-loop calculations: novel
  analytic and semi-analytic techniques", [Pak:2011xt],
  "http://arxiv.org/pdf/1111.0868.pdf".
- Jens Hoff and Jonathan Grigo, "Mass-corrections to double-Higgs
  production & TopoID", [Grigo:2014oqa],
  "http://arxiv.org/pdf/1407.1617.pdf"
- Jens Hoff, "Methods for multiloop calculations and Higgs boson
  production at the LHC, "http://d-nb.info/1071894153/34".
- Jens Hoff, "The Mathematica package TopoID and its application to the
  Higgs boson production cross section", [TODO: identifier], "TODO:
  weblink"
- Jens Hoff and Alexey Pak, "TODO: title", [TODO: identifier], "TODO:
  weblink"


Authors
=======

The first version of TopoID is due to Alexey Pak.  To be more specific
the code for two main algorithms (canonical ordering of polynomials for
topology identification and usage of Groebner bases for partial
fractioning) described in [Pak:2011xt] was adopted initially.  This code
was later rewritten completely and integrated into a new package by Jens
Hoff.  Since then the package gained a lot of functionality, see the
documentation for further information.


License
=======

This package is distributed under GPLv3.  See the file COPYING.  If you
use the package for a project, please cite it as:

  [TODO: LaTeX code]


Files and directories
=====================

- The main directory "TopoID/" contains the source code of the package.
- "etc/" contains ancillary QGRAF style files and FORM routines.
- "doc/" contains a complete user manual (the publication [TODO:
  identifier]) and a tutorial in pdf format.
- "examples/" helds various simple demonstrations of the features of
  TopoID.
- "check/" helds test routines for the modules of TopoID and is meant
  mainly for keeping up consistency in development.
- "NEWS" contains the most important changes in different versions.
- "TODO" contains a list of features to be integrated in the future.


Installation
============

See the file "INSTALL".