oineus.mapping_cylinder

oineus.mapping_cylinder(fil_domain, fil_codomain, v_domain, v_codomain, v_domain_value=None, v_codomain_value=None, with_indices=False)

Build the mapping cylinder of the inclusion fil_domain -> fil_codomain.

The auxiliary vertex values default to filtration-order -inf (fil_domain.neg_infinity() / fil_codomain.neg_infinity()), which keeps the cylinder’s persistent homology equivalent to the inclusion’s. Pass explicit values only if you intentionally want the auxiliary vertices to enter at a finite point in the filtration.

Slim Freudenthal / bit-packed inputs are materialized to the fat encoding first (the cylinder is built over fat product cells); the cells keep their combinatorial uids, so uid-keyed lookups against the original filtrations still resolve.