imas.util.get_parent¶

imas.util.get_parent(node: IDSBase) → IDSBase | None¶

Get the parent of any IDS node.

Parameters:

node: IDSBase¶

Any node (structure, array of structures, data node) of an IDS.

Returns:

The parent node of the provided node, or None if the node is an IDS toplevel.

Example

>>> cp = imas.IDSFactory().core_profiles()
>>> cp.profiles_1d.resize(2)
>>> imas.util.get_parent(cp.profiles_1d[0].electrons.temperature)
<IDSStructure (IDS:core_profiles, profiles_1d[0]/electrons)>
>>> imas.util.get_parent(cp.profiles_1d[0].electrons)
<IDSStructure (IDS:core_profiles, profiles_1d[0])>
>>> imas.util.get_parent(cp.profiles_1d[0])
<IDSStructArray (IDS:core_profiles, profiles_1d with 2 items)>
>>> imas.util.get_parent(cp.profiles_1d)
<IDSToplevel (IDS:core_profiles)>
>>> imas.util.get_parent(cp)
>>>