JAS: Java Algebra System ======================== Version 2.7, 2023 by Heinz Kredel, University of Mannheim, kredel at rz.uni-mannheim.de Copyright (c) 2000-2023 by Heinz Kredel. Programms released under GPL or LGPL, see COPYING.jas or COPYING.lgpl.jas. Web home-page: http://krum.rz.uni-mannheim.de/jas/ Requirements ------------ A Java JDK 1.11. Documentation see index.html. Required libraries are log4j-core-2.17.1.jar, log4j-api-2.17.1.jar (from Apache Log4j2 or jars from some other compatible logging framework like SLF4J) and junit-4.12.jar, hamcrest-core-1.3.jar (from Junit 4 for tests in trc) Usage ----- > java -cp {other_jar_files}:jas-<version>-bin.jar:. <sample class> for example > java -cp ../lib/log4j-core-2.17.1.jar:../lib/log4j-api-2.17.1.jar:jas-2.6.5428-bin.jar edu.jas.application.RunGB seq examples/trinks7.jas or > jruby examples/<some input file>.rb or > jas examples/<some input file>.rb for example > ./jas examples/all_rings.rb or > jython examples/<some input file>.py or > jas -py examples/<some input file>.py The shell script "jas" figures out the Java, jruby, jython and JAS environment and runs the respective scripting interpreter. See > man -l doc/jas.1 for more information. Compilation of your own Java files using the JAS library can be done with the "javac" command. > javac -cp {other_jar_files}:jas-<version>-bin.jar:. <your sample code> Versions and jar files ---------------------- JAS is distributed in 3 jar files: jas-<version>-bin.jar: or jas-<version>.jar: the Java class files jas-<version>-src.zip: the java source code jas-<version>-doc.zip: the Java doc, epydoc, jrdoc and more info files optional jar files which require further installed packages: jas-meditor.jar: the interface to meditor jas-jython.jar: an interface for Java scripting jas-mpj.jar: MPI Java depending code mylog.jar: a substitute for log4j to use Java logging nolog.jar: a substitute for log4j to disable any logging droidlog.jar: a substitute for log4j to use Android logging jlinalg_adapter.jar: an adaptor to parts of JLinAlg commons-math_adapter.jar: an adaptor to parts of Apache commons.math pre packaged JAS versions: jas-java_<version>-all.deb a Debian 10 (buster) package usable in MathLibre ruboto-irb-jas-release.apk an Android App based on Ruboto (defunct) There are GIT repositories for the scource code, which can be cloned with > git clone http://krum.rz.uni-mannheim.de/jas.git jas or > git clone https://github.com/kredel/java-algebra-system.git jas There is a Maven compatible repository for bytecode, source and javadocs at https://oss.sonatype.org/ groupId: de.uni-mannheim.rz.krum, artifactId: jas, version (for example): 2.7.50 The version is specified by a two digit major.minor number and a revision number. The revision number was the subversion revision number, but with git it is just a consecutive number. For example in jas-2.7.80-bin.jar "2.7" is the JAS version number and "80" is the git 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.zip > cd <JAS version number> > jar -xf jas-<version>-bin.jar > jar -xf jas-<version>-doc.zip If you have a working Ant with Ivy, the last two steps can be replaced by > ant resolve > ant compile > ant doc provided you have setup build.xml, ivy.xml for the required libraries. Directory structure ------------------- . main directory, entry to html documentation +doc html documentation, 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 +mpj MPI Java versions of distributed Groebner bases +mpi OpenMPI Java versions of distributed Groebner bases +jlinalg_adaper some adapter classes to JLinAlg +commons-math_adaper some adapter classes to Apache Commons Math3 +src source code +trc junit test sources +test junit test output and log4j output ../lib directory for required libraries, not included $Id$