XMS

Troubleshooting Model Executables

GMS, SMS, and WMS (collectively known as XMS) all make use of numerical models for the final simulation run. These numerical models include MODFLOW, ADCIRC, SRH-2D, GSSHA, HEC-RAS, etc. These numerical models are not developed by Aquaveo, but the XMS software does provide an interface for using these models. This article will discuss more about how the XMS software integrates with these numerical models.

XMS will allow you to import all of the starting data and define all the parameters for a numerical model simulation. After the project has been built in XMS, XMS will export all of the files needed for the model run. XMS will then access the numeric model executable and launch the numerical model to run your simulation.

If the numerical model fails to run, there sometimes can be an issue with the numerical model executable. Typically, you will receive a warning message stating the model executable can’t be found. When this happens there are two ways to resolve the conflict.

The first is to click the browse button on the warning dialog and browse to the location of the model executable. Select the model executable and simulation will start running. In most cases, the model executables are located in a folder called models located in the locations where the XMS software has been installed.

The second method is to make certain the path to the model executable location has been correctly in XMS. This is done by going the Preferences dialog (use the Edit | Preferences command). In the Preferences dialog, there is a tab call either Files or File Locations. On the Files tab is a list of the available numerical models and where XMS is accessing that executable for the model. From here, you can change the file path to point to the correct location of the model executable.

File Locations tab in the Preferences dialog

Often when the model executable cannot be found the cause is one of a few common issues. One is that the path location was not correctly set when XMS was installed. Another is that the numerical model was not installed correctly. And another is that you may have been using a custom installation of the numerical model software with the model executable in a location where XMS is not looking.

Also note that some numerical models require multiple executables. Often this is a pre-processor that has its own executable. Make certain that the file path is correct for all executables used by the numerical model.

Making certain the correct model executable can be found by XMS can make running your model simulation a lot easier. Check out all the available numerical models availing in XMS today!

Blog tags: 

Understanding Projections vs. Reproject

Have you ever wondered what the difference between projection and reprojection is? Have you ever needed to convert a projection from one type to another in GMS, SMS, or WMS (collectively known as XMS)? The use of projections in WMS can be confusing, so the following should provide further clarification.

Specifying Projections

Projections can be associated with individual data objects, either in the object data file itself or in an associated *.prj file. If XMS cannot find a projection, the object will be left as "no projection," or, when new objects are created, XMS will assign the display projection to it. You can specify an object's projection by right-clicking on it and selecting Projection. Note that this projection must be the same as the original projection of the data; specifying an incorrect projection will result in data issues.

Reprojecting on the Fly

"Reprojecting on the Fly" occurs when datasets or objects from multiple projections are loaded into a project, where the x and y values would not otherwise overlap (i.e., the data would be displayed in two or more distinct locations). The different projections for these data will be "reprojected on the fly" to match the display projection such that the data objects will line up. Note that this does not change any *.prj files or the projections that are set for each object; it is an automatic function internal to XMS used for display purposes.

Converting a Projection

If you need to convert from one projection to another, this can be done by right-clicking on it and choosing Reproject. To use this command, the data must first have the correct projection specified. After choosing Reproject, the command will prompt the user to select a new projection, the data will be converted to the selected projection. If a *.prj file is associated with the object (such as a TIFF), reprojecting the object will change the *.prj file. Reprojection on the fly is usually sufficient for most applications. Please note that there are some limitations for reprojecting.

Reporject Dialog Example

Once the datasets are referencing their projection correctly, XMS should reproject them on the fly to match your display projection. If you don't have a display projection set, you can do so by selecting the Display menu and choosing Projection. At that point, if you would like to reproject your scatter(s) into the same projection as the display projection, you would be able to do so.

Now that you see the differences between projection vs. reproject try them out in XMS today!

Blog tags: