TreeStore is one of Python-Blosc2's headline features, and doc/reference/tree_store.rst documents its API. However, there is no interactive tutorial notebook in doc/tutorials/ showing how to use TreeStore to organize and query complex datasets.
Suggested Work
Create a new Jupyter Notebook at doc/tutorials/17.treestore-hierarchies.ipynb and register it in doc/tutorials/index.rst.
The notebook should demonstrate:
- Container layouts: Creating and opening in-memory stores, single-file zip stores (
.b2z), and directory layouts (.b2d).
- Hierarchy & Groups: Creating groups and populating nested paths (e.g.,
/experiment/run_01/measurements, /metadata/config).
- Storing mixed containers: Inserting
blosc2.NDArray arrays, blosc2.CTable tables, and custom scalar/dictionary attributes (attrs).
- Traversal & Discovery: Walking through trees with
tree.walk() and searching for nodes matching specific criteria.
- Updating nodes & compression: Replacing or appending nodes in existing stores.
- Visualizing with
b2view: Mentioning how the generated .b2z/.b2d file can be browsed in the terminal via b2view.
TreeStoreis one of Python-Blosc2's headline features, anddoc/reference/tree_store.rstdocuments its API. However, there is no interactive tutorial notebook indoc/tutorials/showing how to useTreeStoreto organize and query complex datasets.Suggested Work
Create a new Jupyter Notebook at
doc/tutorials/17.treestore-hierarchies.ipynband register it indoc/tutorials/index.rst.The notebook should demonstrate:
.b2z), and directory layouts (.b2d)./experiment/run_01/measurements,/metadata/config).blosc2.NDArrayarrays,blosc2.CTabletables, and custom scalar/dictionary attributes (attrs).tree.walk()and searching for nodes matching specific criteria.b2view: Mentioning how the generated.b2z/.b2dfile can be browsed in the terminal viab2view.