Skip to content

Commit 7b7d875

Browse files
committed
[skip-ci][doc] Merging.md: update comment about levels of merging
1 parent ba2e00f commit 7b7d875

File tree

1 file changed

+7
-1
lines changed

1 file changed

+7
-1
lines changed

tree/ntuple/doc/Merging.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,13 @@ Please note that the RNTupleMerger is currently experimental and the content of
1313
* **L3 Merge** (*reseal* merge): merge a page by resealing/repacking it (implies decompressing/recompressing, may change the encoding)
1414
* **L4 Merge** (*slow* merge): merge a page by re-reading and re-writing all values, potentially changing the pages' boundaries and clustering (implies resealing and recompressing)
1515

16-
(*NOTE: currently there is no guarantee for the user about which mode will be used to generate the merged RNTuple. At the moment, L0 and L4 are never used; L1 is used when possible, otherwise L3 is used. Note that we currently don't use L2 because in general when recompressing we might need to change encoding. Improvements on this front are possible and in principle we should be able to use L2 when the encoding doesn't need to change.*)
16+
Currently there is no guarantee for the user about which mode will be used to generate the merged RNTuple.
17+
At the moment, this is how it works:
18+
- if both compression and encoding of the target column match those of the source column, L1 is used;
19+
- otherwise, if compression matches but encoding doesn't, L2 is used;
20+
- otherwise L3 is used.
21+
22+
Note that L0 and L4 are currently never used.
1723

1824
## Goal
1925
The goal of the RNTuple merging process is producing one output RNTuple from *N* input RNTuples that can be used as if it were produced directly in the merged state. This means that:

0 commit comments

Comments
 (0)