Introduction to TSAFE
What do you need:
For running TSAFE:
For compiling TSAFE:
or
(use the latest stable versions to make sure that everything is working correctly)
Contents of the archive
- datafiles/
Some data needed
to use TSAFE. (navigation files, the
map, sample config..)
- lib/
Libraries needed to run TSAFE.
- server/
Two server scripts and that reads from test1.txt with flight data.
The
normal server (serve.py) sends the data really fast,
so if you want to see the flights moving use the delayed server (DELAY_serve.py).
- tsafe/
The source code for TSAFE.
- tsafe/common_datastructures/_resources/
Some essential files to start TSAFE. (splash screen, icon..)
- .classpath .project build.xml
Eclipse project files.
- default_tsafe.properties tsafe.properties
Configuration files.
- Makefile env.mk manifest
Files for compiling with Make.
Installing TSAFE
Extract the complete zip archive to a folder of your choice.
Starting TSAFE
- Start the "DELAY_server.py" in the "server/"
directory.
It will read data from the file test1.txt.
It should start with the message "Serving data on port 4500".
- Start the "Tsafe.jar".
- Click the Data Sources tab and change the "Data Files" to the right path.
You will find the data
filess in the folder "datafiles/".
- Click the map tab and change the path to the "Background Image".
You will find
the map in the folder "datafiles/".
- Click "Save configuration".
- Leave everything else untouched and click on "Launch TSAFE"
It can take a while till the map is loaded and
the first flights show on the screen.
Programming with Eclipse
Importing the Project in Eclipse:
- Start Eclipse.
- File -> Import
- Choose "Existing Project into Workspace" and click on "Next".
- Enter the path to the extracted archive and click on "Finish"
- Windows -> Preferences
- Java -> Build Path -> Classpath Variables
- Click on "New" and enter the following:
Name: LIB_FIGIO
Path: {path to extracted archive}/lib/figio.lib
- Click on "OK" two times.
Using the Ant script to make a jar file:
- Window -> Show View -> Ant
- Make a right click in the Ant view and choose "Add Buildfiles ..."
- Double click on the build.xml
- If you click on the play button in the Ant view, the script generates
a jar file and copies it, and all the stuff which is needed to run it,
in the "build/"
directory.
(the steps you have to do can slighty differ, depending on the version and your
configuration of Eclipse)
Programming with Make
Make is only used for compiling and running TSAFE. You have to use a normal
texteditor to change the sourcecode.
- Change the "ROOT_PATH" in the "env.mk" file to the path
where you have extracted the archive.
- Change to the directory where you have extracted the archive.
- Type "make " and one of the following options:
- all
Compiles the whole program, but only if there have been changes
to the sourcecode since the last compiling.
- run
Starts TSAFE. (You need a running X-Server for this)
If necessary Make compiles the program prior to starting it.
- build
Generates a jar file and copies it, and all the stuff which is
needed to run it, in the "build/" directory.
- clean
Deletes all compiled ".class" files and the "build/" directory.
Normally not needed, because make recompiles the program
automatically when there have been changes to the sourcecode.
The makefile has only been tested with Linux, however there is a version of make
available for windows, so it should be possible to
use it on windows.
More information
See the user's guide for more information on how to install and run
TSAFE.