694 lines
45 KiB
HTML
694 lines
45 KiB
HTML
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<!doctype html>
|
||
<html lang="en">
|
||
<head>
|
||
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
|
||
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
|
||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>
|
||
<link rel="preconnect" href="https://fonts.googleapis.com">
|
||
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
||
<link href="https://fonts.googleapis.com/css2?family=Roboto:wght@100;300;400;500;700&display=swap" rel="stylesheet">
|
||
<link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.0.10/css/all.css" integrity="sha384-+d0P83n9kaQMCwj8F4RJB66tzIwOKmrdb46+porD/OvrJ+37WqIM7UoBtwHO6Nlg" crossorigin="anonymous">
|
||
<link rel="schema.DC" href="http://purl.org/dc/elements/1.1/" title="The Dublin Core metadata Element Set" />
|
||
|
||
<script src="https://assets.nlm.nih.gov/uswds/js/uswds-init.min.js"></script>
|
||
<link rel="stylesheet" href="/home_assets/uswds/css/styles.css">
|
||
|
||
<title>UMLS - MetamorphoSys Help</title>
|
||
<link rel="schema.DC" href="http://purl.org/dc/elements/1.1/" title="The Dublin Core metadata Element Set" />
|
||
<meta name="DC.Title" content="MetamorphoSys Help" />
|
||
|
||
<meta name="DC.Publisher" content="U.S. National Library of Medicine" />
|
||
<meta name="DC.Date.Issued" content="2009-09-02" />
|
||
<meta name="DC.Date.Modified" content="2022-11-21" />
|
||
<meta name="NLMDC.Date.LastReviewed" content="2019-04-25" />
|
||
<meta name="NLM.Contact.Email" content="nlmumlscustserv@mail.nlm.nih.gov" />
|
||
<meta name="DC.Type" content="Technical Documentation" />
|
||
<meta name="NLM.Permanence.Level" content="Permanence Not Guaranteed" />
|
||
<meta name="DC.Rights" content="Public Domain" />
|
||
<meta name="DC.Language" content="eng" />
|
||
|
||
<meta name="keywords" content="Unified Medical Language System, UMLS" />
|
||
<meta name="description" content="The UMLS integrates and distributes key terminology, classification and coding standards, and associated resources to promote creation of more effective and interoperable biomedical information systems and services, including electronic health records. " />
|
||
|
||
<link href="/scripts/videojs/css/videojs.min.css" rel="stylesheet" type="text/css">
|
||
<!-- Google Tag Manager --><script>(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push(
|
||
{'gtm.start': new Date().getTime(),event:'gtm.js'}
|
||
);var f=d.getElementsByTagName(s)[0],j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src='//www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);})(window,document,'script','dataLayer','GTM-MT6MLL');</script>
|
||
<!-- End Google Tag Manager -->
|
||
</head>
|
||
<body>
|
||
<!-- Google Tag Manager -->
|
||
<noscript><iframe src="//www.googletagmanager.com/ns.html?id=GTM-MT6MLL" height="0" width="0" style="display:none;visibility:hidden" title="googletagmanager"></iframe></noscript>
|
||
<!-- End Google Tag Manager -->
|
||
<!-- TOP NAV -->
|
||
<a class="usa-skipnav" href="#main">Skip to main content</a>
|
||
<div class="usa-banner site-banner" aria-label="Official government website">
|
||
<div class="usa-accordion">
|
||
<header class="usa-banner__header">
|
||
<div class="usa-banner__inner">
|
||
<div class="grid-col-auto"> <img class="usa-banner__header-flag" src="https://assets.nlm.nih.gov/uswds/img/us_flag_small.png" alt="U.S. flag"/> </div>
|
||
<div class="grid-col-fill tablet:grid-col-auto">
|
||
<p class="usa-banner__header-text"> An official website of the United States government </p>
|
||
<p class="usa-banner__header-action" aria-hidden="true"> Here’s how you know </p>
|
||
</div>
|
||
<button class="usa-accordion__button usa-banner__button" aria-expanded="false" aria-controls="gov-banner"> <span class="usa-banner__button-text">Here’s how you know</span> </button>
|
||
</div>
|
||
</header>
|
||
<div class="usa-banner__content usa-accordion__content" id="gov-banner">
|
||
<div class="grid-row grid-gap-lg">
|
||
<div class="usa-banner__guidance tablet:grid-col-6"> <img class="usa-banner__icon usa-media-block__img" src="https://assets.nlm.nih.gov/uswds/img/icon-dot-gov.svg" role="img" alt="" aria-hidden="true"/>
|
||
<div class="usa-media-block__body">
|
||
<p> <strong> Official websites use .gov </strong> <br />
|
||
A <strong>.gov</strong> website belongs to an official government
|
||
organization in the United States. </p>
|
||
</div>
|
||
</div>
|
||
<div class="usa-banner__guidance tablet:grid-col-6"> <img class="usa-banner__icon usa-media-block__img" src="https://assets.nlm.nih.gov/uswds/img/icon-https.svg" role="img" alt="" aria-hidden="true"/>
|
||
<div class="usa-media-block__body">
|
||
<p> <strong> Secure .gov websites use HTTPS </strong> <br />
|
||
A <strong>lock</strong> ( <span class="icon-lock">
|
||
<svg xmlns="http://www.w3.org/2000/svg" width="52" height="64" viewBox="0 0 52 64" class="usa-banner__lock-image" role="img" aria-labelledby="banner-lock-title-default banner-lock-description-default" focusable="false">
|
||
<title id="banner-lock-title-default">Lock</title>
|
||
<desc id="banner-lock-description-default">A locked padlock</desc>
|
||
<path fill="#000000" fill-rule="evenodd" d="M26 0c10.493 0 19 8.507 19 19v9h3a4 4 0 0 1 4 4v28a4 4 0 0 1-4 4H4a4 4 0 0 1-4-4V32a4 4 0 0 1 4-4h3v-9C7 8.507 15.507 0 26 0zm0 8c-5.979 0-10.843 4.77-10.996 10.712L15 19v9h22v-9c0-6.075-4.925-11-11-11z"/>
|
||
</svg>
|
||
</span> ) or <strong>https://</strong> means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites. </p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
<!-- HEADER -->
|
||
<header id="siteheader" class="usa-header usa-header--basic">
|
||
<div class="usa-nav-container tablet:padding-x-4 mobile-lg:padding-x-2 padding-y-1">
|
||
<div class="grid-row padding-y-105">
|
||
<div class="grid-col-8 desktop:grid-col-4 tablet-lg:grid-col-4 tablet:grid-col-6"> <a href="https://www.nlm.nih.gov/"> <img src="https://assets.nlm.nih.gov/uswds/img/NLM_White.png" alt="NLM logo" class="logo margin-top-1"> </a> </div>
|
||
<div class="desktop:grid-col-4 desktop:grid-offset-4 tablet-lg:grid-col-6 tablet-lg:grid-offset-2 tablet:grid-col-6 grid-col-12">
|
||
<form class="usa-search desktop:margin-top-2 tablet:margin-top-2 mobile:margin-top-1" role="search" data-gtm-form-interact-id="0" method="get" action="//vsearch.nlm.nih.gov/vivisimo/cgi-bin/query-meta" target="_self" name="searchForm" id="searchForm2">
|
||
<input class="usa-input ui-autocomplete-input" aria-label="Search" type="search" name="query" data-gtm-form-interact-field-id="0" id="search2" autocomplete="off" placeholder="Search NLM" >
|
||
<input type="hidden" name="v:project" value="nlm-main-website">
|
||
<button class="usa-button border border-top border-bottom border-right border-white" role="button" aria-label="Search" type="submit"> <span class="usa-search__submit-text"> <i class="fas fa-search"></i> </span> </button>
|
||
</form>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</header>
|
||
<div class="bg-secondary insertCOOP">
|
||
<div class="usa-nav-container">
|
||
<div class="usa-navbar ">
|
||
<button class="usa-menu-btn">Menu</button>
|
||
</div>
|
||
<nav aria-label="Primary navigation" class="usa-nav">
|
||
<button class="usa-nav__close"><img src="https://assets.nlm.nih.gov/uswds/img/close.svg" alt="close"></button>
|
||
<ul class="usa-nav__primary usa-accordion insertNav">
|
||
|
||
<li class="usa-nav__primary-item desktop-lg:margin-x-5 desktop:margin-x-3 tablet:margin-x-0">
|
||
<button type="button" class="usa-accordion__button usa-nav__link usa-current" aria-expanded="false" aria-controls="basic-nav-section-one"> <span>Products and Services <i class="fas fa-caret-down margin-left-05"></i> </span> </button>
|
||
<ul id="basic-nav-section-one" class="usa-nav__submenu bg-secondary" hidden="">
|
||
<li class="usa-nav__submenu-item"> <a href="//eresources.nlm.nih.gov/nlm_eresources/"><span>All Products and Services</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="//clinicaltrials.gov/"><span>ClinicalTrials.gov</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="//collections.nlm.nih.gov/"><span>Digital Collections</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="//catalog.nlm.nih.gov"><span>LocatorPlus Catalog</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="//meshb.nlm.nih.gov/search"><span>Medical Subject Headings (MeSH)</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="//medlineplus.gov/"><span>MedlinePlus</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="//pubmed.ncbi.nlm.nih.gov/"><span>PubMed/MEDLINE</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="//uts.nlm.nih.gov/uts/"><span>Unified Medical Language System (UMLS)</span></a> </li>
|
||
</ul>
|
||
</li>
|
||
<li class="usa-nav__primary-item desktop-lg:margin-x-5 desktop:margin-x-3 tablet:margin-x-0">
|
||
<button type="button" class="usa-accordion__button usa-nav__link usa-current" aria-expanded="false" aria-controls="basic-nav-section-two"> <span> Resources for You <i class="fas fa-caret-down margin-left-05"></i></span> </button>
|
||
<ul id="basic-nav-section-two" class="usa-nav__submenu bg-secondary" hidden="">
|
||
<li class="usa-nav__submenu-item"> <a href="https://www.nlm.nih.gov/portals/researchers.html"><span>For Researchers</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="https://www.nlm.nih.gov/portals/publishers.html "><span>For Publishers</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="ttps://www.nlm.nih.gov/portals/librarians.html"><span>For Librarians</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="https://www.nlm.nih.gov/training.html "><span>For Educators/Trainers </span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="https://www.nlm.nih.gov/portals/healthcare.html"><span>For Health care Professionals</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="//www.nlm.nih.gov/portals/public.html "><span>For the Public</span></a> </li>
|
||
</ul>
|
||
</li>
|
||
<li class="usa-nav__primary-item desktop-lg:margin-x-5 desktop:margin-x-3 tablet:margin-x-0">
|
||
<button type="button" class="usa-accordion__button usa-nav__link usa-current" aria-expanded="false" aria-controls="basic-nav-section-three"> <span>Explore NLM <i class="fas fa-caret-down margin-left-05"></i> </span> </button>
|
||
<ul id="basic-nav-section-three" class="usa-nav__submenu bg-secondary" hidden="">
|
||
<li class="usa-nav__submenu-item"> <a href="https://www.nlm.nih.gov/about/index.html"><span>About the Library</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="https://www.nlm.nih.gov/about/visitor.html"><span>Visit the Library</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="https://www.nlm.nih.gov/hmd/index.html"><span>History of Medicine</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="https://www.nlm.nih.gov/about/org.html"><span>NLM by Organization</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="https://www.nlm.nih.gov/news/newsandevents.html"><span>News, Events, and Updates</span></a> </li>
|
||
</ul>
|
||
</li>
|
||
<li class="usa-nav__primary-item desktop-lg:margin-x-5 desktop:margin-x-3 tablet:margin-x-0">
|
||
<button type="button" class="usa-accordion__button usa-nav__link usa-current" aria-expanded="false" aria-controls="basic-nav-section-four"> <span> Grants and Research <i class="fas fa-caret-down margin-left-05"></i> </span> </button>
|
||
<ul id="basic-nav-section-four" class="usa-nav__submenu bg-secondary" hidden="">
|
||
<li class="usa-nav__submenu-item"> <a href="https://www.nlm.nih.gov/ep/index.html"><span>NLM Extramural Programs</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="https://www.nlm.nih.gov/research/index.html"><span>NLM Intramural Research Program</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="https://www.ncbi.nlm.nih.gov/"><span>National Center for Biotechnology Information</span></a> </li>
|
||
<li class="usa-nav__submenu-item"> <a href="//lhncbc.nlm.nih.gov/"><span>Lister Hill National Center for Biomedical Communications</span></a> </li>
|
||
</ul>
|
||
</li>
|
||
|
||
</ul>
|
||
</nav>
|
||
</div>
|
||
</div>
|
||
|
||
<!-- End of TOP NAV -->
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<!-- DIVISIONAL BANNER -->
|
||
|
||
<div class="bg-gray-70">
|
||
<div class="grid-container">
|
||
<div class="grid-row divisional">
|
||
|
||
|
||
|
||
|
||
<div class="grid-col text-white">
|
||
|
||
<div class="float-left">
|
||
<h4 class="margin-bottom-0">Unified Medical Language System<small><sup>®</sup></small> (UMLS<small><sup>®</sup></small>)</h4>
|
||
</div>
|
||
<div class="float-right margin-top-05">
|
||
<p>
|
||
|
||
|
||
|
||
<a class="text-white" href="/research/umls/quickstart.html">UMLS Quick Start Guide</a>
|
||
|
||
|
||
|
||
| <a class="text-white" href="/research/umls/faq_main.html">FAQs</a>
|
||
|
||
|
||
|
||
| <a class="text-white" href="/research/umls/support.html">Customer Support</a>
|
||
|
||
|
||
|
||
|
||
</p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<!--END DIVISIONAL BANNER -->
|
||
|
||
<!-- Breadcrumbs -->
|
||
<div class="grid-container">
|
||
<nav class="usa-breadcrumb usa-breadcrumb--wrap padding-top-1" aria-label="Breadcrumbs">
|
||
<ol class="usa-breadcrumb__list">
|
||
<li class="usa-breadcrumb__list-item"> <a href="/index.html" class="usa-breadcrumb__link"><span>Home</span></a> </li>
|
||
|
||
|
||
|
||
|
||
|
||
<li class="usa-breadcrumb__list-item"> <a href="/healthit" class="usa-breadcrumb__link"><span>Health IT</span></a> </li>
|
||
|
||
|
||
|
||
<li class="usa-breadcrumb__list-item"> <a href="/research/umls/" class="usa-breadcrumb__link"><span>UMLS</span></a> </li>
|
||
|
||
|
||
|
||
|
||
<li class="usa-breadcrumb__list-item"> <span>MetamorphoSys Help</span></li>
|
||
|
||
|
||
|
||
|
||
</ol>
|
||
</nav>
|
||
</div>
|
||
<!-- End Breadcrumbs -->
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<main class="padding-bottom-5" id="main">
|
||
<div class="grid-container">
|
||
|
||
|
||
|
||
<div class="grid-row">
|
||
|
||
<div class="col">
|
||
|
||
|
||
|
||
<div class="h1">MetamorphoSys Help</div>
|
||
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
|
||
|
||
</div>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<div class="row">
|
||
<div class="col-sm-6">
|
||
<p>MetamorphoSys is the UMLS installation wizard and Metathesaurus customization tool included in each UMLS release. MetamorphoSys installs one or more of the UMLS Knowledge Sources and enables you to create customized Metathesaurus subsets. Each
|
||
UMLS release includes an updated version of MetamorphoSys. Use only the version of MetamorphoSys distributed with the most current UMLS release.</p>
|
||
<ul>
|
||
<li><a href="#System_reqs">System Requirements </a></li>
|
||
<li><a href="#starting">Starting MetamorphoSys </a></li>
|
||
<li><a href="#screens_tabs">MetamorphoSys Screens and Tabs </a></li>
|
||
<li><a href="#output_options">Customizing the Metathesaurus Tabs</a></li>
|
||
<li><a href="#Filters">MetamorphoSys Metathesaurus Filters</a></li>
|
||
<li><a href="#Options_advanced">Options for Advanced Users</a></li>
|
||
<li><a href="#done">Completing a Subset</a></li>
|
||
</ul>
|
||
</div>
|
||
<div class="col-sm-6">
|
||
<h2>Install, Customize, and Subset the UMLS</h2>
|
||
<video class="video-js vjs-fluid vjs-default-skin"
|
||
|
||
controls=""
|
||
|
||
data-setup='{ "aspectRatio":"640:360"}'
|
||
|
||
id="player_one"
|
||
|
||
playsinline=""
|
||
|
||
poster="/research/umls/user_education/quick_tours/MMSys/CreateSubsetsN_First_Frame.png"
|
||
|
||
preload="none">
|
||
|
||
<source default=""
|
||
|
||
label="360p"
|
||
|
||
res="360"
|
||
|
||
src="/research/umls/user_education/quick_tours/MMSys/CreateSubsetsN.mp4"
|
||
|
||
type="video/mp4">
|
||
|
||
<track
|
||
|
||
kind="captions"
|
||
|
||
label="English Captions"
|
||
|
||
src="/research/umls/user_education/quick_tours/MMSys/CreateSubsetsN.vtt"
|
||
|
||
srclang="en">
|
||
|
||
</video>
|
||
|
||
</div>
|
||
|
||
</div>
|
||
<h2><a id="System_reqs" name="System_reqs"></a>System Requirements</h2>
|
||
<p>MetamorphoSys has been tested on the following operating systems:</p>
|
||
<ul>
|
||
<li>Windows 7 Enterprise, Vista, XP</li>
|
||
<li>Linux*</li>
|
||
<li>Macintosh OS X (Leopard, Snow Leopard)</li>
|
||
</ul>
|
||
<p>*Linux note: All releases are fully tested under Ubuntu Desktop. Other Linux releases may work equally well.</p>
|
||
<p>Hardware Requirements</p>
|
||
<ul>
|
||
<li>Minimum 30 GB of free hard disk space.</li>
|
||
<li>Minimum 2 GB of RAM, preferably more. Smaller memory size will cause virtual memory paging with exponentially increased processing time.</li>
|
||
<li>CPU speed of at least 2 GHz for reasonable installation times.</li>
|
||
</ul>
|
||
<p>Use a high-speed internet connection to <a href="//www.nlm.nih.gov/research/umls/licensedcontent/umlsknowledgesources.html">download</a> the files from the UMLS Web site. Download and extract all UMLS data and zip files to the same directory.</p>
|
||
<p>All file sizes are checked at installation. The Validate Distribution option allows users to verify the integrity of the downloaded .nlm files. It compares special MD5 signatures to those in the release MD5 and CHK files, and is a useful first step
|
||
for trouble-shooting when problems occur with a UMLS installation.</p>
|
||
<p>After the UMLS release is downloaded, <strong>it must include these files*, in the same directory</strong>:</p>
|
||
<ul>
|
||
<li>mmsys.zip (zipped MetamorphoSys application)</li>
|
||
<li>2016aa-1-meta.nlm (compressed Metathesaurus data)</li>
|
||
<li>2016aa-2-meta.nlm (compressed Metathesaurus data)</li>
|
||
<li>2016aa-otherks.nlm (compressed Semantic Network and SPECIALIST Lexicon)</li>
|
||
<li>2016AA.CHK</li>
|
||
<li>2016AA.MD5</li>
|
||
<li>Copyright_Notice.txt</li>
|
||
<li>README.txt</li>
|
||
</ul>
|
||
<p>You must unzip mmsys.zip to the same directory as the other downloaded files. Once you unzip the file, you should see the following list of files in your directory. The mmsys.zip file must remain the same directory.</p>
|
||
<p><img src="file_list.jpg" alt="Downloaded and unzipped files" width="187" height="412" /></p>
|
||
<p>*File names for the 2016AA UMLS Release in alphabetical order.</p>
|
||
<p> </p>
|
||
<h2><a id="starting" name="starting"></a>Starting MetamorphoSys</h2>
|
||
<p>You can start MetamorphoSys by doing one of the following: 1. Double click the appropriate file for your platform. OR 2. Open a terminal window and change to the directory of the downloaded files, and then type the appropriate
|
||
command for your platform:</p>
|
||
<ul>
|
||
<li>./run.bat or ./run64.bat (Windows)</li>
|
||
<li>./run_mac.sh (or click on the run_mac.command file)</li>
|
||
<li>./run_linux.sh</li>
|
||
</ul>
|
||
<p>Once you have executed the appropriate command, the MetamorphoSys application will begin.</p>
|
||
<p> </p>
|
||
<h2><a id="screens_tabs" name="screens_tabs"></a>MetamorphoSys Screens and Tabs</h2>
|
||
<p>MetamorphoSys screens and tabs will lead you through the process of installing the UMLS Knowledge Sources and customizing the Metathesaurus.</p>
|
||
<h3>Welcome to MetamorphoSys</h3>
|
||
<p>Select one of the following:</p>
|
||
<ol>
|
||
<li>Install UMLS — to install one or more UMLS Knowledge Sources.</li>
|
||
<li>Browse my Subset — to open the RRF subset browser.</li>
|
||
</ol>
|
||
<p>File menu option:<br />Validate Distribution<br />Exit</p>
|
||
<p>Advanced menu options:<br />Customize My Subset (customizes an existing Metathesaurus subset)<br />Build MRCXT (opens the MRCXT Builder)<br />Copy Database Load Scripts to Hard Drive (copies database load scripts to local storage)</p>
|
||
<p>Validate Distribution confirms that all UMLS files have transferred correctly and are complete. The process takes approximately 30 minutes and produces a log file (validation.log) and an alert box that displays a statement regarding the validity of
|
||
the files. Use Validate Distribution as the first step in troubleshooting when experiencing any malfunctions.</p>
|
||
<p>In order to create correct subsets, use the version of MetamorphoSys that matches the version of the Metathesaurus release files being subsetted. Do not use older versions of MetamorphoSys with newer or older release files; use the version of MetamorphoSys
|
||
included with the release files.</p>
|
||
<h3>Install UMLS</h3>
|
||
<p>MetamorphoSys creates a top-level destination directory in local storage for the UMLS Knowledge Sources. The directory is named with the UMLS Release version, for example: 2016AA. The following directory structure is created beneath the destination
|
||
directory, shown below for the 2016AA release:<br /><br /><installation directory></p>
|
||
<dl>
|
||
<dt>2016AA</dt>
|
||
<dd>NET</dd>
|
||
<dd>LEX</dd>
|
||
<dd>META</dd>
|
||
<dd> </dd>
|
||
</dl>
|
||
<p>Install any one, two, or all three Knowledge Sources as follows:</p>
|
||
<div>
|
||
<table class="table table-bordered">
|
||
<tbody>
|
||
<tr>
|
||
<th>
|
||
<p><strong>Selection</strong></p>
|
||
</th>
|
||
<th>
|
||
<p>Installed To</p>
|
||
</th>
|
||
</tr>
|
||
<tr>
|
||
<td>Semantic Network</td>
|
||
<td>NET directory</td>
|
||
</tr>
|
||
<tr>
|
||
<td>SPECIALIST Lexicon</td>
|
||
<td>LEX directory</td>
|
||
</tr>
|
||
<tr>
|
||
<td>MetamorphoSys</td>
|
||
<td>MMSYS directory</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
<p>The META directory is populated with the Metathesaurus subset files created during installation. Depending on your configuration, some of these files may contain zero bytes.</p>
|
||
<p>Use the Browse button to locate source and destination directory locations.</p>
|
||
<p>Click OK to proceed with installation. A progress monitor tracks each step of the installation process. If the Metathesaurus is selected, installation will begin after all Metathesaurus options are selected.</p>
|
||
<p>To cancel installation at any time, click 'Cancel' at the bottom of the Install UMLS progress screen, or at the bottom of the MetamorphoSys progress window.</p>
|
||
<h3>MetamorphoSys Configuration</h3>
|
||
<p>Configuration files include all of the options and filters that have been selected. By saving a configuration file users can reproduce a subset exactly. Select New Configuration to create a new subset configuration. Select Open Configuration to open
|
||
a previously saved configuration file.</p>
|
||
<h3>License Agreement Notice</h3>
|
||
<p>The Metathesaurus contains source vocabularies produced by many different copyright holders. The majority of the content of the Metathesaurus is available for use under the basic (and quite open) terms described in the UMLS Metathesaurus <a href="https://uts.nlm.nih.gov/uts/assets/LicenseAgreement.pdf">license agreement</a>.</p>
|
||
<p>Some vocabulary producers place additional restrictions on the use of their content as distributed within the Metathesaurus.</p>
|
||
<p>Levels of additional restrictions are described in Section 12 of the UMLS Metathesaurus License. Individual vocabularies and their restriction levels are listed in Appendix 1 of the UMLS Metathesaurus License. If you already heve a separate license
|
||
for one of the source vocabularies, your existing license also applies to that source as distributed within the Metathesaurus. In some cases, you may have to request permission or negotiate a separate license with a vocabulary producer in order
|
||
to use that vocabulary in a production system. There may be a charge associated with these separate permissions or license agreements.</p>
|
||
<p>Click Accept or Do Not Accept after reviewing the UMLS Metathesaurus License.</p>
|
||
<h3>Select Default Subset</h3>
|
||
<p>You must select one of four pre-defined default subsets as a starting point.</p>
|
||
<p><img src="Metamorphosys_Select_Default_Subset_Configuration_window.png" alt="Metamorphosys - Select Default Subset Configuration window" /></p>
|
||
<ol>
|
||
<li>Active Subset: excludes "legacy" sources that have not been updated for several years in the UMLS Metathesaurus.</li>
|
||
<li>Level 0: contains vocabulary sources for which no additional license agreements are necessary beyond the UMLS license.</li>
|
||
<li>Level 0 + SNOMED CT: contains all Level 0 sources and SNOMED CT.</li>
|
||
<li>SNOMEDCT + SCTUSX: includes only SNOMED CT and the US Extension to SNOMED CT.</li>
|
||
</ol>
|
||
<p>Use the Source List tab to modify your default subset.</p>
|
||
<p>
|
||
<!--: <a href="mailto:custserv@nlm.nih.gov">custserv@nlm.nih.gov</a>. -->We encourage you to suggest additional default subsets for future releases by clicking the contact link at the top of the page.</p>
|
||
<p> </p>
|
||
<h2><a id="output_options" name="output_options"></a>Customizing the Metathesaurus Tabs</h2>
|
||
<h3>Option Tabs</h3>
|
||
<p>Input Options<br />Output Options<br />Source List<br />Precedence<br />Suppressibility</p>
|
||
<p>Select and complete Option tabs in any order. Note that the selections made in one option tab may affect the display and available choices on other Options tabs.</p>
|
||
<p>Select 'Reset' on the menu bar, then select the appropriate Reset command to the default settings for any option.</p>
|
||
<p>When you have completed configuring your Metathesaurus subset, go to the menu bar, select 'Done', and then 'Begin Subset'.</p>
|
||
<p>You will be prompted to save your configuration. Name your configuration file, which will be stored in the destination META directory. This file documents your configuration choices, and can be used as the starting point for a later customization
|
||
using the Customize My Subset option on the Welcome screen.</p>
|
||
<h3>Input Options Tab</h3>
|
||
<p>This tab allows users to indicate the location of required directories, the configuration file, and the input and output directories.</p>
|
||
<p>For the initial installation, NLM Data File Format must be selected.</p>
|
||
<p>When customizing an existing subset, use Browse to select its current format of either Original Release Format or Rich Release Format.</p>
|
||
<h3>Output Options Tab</h3>
|
||
<ul>
|
||
<li>Select Output Format<br />Select either Rich Release Format or Original Release Format. Rich Release Format is the default selection for the initial installation and for customizing an existing subset in the Rich Release Format. Original Release
|
||
Format is the default for customizing an existing subset in the Original Release Format. Note: You cannot generate a correct Rich Release Format subset from Original Release <br /><br /></li>
|
||
<li>Subset Folder<br />Indicate where the new subset files should be placed.<br /><br /></li>
|
||
<li>Write Database Load Scripts<br />Outputs a load script in either Oracle or MySQL format, which you may further optimize or customize. See the <a href="//www.nlm.nih.gov/research/umls/load_scripts.html">Load Scripts</a> page for more information
|
||
on UMLS load scripts.</li><br />
|
||
<li>Source Abbreviation Format<br />Source vocabulary information in the Metathesaurus content can be identified by a versionless, or Root Source Abbreviation (RSAB), or by the longer and more descriptive Versioned Source Abbreviation (VSAB). The default
|
||
is the RSAB, but you may choose to include the VSABs. For example,
|
||
<ul>
|
||
<li>MSH is the Root Source Abbreviation (RSAB)</li>
|
||
<li>MSH_2003_12_12 is the Versioned Source Abbreviation (VSAB)</li>
|
||
</ul>
|
||
In either case, your subset will include the MRSAB file which links the RSABs to the corresponding VSABs for all source vocabularies in your subset.<br /><br /></li>
|
||
<li>Maximum Field Length<br />Restrict fields in your output to the maximum field length allowed in your application or database software. Beginning with the 2007AA Release the default value for this field is 3990 characters. <br /><br /></li>
|
||
<li>Remove MTH Only Concepts<br />Select this option to retain MTH atoms ONLY when they overlap with atoms from other sources in your subset.<br /><br />
|
||
</li>
|
||
<li>Calculate MD5 Values for Output Files<br />When this box is checked, the MD5 algorithm generates a mmsys.md5 file in the Metathesaurus subset directory. The information in this file can be used to verify data integrity of the Metathesaurus files
|
||
(RRF or ORF), and can be useful when troubleshooting problems. The MD5s values appear in the META/mmsys.md5 file. Please note that these MD5s are intended for comparison of different runs and are calculated in a platform independent way, and they
|
||
ignore differing line terminations. For this reason, native MD5 calculation programs may differ from those in the mmsys.md5 file.<br /><br /></li>
|
||
<li>Add UTF-8 BOM Characters to Output Files<br />When this box is checked, all output data files are prepended with a byte order mark. This beginning-of-file marker (3 bytes) indicates that the file is encoded as UTF-8.<br /><br /></li>
|
||
<li>Build Browser Index Files<br />This option creates index files used by the RRF Browser to lok up data. Leaving this box checked is highly recommended. Unchecking this option will cause the RRF Browser to run much slower.</li>
|
||
</ul>
|
||
<h3>Source List Tab</h3>
|
||
<p>The Source List tab displays all source vocabularies in the current version of the Metathesaurus. Sources are sorted alphabetically by Source Abbreviation in the default display. At the top of the Source List tab there are two radio buttons:</p>
|
||
<p><img src="../../images/source_tab_radios.gif" alt="source list options" width="221" height="49" /></p>
|
||
<p>The highlighted sources reflect the default subset selected earlier in the installation process. You may select or deselect additional sources to include or exclude from your subset. Leave the button set to 'Select Sources to EXCLUDE from subset'
|
||
in order to highlight sources that will be removed from your customized Metathesaurus subset.</p>
|
||
<p>Or you may choose 'Select sources to INCLUDE in subset'. When selected, only the highlighted sources will be included in your local subset.</p>
|
||
<p>Note: The highlighted sources do NOT change when you switch between these two options. If a source is highlighted for EXCLUSION from a subset, and you choose Select sources to INCLUDE in subset , that source will now be highlighted for INCLUSION in
|
||
your subset.</p>
|
||
<p>To select or deselect additional rows, hold down the <CTRL> key while making your selection.</p>
|
||
<p>You may sort the Source List by Full Source Name, Source Abbreviation, Source Family, Language, or Level (UMLS License Restriction Level). Click on the column header to re-sort the list by that data.</p>
|
||
<p>The complete Metathesaurus contains over 150 source vocabularies and in its entirety is an extremely large and unwieldy set of data files. Carefully consider what sources will contribute useful data to your application, and then exclude other sources,
|
||
to reduce the size of output subsets and to improve application performance.</p>
|
||
<p>Consider also that the data from some sources may be incompatible with your intended application. They may contain terms that are recognizable only within the context of a specific source; or they may contain abbreviations that are confusing, or not
|
||
particularly useful to your application.</p>
|
||
<p>Additional information source vocabularies is available under <a href="//www.nlm.nih.gov/research/umls/sourcereleasedocs/index.html">UMLS Source Release Documentation</a>. You may also contact the source providers included in the Appendix to the License
|
||
Agreement for additional documentation or information.</p>
|
||
<p>You may select individual sources to remove based on the Full Source Name or Source Abbreviation. You may take advantage of groups of related vocabularies, called Source Families, to assist in the removal of related sources when one source is selected.</p>
|
||
<p>Note, for example, that CPT (the AMA's Physicians' Current Procedural Terminology, CPT4) is also a part of HCPT (the Health Care Financing Administration Common Procedure Coding System, HCPCS). Both vocabularies must be removed to exclude all sources
|
||
of CPT information.</p>
|
||
<p>You may also exclude sources by language, or by license restriction level. To reset source selections and return to the default list, select Reset Sources to Exclude Defaults under Reset on the menu bar.</p>
|
||
<h3>Precedence Tab</h3>
|
||
<p>The Precedence tab displays the default order of precedence of Metathesaurus source and term type combinations as determined by NLM. One string from one English term is designated and labeled as the default preferred name of each concept in the Metathesaurus.
|
||
Selection of the default preferred name for any Metathesaurus concept is based on an order of precedence of all the types of English strings in all the Metathesaurus source vocabularies. Different types of strings, e.g., preferred terms, cross references,
|
||
and abbreviations from each vocabulary will have different positions in this order.</p>
|
||
<p>The default order of precedence determined by NLM will not be suitable for all applications of the Metathesaurus. MetamorphoSys can be used to change the selection of preferred names to feature terminology from the source vocabularies most appropriate
|
||
to particular user populations.</p>
|
||
<p>You may reorder the ranking of source and term type combinations by cutting and pasting, or dragging and dropping the rows in the Precedence List. Term types from sources that have been excluded on the Source List tab will not be displayed.</p>
|
||
<p>The ranking of sources and term types will affect the output subset. In particular, the name of a concept will be determined by the highest ranking term type in that concept.</p>
|
||
<p><a name="suppress"></a></p>
|
||
<h3>Suppressibility Tab</h3>
|
||
<p>The Suppressibility tab displays source/term type combinations to be marked as suppressible in the output subset. Term types from sources that have been excluded on the Source List will not display. For a new subset, the initial display highlights
|
||
default source/term types made suppressible by NLM. You may select or deselect source/term types to be marked as suppressible in your output subsets. When customizing an existing subset, the initial display highlights your suppressibility settings
|
||
for that subset.</p>
|
||
<p> </p>
|
||
<h2><a id="Filters" name="Filters"></a>MetamorphoSys Metathesaurus Filters</h2>
|
||
<p>MetamorphoSys Filters allow users to create a custom subset containing a specific group of terms. The Enable/Disable Filter option is listed under the File Menu. When a filter is enabled, its corresponding tab appears on the UMLS Metathesaurus Configuration
|
||
screen. When a filter is disabled, its tab disappears. An option for specific help information for each filter is displayed on the Help Menu when that filter is selected. The current filters are:</p>
|
||
<ul>
|
||
<li>Attributes Type List</li>
|
||
<li>Content View List</li>
|
||
<li>Languages List</li>
|
||
<li>Relations List</li>
|
||
<li>Sample Meta</li>
|
||
<li>Semantic Types List</li>
|
||
<li>Source Subset List</li>
|
||
<li>Source Term Types List</li>
|
||
<li>UI List</li>
|
||
<li>Unicode</li>
|
||
</ul>
|
||
<h3>Import Filter</h3>
|
||
<p>This command allows the user to import filters developed according to the Filter API. Filters cannot be exported or removed from the application, but they can be disabled. A window will pop up with all filters available for import. These filters are
|
||
found in the METAMSYS/ext directory.</p>
|
||
<p>Two simple import filters are provided as examples of custom filtering:</p>
|
||
<ul>
|
||
<li>NosNec (for Testing): To exclude "NOS" or "NEC" strings from the output subset</li>
|
||
<li>OddEven (for Testing): To exclude odd or even numbered CUIs from the output subset</li>
|
||
</ul>
|
||
<p>When an import filter is selected, its option tab appears on the Metathesaurus configuration screen.</p>
|
||
<p> </p>
|
||
<h2><a id="Options_advanced" name="Options_advanced"></a>Options for Advanced Users</h2>
|
||
<h3>MetamorphoSys Options</h3>
|
||
<p>Opens a configuration window which contains the following user capability:</p>
|
||
<p>Auto Select Related Items - If this check-box is selected, there is no prompt when the selected row shares a Source Family or has a Dependent Source. The system automatically selects the Dependent Source rows or the rows with the same Source Family.
|
||
The default for this flag is false.</p>
|
||
<h3>Advanced Source List Options</h3>
|
||
<p>Opens a configuration window which contains the following user capabilities:</p>
|
||
<h3>Enforce Family Selection</h3>
|
||
<p>If Enforce Family Selection is selected, you will be prompted to select other sources in the same Source Family.</p>
|
||
<h3>Enforce Dependent Source Selection</h3>
|
||
<p>If Enforce Dependent Source Selection is selected, and you select a source in the Dependent Source Associations table, you may select any dependent sources listed. As with Enforce Family Selection, this function exists for deselection of sources as
|
||
well. The default for this flag is true.</p>
|
||
<p>This selection also provides the following capabilities:</p>
|
||
<ul>
|
||
<li>Click the Add button to add Source/Dependent Source relationships to the Dependent Source Associations table.</li>
|
||
<li>Click the Clear button to clear the whole table.</li>
|
||
<li>Click on a specific line(s) and press the Delete button to remove the line(s).</li>
|
||
<li>Click the Source or Dependent Source table header to sort the table.</li>
|
||
<li>Click a table header to do a reverse sort.</li>
|
||
<li>Click the Done button at the bottom of the window to exit the Advanced Options dialog.</li>
|
||
</ul>
|
||
<h3>Advanced Suppressibility Options (Remove Suppressible Data)</h3>
|
||
<p>You may specify which of three types of suppressible data to exclude from your customized subsets:</p>
|
||
<ul>
|
||
<li>Source Term Type: groups of terms are marked suppressible by Source/Term Type.</li>
|
||
<li>Editor Assigned: specific terms are marked suppressible by Metathesaurus editors.</li>
|
||
<li>Obsolete: terms identified as Obsolete in their source vocabularies.</li>
|
||
</ul>
|
||
<p>Rich Release Format (RRF)<br />If you select Remove Source Term Type suppressible data, data with a SUPPRESS flag set to Y will be removed.<br />If you select Remove Editor Assigned suppressible data, data with a SUPPRESS flag set to E will be removed.<br
|
||
/>If you select Remove Obsolete data, data with a SUPPRESS flag set to O will be removed.</p>
|
||
<p>Original Release Format (ORF) <br />In ORF, all three types of suppressibility are represented by ts=s or ts=p. Selecting only one or two options above will result in a subset that still contains some terms where ts=s or ts=p.</p>
|
||
<h3>Advanced Semantic Types To Exclude</h3>
|
||
<p><br />These options are available when the Semantic Types to Exclude filter has been enabled from the File menu and allow you to set the predicate for concept removal. There are two choices:</p>
|
||
<ol>
|
||
<li>Remove concept with ANY selected Semantic Type - If this option is selected, a concept will be removed if any of its Semantic Types appear on the exclude list.</li>
|
||
<li>Remove concept with ALL selected Semantic Types - If this option is selected, a concept will be removed only if all of its Semantic Types are on the exclude list.</li>
|
||
</ol>
|
||
<p> </p>
|
||
<h2><a id="done" name="done"></a>Completing a Subset</h2>
|
||
<p>When all options have been explored and you have completed configuring your Metathesaurus subset, select Done from the menu bar, and then Begin Subset. To save your configuration in order to create a subset at a later time, select Save Configuration
|
||
from the File menu.</p>
|
||
<p>To return to Metathesaurus default selections for all of the filter tabs (Input Options, Output Options, Source List, Precedence and Suppressibility) use the Reset Menu. The default selections are those listed in the mmsys.prop.default file in the
|
||
config folder. The mmsys.prop.sav file contains the properties used in the last run of MetamorphoSys. Please note: the choice of version, Original Release Format or Rich Release Format, will not be reset on the Output Options tab and the Input options
|
||
tab.</p>
|
||
<p>The Install UMLS Metathesaurus progress monitor charts the process through the following steps: Initializing the CUI list; Subsetting Content, Subsetting Indexes, and Final Processes. To stop processing and exit MetamorphoSys at any time, press Cancel
|
||
at the bottom of the progress monitor. The interrupted process cannot be resumed. The configuration must be recalled (if saved), or recreated (if not saved), and subsetting must be started again.</p>
|
||
<p>MetamorphoSys produces an install.log file in the release directory, containing the log of the installation process up to the start of Metathesaurus subsetting. It records which operations were selected, and reports the results of file validations
|
||
against both CHK and MD5 files. If the downloaded files pass validation, processing continues and subsetting begins. If files fail validation, the install.log is displayed.</p>
|
||
<p>When subsetting is complete, progress and error messages and the configuration settings are displayed on the screen and also written to a log file called mmsys.log in the directory containing the subsetted files. The subsetted Metathesaurus files
|
||
are located in the chosen destination directory.</p>
|
||
|
||
|
||
|
||
|
||
<p class=”margin-top-5”><small>Last Reviewed: April 25, 2019</small></p>
|
||
|
||
</div>
|
||
</main>
|
||
|
||
<!-- FOOTER -->
|
||
<footer class="usa-footer__primary-section padding-top-5 padding-bottom-3 insertfooter">
|
||
|
||
<div class="grid-container">
|
||
<div class="grid-row">
|
||
<div class="desktop:grid-col-3 grid-col-6"> <a href="https://www.nlm.nih.gov/socialmedia/index.html">
|
||
<p class="text-white">Connect with NLM</p>
|
||
</a>
|
||
<ul class="social_media add-list-reset">
|
||
<li class="margin-right-05"><a href="https://www.facebook.com/nationallibraryofmedicine"><img class="bg-secondary" src="https://www.nlm.nih.gov/images/facebook.svg" alt="Facebook"></a></li>
|
||
<li class="margin-right-05"><a title="External link: please review our privacy policy." href="https://www.linkedin.com/company/national-library-of-medicine-nlm/"><img class="bg-secondary" src="//www.nlm.nih.gov/images/linkedin.svg" alt="LinkedIn"></a></li>
|
||
<li class="margin-right-05"><a title="External link: please review our privacy policy." href="https://twitter.com/NLM_NIH"><img src="//www.nlm.nih.gov/images/twitter.svg" class="img-fluid bg-secondary" alt="Twitter"></a></li>
|
||
<li class="margin-right-05"><a title="External link: please review our privacy policy." href="https://www.youtube.com/user/NLMNIH"><img src="//www.nlm.nih.gov/images/youtube.svg" class="bg-secondary" alt="You Tube"></a></li>
|
||
<li class="margin-right-05"><a title="External link: please review our privacy policy." href="https://public.govdelivery.com/accounts/USNLMOCPL/subscriber/new?preferences=true"><img src="//www.nlm.nih.gov/images/mail.svg" class=" bg-secondary" alt="Government Delivery"></a></li>
|
||
</ul>
|
||
</div>
|
||
<div class="desktop:grid-col-3 grid-col-6">
|
||
<p class="address_footer text-white"> National Library of Medicine <br>
|
||
<a href="https://www.google.com/maps/place/8600+Rockville+Pike,+Bethesda,+MD+20894/@38.9959508,-77.101021,17z/data=!3m1!4b1!4m5!3m4!1s0x89b7c95e25765ddb:0x19156f88b27635b8!8m2!3d38.9959508!4d-77.0988323" class="text-white"> 8600 Rockville Pike <br>
|
||
Bethesda, MD 20894 </a></p>
|
||
</div>
|
||
<div class="desktop:grid-col-3 grid-col-6">
|
||
<p><a href="/web_policies.html" class="text-white"> Web Policies </a><br>
|
||
<a href="https://www.nih.gov/institutes-nih/nih-office-director/office-communications-public-liaison/freedom-information-act-office" class="text-white"> FOIA </a><br>
|
||
<a href="https://www.hhs.gov/vulnerability-disclosure-policy/index.html" class="text-white">HHS Vulnerability Disclosure</a> </p>
|
||
</div>
|
||
<div class="desktop:grid-col-3 grid-col-6">
|
||
<p><a class="supportLink text-white" href="//support.nlm.nih.gov?from="> NLM Support Center </a> <br>
|
||
<a href="/accessibility.html" class="text-white"> Accessibility </a><br>
|
||
<a href="/careers/careers.html" class="text-white"> Careers </a></p>
|
||
</div>
|
||
</div>
|
||
<div class="grid-row">
|
||
<div class="grid-col-12">
|
||
<p class="text-center text-white"> <a class="text-white" href="//www.nlm.nih.gov/">NLM</a> | <a class="text-white" href="https://www.nih.gov/">NIH</a> | <a class="text-white" href="https://www.hhs.gov/">HHS</a> | <a class="text-white" href="https://www.usa.gov/">USA.gov</a></p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
</footer>
|
||
<script src="//assets.nlm.nih.gov/uswds/js/uswds.min.js"></script>
|
||
<script src="//assets.nlm.nih.gov/jquery/jquery-latest.min.js"></script>
|
||
<script src="//assets.nlm.nih.gov/jquery/jquery-migrate-latest.min.js"></script>
|
||
<script src="/scripts/nlm_autocomplete.js"></script>
|
||
<script src="/scripts/nlm_uswds.js"></script>
|
||
|
||
|
||
|
||
|
||
|
||
<script src="/scripts/videojs/video.min.js" type="text/javascript"></script>
|
||
|
||
<script src="/scripts/videojs/nuevo.min.js" type="text/javascript"></script>
|
||
|
||
<script src="/scripts/videojs/plugins/videojs.hotkeys.min.js" type="text/javascript"></script>
|
||
|
||
<script>
|
||
|
||
var player = videojs('player_one');
|
||
|
||
player.nuevo();
|
||
|
||
player.hotkeys({ // Section needed for keyboard access to work
|
||
|
||
volumeStep: 0.1,
|
||
|
||
seekStep: 5,
|
||
|
||
alwaysCaptureHotkeys: true
|
||
|
||
});
|
||
|
||
</script>
|
||
|
||
</body>
|
||
</html>
|
||
|
||
|