mkt.databases.pssm.consurf_grade_boundaries

mkt.databases.pssm.consurf_grade_boundaries(scores: list[float | None], n_bins: int = 9) → ndarray[source]

Interior quantile boundaries splitting scores into n_bins grades.

The ConSurf grading is equal-frequency (quantile) binning of a continuous conservation score. This returns the n_bins - 1 interior score cut points (ascending), so a caller can map a specific grade cutoff back to a score threshold (e.g. the score at the grade 6|7 boundary). None/NaN scores are ignored when estimating the quantiles.

Parameters:

  • scores (list[float | None]) – Per-position conservation scores (any continuous scale).

  • n_bins (int) – Number of grades (default 9, the ConSurf convention).

Returns:

Ascending array of the n_bins - 1 interior quantile boundaries; empty if no finite scores are supplied.

Return type:

numpy.ndarray