Thermoptim browser Installation Guide

The Thermoptim browser allows you to carry out guided explorations of models of energy systems whose scenario is described in HTML files.

It can guide in a rich and detailed way a learner using the simulator as part of his teaching.

This guide will help you install this software available for three environments: Microsoft Windows, GNU/Linux and Mac OS X.

Download

Please download the appropriate archive for your operating system:

Installation in Mac OS X

Installing the JAVA runtime environment

Thermoptim is an application written in JAVA. In order for this software to be able to run, you must therefore install on your system a runtime environment (the Java Runtime Environment or JRE).

If, this JRE is not already installed on your system, download the installation file “jre-8u121-macosx-x64.dmg” on this page(or else find the link which corresponds to your system version using a search engine) and follow the registration procedure available at this address.

For the software to launch you must have on your system JAVA version 7 ou 8 (this is the standard version since 2014). If not, see the next section..

Installation of the Thermoptim browser

Start by downloading the ThoptBrows_1.1.23_mac.zip ThoptBrows_1.1.23_mac.zip (not available) archive, and copy it to your Desktop or to any folder where you have write rights.

Using the right click (or a click while holding down the ctrl key) open the contextual menu, and launch “Open with > Archive utility”.

The archive utility will then create a new "NavThop_mac" folder in the folder containing the .zip archive.

Then copy the entire folder to your "Documents" folder.

You can now open the contents of the "NavThop_mac" folder and double-click the "NavThopt" icon to launch the application.

Good work!

Authorization issue at runtime

When launching the application, it is possible that the system blocks the process with the following message: “Unable to open" NavThopt ", because this app comes from an unidentified developer…”

In this case, you will have to open your “System Preferences…” :

Open the “Security and confidentiality”setting screen:

Then click the “Open anyway” button…

Then confirm your action by clicking the “Open”button!

You can now return to the folder containing Thermoptim and relaunch the "NavThopt" application..

Installation under Microsoft Windows

Installing the JAVA runtime environment

Thermoptim is an application written in JAVA. In order for this software to be able to run, you must therefore install on your system a runtime environment (the Java Runtime Environment or JRE).

If, this JRE is not already installed on your system, download the installation file "jre-8u121-windows-x64.exe" if you have a 64-bit processor (for recent PCs) or "jre-8u121- windows-i586.exe "if you have a 32 bit processor on this page and follow the registration procedure available at this address:.

For the software to launch you must have on your system JAVA version 7 ou 8 (this is the standard version since 2014). If not, see the next section..

Installation of the Thermoptim browser

Start by downloading the ThoptBrows_1.1.23_win.zip ThoptBrows_1.1.23_win.zip archive, and copy it to your Desktop or to any folder where you have write rights.

Using the right-click open the context menu, and launch "Extract here ..."..

A new window opens. Choose a target folder then validate by clicking “Extract” button.

Open the newly created folder.

Finally, double-click on the file “NavThopt.jar”

If nothing happens, then you may not have installed a JAVA runtime environment!

Good work!

In some cases, it happens that the Current Working Directory is not correctly defined when launching the .jar file. In this case, you can launch the applications using the "NavThopt.bat" and "Thermoptim.bat" scripts contained in the folder.

Installation under GNU/Linux

GNU / Linux environments are varied, we will limit ourselves to describing an installation for Ubuntu distribution.

Installing the JAVA runtime environment

Thermoptim is an application written in JAVA. In order for this software to be able to run, you must therefore install on your system a runtime environment (the Java Runtime Environment or JRE).

If you are familiar with using your package system, simply install the openjdk-8-jre and openjfx packages.

To install these two packages, you can use the Ubuntu Software Center (if it is installed on your system, which is no longer the case by default since Ubuntu 16.04)...

… Or, in a terminal, execute the following commands:

				sudo apt-get update
sudo apt-get install openjdk-8-jre openjfx

For more information on installing packages, you can consult the documentation of the . the Ubuntu community documentation.

Installation of the Thermoptim browser

Start by downloading the ThoptBrows_1.1.23_linux.zip ThoptBrows_1.1.23_linux.zip (not available) archive, and copy it to your Desktop or to any folder where you have write rights.

Using the right-click open the context menu, and launch "Extract here ..."..

Open the newly created folder.

Finally, double-click on the file "NavThopt.jar"

Good work!

Miscellaneous issues

If you have a problem with character encoding:

For the characters to display correctly, you must have the locale en_EN.UTF-8installed and activated on your system.

If this is not the case, you can install this locale, by running the following command:

				sudo apt-get install language-pack-en
			

…Then activate it, by executing the following command:

				sudo dpkg-reconfigure locales
			

You will then have to check the box “en_EN.UTF-8”.

Using Java 1.7

In order for the Thermoptim browser to work correctly with JAVA 1.7, you must ensure that you have the JavaFX library installed.

The installation procedure is described on this page.

Use of an earlier version

If for some reason you cannot install a recent JAVA runtime environment, then you can use a regular version of Thermoptim (that is, without the support of guided explorations).

To do this, simply open the "Thermoptim" launcher instead of the "NavThopt" launcher (under Windows, this is the "Thermoptim.jar" file).

You will then be able to read the guided explorations in a standard Internet browser by opening the file "explorations/ctc/accueil_en.html" contained in the archive or by consulting the online version.

Unfortunately, you will not be able to benefit from the coupling between the explorations and Thermoptim: you will have to execute all the operations in Thermoptim by yourself…

Alternate solution

If for some reason you cannot install a recent JAVA runtime environment, then you can use a regular version of Thermoptim (that is, without the support of guided explorations).

To do this, simply open the "Thermoptim" launcher instead of the "NavThopt" launcher (under Windows, this is the "Thermoptim.jar" file).

You will then be able to read the guided explorations in a standard Internet browser by opening the file "explorations/ctc/accueil.html" contained in the archive or by consulting the online version.

In this case you will not be able to benefit from the coupling between the explorations and Thermoptim: you will have to execute all the operations in Thermoptim by yourself.

Note that you can derive the same educational benefit from these guided explorations whether or not you use the Thermoptim browser. Studying them in a standard browser will allow you to work as well.