Complete M6.1 environmental units and coupling contract

This commit is contained in:
dingo
2026-09-27 00:06:24 -04:00
parent 5aeb18a4aa
commit 750afcd4d4
13 changed files with 550 additions and 4 deletions
+53
View File
@@ -0,0 +1,53 @@
#include "evo/world/environment_units.hpp"
#include <array>
#include <cstddef>
#include <limits>
#include <numeric>
namespace evo::world {
std::expected<HabitatMeasure, EnvironmentUnitError> measure_habitat(HabitatBox box) noexcept {
const std::array lengths{box.width.value, box.height.value, box.depth.value};
const std::array origins{box.x.value, box.y.value, box.z.value};
for (std::size_t i = 0; i < lengths.size(); ++i) {
if (lengths[i] == 0 || lengths[i] > habitat_axis_limit_um)
return std::unexpected{EnvironmentUnitError::invalid_extent};
if (origins[i] > habitat_axis_limit_um - lengths[i])
return std::unexpected{EnvironmentUnitError::outside_voxel};
}
// Validated factors <= 1e6: products <= 1e12 and 1e18 fit u64.
const auto area = box.width.value * box.height.value;
return HabitatMeasure{{area}, {area * box.depth.value}};
}
std::expected<MassConcentration, EnvironmentUnitError>
mass_concentration(accounting::Femtograms mass, CubicMicrometres volume) noexcept {
if (volume.value == 0 || volume.value > habitat_volume_limit_um3)
return std::unexpected{EnvironmentUnitError::invalid_volume};
const auto divisor = std::gcd(mass.value, volume.value);
return MassConcentration{mass.value / divisor, volume.value / divisor};
}
std::expected<WaterSaturation, EnvironmentUnitError>
water_saturation(accounting::Femtograms water, accounting::Femtograms capacity) noexcept {
if (capacity.value == 0)
return std::unexpected{EnvironmentUnitError::zero_capacity};
if (water.value > capacity.value)
return std::unexpected{EnvironmentUnitError::excess_water};
const auto divisor = std::gcd(water.value, capacity.value);
return WaterSaturation{water.value / divisor, capacity.value / divisor};
}
std::expected<EnergyIntegral, EnvironmentUnitError>
integrate_energy(EnergyRate rate, std::uint64_t ticks, std::uint64_t remainder) noexcept {
if (rate.ticks_denominator == 0)
return std::unexpected{EnvironmentUnitError::invalid_rate};
if (remainder >= rate.ticks_denominator)
return std::unexpected{EnvironmentUnitError::invalid_remainder};
const auto available = std::numeric_limits<std::uint64_t>::max() - remainder;
if (ticks != 0 && rate.picojoules_numerator > available / ticks)
return std::unexpected{EnvironmentUnitError::overflow};
const auto numerator = rate.picojoules_numerator * ticks + remainder;
return EnergyIntegral{{numerator / rate.ticks_denominator}, numerator % rate.ticks_denominator};
}
} // namespace evo::world