silverweed/rntviewer
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
257 commits 2 branches 0 tags 2.1 MiB
C++ 90.8%
C 8%
Makefile 1.2%
Find a file
silverweed 47c993dd01 invert order of BgColorFn calls in mem edit to avoid cache misses 
BgColorFn(addr) will call find_section(addr) internally. If we call
BgColorFn(addr + 1) and then BgColorFn(addr), the first call may cause
the cached `last_pinfo` / `last_other_root_obj` to change to the next
one in the list, which in turn will cause the second call to "page fault".
Inverting the order doesn't change anything in mem_edit but it better
uses our application cache to speedup section finding.
2025-01-24 11:04:59 +01:00
src some fixes & speedups 2025-01-24 11:04:28 +01:00
testdata add first 1.0.0.0 rntuple to testdata 2024-11-13 13:51:38 +01:00
third_party invert order of BgColorFn calls in mem edit to avoid cache misses 2025-01-24 11:04:59 +01:00
.gitignore update gitignore 2024-09-24 11:56:56 +02:00
.gitmodules make imgui a submodule; import memory editor 2024-07-10 21:41:48 +02:00
COPYING add license 2024-08-08 17:27:22 +02:00
example.png update example.png 2024-11-13 11:58:57 +01:00
Makefile simplify a bunch of stuff 2025-01-22 17:04:56 +01:00
README.md remove GLAD 2024-11-13 14:32:35 +01:00

README.md

rntviewer

This is an interactive visualization tool for RNTuple. It can also be used to read generic TFiles and display some information about them, but it's mostly focused on inspecting the on-disk structure of RNTuples.

Getting the repo

Clone this repository with

git clone --recurse-submodules https://codeberg.org/silverweed/rntviewer

Dependencies

rntviewer currently only fully works on Linux, with the terminal-only version working on MacOS as well.

The dynamic dependencies are:

  • GLFW3 (libglfw3-dev on debian, glfw-devel on fedora, glfw on arch)
  • ROOT (likely bleeding edge version, compiled from sources)
  • libxxhash3-dev

Other than those, rntviewer statically depends on Dear ImGui (included in the source tree - make sure to clone the submodules!).

For the graphical version, the OS must support OpenGL 3.3 or higher.

For the terminal-only version you don't need GLFW3, ImGui or OpenGL support.

Building

Building is done with make. Make sure to source /path/to/root/bin/thisroot.sh before running it. You probably want to build the release version:

make r

You can test that the tool is working properly with:

./rntviewer testdata/RNTuple.root

To build the terminal-only version:

make nogfx_r

Usage

Basic usage is:

./rntviewer <ntuple_file.root> [ntuple_name]

This will open a window and let you browse the RNTuple, jump around its sections and get some information about them. If you don't specify ntuple_name, the program will look for the first RNTuple in the file.

There is also a non-interactive non-graphical mode that can be used in a terminal (useful e.g. for ssh sessions):

$ ./rntviewer -t <ntuple_file.root> [ntuple_name]

The -t flag enables terminal mode. Use ./rntviewer -h to get a help message about the other flags that rntviewer accepts and are particularly useful in non-interactive mode.