Detector Description for HEP

DD4hep toolkit goals

  • Full Detector Description
    It include geometry, materials, visualization, readout, alignment, calibration, etc.
  • Full Experiment life cycle
    Detector concept development, detector optimization, construction, operation. Easy transition from one phase to the next
  • Consistent Description
    Single source of detector information for simulation, reconstruction, analysis, etc.
  • Ease of Use
    Few places to enter information. Minimal dependencies

Overall Design


The design document for DD4Hep is one of the AIDA deliverables. 

The DD4hep Starters Guide contains all necessary instructions to build the packages and use the contained software. The main documentation of the core software is the DD4Hep User's Guide (work in progress).

Besides this main document the various sub-packages, which depend on the core package:

  • The DDG4 User's Guide covering the simulation of particle collisions using geometries described by DD4hep (work in progress).
  • The DDAlign User's Guide describing the access to alignment data and the handling of misplaced geometries within DD4hep (work in progress).
  • The DDCond Users Guide, illustration the connection to conditions data (work in progress).
  • The DDRec User's Guide, a repository of objects used to reconstruct particle collisions developed by the linear collider groups mainly at CERN and Desy (work in progress).

A more detailed User Manual generated using doxygen is available here.

The CLICdp Twiki may be helpful to resolve common difficulties when getting started.

Code repository

DD4hep software package is available at

Public checkout is available through svn co DD4hep 

Bug Tracker (JIRA)

The new DD4hep bug tracker is accessible at: 
To create new bugs you require a CERN account, but you can create an external account very easily. 
The old tracker is available at

Build and Run instructions

Basic instructions are available on the ReadMe.txt file

Presentations and Documentation