Skip to content

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.

Clone this wiki locally