7 releases
0.1.6 | Jul 29, 2022 |
---|---|
0.1.5 | Jul 22, 2022 |
21 downloads per month
185KB
4.5K
SLoC
oxyroot
Another attempt to make library reading of .root
binary files which are commonly used in particle physics
Inspiration
To make this library :
- heavy inspiration taken from groot for reading root file, even the code organisation
- inspiration taken from uproot to provide branch interface (for reading basket buffer)
See also
Another rust implementation of a root reader is root-io
.
Getting started
Example: Iter over a branch tree containing i32
values
use oxyroot::RootFile;
let s = "examples/from_uproot/data/HZZ.root";
let tree = RootFile::open(s).unwrap().get_tree("events").unwrap();
let NJet = tree.branch("NJet").unwrap().as_iter::<i32>();
NJet.for_each( | v| println!("v = {v}"));
Example: Iter over a branch tree containing Vec<i32>
(aka std::vector<int32_t>
) values
use oxyroot::RootFile;
let s = "tests/stl_containers/stl_containers.root";
let tree = RootFile::open(s).unwrap().get_tree("tree").unwrap();
let vector_int32 = tree.branch("vector_int32")
.unwrap().as_iter::<Vec<i32> > ()
.collect::<Vec<_ > > ();
assert_eq!(
vector_int32,
[
vec![1],
vec![1, 2],
vec![1, 2, 3],
vec![1, 2, 3, 4],
vec![1, 2, 3, 4, 5]
]
);
Feature
oxyroot
use flate2
to decompress zlib compressed data.
The default backend is miniz_oxide
, pure Rust crate.
If you want maximum performance, you can use the zlib-ng C library:
[dependencies]
oxyroot = { version = "0.1", features = ["zlib-ng"] }
Dependencies
~9.5MB
~178K SLoC