Because of a lapse in government funding, the information on this website may not be up to date, transactions submitted via the website may not be processed, and the agency may not be able to respond to inquiries until appropriations are enacted. The NIH Clinical Center (the research hospital of NIH) is open. For more details about its operating status, please visit cc.nih.gov. Updates regarding government operating status and resumption of normal operations can be found at OPM.gov.

Lexical Tools

Manual Installation Instructions

Introduction

This page shows what the Lexical Tools installation script does. A manual installation can be performed to replace the installation script when needed (such as installing Lvg in Mac). It is not recommended for general users to install the Lexical Tools manually. Please refer to installation instructions for installing the Lexical Tools.

Prerequisites

  • Archive program:
    • Unix: gtar
    • Windows: WINZIP
  • JRE V 1.8.0_202
  • 100 MB ram
  • 4.0 GB disk space

Install

  1. Create a new directory for the Lexical tool on your machine.
  2. Download the zip archive: lvg${YEAR}.tgz, and place it in the newly created directory. "${YEAR}" is the version identification (year).
  3. Uncompress or Unzip the archive. Be careful to use a version of unzip that allows long filenames and that will recreate the full directory structure.

    You should now have six files and nine sub-directories under lvg${YEAR}, as shown in follows:

    • build.xml
    • install_linux.sh
    • install_win.bat
    • overview.html
    • ReadMe.txt
    • SPECIALIST_NLP_TOOLS_TERMS_AND_CONDITIONS.txt

    • /bin
    • /data
    • /docs
    • /examples
    • /install
    • /lib
    • /loadDb
    • /logs
    • /sources

Please refer to Repository Lists for details.

Setup

I. JRE/Java

  • The default installation script install java under ${LVG_DIR}/bin/jre1.8.0_202/bin/java for Linux
  • Users should upgrade Java to 1.8+ themselves
  • Users may use existing Java in their computer if the version is 1.8+
  • 32-bit JRE (jre-8u202-linux-i586.tar.gz) needs to be installed if a 32-bit computer is used to run Lexical Tools (not recommended!)

II. Command Line scripts:
Manually modify shell scripts, fields, lgt, luiNorm, lvg, norm, toAscii, and wordInd, under ${LVG_DIR}/bin/ as follows:

VariableValueExample
JAVAThe JRE/bin/java you will use
  • JAVA=/Projects/lvg2025/bin/jre1.8.0_202/bin/java
  • JAVA=java
LVG_DIRThe full path of the top directory of lvg2025 LVG_DIR=/Projects/lvg2025
CLASSPATHIncludes:
  • lib/lvg2025dist.jar
    => lvg2025dist.jar includes classes of norm, luiNorm, lvg, wordInd, toAscii, lgt, all lvg API classes, jdbc driver of HSqlDb, and IBM icu4j.jar library
  • ${LVG_DIR}
    => the full path of the top directory of lvg2025, this allows lvg to find the default configuration file, data/config/lvg.properties
CLASSPATH=${LVG_DIR}:${LVG_DIR}/lib/lvg2025dist.jar

III. Configuration file:
Manually modify configuration file, ${LVG_DIR}/data/config/lvg.properties, as follows:

VariableValueExample
LVG_DIRThe full path of the top directory of lvg2025 LVG_DIR=/Projects/lvg2025

Make sure values of database variables are setup appropriately in the configuration file, see configuration setup for details

Now you are ready for running norm, luiNorm, wordInd, toAscii, lvg, fields, and lgt.