Troubleshooting common simulation errors and how to fix Them
Summary: Simulation errors are most often caused by conflicting scheduling strategies, too many strategy slots, resource constraints, incorrect task assignments, or unreviewed logistics utilisation reports. To resolve them, reduce active strategies and slots to one, check resource availability, review task assignments, and review logistics utilisation reports.
What Are the Common Causes of Simulation Errors?
Simulation errors are commonly caused by five issues: multiple scheduling strategies, too many strategy slots, resource constraints, incorrect task assignments, and unreviewed logistics utilisation reports.
-
Multiple scheduling strategies:
- Having multiple scheduling strategies can lead to conflicts, especially if tasks are scheduled and then rescheduled before there is enough time for them to be executed. This can result in simulation failures.
-
Presence of strategy slots:
- Using too many strategy slots complicates the scheduling process. A strategy slot defines the time window in which a scheduled task can be executed. When tasks are not properly aligned with available resources across those slots, errors can occur during simulation.
-
Resource constraints:
- Errors can occur due to resource constraints, such as when a vessel is not available at the time a task is scheduled to run. This can prevent the simulation from running successfully.
-
Incorrect task assignments:
- If tasks are not assigned correctly to the appropriate vessels, it can lead to errors. For example, if a vessel is set to perform tasks that it is not equipped for, the simulation may fail.
Unreviewed logistics utilisation reports: Failing to review logistics utilisation reports can allow inefficiencies and scheduling conflicts to go undetected. These reports provide detailed information about tasks performed by each vessel and their durations, making them a key diagnostic resource.
How Do You Troubleshoot Simulation Errors?
To troubleshoot simulation errors, reduce your active scheduling strategies and strategy slots to one each, confirm resources and task assignments are correct, and review the logistics utilisation reports. Then re-run the simulation.
Reduce active scheduling strategies: If you encounter errors, reduce the number of active scheduling strategies to one. Remove or disable any additional strategies so that only a single strategy is in effect, then re-run the simulation to confirm the conflict is resolved. Once the simulation runs successfully, reintroduce additional strategies one at a time to identify which combination causes the failure.
Reduce strategy slots: Within your active scheduling strategy, reduce the number of strategy slots to one. Start with a single slot to eliminate scheduling window conflicts, confirm the simulation runs successfully, and then add slots back incrementally if needed.
Check resource availability: Confirm that all required vessels and resources are available and properly assigned to their tasks. If a vessel is unavailable or misconfigured, reassign tasks to an available vessel before re-running the simulation.
Review task assignments: Verify that each task is assigned to a vessel equipped to perform it. If a task is assigned to a vessel that lacks the required equipment, reassign it to a suitable vessel, then re-run the simulation to confirm the error is resolved.
Review logistics utilisation reports: Open the logistics utilisation reports and review task durations and vessel assignments for each scheduled operation. To access these reports, navigate to the Reports section and select Logistics Utilisation. Look for overlapping tasks, underutilised vessels, or abnormally long durations — these patterns commonly indicate the root cause of simulation errors.
What Should You Do If Errors Persist?
If errors persist after completing all troubleshooting steps, select Help from the in-app navigation menu and choose Contact Support, or visit the support portal.