go-root

=======
go-root
=======

Experimental, pure-Go package to read ROOT files (and perhaps write
them out too), without having ROOT installed.

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

::

  $ go get github.com/sbinet/go-root/pkg/groot


Example
=======

An executable ``groot-ls`` is provided, which will recursively dump
the hierarchical content of a ``ROOT`` file:

::

  $ go get github.com/sbinet/go-root/cmd/groot-ls
  $ groot-ls -f my.esd.root
  :: groot-ls ::
  file: 'my.esd.root' (version=53005)
  / -> #11 key(s)
  key: name='##Shapes' title='##Shapes' type=TTree
  key: name='##Links' title='##Links' type=TTree
  key: name='##Params' title='##Params' type=TTree
  key: name='CollectionTree' title='CollectionTree' type=TTree
  key: name='CollectionTreeTPCnv::MuonMeasurements_tlp2' title='CollectionTreeTPCnv::MuonMeasurements_tlp2' type=TTree
  key: name='CollectionTreeInDet::Track_tlp1' title='CollectionTreeInDet::Track_tlp1' type=TTree
  key: name='CollectionTreeMuonCaloEnergyContainer_tlp1' title='CollectionTreeMuonCaloEnergyContainer_tlp1' type=TTree
  key: name='CollectionTreeAnalysis::JetTagInfo_tlp3' title='CollectionTreeAnalysis::JetTagInfo_tlp3' type=TTree
  key: name='POOLContainer' title='POOLContainer' type=TTree
  key: name='MetaData' title='MetaData' type=TTree
  key: name='MetaDataHdr' title='MetaDataHdr' type=TTree
  ::bye.

  $ groot-ls -f my.d3pd.root
  :: groot-ls ::
  file: 'my.d3pd.root' (version=52200)
  / -> #5 key(s)
  key: name='Schema' title='' type=AttributeListLayout
  key: name='egammaMeta' title='egammaMeta' type=TDirectory
    /egammaMeta -> #1 key(s)
    key: name='TrigConfTree' title='TrigConfTree' type=TTree
  key: name='Lumi' title='Lumi' type=TDirectory
    /Lumi -> #1 key(s)
    key: name='egamma' title='object title' type=TObjString
  key: name='CollectionTree' title='CollectionTree' type=TTree
  key: name='egamma' title='egamma' type=TTree
  ::bye.


Documentation
=============

``groot`` documentation can be found over there:

http://go.pkgdoc.org/github.com/sbinet/go-root/pkg/groot