Difference between revisions of "File Metadata Schema"

From DUNE
Jump to navigation Jump to search
Line 33: Line 33:
 
The "<code>runs</code>" variable is a '''list''' of 2-tuples or 3-tuples.  In the former case, <code>the subrunnumber</code> is dropped.  This means that a single file may be recorded as spaning runs and/or subruns.  The <code>file_partition</code> is open to interpretation by the experiment (as are the other numbers).
 
The "<code>runs</code>" variable is a '''list''' of 2-tuples or 3-tuples.  In the former case, <code>the subrunnumber</code> is dropped.  This means that a single file may be recorded as spaning runs and/or subruns.  The <code>file_partition</code> is open to interpretation by the experiment (as are the other numbers).
  
= Proposed Schema Evolution Policy and Procedure =
+
= 35 ton =
  
A proposal for schema evolution policy and procedure is in {{DocDB|9888}}.  It contains a description of the existing file metadata schema. 
+
This section collects info specific to metadat for 35t raw data file production
  
= 35t file numbers =
+
== File numbering ==
  
 
Some email ca. July 2014 between online and offline people discussed this.  The summary:
 
Some email ca. July 2014 between online and offline people discussed this.  The summary:
Line 46: Line 46:
  
 
In terms of SAM, this means either dropping <code>subrunnumber</code> and using the 2-tuple form of <code>runs</code> and using <code>file_partition</code> to count the subrun '''OR''' keeping the 3-tuple form and either ignoring <code>file_partition</code> or filling it with a redundant count.  My (bv) recomendation is to adopt the latter.
 
In terms of SAM, this means either dropping <code>subrunnumber</code> and using the 2-tuple form of <code>runs</code> and using <code>file_partition</code> to count the subrun '''OR''' keeping the 3-tuple form and either ignoring <code>file_partition</code> or filling it with a redundant count.  My (bv) recomendation is to adopt the latter.
 +
 +
== Desire metadata schema ==
 +
 +
This section collects the metadata schema desired for the 35t, parameter names, types, etc.  This will become the fodder for a formal change proposal.
 +
 +
 +
 +
  
 
[[Category:Metadata]]
 
[[Category:Metadata]]

Revision as of 15:34, 7 November 2014

File Metadata Schema is a description of what excerpted, summary information we store about each file and outside each file.

Documents

Drivers

The metadata schema is something that multiple systems rely on

  • detector DAQ systems must ultimtely produce it
  • end-user analyses rely on datasets defined in terms of it
  • production data processing systems need to query it

Currently, the schema to describe data from the the verticle slice test and 35t prototype test run are paramount.

SAM

The de'facto choice for a file metadata system is "SAM" from Fermilab. It has a required/default schema. The table in this Redmine page gives a summary. It is up to the experiment to extend and for some elements, interpret, this schema. This extension and interpretation needs to be carefully nailed down and allowed to evolve in a well controlled manner.

File numbers

See below for issues on this topic related to 35t.

SAM supports both subrun and file numbers. It has two fields that pertain on a per-file basis:

runs = [ [<runnumber>, <subrunnumber>, <runtype>], ]
file_partition = <filenumber>

The "runs" variable is a list of 2-tuples or 3-tuples. In the former case, the subrunnumber is dropped. This means that a single file may be recorded as spaning runs and/or subruns. The file_partition is open to interpretation by the experiment (as are the other numbers).

35 ton

This section collects info specific to metadat for 35t raw data file production

File numbering

Some email ca. July 2014 between online and offline people discussed this. The summary:

  • artDAQ writes files to disk and enstore and is the initial source of metadata (Kurt Biery, John Freeman)
  • Monotonically increasing "run number" (likely not starting at zero/one, and tracked/asserted by run control. Subrun and/or file numbers generated by artDAQ (Erik Blaufus)
  • artDAQ will set subrun number and will keep one file per subrun (Kurt Biery)

In terms of SAM, this means either dropping subrunnumber and using the 2-tuple form of runs and using file_partition to count the subrun OR keeping the 3-tuple form and either ignoring file_partition or filling it with a redundant count. My (bv) recomendation is to adopt the latter.

Desire metadata schema

This section collects the metadata schema desired for the 35t, parameter names, types, etc. This will become the fodder for a formal change proposal.