q_analysis() describes how the maximal simplices of a simplicial complex
(those not contained in a larger one) hang together, after Atkin (1974).
Two maximal simplices are q-near when they share a face of dimension at
least q (q + 1 shared nodes), and q-connected when a chain of q-near
simplices joins them. The result has two parts:
Q-vector: \(Q_q\), the number of q-connected components among the maximal simplices of dimension at least q, for each q from the largest simplex dimension down to 0. Simplices of lower dimension do not exist at level q and are not counted.
Structure vector: here the dimension of the largest simplex each node belongs to. (Atkin uses "structure vector" for the Q-vector itself; the name is kept for compatibility.)
A Q-vector of 1 at every level means the maximal simplices stay in one
piece however many shared nodes are required. Requiring more shared
nodes splits the complex more, but fewer simplices take part at higher
q, so the count can rise or fall with q; print() reports the lowest
level at which there is more than one. Like
the complex itself, the vectors depend on the threshold or pathways
build_simplicial() was given.
Arguments
- sc
A
simplicial_complexfrombuild_simplicial().- x
- ...
- combined
For the
plot()method:TRUE(default) draws the Q-vector and the structure vector side by side, which needs gridExtra;FALSEreturns them as a named list of ggplots (q_vector,structure_vector).
Value
A q_analysis object. print() shows the components at each
level, the level at which the complex first splits and the structure
vector; plot() draws the two vectors. The object's fields:
- q_vector
Named integer vector, one entry per level from the highest down (
q_2,q_1,q_0for a complex of dimension 2): the number of q-connected components at that level.- max_q
The largest simplex dimension, the highest level.
- structure_vector
Named integer vector, one entry per node: the dimension of the largest simplex containing it.
The print() method returns its input invisibly. plot()
returns the drawn grid grob invisibly with combined = TRUE, and the
named list of two ggplots invisibly with combined = FALSE.