sfa_deletion_gaps: Newly Uncovered Content After an Item-Set Change

In semanticfa: Semantic Factor Analysis of Language Model Embeddings

Newly Uncovered Content After an Item-Set Change

Description

Compares two audits of the same region - a reference audit and an audit of a changed item set (items deleted, a short form, a revision) - and reports the content the change strands: the region sentences covered by the reference scale but not by the changed one. Labeling only this delta is what makes a deletion study readable. The changed scale's full gap report mixes newly created gaps with whatever the reference scale already failed to cover, and the pre-existing uncovered mass usually drowns the signal.

Usage

sfa_deletion_gaps(reference, reduced, quotes = 3L, top = 8L)

Arguments

reference	The reference audit ("sfa_coverage"), typically the full scale.
reduced	The changed item set's audit, run against the same region and anchored to reference$radius.
quotes	Number of example sentences to return. Default 3, ordered by how far the change strands them (largest increase in nearest-item distance first).
top	Number of label terms. Default 8.

Details

Both audits must be run against the same region with the same filters, and the changed audit must be anchored to the reference audit's radius (radius = reference$radius) - otherwise recalibration moves the yardstick along with the item set and the delta confounds the two. The function checks both conditions.

Value

A list: n_new (newly uncovered sentences), share_new (their fraction of the region), coverage_drop (reference$coverage - reduced$coverage), terms (distinctive terms of the newly uncovered content against the still-covered content), and quotes.

semanticfa documentation built on Sept. 2, 2026, 1:07 a.m.