bioniumx.physics.habitability_score

bioniumx.physics.habitability_score(T_eq: float, radius_Rearth: float, mass_Mearth: float | None = None) → float[source]

Compute a heuristic Earth Similarity / Habitability Score.

Combines the Earth Similarity Index (ESI) formulation with constraints on planet radius to heavily penalize gas giants and freezing/boiling worlds.

Parameters:

T_eq (float) – Planetary equilibrium temperature in K.
radius_Rearth (float) – Planetary radius in Earth radii.
mass_Mearth (float, optional) – Planetary mass in Earth masses. If None, estimated from radius.

Returns:

score – Habitability score between 0 and 1. Non-physical catalog values such as zero or negative radius return 0.0.

Return type:

float