Sub-Term Mapping Tools

Mapping Tool (mt)

- Introduction
- Set Up
- Test Run
- Input
- Output
- Options

Introduction

Mt (Mapping Tool) is used in STMT to find following table lookup mapping:

• map a term to CUIs
• map a term to EUIs
• map a term to synonyms
• map a term to recursive synonyms

• map a CUI to preferred term

Set Up

Follow the installation instructions to install and run the mt program. Check on the following items only if you don't use the provided script to install Sub-Term Mapping Tools.

• CLASSPATH:
  1. include the STMT distribution jar file, ${STMT_DIR}/lib/stmt${YEAR}dist.jar, in your CLASSPATH.
  2. include the stmt top directory in your CLASSPATH.

• Configuration File: assign the full path of the top directory of stmt${YEAR} to a variable named ROOT_DIR in the configuration file, data/Config/stmt.properties.

• Lvg Configuration File: set the lvg configuration file (LVG_CONFIG_FILE) to the default (data/Config/lvg.properties) or your installed lvg directory in the stmt configuration file.

Test Run

• Run java program

  Enter the command:

  > mt -p
  - Please input a term (type "Ctl-d" to quit) >
  disease
  --- CUIs ---
  C0012634
  
  --- EUIs ---
  E0023270
  
  --- Synonyms ---
  conditions
  dis
  diseases due to
  disorder
  illness
  infection
  mal
  problem
  syndrome
  

  where:

  • mt: mt script to run Mapping Tool Java class
  • -p: set mt system option to show prompt (try -h option!)

Input

Free text (a word or term)

Output

Mapping results (CUI, EUI, Synonyms, etc.) of the input term

Options

Please refer to design document