MetaMap is a highly configurable program that maps biomedical text to concepts in the UMLS Metathesaurus 1. This guide is designed to help install MetaMap on the Linux operating system.
Important: Users are responsible for compliance with the MetaMap Terms and Conditions.
To use this application, you must have signed the UMLS agreement. The UMLS agreement requires those who use the UMLS to file a brief report once a year to summarize their use of the UMLS. It also requires the acknowledgment that the UMLS contains copyrighted material and that those copyright restrictions be respected. The UMLS agreement requires users to agree to obtain agreements for EACH copyrighted source prior to it's use within a commercial or production application.
To download MetaMap, you must have access to an UTS account. For information on how to acquire an UTS account, please see the UMLS Terminology Services Page.
MetaMap requires a minimum of 8GB of space to run.
The public distribution can be downloaded at:
Use the following tar command extract the distribution:
% tar xvfj public_mm_{os}_{year}.tar.bz2
Tar will create the distribution directory public_mm.
To begin the initial install, go to the directory created when you extracted the distribution (public_mm). You can speed up the process by telling the install program where your java installation is by setting the environment variable JAVA_HOME to the Java installation directory. If you don't set the variable the program will prompt you for the information.
To file out where your java installation is located type of the command line:
% which java
To set the environment variable JAVA_HOME:
If the command: which java returns /usr/local/jre1.4.2/bin/java, then JAVA_HOME should be set to /usr/local/jre1.4.2/.
For example:
# in C Shell (csh or tcsh) setenv JAVA_HOME /usr/local/jre1.4.2 # in Bourne Again Shell (bash) export JAVA_HOME=/usr/local/jre1.4.2 # Bourne Shell (sh) JAVA_HOME=/usr/local/jre1.4.2 export JAVA_HOME
You also need to add the public_mm/bin directory to your program path:
# in C Shell (csh or tcsh) set path = ( $path <public_mm's parent dir>/public_mm/bin ) # in Bourne Again Shell (bash) export PATH=$PATH:<public_mm's parent dir>/public_mm/bin # Bourne Shell (sh) PATH=$PATH:<public_mm's parent dir>/public_mm/bin export PATH
Run the installation script as follows:
% cd public_mm % ./bin/install.sh
An example of a successful installation looks as follows:
$ cd /nfsvol/nlsaux15/public_mm $ bin/install.sh 1 1 Enter basedir of installation [/nfsvol/nlsaux15/public_mm] Basedir is set to /nfsvol/nlsaux15/public_mm. The WSD Server requires Sun's Java Runtime Environment (JRE); Sun's Java Developer Kit (JDK) will work as well. if the command: "which" java returns /usr/local/jre1.4.2/bin/java, then the JRE resides in /usr/local/jre1.4.2/. Where does your distribution of Sun\'s JRE reside? Enter home path of JRE (JDK) [/usr/local/jdk1.6.0_11]: Using /usr/local/jdk1.6.0_11 for JAVA_HOME. /nfsvol/nlsaux15/public_mm/WSD_Server/config/disambServer.cfg generated /nfsvol/nlsaux15/public_mm/WSD_Server/config/log4j.properties generated Setting up bin directory scripts: /nfsvol/nlsaux15/public_mm/bin/BuildDataFiles generated. /nfsvol/nlsaux15/public_mm/bin/builddatafiles.sh generated. /nfsvol/nlsaux15/public_mm/bin/dfbuilder.profile generated. /nfsvol/nlsaux15/public_mm/bin/filter_mrconso generated. /nfsvol/nlsaux15/public_mm/bin/form_opt generated. /nfsvol/nlsaux15/public_mm/bin/linkSICStus generated. /nfsvol/nlsaux15/public_mm/bin/LoadDataFiles generated. /nfsvol/nlsaux15/public_mm/bin/loaddatafiles.sh generated. /nfsvol/nlsaux15/public_mm/bin/make_all generated. /nfsvol/nlsaux15/public_mm/bin/metamap11.custom generated. /nfsvol/nlsaux15/public_mm/bin/metamap11 generated. /nfsvol/nlsaux15/public_mm/bin/metamap2011.TEMPLATE generated. /nfsvol/nlsaux15/public_mm/bin/mmserver11 generated. /nfsvol/nlsaux15/public_mm/bin/rundatafiles.sh generated. /nfsvol/nlsaux15/public_mm/bin/SKRenv.11 generated. /nfsvol/nlsaux15/public_mm/bin/skrmedpostctl generated. /nfsvol/nlsaux15/public_mm/bin/SKRrun.11 generated. /nfsvol/nlsaux15/public_mm/bin/testapi.sh generated. /nfsvol/nlsaux15/public_mm/bin/wsdserverctl generated. Setting up test suite: /nfsvol/nlsaux15/public_mm/TestSuite/runTest_2011.sh generated. Checking for required datafiles Checking for optional datafiles (WSD) Public MetaMap Install complete. Public MetaMap Install Settings: Public MetaMap basedir: /nfsvol/nlsaux15/public_mm Public MetaMap Program Dir: /nfsvol/nlsaux15/public_mm/bin Java Home dir: /usr/local/jdk1.6.0_11 $
MetaMap requires the starting of two servers, The Part-of-Speech Tagger and Word Sense Disambiguation (WSD) Servers. They can be started and stopped as follows:
Before running MetaMap you need to start the Tagger and WSD servers. Both servers will automatically run in the background when started.
% ./bin/skrmedpostctl start
% ./bin/wsdserverctl start
You can stop the each server by invoking the corresponding script with the stop parameter:
% ./bin/skrmedpostctl stop
% ./bin/wsdserverctl stop
You can determine if the server are running by the command:
% ps ax | grep java
The output should look something like this:
16105 pts/0 Sl 0:00 /usr/local/jdk1.6.0_01/bin/java -Xmx2g -Dserver.config... 16158 pts/0 R+ 0:00 grep java 21914 pts/0 Sl 0:02 /usr/bin/gij -Djava.version=1.4.2 -Djava.home=/usr/lib/... %
If there are no errors starting the WSD and Tagger servers then MetaMap can be run as follows:
% ./bin/metamap11
If you're using the pre-release version of MetaMap 11 use the following command:
% ./bin/metamap11 -L 11 -Z 10
MetaMap has a plethora of options that are explained elsewhere. 2
For users who wish to use there own datasets with MetaMap, a datafile builder suite is now available. Go to the MetaMap Web Site (http://metamap.nlm.nih.gov/) for more information.
If you have problems then send email to mmtx@nlm.nih.gov.
For more information on running MetaMap and its many options, please see these references:
[1] - MetaMap: Mapping Text to the UMLS Metathesaurus, July 2006, http://skr.nlm.nih.gov/papers/references/metamap06.pdf
[2] - MetaMap 2009 Usage, http://metamap.nlm.nih.gov/Docs/MM09_Usage.shtml
This document was generated using AFT v5.098