|
Open Source
Contributions Table
of Contents Published: October
21, 2002 |
JNumeric
|
Open Source
Contributions Table
of Contents Published: October
21, 2002 |
Note: This is the README document that comes with JNumeric found at: http://jnumerical.sourceforge.net/
WHAT IS JNUMERIC?
-----------------
JNumeric provides the functionality for JPython that Numeric does for
CPython. As the Numeric documentation states, Numeric is "...a
collection of extension modules to provide high-performance
multidimensional numeric arrays to the Python programming language."
JNumeric provides the same functionality as the core of Numeric
module and aims to provide akk of the standard extensions to
Numeric modules (FFT, LinearAlgebra, RandomArray).
BUILDING
---------
Go to src and type "make". The jar file should appear in the
release directory.
INSTALLATION (JEDIT)
--------------------
Assuming you are using jEdit with the Jython interpreter, all
you have to do is drop the Numeric jar file to your jedit
jar directory. This may be ~/.jedit/jars. So here's how it
could go...
cd src
make
cd ../release
rm ~/.jedit/jars/jnumer*.jar
cp jnumer*.jar ~/.jedit/jars
Make sure you restart jEdit.
OBTAINING JNUMERIC
------------------
Our home page is found at
http://jnumerical.sourceforge.net
Also, please see the file DIFFERENCES.txt for a list of intentional
differences between JNumeric and CNumeric.
I highly recomend that you also download at JPython1.1b1 or later.
Earlier versions of JPython have a fairly serious bug in getslice.
WHENCE FROM HERE?
-----------------
In addition to tracking down any bugs, here are a couple of things
that I would like to do (or have done) with JNumeric at some point:
* Add the standard extensions (FFT, LinearAlgebra, and RandomArray).
* Cleaned up ufunc interface.
* Other assorted code cleanup.
I would realy love FFT, LinearAlgebra, or RandomArray code -- (if you're
interested in working on LinearAlgebrea let me know I have some preliminary
ideas for this).
INSTALLATION (General)
----------------------
Note: these notes where written by Tim who is no longer
maintaining the project. They may be obselete.
Add the exact location of the jnumeric.jar file to your Java
CLASSPATH, for example using Bash:
export CLASSPATH=$CLASSPATH:/home/me/jpythonstuff/jnumeric-0.2a1.jar/
That's it. I did this by modifying my jpython startup script to:
jview /cp:p C:/WINDOWS/JAVA/JPython-1.01/jpython.jar /cp:p C:/WINDOWS/JAVA/JPython-1.1/jnumeric-0.2a1.jar org.python.core.jpython $1 $2 $3 $4 $5 $6 $7 $8 $9
NOTE: if you have JNumeric-0.1 installed, you must remove it from
python's path before JNumeric-0.2 will work. This is probably set
in the registry as python.path. The signature of this error is an
inability to find the umath module.
If you have a better way to do this let me know -- I'd like to be
able to install without mucking with the classpath. (Actually there is
one way, drop BOTH the jpython.jar and jnumeric.jar files in the
jdk1.2.1/jre/lib/ext directory).
If you wish to recompile the source files: (1) you will need to grab
the full distribution instead of just the jar file, (2) you may need
to add jpython.jar to your classpath when you compile, (3) mail me if
(when) you get stuck.
COPYING
-------
All files in this distribution are Copyright (c) 1998 , 1989 Timothy
Hochberg except where indicated otherwise in the source. Do not
redistribute without an unmodified copy of this file. This code
provided in the hope that it will be useful, however it comes with no
warranty of any kind. See LICENCE.txt.
Note: Some recent code might be copyrighted by D. Lemire or D. Bagnell
but given the licensing scheme, copyright disputes are irrelevant.
Enjoy!
____
Current maintainer: Daniel Lemire (lemire@ondelette.com)
Previous maitainer and founder: Tim Hochberg
Developer: Drew Bagnell
Additional
documentation, product downloads and updates are at
www.PushToTest.com.
While the TestMaker software is distributed under
an open-source license, the documentation remains
(c) 2002 PushToTest. All rights
reserved.
