vertebrae.scoring.separatix

Internal Separatix adapter.

Classes

SeparatixResult	Structured result from Separatix complexity diagnostics.
SeparatixScorer	Internal adapter for Separatix complexity diagnostics.

Functions

probe_summary_for_result(result)	Return the required probe summary or a disabled diagnostic summary.
summarize_probe_diagnostics(report, *, target_type, ...)	Normalize existing Separatix probe evidence without fitting new models.

Module Contents

class vertebrae.scoring.separatix.SeparatixResult

Structured result from Separatix complexity diagnostics.

to_dict()

Serialize the diagnostic result to a JSON-safe dictionary.

Return type:

Dict[str, Any]

class vertebrae.scoring.separatix.SeparatixScorer(config=None, overlap_config=None)

Internal adapter for Separatix complexity diagnostics.

Parameters:

• config (Optional[vertebrae.config.SeparatixConfig])

• overlap_config (Optional[Union[vertebrae.config.OverlapScoringConfig, vertebrae.config.ContinuousOverlapScoringConfig]])

score(Z, y, label_names=None, groups=None, target_type='auto', target_names=None)

Run Separatix on dense or sparse embeddings and labels.

Parameters:

• Z (Any)

• y (Any)

• label_names (Optional[Any])

• groups (Optional[Any])

• target_type (str)

• target_names (Optional[Any])

Return type:

SeparatixResult

skipped_result(reason, overlap_score, threshold)

Return a structured skipped result for gated runs.

Parameters:

• reason (str)

• overlap_score (float)

• threshold (float)

Return type:

SeparatixResult

vertebrae.scoring.separatix.probe_summary_for_result(result)

Return the required probe summary or a disabled diagnostic summary.

Parameters:

result (Optional[SeparatixResult])

Return type:

Dict[str, Any]

vertebrae.scoring.separatix.summarize_probe_diagnostics(report, *, target_type, grouped, n_groups)

Normalize existing Separatix probe evidence without fitting new models.

Parameters:

• report (Dict[str, Any])

• target_type (str)

• grouped (bool)

• n_groups (Optional[int])

Return type:

Dict[str, Any]