重构质量模型并补充回热器分段建模

This commit is contained in:
ljz committed 2026-06-24 11:23:58 +08:00
1 parent 5709ed5f71
commit 1a4b050d53
5 files changed
+940 -248

No files matched your search

+18 -240
View File
@@ -1,13 +1,9 @@
# -*- coding: utf-8 -*-
"""Component models used by Brayton cycle simulations."""
import math
import ctREFPROP.ctREFPROP as ct
class ComponentMassMixin:
"""Shared mass-calculation interface for cycle components."""
"""Shared mass-result storage interface for cycle components."""
component_type = "component"
@@ -15,43 +11,16 @@ class ComponentMassMixin:
self.mass = None
self.mass_variables = None
def calculate_mass(self, mass_model=None, **kwargs):
"""Calculate and store component mass.
def set_mass_result(self, result):
"""Store a mass-model result on this component.
The future mass model can be provided as either a callable accepting
``(component, **kwargs)`` or an object exposing ``calculate_mass`` or
``calculate_<component_type>_mass``.
Mass formulas live in ``brayton_cycle.mass_models``. Components only
keep the result after their thermodynamic calculator has populated
``variables``.
"""
if self.variables is None:
raise ValueError("Run component calculator before mass calculation")
raise ValueError("Run component calculator before storing mass")
if mass_model is None:
result = self._calculate_mass(**kwargs)
else:
result = self._run_external_mass_model(mass_model, **kwargs)
return self._store_mass_result(result)
def mass_calculator(self, mass_model=None, **kwargs):
return self.calculate_mass(mass_model=mass_model, **kwargs)
def _calculate_mass(self, **kwargs):
raise NotImplementedError(
f"{self.__class__.__name__} mass model is not implemented yet. "
"Pass a mass_model or override _calculate_mass()."
)
def _run_external_mass_model(self, mass_model, **kwargs):
method_name = f"calculate_{self.component_type}_mass"
if hasattr(mass_model, method_name):
return getattr(mass_model, method_name)(self, **kwargs)
if hasattr(mass_model, "calculate_mass"):
return mass_model.calculate_mass(self, **kwargs)
if callable(mass_model):
return mass_model(self, **kwargs)
raise TypeError("mass_model must be callable or expose a supported method")
def _store_mass_result(self, result):
if isinstance(result, dict):
if "mass" in result:
mass = result["mass"]
@@ -70,8 +39,17 @@ class ComponentMassMixin:
self.variables["mass_variables"] = self.mass_variables
return self.mass
class Compressor():
def clear_mass_result(self):
self.mass = None
self.mass_variables = None
if self.variables is not None:
self.variables.pop("mass", None)
self.variables.pop("mass_variables", None)
class Compressor(ComponentMassMixin):
"""压缩机类"""
component_type = "compressor"
def __init__(self, name, eff):
"""
初始化参数
@@ -87,6 +65,7 @@ class Compressor():
self.name = name
self.eff = eff
self.variables = None
self._init_mass_interface()
def calculator(self, p_in, T_in, p_out, property_calculator):
# 先计算熵值
@@ -165,40 +144,6 @@ class Turbine(ComponentMassMixin):
'pi': p_in / p_out
}
def _calculate_mass(self, Pe=None, A=0.5, **kwargs):
"""Estimate turbine/TAC mass with the empirical TAC formula.
Formula from the provided reference:
M = A * sqrt(0.5*pi*(30.522*ln(Pe) - 5.7178))
If Pe is not supplied, the current turbine specific work ``Wt`` is used
directly as Pe without unit conversion.
"""
if not 0.4 <= A <= 0.8:
raise ValueError("A should be within the recommended range 0.4-0.8")
if Pe is None:
Pe = abs(self.variables['Wt'])
if Pe <= 0:
raise ValueError("Pe must be positive")
fit_term = 30.522 * math.log(Pe) - 5.7178
if fit_term <= 0:
raise ValueError(
"Pe is outside the valid logarithmic domain for this "
"empirical mass formula"
)
mass = A * math.sqrt(0.5 * math.pi * fit_term)
return {
'mass': mass,
'A': A,
'Pe': Pe,
'fit_term': fit_term,
'formula': 'A*sqrt(0.5*pi*(30.522*ln(Pe)-5.7178))',
}
class Recuperator(ComponentMassMixin):
"""换热器类"""
component_type = "recuperator"
@@ -389,52 +334,6 @@ class Heater(ComponentMassMixin):
'Q_in': Q_input,
}
def _calculate_mass(
self,
P_heat_mwt=None,
mass_flow_rate=None,
shielding_mass_ton=2.8,
include_shielding=True,
**kwargs,
):
"""Estimate reactor and shielding mass for the heater module.
Reactor empirical formula from the provided reference:
M_reactor = 0.2195 * P_heat + 0.09836
P_heat is the reactor thermal power in MWt, and masses are in tons.
The shielding mass is added as a constant 2.8 ton by default.
If P_heat_mwt is not supplied, it is estimated from Q_in and
mass_flow_rate, assuming Q_in is kJ/kg and mass_flow_rate is kg/s:
P_heat_mwt = abs(Q_in) * mass_flow_rate / 1000
"""
if P_heat_mwt is None:
if mass_flow_rate is None:
raise ValueError(
"Heater mass calculation requires P_heat_mwt, or "
"mass_flow_rate to estimate P_heat_mwt from Q_in."
)
P_heat_mwt = abs(self.variables['Q_in']) * mass_flow_rate / 1000
if P_heat_mwt <= 0:
raise ValueError("P_heat_mwt must be positive")
if shielding_mass_ton < 0:
raise ValueError("shielding_mass_ton must be non-negative")
reactor_mass_ton = 0.2195 * P_heat_mwt + 0.09836
shielding_mass = shielding_mass_ton if include_shielding else 0.0
total_mass_ton = reactor_mass_ton + shielding_mass
return {
'mass': total_mass_ton,
'reactor_mass_ton': reactor_mass_ton,
'shielding_mass_ton': shielding_mass,
'P_heat_mwt': P_heat_mwt,
'include_shielding': include_shielding,
'formula': '0.2195*P_heat+0.09836+shielding_mass',
}
class Condenser(ComponentMassMixin):
"""冷凝器类"""
component_type = "condenser"
@@ -463,127 +362,6 @@ class Condenser(ComponentMassMixin):
'Q_out': Q_output,
}
def _calculate_mass(
self,
Qc_kw=None,
co2_mass_flow_rate=None,
coolant_outlet_T=None,
water_inlet_T=None,
water_mass_flow_rate=None,
water_pressure_kpa=101.325,
refprop_path="C:/Program Files (x86)/REFPROP 10.0+/REFPROP",
emissivity=0.92,
surface_temperature=210.15,
area_density=6.75,
**kwargs,
):
"""Estimate radiator mass for the condenser module.
Radiator heat rejection model:
Qc = phi * sigma * A_rad * (T**4 - T0**4)
M_rad = kappa * A_rad
The NaK coolant in the reference is represented here by water. If
coolant_outlet_T is not supplied, water outlet temperature is evaluated
with REFPROP from water_inlet_T, water_mass_flow_rate, and Qc_kw.
Args:
Qc_kw: Total heat rejection in kW.
co2_mass_flow_rate: Optional kg/s. If Qc_kw is not supplied, Qc_kw
is estimated as Q_out * co2_mass_flow_rate, assuming Q_out is
kJ/kg.
coolant_outlet_T: Radiator coolant outlet temperature T in K.
water_inlet_T: Water inlet temperature in K for REFPROP calculation.
water_mass_flow_rate: Water mass flow rate in kg/s.
water_pressure_kpa: Water pressure for REFPROP calculation.
refprop_path: REFPROP root path.
emissivity: Radiator surface emissivity phi.
surface_temperature: Ambient/surface temperature T0 in K. Default is
-63 degC for Mars, 210.15 K.
area_density: Radiator face density kappa in kg/m2.
"""
if Qc_kw is None:
if co2_mass_flow_rate is None:
raise ValueError(
"Condenser mass calculation requires Qc_kw, or "
"co2_mass_flow_rate to estimate Qc_kw from Q_out."
)
Qc_kw = abs(self.variables['Q_out']) * co2_mass_flow_rate
if Qc_kw <= 0:
raise ValueError("Qc_kw must be positive")
if emissivity <= 0:
raise ValueError("emissivity must be positive")
if area_density <= 0:
raise ValueError("area_density must be positive")
if coolant_outlet_T is None:
coolant_outlet_T = self._calculate_water_outlet_temperature(
Qc_kw=Qc_kw,
water_inlet_T=water_inlet_T,
water_mass_flow_rate=water_mass_flow_rate,
water_pressure_kpa=water_pressure_kpa,
refprop_path=refprop_path,
)
temperature_term = coolant_outlet_T**4 - surface_temperature**4
if temperature_term <= 0:
raise ValueError(
"coolant_outlet_T must be higher than surface_temperature for "
"radiative heat rejection"
)
stefan_boltzmann = 5.670374419e-8
Qc_w = Qc_kw * 1000
area_m2 = Qc_w / (emissivity * stefan_boltzmann * temperature_term)
mass_kg = area_density * area_m2
return {
'mass': mass_kg,
'radiator_area_m2': area_m2,
'Qc_kw': Qc_kw,
'coolant_outlet_T': coolant_outlet_T,
'surface_temperature': surface_temperature,
'emissivity': emissivity,
'area_density': area_density,
'mass_unit': 'kg',
'formula': 'M_rad=kappa*Qc/(phi*sigma*(T^4-T0^4))',
}
def _calculate_water_outlet_temperature(
self,
Qc_kw,
water_inlet_T,
water_mass_flow_rate,
water_pressure_kpa,
refprop_path,
):
if water_inlet_T is None or water_mass_flow_rate is None:
raise ValueError(
"Provide coolant_outlet_T directly, or provide water_inlet_T "
"and water_mass_flow_rate for REFPROP water calculation."
)
if water_mass_flow_rate <= 0:
raise ValueError("water_mass_flow_rate must be positive")
water = ct.REFPROPFunctionLibrary(refprop_path)
water.SETUPdll(1, 'WATER.FLD', 'HMX.BNC', 'DEF')
water.SETUPdll(2, 'SI', 'SI', 'DEF')
z = [1.0]
mw = water.WMOLdll(z)
inlet = water.TPFLSHdll(water_inlet_T, water_pressure_kpa, z)
if inlet.ierr > 0:
raise ValueError(f"REFPROP water inlet calculation error: {inlet.ierr}")
h_in_mass = inlet.h / mw
h_out_mass = h_in_mass + Qc_kw / water_mass_flow_rate
outlet = water.PHFLSHdll(water_pressure_kpa, h_out_mass * mw, z)
if outlet.ierr > 0:
raise ValueError(f"REFPROP water outlet calculation error: {outlet.ierr}")
return outlet.T
class Concentrator(ComponentMassMixin):
"""汇流组件"""
component_type = "concentrator"