TOOLS: MetaMap

MetaMap Java API

The MetaMap Java API allows Java programs to access the MetaMap mapping engine. This release contains the set of Java Classes that comprise the API and the MetaMap's Mapping Engine Server.

In order to use the MetaMap Java API release the following packages are required:

MetaMap Full Download
The full version of MetaMap must be downloaded from MetaMap Full Download and installed before installing the Java API distribution.
Java Runtime Environment (JRE) 1.8 or later
Java Software Development Kit (SDK) 1.8 or later is required for use of the Java API. Java Runtime Environment (JRE 1.8) or later is the minimum required environment for running the API. Java is available from the "Developer Resources for Java Technology" website (http://www.java.com/).

There is brief documentation on Using the MetaMap Java API and JavaDoc Documentation for the MetaMap Java API

If you wish to modify the server portion of the API you'll need the MetaMap Sources Release as well.

The Java API Release (2020)

Linux:
MetaMap Java API Release for Linux (Bzip2 Tar - 60 MB) [sha1sum] [md5sum]
The 2020v2 Java API implementation adds UTF-8 support missing from the original 2020 Java API implementation.
MetaMap Java API Release for Linux v2 (Bzip2 Tar - 60 MB) [sha1sum] [md5sum]

The Java API Release (2018)

Linux:
MetaMap Java API Release for Linux (Bzip2 Tar - 8 MB) [sha1sum] [md5sum]

The Java API Release (2016v2)

Linux:
MetaMap Java API Release for Linux (Bzip2 Tar - 8 MB) [sha1sum] [md5sum]
Mac OS/X:
MetaMap Java API Release for Mac OS/X (Tested on 10.11.6) (Bzip2 Tar - 5 MB) [sha1sum] [md5sum]

The Java API Release (2016)

Linux:
MetaMap Java API Release for Linux (Bzip2 Tar - 8 MB) [sha1sum] [md5sum]
Mac OS/X:
MetaMap Java API Release for Mac OS/X (Tested on 10.8) (Bzip2 Tar - 6 MB) [sha1sum] [md5sum]
Updated MetaMap API Jar:
An new MetaMap API Jar which contains updated versions of Phrase interface and PhraseImpl class which provides a new getMincoMan method that allows access to the underlying PrologBeans representation of the MincoMan result of the PhaseX minimal commitment parser. Reference: Aronson, Alan R.; Thomas C. Rindflesch; and Allen C. Browne. 1994. Exploiting a large thesaurus for information retrieval. Proceedings of RIAO, 197-216. Traversing the representation requires use of the SICStus PrologBeans API. An example of using the getMincoMan method is available in the Java source program MincoManExample.java.

MetaMap API Jar (Java Archive - 93KB) [sha1sum] [md5sum]

The Java API Release (2014)

Java API bugfix

Important Note: For Users who have downloaded the MetaMap 2014 Java API before Sept 12th, 2014.

Two bugs were discovered in the Java API distribution, one which can cause the MetaMap server process to run slowly and one which can cause the Java client of the API to crash if a user-defined Acronym or Abbreviation is present in the input document. The Java API distributions for Linux, Mac OS/X, and Windows have been updated as of Sept 12th, 2014 4:30pm EDT.

Linux:
MetaMap Java API Release for Linux (Bzip2 Tar - 16 MB) [sha1sum] [md5sum]
MetaMap Java API Release for Linux (64-bit) (Bzip2 Tar - 16 MB) [sha1sum] [md5sum]
Windows XP and Windows 7
MetaMap Java API Release for Win32 (Zip format - 16 MB) [sha1sum] [md5sum]
MetaMap Java API Release for Win32 (7-Zip format - 16 MB) [sha1sum] [md5sum]
Mac OS/X:
MetaMap Java API Release for Mac OS/X (Tested on 10.8) (Bzip2 Tar - 6 MB) [sha1sum] [md5sum]

The Java API Release (2013v2)

Linux:
MetaMap Java API Release for Linux (Bzip2 Tar - 16 MB) [sha1sum] [md5sum]
MetaMap Java API Release for Linux (64-bit) (Bzip2 Tar - 16 MB) [sha1sum] [md5sum]
Windows XP and Windows 7
MetaMap Java API Release for Win32 (7-Zip format - 16 MB) [sha1sum] [md5sum]
MetaMap Java API Release for Win32 (Zip format - 16 MB) [sha1sum] [md5sum]
Mac OS/X:
MetaMap Java API Release for Mac OS/X (Tested on 10.8) (Bzip2 Tar - 6 MB) [sha1sum] [md5sum]

Clojure Wrapper for Java API Release (2013v2)

This requires the MetaMap Full Download and the MetaMap Java API.

Preparing the MetaMap Java API for use with Leiningen:

After installing the Full download and the Java API, install the MetaMap API jar and its supporting libraries into Maven using the following commands:

First install PrologBeans into Maven repository:

$ mvn install:install-file \
-Dfile=<parent>/public_mm/src/javaapi/dist/prologbeans.jar \
-DgroupId=se.sics -DartifactId=prologbeans -Dversion=4.2.1 \
-Dpackaging=jar
Then install the MetaMap API:
$ cd <parent>/public_mm/src/javaapi
$ mvn install
To use it in a Leiningen project add [metamap-api/metamap-api "1.0-SNAPSHOT"] to the :dependencies section of the project.clj file.
For all platforms
MetaMap API Clojure Wrapper (Bzip2 Tar - 52Kb)

The Java API Release (2013)

Linux:
MetaMap Java API Release for Linux (Bzip2 Tar - 16 MB) [sha1sum] [md5sum]
Windows XP and Windows 7
MetaMap Java API Release for Win32 (7-Zip format - 16 MB) [sha1sum] [md5sum]
Mac OS/X:
MetaMap Java API Release for Mac OS/X (Tested on 10.6 and 10.8) (Bzip2 Tar - 6 MB) [sha1sum] [md5sum]