Home

What's new?

SSA Examples

How to work with SmART

Online Version

How SmART works

→ Download

Links

Download and Installation

License
What you need
What you do
Configuring SmART

License

SmART is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License. A copy of this license has been included in the SmART package. Downloading SmART is not necessary unless you are unable to use the online version which is available under http://smart.sbronner.com. Using the online version does not require to download any file!


What you need

For running SmART on your own computer while being offline, you need three things:

  1. The file smart.war, providing the SmART web application (see below for downloading the file).
  2. SmART requires a Servlet Container being installed, e.g. Apache Tomcat or Jetty.
  3. A Servlet Container requires a Java Runtime Environment (JRE), some versions additionally require a Java Compiler. If you want to play it safe you should install either both or a Java Software Development Kit (SDK) which includes a JRE plus a compiler. The official Java JRE and SDK are provided by Sun. Alternatively, you can use Kaffe as a JRE and/or Jikes as a Java Compiler.


What you do

  1. First, check if you have a JRE installed. If your Operating System is Linux or Mac OSX open a Shell, if you are working with Windows open a DOS Box. In both cases, type java -version. If the version of your JRE is displayed you are lucky. Otherwise, download the Sun JRE or Kaffe and install it according to the documentation included. As far as I know, a JRE should suffice for the Tomcat Servlet Container under Windows but not under UNIX/Linux. In the latter case, check if a Java Compiler has been installed by typing javac -help. If no help text is displayed download the Sun SDK or Kaffe plus Jikes and install it (in the latter case first Jikes, then Kaffe). After installation, java -version should result in a version number rather than an error message.
  2. Download a Servlet Container like Apache Tomcat or Jetty and install it according to the documentation included. Start the program by calling the appropriate Shell Script under Linux or Mac OSX or by double-clicking some executable file under Windows. You can configure the Servlet Container so that it will run as a server process, i.e. start automatically when your computer is booted. Otherwise you will have to start the Servlet Container each time your computer has been shut down. Refer to the Servlet Container's install documentation for further instructions.
  3. Download the file smart.war by right-clicking this link and choosing "Save Target As". Save the file in the Servlet Container's "webapps" directory. Stop your Servlet Container and start it again. The file smart.war should be unpacked automatically to a subdirectory "smart" in the "webapps" directory.
  4. Now it's time (drum roll). Start your favorite web browser and type http://localhost:8080/smart into its address line. If everything works fine enjoy SmART!
  5. If you encounter any problems contact your system administrator and in case you don't have one available feel free to contact me via carstencmziegert.org.


Configuring SmART

SmART comes with a predefined relation hierarchy which is easily configurable if you are familiar with XML. Open the file RelationConfig.xml in your favorite text editor. (You will find it in the "config" subdirectory of your "smart" directory which is located in your Servlet Container's "webapps" subdirectory.) If you have opened the file define new relations, or arrange the existing ones by means of the <grp> tag into groups and sub-groups. Please consider that the <rel> tag (representing a semantic relation) has two attributes: name is the relation name which is displayed in SSA output such as graphic export (the "real" name) whereas out denotes the relation's designation in the list the user chooses from during the analysis process.

Please note: The English (RelationConfig.xml) and the German relation hierarchy (RelationConfig_de.xml) don't agree with each other in all details. The reason is that different sources were used: The book "A Semantic and Structural Analysis of Philippians" by John Banker for the English version and the lecture "Greek III" by Dr. Heinrich von Siebenthal at Freie Theologische Akademie for the German version.