XMM-Newton SAS Home Page
XMM-Newton Science Analysis System


dal (dal-1.199) [xmmsas_20230412_1735-21.0.0]

Qualified Names

Most objects in the Dal Model have a name, and an owner (usually referred to as the parent). This gives rise to an ancestral sequence of objects, beginning with the dataset and continuing to the object. The Qualified Name, of an object is the token-separated concatenation of names of each object in this sequence.

The colon character is used to separate the names of datasets, blocks and columns, but the % character is used before an attribute name.

e.g. "set:tab:col%att" is the fully qualified name of the column-attribute with name "att", whose parent column has name "col", whose parent table has name "tab", whose parent dataset has name "set".

It is possible to omit the block, column or attribute name from a qualified name. The effect of this is equivalent to specifying the name of the first block in a dataset, the first column in a table, or the first attribute in an attributable e.g.the qualified name "set::col" may be used to access the column with name "col" in the first table contained in the dataset with name "set".

The qualified name of an object may be passed to many of the functions and subroutines. The DAL will parse these names and raise an error if inconsistencies are detected.

XMM-Newton SOC -- 2023-04-16