Source code for energy_methods.wind_installation

"""Transparent daily turbine-installation and commissioning opportunity scenarios.

This is a project-planning sensitivity model, not offshore weather forecasting,
asset dispatch, or a claim about any named project's actual construction plan.
"""

from __future__ import annotations

import math
from collections.abc import Sequence
from dataclasses import dataclass


[docs] @dataclass(frozen=True) class InstallationSchedule: """Daily-installation events; day 0 is the first illustrative campaign day.""" completion_days: tuple[int, ...] duration_days: int charter_vessel_days: int
[docs] def simulate_installation( turbines: int, *, vessel_start_days: Sequence[int], workable_days: Sequence[bool], workable_days_per_turbine: float, ) -> InstallationSchedule: """Install turbines with independent vessel crews and site-wide weather. Each vessel accrues one unit of work on a workable day once available. Each turbine requires ``workable_days_per_turbine`` accumulated units on *one* vessel. Progress survives bad-weather days; vessels do not transfer partially completed turbine jobs. At most one turbine per vessel per day. These simplified constraints ignore foundations, port loading, lifting, maintenance, cable laying and crew shifts; workload and site-wide weather are declared *scenario inputs*, not observed Dogger Bank conditions. """ if not isinstance(turbines, int) or isinstance(turbines, bool) or turbines <= 0: raise ValueError("turbines must be a positive integer") if not math.isfinite(workable_days_per_turbine) or workable_days_per_turbine < 1: raise ValueError("workable_days_per_turbine must be finite and at least one") starts = tuple(vessel_start_days) if not starts or any( not isinstance(day, int) or isinstance(day, bool) or day < 0 for day in starts ): raise ValueError("vessel start days must be nonnegative integers") if not workable_days or any(not isinstance(day, bool) for day in workable_days): raise ValueError("workable_days must be a nonempty sequence of booleans") work_done = [0.0] * len(starts) completions: list[int] = [] for day, workable in enumerate(workable_days): if workable: for index, start in enumerate(starts): if day < start or len(completions) == turbines: continue work_done[index] += 1.0 if work_done[index] + 1e-12 >= workable_days_per_turbine: completions.append(day) work_done[index] -= workable_days_per_turbine if len(completions) == turbines: duration = day + 1 return InstallationSchedule( completion_days=tuple(sorted(completions)), duration_days=duration, charter_vessel_days=sum(max(0, duration - start) for start in starts), ) raise ValueError("The supplied weather horizon does not complete the installations")
[docs] def commissioning_opportunity_mwh( schedule: InstallationSchedule, *, project_capacity_mw: float, net_capacity_factor: float, horizon_days: int, grid_ready_day: int = 0, commissioning_lag_days: int = 0, ) -> float: """Conditional energy opportunity under progressive per-turbine commissioning. Identical turbine AC ratings are assumed. A completed installation can generate no earlier than the next day, a uniform commissioning lag, and the common grid-ready day. This is an *opportunity envelope*, NOT measured generation, lost energy, contractual revenue or confirmed access to grid. """ if ( not isinstance(horizon_days, int) or isinstance(horizon_days, bool) or horizon_days <= 0 or not isinstance(grid_ready_day, int) or isinstance(grid_ready_day, bool) or grid_ready_day < 0 or not isinstance(commissioning_lag_days, int) or isinstance(commissioning_lag_days, bool) or commissioning_lag_days < 0 ): raise ValueError("Horizon, grid-ready day and commissioning lag must be valid days") if ( not math.isfinite(project_capacity_mw) or project_capacity_mw <= 0 or not math.isfinite(net_capacity_factor) or not 0 < net_capacity_factor <= 1 ): raise ValueError("Project capacity and capacity factor must be valid") if not schedule.completion_days: raise ValueError("At least one installed turbine is required") if any(day < 0 or day >= schedule.duration_days for day in schedule.completion_days): raise ValueError("Invalid completion day in installation schedule") turbine_mw = project_capacity_mw / len(schedule.completion_days) turbine_days = sum( max(0, horizon_days - max(grid_ready_day, day + 1 + commissioning_lag_days)) for day in schedule.completion_days ) return turbine_days * 24.0 * turbine_mw * net_capacity_factor