Switching Model Executables

The Groundwater Modeling System, Surface-water Modeling System, and Watershed Modeling System (collectively known as XMS) applications make use of multiple numerical models. XMS is packaged with the executables for each of these numerical models. At times, you may need to switch out which numerical model executable XMS uses.

In general, you will want to use the model executable that comes packaged with the XMS. XMS is coded to work with the specific model executables that are distributed with each version of the software.

There are some reasons you might want to change which model executable it used. It might fix a bug with the model executable. It might get you access to features in an older or newer version of the model executable. It might also help you test issues with the numerical model. Replacing the model executable isn't guaranteed to help with any of these, but it is one option for troubleshooting with all of them.

For all XMS applications, the numerical model executables to be used are selected in the Preferences dialog. If you already know where the model executable is, you can copy and paste the executable into the preferences dialog. To do so, use the following workflow:

1. Copy the executable file path. If using Windows 11, right-click on the desired model executable and select "Copy as Path."
2. If using Windows 10, open the Properties dialog from the right-click menu. Copy and paste the location path into a text document. Then, make sure to grab the file name ending in ".exe" as well. The executable path will be incomplete without that file name.
3. In your XMS software, open the Preferences dialog from the Edit menu.
4. Find the model executable that you want to change and click on the file path next to the name or the Browse button.
5. In SMS or WMS, this will bring up an Open dialog. In the File name box, paste in the new executable path. If you are using Windows 11, make sure to delete the quotation marks at the beginning and end. Selecting Open saves the new model executable.
6. In GMS, the model executable is editable without bringing up the Open dialog. Simply erase the former executable path and paste in the new one. As long as the path is a valid path and the path ends in ".exe", GMS will save it. Again, for Windows 11, delete the quotation marks.
7. Finalize the model executable by clicking OK to exit the Preferences dialog. Otherwise, the executable will not save.

Now, there are some issues to keep in mind. As mentioned earlier, changing out a numerical model executable is not guaranteed to fix a particular issue or even improve the situation. Older or newer versions of the model executable may not always be compatible with your version of XMS. Sometimes the model executable is not compatible with a particular project. The new executable might even worsen the situation. If any of these things happen, you can reintroduce the original executable.

Check out the available model executables in XMS today!