- GenericPhysics.throats(labels='all', mode='or', asmask=False, to_global=False)¶
Returns throat locations where given labels exist, according to the logic specified by the
mode (str) –
Specifies how the query should be performed. The options are:
’or’, ‘union’, ‘any’ : (default) Throats with one or more of the given labels are returned.
’and’, ‘intersection’, ‘all’ : Throats with all of the given labels are returned.
’xor’, ‘exclusive_or’ : Throats with only one of the given labels are returned.
’nor’, ‘none’, ‘not’ : Throats with none of the given labels are returned.
’nand’ : Throats with not all of the given labels are returned.
’xnor’ : Throats with more than one of the given labels are returned.
Truethen a boolean array of length Nt is returned with
Truevalues indicating the throats that satisfy the query.
True, the returned indices will be indexed relative to the full domain. This only has an effect when the calling object is a Subdomain.
A Numpy array containing throat indices filtered by the logic specified
>>> import openpnm as op >>> pn = op.network.Cubic(shape=[3, 3, 3]) >>> Ts = pn.throats() >>> Ts[0:5] # Look at first 5 throat indices array([0, 1, 2, 3, 4])