gffutils.interface.FeatureDB.children

FeatureDB.children(self, id, level=None, featuretype=None, order_by=None, reverse=False, limit=None, completely_within=False)

Return children of feature id.

Parameters

idstring or a Feature object

levelNone or int

If level=None (default), then return all children regardless of level. If level is an integer, then constrain to just that level.

limitstring or tuple

Limit the results to a genomic region. If string, then of the form “seqid:start-end”; if tuple, then (seqid, start, end).

strand“-” | “+” | “.”

Limit the results to one strand

featuretypestring or tuple

Limit the results to one or several featuretypes.

order_bystring or tuple

Order results by one or many fields; the string or tuple items must be in: ‘seqid’, ‘source’, ‘featuretype’, ‘start’, ‘end’, ‘score’, ‘strand’, ‘frame’, ‘attributes’, ‘extra’.

reversebool

Change sort order; only relevant if order_by is not None. By default, results will be in ascending order, so use reverse=True for descending.

completely_withinbool

If False (default), a single bp overlap with limit is sufficient to return a feature; if True, then the feature must be completely within limit. Only relevant when limit is not None.

Returns

A generator object that yields Feature objects.