Skip to content

v0.4.0

Choose a tag to compare

@github-actions github-actions released this 19 Nov 14:16
· 74 commits to main since this release

Highlights

v0.4.0 expands pvsyst-cli-mcp from single-run simulation into a full engineering workflow covering financial modeling, zero-template commercial component synthesis, multi-provider weather acquisition, finite 3D ground layouts with obstacles & base slope, bounded closed-loop optimization, and interactive bilingual HTML engineering reports.

1. Financial & Economics Evaluation (pvsyst_evaluate_economics)

  • Pure-Python cashflow engine supporting fixed tariffs, time-of-use (TOU) schedules, and PV+BESS arbitrage directly from PVsyst hourly simulation CSVs or batch summary CSVs.
  • Computes LCOE, NPV, IRR, simple & discounted payback, and 25-year degraded cashflow projections.
  • Ranks multi-scenario batch runs with full financial KPIs.

2. Zero-Template Commercial .PAN / .OND Synthesis & Electrical Filtering

  • pvsyst_build_sourced_component now supports zero-template mode (template_name=None):
    • .PAN: 5-parameter single-diode STC solver (RShunt, Rp_0, RSerie, Gamma), temperature coefficients (muIsc, muVocSpec, muPmpReq), bifaciality (BifacialityFactor), and cell layout (NCelS, NCelP).
    • .OND: Mode-1 8-point ProfilPIO efficiency curve synthesis with VNomEff, NbMPPT, IDCMax, IMaxDC.
    • Verified live on PVsystCLI 8.1.7 with zero warnings.
  • pvsyst_list_components now supports electrical range filters (power, voltage, efficiency, bifaciality, MPPT count) backed by an mtime-invalidated metadata cache (.mcp-component-index.json).

3. Multi-Provider Weather Acquisition (PVGIS v5.3 TMY & NASA POWER)

  • Extended pvsyst_acquire_weather and pvsyst_simulate_design (weather.mode) with pvgis_tmy (PVGIS v5.3 8760-hour TMY) and nasa_power (NASA POWER hourly solar/meteorological data) alongside open_meteo (ERA5).
  • Added one-step prepare=True on pvsyst_acquire_weather to download and convert directly to .SIT/.MET + manifest.
  • Supported automatic aggregation of sub-hourly (15min/30min) observation CSVs.

4. Finite 3D Ground Polygon Layout, Obstacles & Base Slope

  • Added 2D site polygon clipping with perimeter setbacks, concave polygons, and arbitrary row azimuths (scene/ground.py).
  • Added 3D near-shading obstacles (building, wall, mesh, tree) and terrain base_slope_deg (BaseSlope synchronized across pvOrient and pvShdArrayTable, live-verified with recompute_shading=True on PVsystCLI 8.1.7 with zero warnings).

5. Bounded Closed-Loop Optimization (pvsyst_optimize_variant)

  • Implements a safe Diagnose -> Clone -> Patch -> Re-simulate optimization loop (max_iterations 1..5).
  • Defaults to dry_run=True with full parameter diff preview; requires explicit confirm=True to execute; never mutates the baseline variant.

6. Interactive Bilingual HTML Engineering Reports (pvsyst_generate_report)

  • Generates standalone print-friendly bilingual (zh / en) interactive Plotly HTML reports (plotly>=5.18,<7.0) for single or multi-scenario studies.
  • Includes monthly yield/PR charts, loss waterfall diagrams, typical 24h TOU/BESS dispatch profiles, 25-year cumulative cashflow curves, and engineering diagnostics tables.

Tool Surface & Documentation

  • Default MCP surface expanded to 43 default tools across 8 groups (72 total tools including admin and expert).
  • Refreshed README.md, README.zh-CN.md, docs/tool-reference.md, docs/architecture.md, docs/native-entry-map.md, docs/testing-and-release.md, docs/sourced-components.md, docs/weather-preparation.md, and docs/single-design-inputs.md.

Verification

  • python scripts/ci_checks.py: 31/31 passed (including wheel packaging & documented tool-surface parity checks)
  • python scripts/run_tests.py --suite all: 429/429 passed
  • Live PVsystCLI 8.1.7 end-to-end probe for zero-template 620W bifacial .PAN + 110kW 9-MPPT .OND + BaseSlope=5.0° 3D shading recomputation: 0 warnings