| name | osaf-analysis |
| description | OpenStudio Analysis Framework (OSAF) workflows, algorithm selection, validation, submission, and result download. Use when the user asks about OSAF, OpenStudio Server analyses, sampling, sweeps, optimization, calibration, or OSA JSON configs. |
| disable-model-invocation | true |
OSAF Analysis Workflows
Use this skill when working with OpenStudio Server / OSAF analysis JSON,
support ZIPs, sampling sweeps, optimization, calibration, or server smoke tests.
Discover Algorithms
For “list OSAF algorithms” or “what is this algorithm best for”, call:
openstudio_analysis_algorithms
Filter by category or analysis type when useful:
openstudio_analysis_algorithms category="sampling"
openstudio_analysis_algorithms category="lhs"
The tool returns analysis types, categories, best-fit use cases, caveats,
typical algorithm keys, and the correct start sequence.
Algorithm Selection
Common choices:
| Need | Prefer |
|---|
| Check server/config/package with one run | single_run |
| One-variable or general parameter sweep | lhs |
| Full-factorial style experiment with 2+ variables | doe |
| Screening many variables cheaply | morris |
| Formal variance-based sensitivity | sobol |
| Multi-objective Pareto calibration/design | nsga_nrel or spea_nrel |
| Continuous calibration/search | pso or rgenoud |
| Debugging repeatability or bounds | repeat_run or preflight |
Do not use DOE for only one real variable. Use LHS for one-variable sweeps.
Validate Existing Configs
For existing OpenStudio-server/spec OSA JSON configs, call:
openstudio_analysis_validate_osa_json
Raw validation is schema-focused by default and accepts legacy server config
patterns. Use require_foundational_measures=true when validating an
MCP-generated analysis that is about to be packaged/submitted.
Create and Submit MCP Analyses
Create OSA JSON from measures:
openstudio_analysis_create_osa_json_from_measures
Before uploading a support ZIP:
openstudio_analysis_prepare_package
openstudio_analysis_validate_package
Submit and upload:
openstudio_analysis_submit
Generated analysis JSON files and support ZIP packages always include the
foundational measures:
- view_model
- openstudio_results
- generic_qaqc
Default output variables are exported and visualized so OSAF plots can show
OpenStudio Results whole-building metrics and electricity/natural gas end uses.
Start Order
OSAF sampled analyses need two start actions:
- Start the algorithm action first, such as lhs, sobol, morris, pso, or nsga_nrel.
- Start batch_run to simulate the generated datapoints.
Prefer:
openstudio_analysis_start_sampled_run
For a single-run smoke test, start single_run first, then batch_run.
