Repository navigation
Troubleshooting
cleorf92 edited this page Sep 28, 2026
·
2 revisions
aiphoria checks your scenario file before solving it and tells you what is wrong, usually with the sheet and row. Here are common messages and what to do.
| Message or problem | Likely cause | What to do |
|---|---|---|
Constrained scenario contained errors, stopping now... with does not have enough outflows …
|
A scenario change asks for more material than the process has | Reduce the change to the maximum given in the message, set Apply to targets to TRUE, or run in Unconstrained mode to explore. See Scenarios and scenario modes. |
Not even number of indicator columns … |
An indicator is missing its comment column, or an extra column follows the indicators | Each indicator needs two columns (factor, comment), and they must be the last columns of the Flows sheet. See Indicators. |
| A flow's source or target process is not found | The process ID in the Flows (or Scenarios) sheet does not match the Processes sheet | Check spelling and the Name:Location format. Avoid spaces in names. |
| Stock distribution parameters are missing or invalid | The distribution type needs parameters that are empty or written wrongly | Use name=value, e.g. stddev=1 or shape=2.5, scale=40. See Processes sheet. |
Error about the version parameter, or columns read in the wrong place |
Scenario file made with aiphoria < 1.1.0 | See Upgrading from older versions. |
Directory … already exists when running the example |
The output folder is still there from an earlier run | Use remove_existing_output_dir=True, or choose another folder. |
| Path must be absolute |
run_example was given a relative path |
Give the full path, e.g. C:\results\aiphoria_example. |
Flows with IDs starting with VP_ appear in the results |
Virtual flows: a process did not balance, or an unconstrained scenario needed more material | Check the input data of that process. See [[Processes, flows and stocks |
| Indicator (e.g. carbon) is zero for some flows | Empty indicator cells count as zero | Give a conversion factor to every flow you want to follow. See Indicators. |
| Flows are zero in years without data |
fill_method is Zeros (the default) |
Set fill_method to Previous (or Next / Interpolate). See Settings sheet. |
| Sankey labels overlap | Processes are placed close together | Drag processes in the Sankey graph, or change the font size in the Settings menu. Save the layout in the Process positions sheet. |
Still stuck? Open an issue on GitHub and include your
aiphoria version (pip show aiphoria), the full error message, and if possible a small scenario file that shows the
problem. Contacts of the maintainers are in the
README.
Getting started
Concepts
Building a scenario file
Results
Help