babylon.formulas.metabolic_rift

Metabolic Rift formulas (Slice 1.4).

Ecological limits on capital accumulation: - Biocapacity Delta: dB = R - (E * eta) where R=regeneration, E=extraction, eta=entropy - Overshoot Ratio: O = C / B where C=consumption, B=biocapacity (O>1 = ecological overshoot)

Functions

calculate_biocapacity_delta(...[, ...])

Calculate change in biocapacity stock: dB = R - (E * eta).

calculate_overshoot_ratio(total_consumption, ...)

Calculate ecological overshoot ratio: O = C / B.
babylon.formulas.metabolic_rift.calculate_biocapacity_delta(regeneration_rate, max_biocapacity, extraction_intensity, current_biocapacity, entropy_factor=1.2)[source]

Calculate change in biocapacity stock: dB = R - (E * eta).

The core metabolic formula. Extraction always costs more than the raw value obtained due to entropy/waste (eta > 1.0).

Parameters:

  • regeneration_rate (float) – Fraction of max_biocapacity restored per tick [0, 1]

  • max_biocapacity (float) – Maximum biocapacity ceiling

  • extraction_intensity (float) – Current extraction pressure [0, 1]

  • current_biocapacity (float) – Current biocapacity stock

  • entropy_factor (float) – Waste multiplier for extraction (default 1.2)

Return type:

float

Returns:

Change in biocapacity (positive = regeneration, negative = depletion)

Examples

>>> calculate_biocapacity_delta(0.02, 100.0, 0.0, 50.0)  # No extraction
2.0
>>> calculate_biocapacity_delta(0.02, 100.0, 0.05, 50.0)  # Light extraction
-1.0
>>> calculate_biocapacity_delta(0.02, 100.0, 0.0, 100.0)  # At max, no regen
0.0
babylon.formulas.metabolic_rift.calculate_overshoot_ratio(total_consumption, total_biocapacity, max_ratio=999.0)[source]

Calculate ecological overshoot ratio: O = C / B.

When O > 1.0, consumption exceeds biocapacity (overshoot). When O <= 1.0, the system is within ecological limits.

Parameters:

  • total_consumption (float) – Total consumption needs across all entities

  • total_biocapacity (float) – Total available biocapacity

  • max_ratio (float) – Cap for ratio when biocapacity depleted (default 999.0)

Return type:

float

Returns:

Overshoot ratio (>1.0 = ecological overshoot)

Examples

>>> calculate_overshoot_ratio(100.0, 200.0)  # Sustainable
0.5
>>> calculate_overshoot_ratio(200.0, 100.0)  # Overshoot
2.0
>>> calculate_overshoot_ratio(100.0, 0.0)  # Depleted biocapacity
999.0