Source code for space_pv_pvmodel.distribution
"""Steady two-wire DC delivery to a constant-power terminal load."""
from math import isfinite, sqrt
[docs]
def dc_cable_delivery(
*,
source_voltage_v: float,
load_w: float,
length_m: float,
conductor_area_mm2: float,
resistivity_ohm_m: float,
density_kg_m3: float,
minimum_voltage_fraction: float = 0.9,
) -> dict[str, float | bool]:
"""Return the high-voltage DC equilibrium and conductor-only mass.
Length is one-way; two identical conductors form the return loop. Resistivity
is supplied at operating temperature. The load is power at the receiving
terminals, before any downstream converter losses. An ideal stiff source and
purely resistive cable are assumed. The high-voltage quadratic root is not
proof of dynamic converter stability. No equilibrium is represented by NaN
voltage/current/loss, never by zero loss. The double-root maximum-transfer
point is reported but fails the strict branch-margin criterion.
Minimum receiving voltage is a fraction of source voltage, in (0.5, 1].
Feasibility here excludes ampacity, insulation, discharge, thermal balance,
regulation, connectors, dust, mechanical qualification and source capacity.
"""
for name, value in locals().copy().items():
if not isfinite(value) or value <= 0:
raise ValueError(f"{name} must be finite and positive")
if not 0.5 < minimum_voltage_fraction <= 1:
raise ValueError("minimum_voltage_fraction must be in (0.5, 1]")
area = conductor_area_mm2 * 1e-6
resistance = 2 * resistivity_ohm_m * length_m / area
mass = 2 * length_m * area * density_kg_m3
maximum = source_voltage_v**2 / (4 * resistance)
ratio = load_w / maximum
if not all(isfinite(x) and x > 0 for x in (resistance, mass, maximum, ratio)):
raise ValueError("derived cable quantities must be finite and positive")
equilibrium = ratio <= 1
receiving = source_voltage_v * (1 + sqrt(1 - ratio)) / 2 if equilibrium else float("nan")
current = load_w / receiving
loss = current**2 * resistance
return {
"loop_resistance_ohm": resistance,
"conductor_mass_kg": mass,
"maximum_transfer_w": maximum,
"equilibrium_exists": equilibrium,
"receiving_voltage_v": receiving,
"current_a": current,
"cable_loss_w": loss,
"source_power_w": load_w + loss,
"cable_efficiency": load_w / (load_w + loss),
"voltage_criterion_pass": bool(
ratio < 1 and receiving >= source_voltage_v * minimum_voltage_fraction
),
}