visibility

tangles.analysis.visibility(tangle_matrix: ndarray, column_orders: ndarray, coherence: ndarray | None = None, complexity: ndarray | None = None)

Calculate the visibility of the tangles in the tangle matrix.

The visibility is the difference between the order at which a tangle ceases to exist (its coherence) and the order at which it can first be distinguished from all other tangles it is not contained in (its complexity).

Parameters

tangle_matrixnp.ndarray

A (tangles x separations)-matrix encoding how a tangle orients a separation. Contains the orientation of the separation if the tangle orients the separation and otherwise 0.

column_ordersnp.ndarray

The orders of the separations in the columns of the tangle_matrix.

coherencenp.ndarray, optional

A parameter for precomputed coherence levels, which are the coherence of a tangle represented as the column index in the tangle_matrix.

complexitynp.ndarray, optional

A parameter for precomputed complexity levels, which are the complexity of a tangle represented as the column index in the tangle_matrix.

Returns

np.ndarray

The visibilities of the tangles.