ISAT Troubleshooting Guide

This document is intended to provide guidance how to resolve some common issues using ISAT and running scenarios on the NADS miniSim™.

Issues have been sorted based on if the issue is related most to ISAT operation and function vs. scenario operation and function.

ISAT Operation and Function

Model X not found

ISAT will display this error when a scenario file contains a model that is not recognized.

The cause of this error is the scenario being opened contains a model and ISAT cannot find that model within any of the sol2 files available.

This can happen if the scenario originates with some other laboratory, or if the scenario was authored with a different sol2 file.

ISAT uses a system variable to identify sol2 file locations: NADSSDC_SCN=C:\NADS\Isat\data\

To correct the missing model error, use Task Manager to exit the ISAT application and locate the sol2 file used to create the scenario. Either replace the ISAT\data sol2 with the scenario sol2 file, or use a text editor to transplant the model from the source sol2 into your working sol2 file.

It is also possible to create a new sol2 file using the prefix sol2_aux.xxx.txt, where xxx is some unique number. Note that sol2 files begin with the keyword SOL2 as the first line. Copy the missing model into this file, and place it into the folder location specified by NADSSDC_SCN.

If ISAT is running when you create a new sol2 or copy over the current one, exit and re-launch. ISAT reads sol2 data only at startup.

NOTE: Model names and IDs must be unique within the entire set of sol2 and sol2_aux files.

ISAT crashes after running an ISC script

Running an ISC script can cause ISAT to become unstable. To prevent problems:

1. run the ISC script - do not move or edit any elements added by the script.
2. save the scenario.
3. close the scenario.
4. re-open the scenario.

At this point scripted elements should operate the same as elements inserted manually.

Scenario Operation and Function

This list is not comprehensive, as there are a vast number of ways to construct a scenario.

It is most useful if the triggers contain some form of self-reporting that is visible in Rehearsal mode and during simulation on miniSim. Since Rehearsal mode does not show Visual Display Text, use either a Create or Write to Cell action.

For rehearsal mode the cell name can be anything, it does not have to be an actual cell. During rehearsal information will be printed to the Debug window.

A Create action is used to create some noticeable element in the simulation, that will indicate the trigger has fired.

Driver is sitting in the middle of nowhere or off-road when miniSim goes to Drive

This is typically when there is no scenario start location defined.

To correct, insert an external driver using ISAT, save the scenario and try to drive again.

My trigger doesn't completely work

Review the actions within the trigger, and see if there is a persistent action that is not the last action.

Action execution stops on a persistent action and no actions after it in the list will work.

If you cannot shift the persistent action to the end of the action stack, then create a time trigger to separate it from the other actions.

Note: multiple persistent actions would require one time trigger per action.

I see cars in the simulation disappear

There are a number of reasons why ADOs might disappear from the scenario:

1. some action is forcing the ADO to attempt something it is not capable of doing
2. the ADO is being removed by a scenario action (this only happens when the delete is explicitly specified)
3. the ADO has a creation radius and has travelled outside the visible radius specified
4. the roadmap contains an anomaly that the ADO cannot resolve