Troubleshooting

This page describes how to overcome some potential issues running the app. If you are having trouble, first check that you are running the latest version of JAVA by requesting in the Terminal:

java -version

If it is previous to Java SE 17, please install a newer version from https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html. If the error persists, run ‘Future Weather Generator’ from the terminal:

java -jar FutureWeatherGenerator.jar

If the error is not listed below, please report it on our code development webpage https://bitbucket.org/cling-project/futureweathergenerator/issues?status=new&status=open.

Error when adding morphed files to DesignBuilder

EPW files generated in macOS or Linux machines may lead DesignBuilder to provide an error message. This error occurs due to DesignBuilder expecting EPW files to have each line ending with carriage return and feed line characters. In order to prevent such an issue, EPW files must be generated in Microsoft’s Windows environment, as the new line character is platform-dependent.

Does not write the files after running on Mac OS

In macOS, some users may experience that the content of some folders does not show when trying to select a file or the output folder. This happens when we double-click on the app to open it. When running from the terminal, the app works fine. In order to solve this issue, the user needs to add ‘JavaLauncher.app’ to full access rights in the system preferences of the operating system.

You can overcome this issue by:

  • Go to System Preferences -> Security -> Privacy -> Full Disk Access.
  • Drag and drop ‘JavaLauncher.jar’ to the list. You can find it at ‘/System/Library/CoreServices/JarLauncher.app’ (macOS).

java.io.FileNotFoundException

This error may occur when the machine uses Antivirus software that prevents the app from writing files. The solution is to pause the Antivirus software or to add the FutureWeatherGenerator.java to the exception rules of the Antivirus software.

java.lang.OutOfMemoryError: Java heap space

If the ‘Future Weather Generator’ does not run due to out of memory, your machine is required to increase the maximum available memory. There are two solutions.

(1) To run from the Terminal (command line):

java -Xmx5120m -jar FutureWeatherGenerator.jar

(2) To add -Xmx5120m option to the java environment parameters.

In macOS machines, open the Java panel on the System Preferences (in Windows machines, open the Java panel on the System Control Panel). Then, Select the Java tab and click on the View button. In the field for Runtime Parameters add: -Xmx5120m.

In both cases, the 5120m means setting 5 GB as the maximum memory available to Java. This value can be increased when needed.