iSpy home
ig-file format:
Ig Files are simple .zip files with a flat directory structure with a separate directory per run (run
directory). Each run directory contains one or more files describing a given event (ig event file)
each. The associated run number and the event number are, respectively, the filename for the run
directory and for the ig event file.
ig-event-file format:
The ig-event-file format is a valid JSON or python dictionary. The format defines three categories of objects: types, collections and associations-sets.
Syntax:
ig-event-file ::= { 'Types': type-descriptions, 'Collections': collections, 'Associations': association-sets }
Types
Types are a mapping of a type-name and its associated type-description. The type-description defines the types of the objects that are to be found in the Collection which uses the same string as the type-name to be identified. The attributes (i.e. columns) of a Collection are defined by an attribute name and an attribute type. The former is just a string label, while the second one define the kind of object which is stored in the attribute, all of which have a C++ equivalent. Possible attribute types include:
- simple numeric types: int, long, and double, which map to their C++ equivalents.
- text-like elements: string, which map to
std::string - vector like quantities: v2d, v3d, v4d which map to
IgV2d,IgV3d,IgV4d.
Syntax:
type-descriptions ::= { type-description, ... }
type-description ::= "type-name": [attributes-description, ...]
type-name ::= string-literal
attribute-description ::= ["attribute-name", "attribute-type"]
attribute-name ::= string-literal
string-literal ::= [A-Za-z_][A-Za-z_/0-9]*
attribute-type ::= int OR long OR double OR string OR v2d OR v3d OR v4d
Collections
Collections are arrays of rows, identified by a collection-name. The collection-name is a string-literal which matches one of the type-names defined in types. Rows are arrays of values, where the type of the value matches the attribute-type of the attribute-description with the same position in the type-description which has its type-name matching the collection name.
This is the actual data contained in a file.
Syntax:
collections ::= {collection, ... }
collection ::= "type-name": [row, ...]
row ::= [ value, ...]
value ::= string-literal OR numeric-literal OR vector-literal
numeric-literal ::= [0-9]+[.]*[0-9]*
vector-literal ::= [numeric-literal, numeric-literal, ...]
Association sets
An association defines a relationship between two rows found in any (possibly the same) collections. They are uniquely identified by two couples of numbers, the first one uniquely identifying the left object of the association, the other identifying the right object. The first element of this couple of numbers is the so called collection id while the second one is called object id. The collection id is the index of the collection type within the Types table, while the object id is the index of the object within the collection. Such a couple of numbers is called object reference. An association-set is an array of associations which share some common meaning decided by the writer of the ig-file.
Syntax:
associations-sets ::= { association-set, ... }
association-set ::= "association-set-name": [association, ...]
association ::= [left-object, right-object]
left-object ::= object-reference
right-object ::= object-reference
object-reference ::= [collection-id, object-id]
collection-id ::= index-literal
object-id ::= index-literal
index-literal ::= [0-9]+
Examples:
Here is a simple example of how an ig file looks like.
{"Types": {"Tracks_V1": [["x", "double"],["y", "double"],["z", "double"],
["px", "double"],["py","double"],["pz", "double"]],
"Clusters_V1": [["x", "double"],["y", "double"],["z", "double"],
["e", "double"]]
},
"Collections": {"Tracks_V1": [[0, 0, 0, 0, 0, 0],
[1, 1, 1, 1, 1, 1],
[2, 2, 2, 2, 2, 2],
[3, 3, 3, 3, 3, 3],
[4, 4, 4, 4, 4, 4],
[5, 5, 5, 5, 5, 5],
[6, 6, 6, 6, 6, 6],
[7, 7, 7, 7, 7, 7],
[8, 8, 8, 8, 8, 8],
[9, 9, 9, 9, 9, 9]
],
"Clusters_V1": [[0, 0, 0, 0],
[1, 1, 1, 1],
[2, 2, 2, 2],
[3, 3, 3, 3],
[4, 4, 4, 4],
[5, 5, 5, 5],
[6, 6, 6, 6],
[7, 7, 7, 7],
[8, 8, 8, 8],
[9, 9, 9, 9]
]
},
"Associations": {"TrackClusters_V1": [[[0, 0], [1, 0]],
[[0, 1], [1, 1]],
[[0, 2], [1, 2]],
[[0, 3], [1, 3]],
[[0, 4], [1, 4]],
[[0, 5], [1, 5]],
[[0, 6], [1, 6]],
[[0, 7], [1, 7]],
[[0, 8], [1, 8]],
[[0, 9], [1, 9]]
],
"TrackClusters2_V1": [[[0, 0], [1, 0]],
[[0, 1], [1, 0]],
[[0, 2], [1, 0]],
[[0, 3], [1, 0]],
[[0, 4], [1, 0]],
[[0, 5], [1, 0]],
[[0, 6], [1, 0]],
[[0, 7], [1, 0]],
[[0, 8], [1, 0]],
[[0, 9], [1, 0]]
]
}
}