pypet/naturalnaming.py
def f_get(self, name, fast_access=False, with_links=True,
              shortcuts=True, max_depth=None, auto_load=False):
        """Searches and returns an item (parameter/result/group node) with the given `name`.

        :param name: Name of the item (full name or parts of the full name)

        :param fast_access: Whether fast access should be applied.

        :param with_links:

            If links are considered. Cannot be set to ``False`` if ``auto_load`` is ``True``.

        :param shortcuts:

            If shortcuts are allowed and the trajectory can *hop* over nodes in the
            path.

        :param max_depth:

            Maximum depth relative to starting node (inclusive).
            `None` means no depth limit.

        :param auto_load:

            If data should be loaded from the storage service if it cannot be found in the
            current trajectory tree. Auto-loading will load group and leaf nodes currently
            not in memory and it will load data into empty leaves. Be aware that auto-loading
            does not work with shortcuts.

        :return:

            The found instance (result/parameter/group node) or if fast access is True and you
            found a parameter or result that supports fast access, the contained value is returned.

        :raises:

            AttributeError: If no node with the given name can be found

            NotUniqueNodeError

                In case of forward search if more than one candidate node is found within a
                particular depth of the tree. In case of backwards search if more than
                one candidate is found regardless of the depth.

            DataNotInStorageError:

                In case auto-loading fails

            Any exception raised by the StorageService in case auto-loading is enabled

        """
        return self._nn_interface._get(self, name, fast_access=fast_access,
                                       shortcuts=shortcuts,
                                       max_depth=max_depth,
                                       auto_load=auto_load,
                                       with_links=with_links)
def f_get(self, name, fast_access=False, with_links=True,
              shortcuts=True, max_depth=None, auto_load=False):
        """Searches and returns an item (parameter/result/group node) with the given `name`.

        :param name: Name of the item (full name or parts of the full name)

        :param fast_access: Whether fast access should be applied.

        :param with_links:

            If links are considered. Cannot be set to ``False`` if ``auto_load`` is ``True``.

        :param shortcuts:

            If shortcuts are allowed and the trajectory can *hop* over nodes in the
            path.

        :param max_depth:

            Maximum depth relative to starting node (inclusive).
            `None` means no depth limit.

        :param auto_load:

            If data should be loaded from the storage service if it cannot be found in the
            current trajectory tree. Auto-loading will load group and leaf nodes currently
            not in memory and it will load data into empty leaves. Be aware that auto-loading
            does not work with shortcuts.

        :return:

            The found instance (result/parameter/group node) or if fast access is True and you
            found a parameter or result that supports fast access, the contained value is returned.

        :raises:

            AttributeError: If no node with the given name can be found

            NotUniqueNodeError

                In case of forward search if more than one candidate node is found within a
                particular depth of the tree. In case of backwards search if more than
                one candidate is found regardless of the depth.

            DataNotInStorageError:

                In case auto-loading fails

            Any exception raised by the StorageService in case auto-loading is enabled

        """
        return self._nn_interface._get(self, name, fast_access=fast_access,
                                       shortcuts=shortcuts,
                                       max_depth=max_depth,
                                       auto_load=auto_load,
                                       with_links=with_links)
Searches and returns an item (parameter/result/group node) with the given `name`.

        :param name: Name of the item (full name or parts of the full name)

        :param fast_access: Whether fast access should be applied.

        :param with_links:

            If links are considered. Cannot be set to ``False`` if ``auto_load`` is ``True``.

        :param shortcuts:

            If shortcuts are allowed and the trajectory can *hop* over nodes in the
            path.

        :param max_depth:

            Maximum depth relative to starting node (inclusive).
            `None` means no depth limit.

        :param auto_load:

            If data should be loaded from the storage service if it cannot be found in the
            current trajectory tree. Auto-loading will load group and leaf nodes currently
            not in memory and it will load data into empty leaves. Be aware that auto-loading
            does not work with shortcuts.

        :return:

            The found instance (result/parameter/group node) or if fast access is True and you
            found a parameter or result that supports fast access, the contained value is returned.

        :raises:

            AttributeError: If no node with the given name can be found

            NotUniqueNodeError

                In case of forward search if more than one candidate node is found within a
                particular depth of the tree. In case of backwards search if more than
                one candidate is found regardless of the depth.

            DataNotInStorageError:

                In case auto-loading fails

            Any exception raised by the StorageService in case auto-loading is enabled