
JAS: Java Algebra System
------------------------

Version 2.4, September-October 2011

by Heinz Kredel, University of Mannheim, kredel at rz.uni-mannheim.de

Copyright (c) 2005-2011 by Heinz Kredel.

Programms released under GPL or LGPL, see COPYING.jas or COPYING.lgpl.jas.


Requirements
------------

A Java JDK 1.6 or JDK 1.7, JDK 1.5 now also possible.

Documentation see index.html.

Required libraries are log4j.jar (from Apache Log4j) and junit.jar (from Junit) 


Usage
-----

javac -cp {other_jar_files}:jas-<version>-bin.jar:.  <your sample code>

java  -cp {other_jar_files}:jas-<version>-bin.jar:.  <your sample class>

or

jython examples/<some input file> 

or

jruby examples/<some input file> 


Versions and jar files
----------------------

JAS is distributed in 3 jar files:

jas-<version>-bin.jar:    the Java class files 
jas-<version>-src.jar:    the java source code
jas-<version>-doc.jar:    the Java doc and epydoc files

optional jar files:

jas-meditor.jar:          the interface to meditor
jas-jython.jar:           an interface for Java scripting
mylog.jar:                a substitute for log4j to use Java logging
jlinalg_adapter.jar:      an adaptor to parts of JLinAlg
commons-math_adapter.jar: an adaptor to parts of Apache commons.math


The version is specified by a two digit major.minor number
and a subversion revision number. For example in

jas-2.2.2088-bin.jar

"2.2"  is the JAS version number and
"2088" is the subversion revision number

The jas-.-bin.jar and jas-.-doc.jar can be generated from jas-.-src.jar.
The fastest way to get a complete JAS install, is 

> jar -xf jas-<version>-src.jar
> cd <JAS version number>
> jar -xf jas-<version>-bin.jar
> jar -xf jas-<version>-doc.jar

If you have a working ant, the last two steps can be replaced by

> ant compile
> ant doc

provided you have setup build.xml and the required libraries.


Directory structure
-------------------

.          main dirrectory, with html documentation
+doc       javadocs, jython docs, jruby docs
+edu       Java class files
+examples  examples for jython, jruby and jas
+images    images for html docs
+jython    JSR 233 scripting interface
+meditor   JSR 233 scripting interface for meditor
+src       source code
+test      junit test output and log4j output
+trc       junit test sources


$Id: README 3808 2011-10-21 20:26:04Z kredel $
