iscc.sample.Dissociation ¶

Dissociation(cell_data, rng=None, recovery_probs=None, stress_strength=0.0, n_stress_genes=None)

Bases: object

Apply cell-type-dependent recovery (+ optional stress signature).

Parameters:

Name	Type	Description	Default
`cell_data`	`dict[str, DataFrame]`	The (already biopsied) ground truth; must include `cell_type`.	required
`rng`	`Generator`		`None`
`recovery_probs`	`dict[str, float]`	Per-biological-type recovery probability (defaults to DEFAULT_RECOVERY).	`None`
`stress_strength`	`float`	Multiplicative bump (1 + stress_strength) applied to the stress-gene set of recovered cells' expression. 0 disables the signature.	`0.0`
`n_stress_genes`	`int`	Size of the stress-gene set (default ~5% of genes, >=1).	`None`

Methods:

Name	Description
`run`	Returns (chosen_index, meta, exp_override).

run ¶

run()

Returns (chosen_index, meta, exp_override).

exp_override is a modified copy of cell_exp when the stress signature is enabled, else None (caller writes the original).