This is IKR SimTree, a tool which complements the IKR SimLib.

IKR SimTree is usable for both the IKR SimLib, Java Edition and
the IKR SimLib, C++ Edition.

IKR SimTree is used to control the execution of simulation
studies and to evaluate simulation results.

Currently IKR SimTree is provided as a binary-only release and
is (C) 2013 University of Stuttgart, IKR. In the future, IKR
SimTree will be licensed under the GPL version 2.

IKR SimTree is distributed in the hope that it will be useful, but
without any warranty of any kind. Please contact the IKR if you
need additional information (http://www.ikr.uni-stuttgart.de).


Installation
------------

IKR SimTree is written in Java and requires a Java Runtime
Environment (JRE) Release 1.6 or later. IKR SimTree is provided as
a jar-File (Java archive file). IKR SimTree is designed for
Linux/Unix and will not run in a Windows environment.

IKR SimTree comes along with two tools named STResultPrinter and
STResultViewer which are used to print the contents of the new
XML-based result file of IKR SimLib 2.7 in a format similar to the
old print server output format. While STResultPrinter prints to
stdout, STResultViewer shows a graphical view of the results.

Scripts named SimTree, STResultPrinter and STResultViewer are
contained in the directory ./script. They give examples how to
execute the jar-File. Replace "jar-path" in the scripts with the
actual path of the SimTree jar-File.

The SimTree script must be reachable through the current PATH
because it calls itself through this script. The STResultPrinter
and STResultViewer scripts have no further external dependencies.


Documentation
-------------

IKR SimTree contains built-in documentation. An introduction with
pointers to more help may be obtained with the command

  SimTree intro

Usage examples will be displayed by the command

  SimTree intro-examples

A printout of the built-in documentation is contained
in the file ./doc/SimTree.txt.


Reporting bugs and submitting feature requests
----------------------------------------------

Please report bugs and submit feature requests! Please use
the command 

  SimTree intro-bugs

for details.
