
4 ABIGAIL HICKOK
Definition 2.3. The simplex indexing induced by fis the unique compatible simplex in-
dexing idxf:K → {1, . . . , N}such that idxf(σi)<idxf(σj) if either f(σi)< f(σj) or if
f(σi) = f(σj) and i<j.
The function idxfis a compatible simplex indexing because the sequence σ1, . . . , σNof sim-
plices is ordered such that i<jif σiis a proper face of σj.
Let Dbe the boundary matrix compatible with the simplex indexing idxf. That is, let D
be the matrix whose (i, j)th entry is
Dij =(1,idx−1
f(i) is an (m−1)-dimensional face of the m-dimensional simplex idx−1
f(j)
0,otherwise.
We decompose the boundary matrix Dinto a matrix product D=RU such that Uis upper
triangular and Ris a binary matrix that is “reduced”. A binary matrix Ris reduced if
lowR(j)̸= lowR(j′) whenever j̸=j′are the indices of nonzero columns in R. The quantity
lowR(j), which is called the pairing function, is the row index of the last 1 in column jif
column jis nonzero and undefined if column jis the zero vector. An RU decomposition can
be computed in O(N3) time [5, 6].
Cohen-Steiner et al. [3] showed that the pairing function lowR(j) depends only on the
boundary matrix Dand not on the particular reduced binary matrix Rin the decomposition
D=RU. A pair (idx−1
f(i),idx−1
f(j)) of simplices with i= lowR(j) represents a persistent
homology generator. The birth simplex idx−1
f(i) creates the homology class and the death
simplex idx−1
f(j) destroys the homology class. The two simplices in a pair have consecutive
dimensions; that is, if dim(idx−1(i)) = q, then dim(idx−1(j)) = q+ 1. If dim(idx−1
f(i)) = q
and dim(idx−1
f(j)) = q+ 1, then a point with coordinates (f(idx−1
f(i)), f(idx−1
f(j))) is added
to the qth persistence diagram. We refer to f(idx−1
f(i)) as its birth and to f(idx−1
f(j)) as its
death. Some simplices are not paired. If i̸= lowR(j) for all j, then the simplex idx−1
f(i) is a
birth simplex for a homology class that never dies. Its birth is f(idx−1
f(i)) and its death is
∞. If dim(idx−1
f(i)) = q, then a point with coordinates (f(idx−1
f(i)),∞) is added to the qth
persistence diagram.
2.2. Vineyards. Let Kbe a simplicial complex. A 1-parameter filtration function on Kis
a function f:K × I→R, where I= [t0, t1] is an interval in R, such that f(·, t) is a filtration
function on Kfor all t∈I. For each t∈I, the r-sublevel sets Kt
r={σ∈ K | f(σ, t)≤r}
are a filtration of K. The set {{Kt
r}r∈R}t∈Iis a set of filtrations parameterized by t∈I. For
each t∈I, one can compute the persistence diagram P D(f(·, t)). The associated vineyard
is the 1-parameter set {P D(f(·, t))}t∈Iof persistence diagrams. We visualize the vineyard in
R2×Ias a continuous stack of PDs (see Figure 1). The points in the PDs trace out curves
with time; these curves are the vines.
An algorithm for computing vineyards is given by [3], and we review it here. Let f:
K × I→Rbe a 1-parameter filtration function, and let σ1, . . . , σNbe the simplices of K,
indexed such that i < j if σiis a proper face of σj. As in Section 2.1, we fix a compatible
simplex indexing idxf:K × I→ {1, . . . , N}such that idxf(σi, t)<idxf(σj, t) if we have
either f(σi, t)< f(σj, t) or we have f(σi, t) = f(σj, t) and i<j. The simplex indexing can
only change at times t∗at which f(σ, t∗) = f(τ, t∗) for some σ, τ ∈ K. At t∗, the indices
of σand τmay change. (If σ,τare the unique pair of simplices whose indices change
at t∗, then σand τare transposed in the simplex indexing and σand τhave consecutive