Skip to content

Latest commit

 

History

History
56 lines (38 loc) · 2.14 KB

README-D4M.md

File metadata and controls

56 lines (38 loc) · 2.14 KB

d4m_api_java

D4M_API is set of D4M scripts that enable the storage and retrieval of associative arrays into a database.

Requirements

  • Matlab (or GNU Octave 3.2.2+ with Java package 1.2.6+)
  • Accumulo 1.6.0+

Building

Build Status Build Status

The maven script will build everything completely on Unix-like systems. On Windows systems, DBinit.m may not be built. See the message in the build after running mvn package.

mvn package -DskipTests=true to compile and build JARs, skipping tests.

Testing

Java tests are mostly broken.

Using

To add to a D4M installation:

  1. Copy target/d4m_api_java-VERSION.jar into d4m_api/lib.
  2. Extract target/libext-VERSION.zip into d4m_api.
  3. Move d4m_api/DBinit.m into d4m_api/matlab_src.

Add the following to your ~/matlab/startup.m file (or ~/.octaverc file).

  addpath('<ParentDir>/d4m_api/matlab_src');  % Replace <ParentDir> with location of d4m_api.
  DBinit;    % Initalizes java path.  NOTE: Octave requires Java package be installed.

Testing in Matlab D4M

  • Edit d4m_api/matlab_src/TEST/DBsetup.m to use connection information for your Accumulo instance.
  • Start Matlab (or octave --traditional).
  • cd to d4m_api/matlab_src/TEST, and run any script ending in TEST.m
  • To run all tests, type Atest = runTESTdir('./')