pvsyst_simulate_template
Preflight or run a template-based full-year PVsyst grid simulation without the GUI, validating inputs first and returning energy, reports, and manifests without overwriting existing files.
Instructions
[Simulation] Preflight or execute one template-to-full-year grid simulation without GUI. Supply an existing valid PRJ/VC, loose text PAN/OND, workspace SIT/MET, tilt, year and a NEW project filename. Missing inputs return field-specific issues. Native MET root date declarations are checked before creating the working project; generic-1990, absent or unreadable dates remain disclosed, not inferred from filenames. Scope: completely checked single subarray/fixed plane, no active shading/layout, PRCorrTemp=False; retain template counts unless capacity is explicitly supplied. capacity plans integer series/strings/inverters against declared design voltages, currents, temperatures, IEC/UL module voltage rating and maximum DC:AC ratio. Require independent unshared 8.1.0/8.1.6, one repeatable inverter/MPPT/string branch, full hardware MPPT population and crystalline PAN at STC; mode/topology stays intact. Design envelope/source are required, not guessed from raw temperature coefficients. No native temperature-model reproduction, hardware selection or design certification. Optional weather_manifest_name binds prepare_weather provenance to the requested year/SIT/MET, explicitly loads native weather, and compares hourly GHI/DHI/Tamb; changed files stop before writes. Conversion/rounding concerns remain needs_review. dry_run=true (default) writes nothing and consumes no simulation execution. dry_run=false copies/configures the project, runs Jan 1 through Dec 31 hourly, validates native context/complete year, and returns energy, standard PR, IL_Pmax, warnings, CSV/PDF/SFI and a persisted JSON manifest with reverse recovery steps. Existing project/output files are never overwritten. Failure retains the original template and working files/backups/manifest; no automatic retry or destructive cleanup. status is blocked/ready/completed/needs_review/failed; inspect it, not just MCP is_error. Extreme IL_Pmax versus STC reference energy triggers a disclosed review heuristic, not a claim of native physical validation or an automatic model repair. Year is 1969..2068 due to two-digit native CSV dates. Restart host for this tool. azimuth overrides the template plane azimuth in -180..180 degrees (zero south, west positive); losses accepts only LIDLoss, PMismMPP and ModuleQualityLoss on the subarray plus UFactor on the whole main array. Template fields left unspecified keep their saved values, and the returned configuration_summary discloses the requested angles and losses; no loss is fitted, inferred or defaulted. Optional report_pages is a nonempty list of native page names (for example ["summary", "losses"]); omit it for the default complete report. Invalid pages stop in preflight, and the request/manifest records the selection. Explicit tracking + tracking_variant selects an existing verified native8.1.6 UnlimTracking template flow instead: omit tilt/azimuth/capacity/losses; exact source PAN/OND database references and equipment counts stay inherited. This branch requires explicit positive nominal_dc_power_kw and printable tracking_power_source; these are declarations cross-checked against native PR, not guessed from names/cached sizing. Loose workspace/builtin model shadows stop; database internals are not inspected or snapshotted. Only CLI8.1.6rev49278, and completed consumption retains needs_review. Reuses create_tracking_variant to create a NEW VC in the isolated clone, then the same yearly native load/report/ context/integrity checks plus finite actual columns and GlobShd. No type conversion, arbitrary geometry or other tracker families. native_consumption_verified becomes true only after validated completion, not engineering certification. Its recovery is review/manual archive of the entire new clone/VC/outputs; no stale per-file undo, automatic retry/resume, deletion or repeat on an existing project/output.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tilt | No | ||
| year | No | ||
| losses | No | ||
| azimuth | No | ||
| dry_run | No | ||
| variant | No | ||
| capacity | No | ||
| met_name | No | ||
| ond_name | No | ||
| pan_name | No | ||
| tracking | No | ||
| site_name | No | ||
| new_project | No | ||
| report_pages | No | ||
| template_project | No | ||
| tracking_variant | No | ||
| nominal_dc_power_kw | No | ||
| tracking_power_source | No | ||
| weather_manifest_name | No |