Troubleshooting and FAQ

The most common questions, with the message you see and what to do about it.

Setting up a scenario

The Simulate button is disabled

The header button needs a pickup and a drop-off connected by an allowed route. In Draw, click an empty area of the canvas: the Properties panel shows the Ready to simulate checklist. As soon as there is one path and two stations, Configure simulation opens the Scenario, where you can pick the stations or accept Use connected pair.

“Enable at least one Pick and one Drop station”

No unblocked station has the Pickup or Drop role. Select stations in Draw and tick the roles. A station with both roles can serve as either end, but never as both ends of the same order.

“No permitted route between selected pickups and drop-offs”

• Check that the paths are really connected: new paths must start on the snap square of an existing endpoint or path. Paths that cross in the middle are not connected.
• Check travel directions: a one-way path may point the wrong way.
• If the layout has links, a chain of links must go from the pickup to the drop-off. Select the links and press Recalculate route after changes.

Only some AGVs are placed

The Fleet step shows, for example, 2/3 AGV. Each AGV needs its own unblocked Charger or Parking location, spaced at least the minimum distance from the others. Mark more stations, move them apart, lower the minimum distance or reduce the fleet. The studio never uses other nodes as a fallback.

During a run

Orders pile up in the queue

Look at the waiting reason in Pending:

• Compatible AGVs busy: the fleet is saturated. Add AGVs, lengthen the order interval, shorten service times, or raise speeds. Check utilisation in Results.
• No AGV can reach the pickup: vehicles cannot get from where they are to the pickup. With links, add link chains from chargers/parking and drop-offs to the pickups.

Vehicles stop and wait for each other (Possible gridlock)

Local collision avoidance does not plan manoeuvres. Typical causes are dead ends shared by several vehicles, two-way single lanes and waiting positions that block an exit. Remedies:

• turn two-way sections into one-way loops;
• add an exclusive traffic zone covering the whole single-lane section and its entrances;
• add a charger or parking outside zones so vehicles can clear them;
• use zone conditions on links to hold vehicles at a safe point.

“Return impossible” or “Return pending”

An idle AGV has no free, reachable charger or parking. Impossible means no route exists with the current directions and links; pending means stations are occupied, reserved or too close to another AGV. Add stations or links for the way back.

“The train cannot reverse: no forward route”

A tugger train only drives forward. The order needs it to turn back somewhere: a pickup or drop-off at the end of a spur, a sharp V between two paths, or a pickup reached from the wrong side. Open the Network tab: Trips trains cannot make and Dead ends for trains point to the stations. Add a loop or a curve so the train can come round, or leave those stations to fleets without trailers in their properties.

An AGV stopped with an empty battery

It reached 0 % away from a charger. Raise the Charge below threshold so vehicles leave for charging earlier, add chargers closer to the work, or check that Unloaded driving autonomy matches your vehicles. Remember that a Parking location does not charge.

Start is disabled

The run reached the chosen duration. Press Reset, or choose a longer duration (or ∞) in the toolbar.

The run is slow or stops when I switch tab

Choose Max speed or use Start run. Hidden tabs keep simulating through a background worker, but browser energy savers may freeze a tab hidden for a long time: exclude the studio's address from them for very long runs.

“Plant logic: …” error in Simulate

The diagram has a problem at runtime, for example an instant loop. Open Plant logic, read the issue next to the named block (often: add a Wait on the return connection), then press Reset.

Traffic optimization

The search finishes without resolving every block

Optimize traffic selects zone and transit-point changes; deferred variants have not been tested. The AI agent can propose other permitted changes based on the incidents and outcomes it receives. Neither engine creates new paths or changes demand or fleets. A dead end without exit space or a parking place on the only passage may require a layout change. Read the remaining blocks and completion reason: you can keep a verified improvement that reduces problems, but the remaining blocks still need attention.

Optimization takes a long time or I cannot edit the project

Every improvement that can be kept must be verified over the entire chosen duration. Five seeds are required when the engine uses randomness; one trial suffices when it verifies zero random draws from initialization to the end of that configuration. Each candidate is checked separately. Time depends on the layout, duration and alternatives: the panel shows the total and approximate real time remaining in the current round, with the estimate paused during decisions. An accepted improvement may start another round. Navigation and workspace switching remain available, while edits are suspended to keep the trials consistent. Press Stop, then Keep or Discard to finish the session; the incomplete attempt is not applied.

AI pauses or is unavailable

AI assistance requires account entitlement and shares the assistant's models and quotas. At the maximum step count shown in the panel or after three repetitions without progress, explicitly choose whether to continue with AI, continue locally or stop. A provider error or exhausted quota suspends requests: you can continue locally or finish. Full access changes only acceptance of verified improvements; it does not grant AI access, increase quotas or renew a tranche. No paid call restarts automatically after a reload.

I closed the tab during a search

Reopen the same account and project to explicitly recover the verified checkpoint stored in the browser. The interrupted attempt starts again from the beginning. If you saw a warning that IndexedDB was unavailable, the checkpoint existed only in the tab and does not survive its closure. Clearing site data also removes these checkpoints.

CAD backgrounds

The drawing has the wrong size

The file probably declares the wrong unit, or none. Reimport choosing Original drawing units explicitly, or correct the size with Scale factor (for example 1000 if the drawing is in metres but was read as millimetres). If you have already drawn paths and stations, do not reimport: with Scale paths and stations too the factor rescales the layout as well.

“WebGL is unavailable”

Enable hardware acceleration in the browser, or choose Image · 1 cm detail in Advanced options.

Parts of the drawing are missing or look wrong

Read the Import results report. Try Recover hatch outlines, the ODA alternative reading method if available, or hide layers covered by WIPEOUT masks. External references (XREF) must be bound into the drawing in your CAD tool.

“Too complex” or size limit errors

Choose fewer layers with Change content, or simplify a copy of the drawing in your CAD tool. Files over 100 MB cannot be uploaded.

Saving

Save is disabled

A field contains an invalid value. The save state reads Fix the fields: find the field marked in the panels and correct it, or press Esc in it.

“The source project changed: reopen it before saving”

The file was modified elsewhere since you opened it. Use Duplicate project to keep your version, or reopen the file.

“API unavailable”

The studio cannot reach its server: your connection dropped, or the service is restarting or waking up after inactivity. The draft and Download .sim copy still work; export a copy if in doubt, wait a moment and try Save again.

“Runs awaiting save”

A finished or reset run could not be sent to the archive, usually because the connection dropped. Press Retry when you are back online; the studio also retries when you reopen it. Keep the tab open if a warning says the browser cannot store the queue, and download the ZIP or PDF of important runs in the meantime.

I refreshed the page. Is my work lost?

Usually not: the automatic draft restores the last project and valid unsaved changes in the same browser and address. It does not survive clearing site data or switching browser, so save or export regularly.

Frequently asked questions

Can the studio control real AGVs?

No. It never uploads files or sends commands to vehicles, and its results do not certify safety.

Why do two runs give different numbers?

Check the seed in Results → Technical data, then compare the layout, scenario, engine version and simulated duration. Random missions, disturbances and zone reservations repeat when these inputs match. Generate a new seed deliberately changes the random sequence; changing the model can also change draw order. Use several seeds per alternative to study variability.

Does changing the language or theme affect my project?

No. They are browser preferences: they never modify the project, add history steps or restart the simulation. Exported CSV files use the separator of the current language.

Do I need a return link for every transport?

No. A transport only needs a route from pickup to drop-off. Vehicles do need a way to continue afterwards, towards the next pickup or a charger/parking, or they will wait.