Skip to content

v0.6.0 — 100% Headless Grid + Stand-Alone Off-Grid PV+BESS+Genset

Latest

Choose a tag to compare

@Anonymousnake Anonymousnake released this 21 Nov 17:05

v0.6.0 — 100% Headless Grid + Stand-Alone Off-Grid Coverage

Every .VCx-writing capability in �0.6.0 has been live-verified on PVsystCLI 8.1.7 with 0 warnings, backed by 502 passing tests across Linux & Windows (Python 3.10 & 3.12).

Highlights

  • 100% Headless Architecture (Zero Win32 GUI Click-Bridge): Removed legacy
    ative/scene.py (-1,531 lines) and "gui" scene import mode; slimmed pvsyst_open_native_project (expert group) to a pure viewer launcher.
  • MV/HV Multi-Stage Transformers & AC Collection Network (pvsyst_configure_transformers): Supports MV-only, parallel MV, and cascaded MV+HV transformers (auto-populating PVsyst 8.1.7 required HV datasheet tags HVTrfDS*), ISO 60228 cable sections (10..1200 mm²), night disconnect, and VAR_GROUPS["transformers"] (EMVOhmL/EMVTrfL/EHVOhmL/EHVTrfL).
  • 3D Continuous Terrain DEM (pvShdGround) & Table Draping: Pure-Python Bowyer–Watson Delaunay TIN terrain generator from XYZ JSON/CSV + lon/lat ENU projection + optional [geo] extra (pip install "pvsyst-cli-mcp[geo]" for
    asterio GeoTIFF .tif), draping fixed sheds and single-axis trackers directly onto terrain elevations/slopes.
  • Special Loads & Deterministic Outage Generators: Added native HouseHold appliance schedules (yearly & seasonal 24-bit half-hour masks), deterministic Probability distribution sampling into native embedded hourly snapshots, WeakGrid mode="generated" deterministic outage schedules, and SystemUnavail mode="random" materialized UnavailPeriods.
  • Spectral Correction, Cross-Orientation Conversion (pvsyst_convert_orientation), & Native PDF Economics:
    • Native First Solar / precipitable-water spectral correction (UseSpectralCorr + SpectralCorrection, SiMono/SiPoly/CdTe/CIS/�Si/Custom).
    • In-place cross-orientation conversion ( ixed ↔ seasonal ↔ sheds ↔ racker_ns ↔ racker_2axis ↔ dome) with automatic stripping of incompatible 3D/result caches.
    • Native EconomicEval=TEcoEvaluation writer so official PVsystCLI PDF reports render econeval and inancialbalance pages directly.
  • Full Stand-Alone Off-Grid PV + BESS + Backup Genset (pvsyst_simulate_design(scope="stand_alone")): Zero-template SystemType=Battery synthesis with .PAN, .BTR, MPPT/direct .RLT controllers, existing or inline auto-synthesized .GEN backup generators, VAR_GROUPS["stand_alone"] (E_User/E_Solar/E_BkUp/E_Miss/EUnused/BkUp_ON/FuelBU/SOCmean/T_LOL), off-grid diagnostics (diagnose_standalone), and lifetime diesel-fuel + genset maintenance LCOE (evaluate_standalone_economics).
  • Quality & Correctness Fixes Merged (PRs #222–#231): Hardened BESS/TOU overnight charging & cycle discharge capping, strict CSV unit guards across economics/BESS/reports, scale-independent IRR convergence, 3V OND & BTR validation, and shared test fixture consolidation.
  • Strict MCP Tool Surface Budget: 48 default tools (+2: pvsyst_configure_transformers, pvsyst_convert_orientation) / 77 total tools (PVSYST_TOOL_GROUPS=all).

Verified PVsyst 8.1.7 Engine Boundary

  • Native pvGridStorage in PVsyst 8.1.7 charges from PV only (no native grid-to-battery charger). For TOU grid-charging arbitrage modeling, use pvsyst_optimize_bess_sizing with �llow_grid_charging=true.

Install / Upgrade

``powershell
pip install -U pvsyst-cli-mcp

Optional GeoTIFF (.tif) terrain DEM support:

pip install -U "pvsyst-cli-mcp[geo]"
``