Repository navigation
v0.4.0
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_componentnow 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-pointProfilPIOefficiency curve synthesis withVNomEff,NbMPPT,IDCMax,IMaxDC.- Verified live on
PVsystCLI 8.1.7with zero warnings.
pvsyst_list_componentsnow 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_weatherandpvsyst_simulate_design(weather.mode) withpvgis_tmy(PVGIS v5.3 8760-hour TMY) andnasa_power(NASA POWER hourly solar/meteorological data) alongsideopen_meteo(ERA5). - Added one-step
prepare=Trueonpvsyst_acquire_weatherto 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 terrainbase_slope_deg(BaseSlopesynchronized acrosspvOrientandpvShdArrayTable, live-verified withrecompute_shading=TrueonPVsystCLI 8.1.7with zero warnings).
5. Bounded Closed-Loop Optimization (pvsyst_optimize_variant)
- Implements a safe Diagnose -> Clone -> Patch -> Re-simulate optimization loop (
max_iterations1..5). - Defaults to
dry_run=Truewith full parameter diff preview; requires explicitconfirm=Trueto 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
adminandexpert). - 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, anddocs/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.7end-to-end probe for zero-template 620W bifacial.PAN+ 110kW 9-MPPT.OND+BaseSlope=5.0°3D shading recomputation: 0 warnings