Skip to content

Commit dc14e85

Browse files
committed
Update README according to QC-129
1 parent c17294a commit dc14e85

1 file changed

Lines changed: 13 additions & 7 deletions

File tree

README.md

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ TODO add a link to the user documentation of the QCG
9797

9898
__Configuration file__
9999

100-
The devices are configured in the config file named `basic.json`. It is installed in `$QUALITY_CONTROL/etc`. Each time you rebuild the code, `$QUALITY_CONTROL/etc/basic.json` is overwritten by the file in the source directory (`~/alice/QualityControl/Framework/basic.json`).
100+
The devices are configured in the config file named `basic.json`. It is installed in `QUALITYCONTROL_ROOT/etc`. Each time you rebuild the code, `QUALITYCONTROL_ROOT/etc/basic.json` is overwritten by the file in the source directory (`~/alice/QualityControl/Framework/basic.json`).
101101

102102
### Readout chain
103103

@@ -138,7 +138,7 @@ The data sampling is configured to sample 1% of the data as the readout should r
138138

139139
__Configuration file__
140140

141-
The configuration file is in `$QUALITY_CONTROL/readout.json`. It is installed in `$QUALITY_CONTROL/etc`. Each time you rebuild the code, `$QUALITY_CONTROL/etc/readout.json` is overwritten by the file in the source directory (`~/alice/QualityControl/Framework/readout.json`).
141+
The configuration file is in `QUALITYCONTROL_ROOT/readout.json`. It is installed in `QUALITYCONTROL_ROOT/etc`. Each time you rebuild the code, `QUALITYCONTROL_ROOT/etc/readout.json` is overwritten by the file in the source directory (`~/alice/QualityControl/Framework/readout.json`).
142142
To avoid this behaviour and preserve the changes you do to the configuration, you can copy the file and specify the path to it with the parameter `--config-path` when launch `qcRunReadout`.
143143

144144
To change the fraction of the data being monitored, change the option `fraction`.
@@ -315,7 +315,7 @@ make -j8 install # replace 8 by the number of cores on your machine
315315

316316
To test whether it works, we are going to run a basic DPL workflow defined in `runBasic.cxx`.
317317
We need to modify slightly the config file to indicate our freshly created module and classes.
318-
The config file is called `basic.json` and is located in `$QUALITY_CONTROL/etc/` (after installation, if you want to modify the original one it is in the source directory `Framework`).
318+
The config file is called `basic.json` and is located in `QUALITYCONTROL_ROOT/etc/` (after installation, if you want to modify the original one it is in the source directory `Framework`).
319319
Change the lines as indicated below :
320320

321321
```
@@ -332,20 +332,26 @@ qcRunBasic
332332

333333
You should see the QcTask at qcg-test.cern.ch with an object `Example` updating.
334334

335+
#### Note on the data format
336+
337+
The header is a O2 header populated with data from the header built by the Readout. The payload received in the QC is a CRU data page.
338+
335339
## Modification of a Task
336340

337341
Fill in the methods in RawDataQcTask.cxx. For example, make it send a second histogram.
338342
Once done, recompile it (see section above) and run it. You should see the second object published in the qcg.
339343

340344
TODO give actual steps
341345

346+
TODO Rename the task in teh config file and see in QCG that it appears under a different name.
347+
342348
## Addition of a Check
343349

344350
TODO
345351

346352
## DPL workflow customization
347353

348-
If you want to change the workflow, edit or copy `runBasic.cxx`. For example...
354+
If you want to change the workflow, edit or copy `runBasic.cxx` or `runReadout.cxx`. For example...
349355

350356
TODO
351357

@@ -409,13 +415,13 @@ In 3 separate terminals, do respectively
409415

410416
__Fraction of data__
411417
The Data Sampling tries to take 100% of the events by default.
412-
Edit $QUALITY_CONTROL/readoutForDataDump.json
418+
Edit QUALITYCONTROL_ROOT/readoutForDataDump.json
413419
to change it. Look for the parameter `fraction` that is set to 1.
414420

415421
__Port__
416422
The Data Sampling sends data to the GUI via the port `26525`.
417-
If this port is not free, edit the config file $QUALITY_CONTROL/readoutForDataDump.json
418-
and $QUALITY_CONTROL/dataDump.json.
423+
If this port is not free, edit the config file QUALITYCONTROL_ROOT/readoutForDataDump.json
424+
and QUALITYCONTROL_ROOT/dataDump.json.
419425

420426
## Use MySQL as QC backend
421427

0 commit comments

Comments
 (0)