throats#

CubicTemplate.throats(labels=None, mode='or', asmask=False)#

Returns throat locations where given labels exist, according to the logic specified by the mode argument.

Parameters:

labels (str or list[str]) – The throat label(s) whose locations are requested. If omitted, ‘all’ throat inidices are returned. This argument also accepts ‘*’ for wildcard searches.

mode (str) –

Specifies how the query should be performed. The options are:

mode	meaning
’or’	Returns the labels that are assigned to any of the given locations. Also accepts ‘union’ and ‘any’
’and’	Labels that are present on all the given locations. also accepts ‘intersection’ and ‘all’
’xor’	Labels that are present on only one of the given locations.Also accepts ‘exclusive_or’
’nor’	Labels that are not present on any of the given locations. Also accepts ‘not’ and ‘none’
’nand’	Labels that are present on all but one of the given locations
’xnor’	Labels that are present on more than one of the given locations.

asmask (bool) – If True then a boolean array of length Nt is returned with True values indicating the throats that satisfy the query.

Returns: