4

I set out to install some fast matrix and BLAS libraries for Java, and settled on MTJ (backed by netlib-java) based on the results of Java Matrix Benchmark. I believe I have everything installed via Maven, but I can't find any credible documentaiton for these libraries.

The logical starting point would be the github pages:

MTJ

netlib

...But I can't find a link to any tutorials or javadoc beyond the incredibly terse MTJ wiki section on Github. Netlib's source appears to be in fortran (with F2J as a compilation step) so I can't crawl directly though source in lieu of javadoc, either.

To make things even more baffling, there appears to be some sort of Javadoc for MTJ out there hosted by a German university for some reason, that references packages (like nni.BLAS) that don't appear to be part of the MTJ library that Maven made for me. There's another even sketchier Javadoc hosted somewhere inside the University of Tennessee that, while having no apparent connection to the netlib-java project, does somehow have a Javadoc page that seems to explain the three extra integer arguments that netlib-java's DGEMV implementation uses (offsets of some sort?). If I look at the fortran documentation inside the netlib-java distribution for DGEMV, it has the eleven standard arguments that I would expect from DGEMV.

So here are my questions:

1.) Is there official documentation for MTJ/netlib? If so, where?

2.) If there is no official documentation, are there any other resources out there that would allow someone to learn to use this library? If this project isn't used exclusively by the developers, then people are learning to use it somehow. How?

3.) If a Java version of netlib's 11-argument DGEMV isn't installed as part of MTJ via Maven, then what is this 14-argument thing on my hard drive?

Thanks.

Community
  • 1
  • 1
amm
  • 343
  • 3
  • 11
  • in the current version there are numerous tests under src/test/java, so one may see how the various methods are invoked; besides there are javadoc comments which briefly explain what is being implemented (for example, the javadoc of BiCG solver reads "BiCG solver. BiCG solves the unsymmetric linear system Ax = b * using the Preconditioned BiConjugate Gradient method.") – John Donn Jan 15 '16 at 09:27

4 Answers4

1

If you download MTJ via Maven, you can also download the Javadoc and source jars at that time. (IntelliJ IDEA will do this for you automagically.) The jar is called mtj-1.0.2-javadoc.jar and contains comprehensive Javadoc. Once upon a time, this seemed to be available on a website, but that site seems to be gone.

David Bruce Borenstein
  • 1,655
  • 2
  • 19
  • 34
0

The closest I've seen so far: http://en.wikipedia.org/wiki/Matrix_Toolkit_Java

Santi Peñate-Vera
  • 1,053
  • 4
  • 33
  • 68
0

Here is link to jar archive with complete javadoc of latest stable MTJ. Just unzip it with tool such 7zip or similar. I agree that lack of guides related to this library might be dauting.

libnull-dev
  • 881
  • 1
  • 7
  • 19
0

I have created a site for mtj 1.0.3-snapshot on divshot.io:

http://mtj103.divshot.io/

Hope this helps.

qed
  • 22,298
  • 21
  • 125
  • 196
  • The website seems to be down. Is there another address where it can be found? Is this actual documentation or javadoc? – Ben Sep 06 '16 at 15:34