LCTuple
 -------

 Marlin package that creates a ROOT TTree with a column wise ntuple
 from LCIO collections.

 F.Gaede, DESY, 2011
 B.Vormwald, DESY, 2012 
 F. Mueller, C. Duerig, A. Ebrahimi, DESY, 2015

-----------------------------------------------------



  Build LCTuple
  -------------

    . /path/to/ilcsoft/installation/v01-XX/init_ilcsoft.sh
    mkdir build
    cd build
    cmake -C $ILCSOFT/ILCSoft.cmake ..
    make install # this should create library: lib/libLCTuple.so
    cd ..


 
 Running LCTuple
 ---------------

    export MARLIN_DLL=$PWD/lib/libLCTuple.so
    cd example
    Marlin --global.LCIOInputFiles=./DST01-06_ppr004_6f_bbqqqq_500_ILD_00_0.001.slcio --global.MaxRecordNumber=1000 lctuple.xml
    

    // make plots with TTree:Draw(), e.g.
    root -l 
    .x /example_plots.C("./lctuple.root")
    
    // see also other examples	
    draw_simhits.C
       - hit maps from sim hits r-z and r-phi

    draw_mcp_vtx.C
       - draw vertices of secondary MCParticles

    draw_vtx_z.C
       - draw tue and reconstructed z-vertex position

    draw_etot.C
       - draw true and reconstructed total energy
 
-------------------------------------------------------------------------------------------

  --------
 | v01-04 |
  --------

   - Added JetBranches which holds branches created from a jet collection
     created by Satoru Jet Finder processor.
     JetBranches has two steerable parameters which are optionally
     set in the steering file:
      * writeExtraParameters: if set to TRUE, the fill function
        calculates some extra parameters using parameters provided
        by the jet finding algorithm. Default value is FALSE.
        See class data members for a list of extra parameters.
      * writeTaggingParameters: if set to TRUE, the fill function
        creates branches for jet parameters coming form flavor tagging
        processor. If no flavor tagging processr is used, this should
        be set to FALSE to prevent errors. Default value is FALSE.
        See class data members for a list of extra parameters.
   - Added isolated lepton branches
   - Added MC particle from relation branches
   - Added MC particle remove overlay branches

  --------
 | v01-03-01 |
  --------

   - add an example for creating an lctuple w/ simhits (F.Gaede)


  --------
 | v01-03 |
  --------
   -  added support for TrackerHits

  --------
 | v01-02 |
  --------
   - (J.List) added some variables: MCParticle daughters: mcda0-mcda4 , Event parameters: evene, evpoe, evpop
             RecoParticles: cluster size: rcncl

  --------
 | v01-01 |
  --------
   -  only change : create the TTree with the name of the processor
                    (used to be hard coded LCTuple)


  --------
 | v01-00 |
  --------

       - first version creates CWNT for 
        MCParticles, ReconstructedParticles, Tracks, Clusters, LCRelations, Vertices

      - optionally also SimTrackerHits and SimCalorimeterHits can
        be written to the ntuple