ripsH1

function ripsH1(vIn, opts?): Diagram;

Defined in: passes/rips.ts:108

The degree-1 persistence diagram of the Vietoris-Rips filtration.

Births are edge lengths, deaths are triangle filtration values (the longest of the triangle’s three edges).

Parameters

Parameter	Type
vIn	PointsInput
opts	RipsOptions

Returns

Diagram

Example

import { ripsH1 } from "@saehrimnir/sickle";

// One-dimensional holes: an array of [birth, death] pairs, longest first.
ripsH1(circlePoints);  // [[0.1256, 1.7526]] — a circle has one loop
ripsH1(arcPoints);     // [] — an open arc has none

// Refuses above `maxPoints` (default 200) rather than subsampling.
ripsH1(bigProjection, { maxPoints: 400 });