Project

General

Profile

Wiki » History » Version 10

Kyle Knoepfel, 06/25/2019 02:26 PM

1 1 Kyle Knoepfel
h1. art_root_io
2 1 Kyle Knoepfel
3 6 Kyle Knoepfel
{{>toc}}
4 6 Kyle Knoepfel
5 3 Kyle Knoepfel
The _art_root_io_ package contains utilities for interacting with ROOT from within an project:art module, service, or other kind of plugin.  Some of the provided facilities include:
6 2 Kyle Knoepfel
7 2 Kyle Knoepfel
* *@RootOutput@*, an _art_ output module that persists data products to ROOT files (hereafter _art_/ROOT files),
8 2 Kyle Knoepfel
* *@RootInput@*, an _art_ input source that can read the _art_/ROOT files, and
9 8 Kyle Knoepfel
* [[TFileService]], an _art_ service that provides a simple interface for making ROOT objects, and persisting them to a bare ROOT file in an organized fashion.
10 2 Kyle Knoepfel
11 1 Kyle Knoepfel
Although not a member of the project:art suite, it is included as a member of the project:critic suite.  The UPS product can be setup by itself, or it can be setup through the _critic_ umbrella UPS product.
12 3 Kyle Knoepfel
13 4 Kyle Knoepfel
h2{background:#D5D8DC}.  I/O handling
14 4 Kyle Knoepfel
15 4 Kyle Knoepfel
h3. Output-file handling
16 4 Kyle Knoepfel
17 4 Kyle Knoepfel
* [[Output-file_handling|art/ROOT output file handling]]
18 4 Kyle Knoepfel
* [[Output file renaming for ROOT files]]
19 4 Kyle Knoepfel
20 4 Kyle Knoepfel
h3. Data products and ROOT dictionaries
21 4 Kyle Knoepfel
22 7 Kyle Knoepfel
* [[Data product dictionary how-to]]
23 4 Kyle Knoepfel
* [[Specifying ROOT compression for data products]]
24 7 Kyle Knoepfel
* [[Facilitating schema evolution for data products]]
25 4 Kyle Knoepfel
26 9 Kyle Knoepfel
h2{background:#D5D8DC}.  Helper programs 
27 9 Kyle Knoepfel
28 9 Kyle Knoepfel
The following programs are provided for reading information about _art_/ROOT files.  For each program, the @-h@ option may be specified for a printout of the available program options.
29 9 Kyle Knoepfel
30 9 Kyle Knoepfel
* %(#config-dumper-exec) *@config_dumper@*%: this program will read an art/ROOT output file and print out configuration information for the process(es) that created that file.
31 9 Kyle Knoepfel
* %(#file_info_dumper-exec) *@file_info_dumper@*%: this program will read an art/ROOT output file and has the ability to print the list of events in the file, print the range of events, subruns, and runs that contributed to making the file, and provides access to the internal SQLite database, which can be saved to an external database.
32 9 Kyle Knoepfel
* %(#count_events-exec) *@count_events@*%: this program will read an art/ROOT output file and print out how many events are contained in that file.
33 9 Kyle Knoepfel
* %(#product_sizes_dumper-exec) [[product_sizes_dumper]]%: this program will read and art/ROOT output file and print out information about the sizes of products.
34 9 Kyle Knoepfel
* %(#sam_metadata_dumper-exec) [[art:SAM_metadata_facilities#sam_metadata_dumper|sam_metadata_dumper]]%: The sam_metadata_dumper application will read an art-ROOT format file, and extract the information for possible post-processing and upload to SAM.
35 9 Kyle Knoepfel
36 3 Kyle Knoepfel
h2{background:#D5D8DC}.  Release notes
37 3 Kyle Knoepfel
38 10 Kyle Knoepfel
* [[Series 1.01]]
39 3 Kyle Knoepfel
* [[Series 1.00]]