Repository navigation
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]"
``