US Army Corps of Engineers
Hydrologic Engineering Center

Skip Navigation LinksHome > software > hec-hms > known issues


Special Characters in Directories and File Names
Some languages include diacritic marks that modify letters.; Examples include the umlaut (¨) from German, the grave (`) from Portuguese, or the circumflex (ˆ) from Italian. There are many types of diacritic marks and many are used in more than one language. The Microsoft Windows operating system allows letters with diacritic marks to be used in directory and file names. The HEC-HMS software currently is not able to process directory or file names that include letters with diacritic marks. No directory or file name should use diacritic marks. The software may not be able to process the files if diacritic marks are used.

Decimal Separator
Most countries use either a period (.) or a comma (,) as the decimal separator in numbers; each country has adopted a standard for which one is preferred. The software allows you to select which decimal seperator to use regardless of any setting in the operating system. In some countries, there will be problems when the software interacts with the clipboard of the operating system.

Debug assertion failed error on exe launch
There is a character limit for the PATH environment variable for the HEC-HMS exe launcher which can cause a "Debug Assertion Failed!" error on launch. To launch via the exe launcher, your system PATH environment variable must be less than 2035 characters. Alternatively, you can launch HEC-HMS via HEC-HMS.cmd.

Small text and icons on high DPI displays
If the Windows display scaling setting is different than 100% HEC-HMS text and icons may appear unusually small. To mitigate this issue browse to the java.exe that is distributed with HEC-HMS. This is located in the <HEC-HMS root>/jre/bin folder. Right click java.exe, select Properties, select Compatibility tab, select Change high DPI settings, select Override high DPI scaling behavior, and select System.