Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

options:
  --recurse                              Recurse sub-folders
  --search-folders                    Search for datasets inside folder(s)
  --search-groups                    Search in groups.  This option is superceeded by the -G (-group ) option if they are both supplied.
  --group <group name>         Dataset Group under which to search for datasets.
  --site <site name>                Name of Site to search.  May be used multiple times to specify a list of sites in which case order is taken as preference.  Defaults to the Master-location if not provided.
  --filter <filter expression>     Criteria by which to filter datasets.  ie: 'DatasetDataType=="MERIT" && nMetStart>=257731220 && nMetStop <=257731580'
  --sort <meta name>             Name of meta-data field to sort on.  May be used multiple times to specify a list of fields to sort on.  Order determines presidence.

...

Panel
titleHere's a loose grammar which defines the filter expressions:

Expr ::= Expr
Expr ::= '(' Expr ')'
Expr ::= '!' Expr
Expr ::= Expr LogOp Expr
LogOp ::= '&&' | '||'
Expr ::= Comparable CmpOp Comparable
CmpOp ::= '==' | '!=' | '>=' | '<='
Comparable ::= "String"                --> a String constant must be enclosed in double quotes
Comparable ::= Number
Comparable ::= Identifier
Comparable ::= UnOp Comparable
UnOp ::= '-' | '+'
Comparable ::= Comparable BinOp Comparable
BinOp ::= '/' | '*' | '+' | '-'

Meta Data fields you can use in your expressions:

System maintained (build in) meta-data:

Type

Name

Built In Type

User Defined Description

Name

String

Dataset Name

FileFormat

String

File encoding. ex: "root", "fits"

DataType

String

Type

 

 

 

 

 

 

 

 

of data in file. Always uppercase. ex: "RECON"

VersionID

Integer

Version of the Dataset this file represents.

CreateDate

Timestamp

Date this Version of the Dataset was created.

Source

String

What created this Version of the Dataset. ex: "PIPELINE", "LINEMODE CLIENT"

TaskName

String

If Source=="PIPELINE" this will contain the name of the Task which created this Version of the Dataset.

RunMin

Long Integer

Smallest Run Identifier found in this file, if applicable.

RunMax

Long Integer

Largest Run Identifier found in this file, if applicable.

NumberEvents

Long Integer

Number of events in the file, if applicable.

FileSizeBytes

Long Integer

Size of this file on disk, in bytes.

RootVersion

String

If FileFormat=="root", the version of root which wrote this file.

SOLibVersion

String

If FileFormat=="root", the version of the shared object library that the events correspond to, if applicable.

TTreeName

String

If FileFormat=="root", the name of the first TTree in the file, if one exists.

 

 

 

 

Examples: