Skip to content

Commit 1757085

Browse files
authored
QC-199 update doc about storage (#229)
1 parent f244d49 commit 1757085

2 files changed

Lines changed: 19 additions & 6 deletions

File tree

README.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -24,24 +24,22 @@ For a general overview of our (O2) software, organization and processes, please
2424
* [QC architecture](doc/ModulesDevelopment.md#qc-architecture)
2525
* [DPL](doc/ModulesDevelopment.md#dpl)
2626
* [Data Sampling](doc/ModulesDevelopment.md#data-sampling)
27-
* [Custom Data Sampling Condition](doc/ModulesDevelopment.md#custom-data-sampling-condition)
28-
* [Bypassing the Data Sampling](doc/ModulesDevelopment.md#bypassing-the-data-sampling)
2927
* [Code Organization](doc/ModulesDevelopment.md#code-organization)
3028
* [User-defined modules](doc/ModulesDevelopment.md#user-defined-modules)
3129
* [Module creation](doc/ModulesDevelopment.md#module-creation)
3230
* [Test run](doc/ModulesDevelopment.md#test-run)
3331
* [Modification of a Task](doc/ModulesDevelopment.md#modification-of-a-task)
3432
* [Addition of a Check](doc/ModulesDevelopment.md#addition-of-a-check)
3533
* [Commit Code](doc/ModulesDevelopment.md#commit-code)
36-
* [DPL workflow customization](doc/ModulesDevelopment.md#dpl-workflow-customization)
37-
* [Plugging Data Sampling and QC into an existing DPL workflow](doc/ModulesDevelopment.md#usage-of-ds-and-qc-in-an-existing-dpl-workflow)
34+
* [Details on data storage](doc/ModulesDevelopment.md#details-on-data-storage)
3835
* [Advanced topics](doc/Advanced.md)
36+
* [Access conditions from the CCDB](doc/Advanced.md#access-conditions-from-the-ccdb)
37+
* [Definition and access of task-specific configuration](doc/Advanced.md#definition-and-access-of-task-specific-configuration)
38+
* [Custom QC object metadata](doc/Advanced.md#custom-qc-object-metadata)
3939
* [Data Inspector](doc/Advanced.md#data-inspector)
4040
* [Use MySQL as QC backend](doc/Advanced.md#use-mysql-as-qc-backend)
4141
* [Local CCDB setup](doc/Advanced.md#local-ccdb-setup)
4242
* [Local QCG (QC GUI) setup](doc/Advanced.md#local-qcg-qc-gui-setup)
43-
* [Custom QC object metadata](doc/Advanced.md#custom-qc-object-metadata)
44-
* [Access conditions from the CCDB](doc/Advanced.md#access-conditions-from-the-ccdb)
4543
* [Information Service](doc/Advanced.md#information-service)
4644
* [Configuration files details](doc/Advanced.md#configuration-files-details)
4745
* [Frequently Asked Questions](doc/FAQ.md)

doc/ModulesDevelopment.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,8 @@
1717
* [Modification of a Task](#modification-of-a-task)
1818
* [Addition of a Check](#addition-of-a-check)
1919
* [Commit Code](#commit-code)
20+
* [Details on data storage](#details-on-data-storage)
21+
* [Storage before v0.14 and ROOT 6.18](#storage-before-v014-and-root-618)
2022

2123
<!-- Added by: bvonhall, at: -->
2224

@@ -220,6 +222,19 @@ For a new feature, just create a new branch for it and use the same procedure. D
220222

221223
General ALICE Git guidelines can be accessed [here](https://alisw.github.io/git-tutorial/).
222224

225+
## Details on data storage
226+
227+
Each MonitorObject is stored as a TFile in the CCDB (see section [Details on data storage](doc/ModulesDevelopment.md#details-on-data-storage)
228+
). It is therefore possible to easily open it with root loaded with alienv. It also seamlessly supports class schema evolution.
229+
230+
The quality is stored as a metadata on the object.
231+
232+
### Storage before v0.14 and ROOT 6.18
233+
234+
Before September 2019, objects were serialized with TMessage and stored as _blobs_ in the CCDB. The main drawback was the loss of the corresponding streamer infos leading to problems when the class evolved or when accessing the data outside the QC framework.
235+
236+
The QC framework is nevertheless backward compatible and can handle the old and the new storage system.
237+
223238
---
224239

225240
[← Go back to Quickstart](QuickStart.md) | [↑ Go to the Table of Content ↑](../README.md) | [Continue to Advanced Topics →](Advanced.md)

0 commit comments

Comments
 (0)