TASverter-r2019-07-19: Installation notes

Copyright © 2003-2019 European Space Agency

It is not permitted to redistribute this software without the express written permission of the European Space Agency.

Disclaimer

Warranty and Disclaimer of Warranty. Although every attempt has been made to ensure the correctness of this converter, it is provided "AS IS" and WITHOUT WARRANTY, either express or implied, including, without limitation, the warranties of NON-INFRINGEMENT, MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY OF THIS SOFTWARE IS WITH THE USER.

Limitation of Liability. Under no circumstances and under no legal theory, whether in tort (including negligence), contract, or otherwise, shall the provider be liable to any person for any direct, indirect, special, incidental, or consequential damages of any character arising as a result of the use of this converter including, without limitation, damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses.

How do I install and run TASverter?

After downloading the installation zip or tar file, unzip or untar the file into an appropriate directory on your machine. In the text below, the full path to this directory (including any drive letters on Windows and any trailing slash or backslash character) will be referred to as [TASverterDir].

NOTE: To avoid problems on Windows systems, make sure that neither [TASverterDir] nor any of its parent directories contain space characters in their names.

The TASverter-r2019-07-19 release contains a single executable that is used to start TASverter in either the graphical user interface or in command line mode.

On Windows you can double-click on TASverter.exe in the File Explorer to open the graphical user interface, because this is the default mode on Windows. If that doesn't work, you may need to open a DOS/cmd window by either clicking on the "Start" button, selecting "Run" and then type "cmd", or by clicking on the "Windows" button and searching for "cmd" and then running the "Command Prompt" app.

To start the graphical user interface from the command prompt on Windows you simply need to type:

[TASverterDir]TASverter.exe

but on Linux you will need to set --gui explicitly and type:

[TASverterDir]TASverter --gui

The TASverter GUI allows you to browse for input and output files, select the file types, and set additional options before starting the conversion process.

To run the command line version of TASverter from the command prompt on Windows you need to set the --nogui option explicitly and type:

[TASverterDir]TASverter.exe --nogui [input options] [output options]

whereas on Linux the command line mode is the default so you can just type:

[TASverterDir]TASverter [input options] [output options]

If you omit the options, TASverter will show the complete help text.

Once you have verified that TASverter runs, you may want to update your environment to include [TASverterDir] in the command path.

On Windows you will need to go to the"Environment Variables" settings on the "Control Panel" and then click and edit the Path variable and set it to:

Path=%Path%;[TASverterDir]

On Linux systems, shell users will need to modify the appropriate .profile or .bashrc file, and add the following line:

export PATH=$PATH:[TASverterDir]

Once your environment has been updated to reflect you new command path, you should be able to run TASverter or the GUI directly from the command line using the appropriate --gui or --nogui options as described above.

I have a problem. What do I do now?

The installation procedure described above is somewhat generic, and there are a number of possible variations due to exact operating system versions or particular command shells. Please ask your system administrator to review the installation procedure above to see whether a variation applies to your system.

If you still have problems, please contact tasverter @ thermal.esa.int