249 lines
18 KiB
HTML
249 lines
18 KiB
HTML
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
|
|
<head>
|
|
<meta http-equiv="X-UA-Compatible" content="IE=8;" />
|
|
<meta name="twitter:card" content="summary_large_image">
|
|
<meta name="twitter:site" content="@NLM_NIH">
|
|
<meta name="twitter:title" content="UMLS® 2023AB Release Available. NLM Technical Bulletin. 2023 Nov–Dec">
|
|
<meta name="twitter:description" content=" The NLM Technical Bulletin is your source to stay informed about NLM products and services.">
|
|
<meta name="twitter:image" content="https://www.nlm.nih.gov/pubs/techbull/images/nlm_tech_bulletin_graphic_twitter.jpg">
|
|
<meta property="og:url" content="https://www.nlm.nih.gov/pubs/techbull/tb.html" />
|
|
<meta property="og:type" content="article" />
|
|
<meta property="og:title" content="UMLS® 2023AB Release Available. NLM Technical Bulletin. 2023 Nov–Dec" />
|
|
<meta property="og:description" content="The NLM Technical Bulletin is your source to stay informed about NLM products and services." />
|
|
<meta property="og:image" content="https://www.nlm.nih.gov/pubs/techbull/images/nlm_tech_bulletin_graphic_facebook.jpg" />
|
|
<link type="text/css" href="/pubs/techbull/styles/reset.css" rel="stylesheet" />
|
|
|
|
<link type="text/css" href="/pubs/techbull/styles/technicalBulletin.css" rel="stylesheet" />
|
|
<!--Call jQuery-->
|
|
<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="/pubs/techbull/scripts/techbull.js" type="text/javascript" language="javascript"></script>
|
|
<!--[if lte IE 8]>
|
|
<script type="text/javascript" src="/scripts/PIE.js"></script>
|
|
<![endif]-->
|
|
<link type="text/css" href="/pubs/techbull/styles/print.css" rel="stylesheet" media="print"/>
|
|
<title>UMLS® 2023AB Release Available. NLM Technical Bulletin. 2023 Nov–Dec</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="UMLS® 2023AB Release Available" />
|
|
|
|
<meta name="DC.Publisher" content="U.S. National Library of Medicine" />
|
|
<meta name="DC.Date.Issued" content="2023-11-06" />
|
|
<meta name="DC.Date.Modified" content="2023-11-06" />
|
|
<meta name="NLMDC.Date.LastReviewed" content="2023-11-06" />
|
|
<meta name="NLM.Contact.Email" content="nlmtechbull@mail.nlm.nih.gov" />
|
|
<meta name="DC.Type" content="Newsletters" />
|
|
<meta name="NLM.Permanence.Level" content="Permanent: Stable Content" />
|
|
<meta name="DC.Rights" content="Public Domain" />
|
|
<meta name="DC.Language" content="eng" />
|
|
|
|
|
|
<meta name="DC.Subject.Keyword" content="Unified Medical Language System" />
|
|
<meta name="DC.Subject.Keyword" content="UMLS Metathesaurus" />
|
|
<meta name="DC.Subject.Keyword" content="Application Programming Interface" />
|
|
<meta name="DC.Subject.Keyword" content="Release" />
|
|
<meta name="DC.Subject.Keyword" content="Subset" />
|
|
<meta name="DC.Subject.Keyword" content="UMLS Terminology Services" />
|
|
<meta name="DC.Subject.Keyword" content="UMLS MetamorphoSys" />
|
|
<meta name="DC.Subject.Keyword" content="License" />
|
|
<meta name="DC.Subject.Keyword" content="NLM Learning Resources Database" />
|
|
<meta name="DC.Subject.Keyword" content="National Library of Medicine" />
|
|
<meta name="DC.Subject.Keyword" content="Training" />
|
|
<meta name="DC.Subject.Keyword" content="UMLS Semantic Network" />
|
|
<meta name="DC.Subject.Keyword" content="Knowledge source" />
|
|
<meta name="DC.Subject.Keyword" content="Medical Dictionary for Regulatory Activities" />
|
|
<meta name="DC.Subject.Keyword" content="Medical Subject Headings" />
|
|
<meta name="DC.Subject.Keyword" content="Natural Language" />
|
|
<meta name="DC.Subject.Keyword" content="Resource Description Framework" />
|
|
<meta name="DC.Subject.Keyword" content="RxNorm" />
|
|
<meta name="DC.Subject.Keyword" content="Spanish" />
|
|
<meta name="DC.Subject.Keyword" content="Systematized Nomenclature of Medicine Clinical Terms" />
|
|
<meta name="DC.Subject.Keyword" content="Tutorial" />
|
|
<meta name="DC.Subject.Keyword" content="UMLS Specialist Lexicon" />
|
|
<meta name="DC.Subject.Keyword" content="source release documentation" />
|
|
<!-- 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 -->
|
|
<div class="skipnavigation"><a title="Skip the navigation on this page" href="#skipnav" class="skipnavigation">Skip Navigation Bar</a></div>
|
|
|
|
<div>
|
|
|
|
<div class="header">
|
|
<img src="/pubs/techbull/images/tb_logo_113.jpg" alt="National Library of Medicine Technical Bulletin" title="National Library of Medicine Technical Bulletin" /><img src="/pubs/techbull/images/nlm_masthead_113.jpg" alt="National Library of Medicine Technical Bulletin" title="National Library of Medicine Technical Bulletin" usemap="#nlm_masthead_113" />
|
|
</div>
|
|
|
|
<div class="search_box">
|
|
<form method="get" action="//vsearch.nlm.nih.gov/vivisimo/cgi-bin/query-meta" target="_self" name="searchForm" class="searchForm">
|
|
<label class="displaynone" for="search">Search</label>
|
|
<input name="query" id="search" type="text" class="search-input inactive" size="50" onfocus="this.value=''" value="Search here for NLM Technical Bulletin articles" aria-label="Search NLM Technical Bulletin">
|
|
<input type="hidden" name="v:project" value="technical-bulletin">
|
|
</form>
|
|
</div>
|
|
|
|
</div>
|
|
|
|
<div id="nav">
|
|
<!--Open drop-->
|
|
<ul class="topnav">
|
|
<li class="currentissue"><a href="//www.nlm.nih.gov/pubs/techbull/current_issue.html">Current Issue</a> <img class="separator" src="/pubs/techbull/images/whitelinetransparentbackground.gif " alt=""/></li>
|
|
<li class="archive"><a href="//www.nlm.nih.gov/pubs/techbull/back_issues.html">Previous Issues</a> <img class="separator" src="/pubs/techbull/images/whitelinetransparentbackground.gif " alt=""/></li>
|
|
<li class="about"><a href="//www.nlm.nih.gov/pubs/techbull/about.html">About</a> <img class="separator" src="/pubs/techbull/images/whitelinetransparentbackground.gif " alt=""/></li>
|
|
<li class="staycurrent"><a href="//www.nlm.nih.gov/pubs/techbull/stay_current.html">Stay Current <img class="emaillogo" src="/pubs/techbull/images/email_20px.gif" alt="E-Mail Sign Up" style="margin-top: -4px;"/> <img class="rsslogo" src="/pubs/techbull/images/rss_20px.gif" alt="RSS Feed" style="margin-top: -4px;"/></a></li>
|
|
</ul>
|
|
<!--Close drop-->
|
|
</div>
|
|
<div class="body">
|
|
<a id="skipnav" name="skipnav"></a>
|
|
<div class="syndicate">
|
|
<p class="tableOfContents"><strong>Table of Contents: <a href="/pubs/techbull/nd23/nd23_issue_cover.html">2023 NOVEMBER–DECEMBER No. 455</a></strong></p>
|
|
<p class="prevnext"><span class="buttons">
|
|
<span class="previous"><a href="nd23_issue_cover.html">Previous</a></span> <span class="next"><a href="nd23_clinicaltrials_content_migration.html">Next</a></span>
|
|
|
|
</span></p>
|
|
<hr class="hr1" />
|
|
<h1 class="articleH1">UMLS® 2023AB Release Available</h1>
|
|
<p class="tbyearmonth">UMLS® 2023AB Release Available. NLM Tech Bull. 2023 Nov-Dec;(455):e1.</p>
|
|
<div class="articleactions">2023 November 06 <span class="status">[posted]</span>
|
|
|
|
|
|
|
|
</div>
|
|
<div class="articleParagraph">
|
|
|
|
<p>The 2023AB release of the Unified Medical Language System® (UMLS) Knowledge Sources is available for <a href="https://www.nlm.nih.gov/research/umls/licensedcontent/umlsknowledgesources.html">download</a> as of November 6, 2023.</p>
|
|
<p>The available downloads are:</p>
|
|
<ul>
|
|
<li>UMLS Metathesaurus Precomputed Subsets (Requires no installation, see below for more information.)</li>
|
|
<li>MRCONSO.RRF file (Most widely used Metathesaurus file.)</li>
|
|
<li>Full Release (UMLS Metathesaurus, Semantic Network, Specialist Lexicon and Lexical Tools, database load scripts, and MetamorphoSys for customizing your UMLS subset and browsing the data.)</li>
|
|
<li>UMLS Metathesaurus History Files (Files that contain historical data from the UMLS Metathesaurus.)</li>
|
|
</ul>
|
|
<p><h1>UMLS Metathesaurus Precomputed Subsets</h1></p>
|
|
<p>In past years, we have required the use of MetamorphoSys to install and customize the UMLS Metathesaurus. Now we are providing two ready-to-use precomputed subsets of the UMLS Metathesaurus that require no installation or customization.</p>
|
|
</p>
|
|
<ul>
|
|
<li><strong>UMLS Metathesaurus Full Subset</strong> (Complete Metathesaurus data without any customization.)</li>
|
|
<li><strong>UMLS Metathesaurus Level 0 Subset</strong> (Includes only level 0 source vocabularies. Level 0 vocabularies do not have any additional restrictions beyond the standard license terms.)</li>
|
|
</ul>
|
|
<p><h1>UMLS Metathesaurus History Files</h1></p>
|
|
<ul>
|
|
<li><strong>Concept History (MRCONSO_HISTORY.txt)</strong> - This file contains all atoms, concepts, and codes that were dropped from the UMLS Metathesaurus MRCONSO.RRF starting with the 2004AA release.</li>
|
|
<li><strong>Relation History (MRREL_HISTORY.txt)</strong> - This file contains all relations dropped from the UMLS Metathesaurus MRREL.RRF file starting with the 2004AA release.</li>
|
|
<li><strong>Source Vocabulary History (MRSAB_HISTORY.txt)</strong> - This file includes a row for every version of every UMLS source vocabulary updated in the UMLS Metathesaurus MRSAB.RRF file starting with the 2004AA release.</li>
|
|
</ul>
|
|
<p>These files are available from the UMLS Download page: <a href="https://www.nlm.nih.gov/research/umls/licensedcontent/umlsknowledgesources.html">https://www.nlm.nih.gov/research/umls/licensedcontent/umlsknowledgesources.html</a></p>
|
|
<p>Please let us know if you find these files useful with comments to the NLM Help Desk (<a href="https://support.nlm.nih.gov/support/create-case/">https://support.nlm.nih.gov/support/create-case/</a>) using the subject line: "UMLS History Files."</p>
|
|
<p><h1>Metathesaurus</h1></p>
|
|
<p>The 2023AB Metathesaurus contains approximately 3.36 million concepts and 15.9 million unique concept names from 185 source vocabularies.</p>
|
|
<p>32 English sources and 38 translation sources were updated. These include MeSH<sup>®</sup>, MedDRA, RxNorm, and SNOMED CT<sup>®</sup> (English and Spanish). For detailed information on changes in this version of the Metathesaurus, see the <a href="https://www.nlm.nih.gov/research/umls/knowledge_sources/metathesaurus/release/updated_sources_expanded.html">Updated Sources (Expanded)</a> section. Additional release statistics may be found in the <a href="https://www.nlm.nih.gov/research/umls/knowledge_sources/metathesaurus/release/statistics.html">Statistics</a> section.</p>
|
|
<p><h1>MetamorphoSys</h1></p>
|
|
<ul>
|
|
<li>The full release requires 34.2 GB of disk space.</li>
|
|
</ul>
|
|
<p>Reported bugs may be viewed on the <a href="https://www.nlm.nih.gov/research/umls/knowledge_sources/metathesaurus/release/notes.html#bugs">Release Notes and Bugs</a> webpage.</p>
|
|
<p>MetamorphoSys can generate custom load scripts for MySQL, Oracle, or Microsoft Access when creating a Metathesaurus subset or installing the Semantic Network. Instructions are available on the <a href="https://www.nlm.nih.gov/research/umls/implementation_resources/scripts/index.html">UMLS Load Scripts</a> homepage.</p>
|
|
<p><h1>Release Information</h1></p>
|
|
<p>To access the UMLS Release files, you must have an active UMLS Metathesaurus® License and a valid <a href="https://uts.nlm.nih.gov/">UTS</a> account. You will be prompted to authenticate with an identity provider with the UTS when downloading the files.</p>
|
|
<p><h1>UMLS Learning Resources</h1></p>
|
|
<p>2023AB <a href="https://www.nlm.nih.gov/research/umls/sourcereleasedocs/index.html">Source Release Documentation</a> webpages are available. </p>
|
|
<p>Additional information regarding the UMLS is available on the <a href="https://www.nlm.nih.gov/research/umls/index.html">UMLS homepage</a>. New users are encouraged to take the <a href="https://www.nlm.nih.gov/research/umls/new_users/online_learning/OVR_001.html">UMLS Basics Tutorial</a> and to explore the <a href="https://www.nlm.nih.gov/research/umls/quickstart.html">UMLS Quick Start Guide</a>, and other training materials.</p>
|
|
<p><h1>UMLS Terminology Services (UTS)</h1></p>
|
|
<p>The <a href="https://uts.nlm.nih.gov/uts/umls/home">UTS Metathesaurus Browser</a> and the <a href="https://documentation.uts.nlm.nih.gov/rest/home.html">UTS REST API</a> include the updated release.</p>
|
|
<p>--</p>
|
|
<p>UMLS REST API authentication has changed. You can now authenticate by simply appending an apiKey parameter to your request, for example:</p>
|
|
<p>https://uts-ws.nlm.nih.gov/rest/content/current/CUI/C0155502/atoms?apiKey={{YOUR_API_KEY}}. </p>
|
|
<p>Authentication via ticket-granting tickets (TGTs) and service tickets is deprecated, but we will continue to accept API authentication via this method until the end of 2023.</p>
|
|
<p><strong>UMLS API Search Endpoint:</strong></p>
|
|
</p>
|
|
<ul>
|
|
<li><strong>Partial matches</strong>: On December 22, 2022, we added a parameter to the search endpoint that returns partial matches. Adding partialSearch=true to your search query will return results that match at least one word in your query. Documentation: <a href="https://documentation.uts.nlm.nih.gov/rest/search/">https://documentation.uts.nlm.nih.gov/rest/search/</a></li>
|
|
<li><strong>Stemming</strong>: On July 17, 2023, we made some changes to the way in which the UMLS API search endpoint handles stemming of individual words. The most significant impact is that queries that include plural forms of words will now find singular forms, for example, a query for "lungs" will find all instances of "lung." In general, API search queries and search queries in the Metathesaurus Browser will produce a higher number of results than before.</li>
|
|
</ul>
|
|
<p><strong>Validating API Keys: </strong>We are now offering an API endpoint for <a href="https://documentation.uts.nlm.nih.gov/rest/authentication.html">validating API keys</a>. This is useful for application developers who need to ensure that their users are UMLS licensees. Make a request that includes both your API key (validatorApiKey) and the API key of the user of your application (apiKey).</p>
|
|
<p>For example: https://utslogin.nlm.nih.gov/validateUser?validatorApiKey=YOUR_API_KEY&apiKey=USER_API_KEY</p>
|
|
<p><strong>Deprecated Subsets and Content Views API Endpoints are shutting down as of December 31, 2023:</strong> These endpoints were deprecated in May of 2022. <a href="https://www.nlm.nih.gov/research/umls/implementation_resources/query_diagrams/er12.html">Source-Asserted Subset information</a> and <a href="https://www.ncbi.nlm.nih.gov/books/NBK9684/#_ch02_sec2_9_">Content View information</a> can be retrieved from the UMLS Metathesaurus files.</p>
|
|
<p><h1>UMLS User Contributions</h1></p>
|
|
<p>UMLS users have extended the functionality of the UMLS in a variety of ways by developing APIs, automation scripts, and natural language processing tools. You can find a list of these on the UMLS Community webpage: <a href="https://www.nlm.nih.gov/research/umls/implementation_resources/community/index.html">https://www.nlm.nih.gov/research/umls/implementation_resources/community/index.html</a>.</p>
|
|
<p>Want to add your tool? Send a request to the NLM Help Desk (<a href="https://support.nlm.nih.gov/support/create-case/">https://support.nlm.nih.gov/support/create-case/</a>) with the subject line: "UMLS Community."</p>
|
|
<p>Be sure to include a link to your source code so that other UMLS users can adapt your tool. We are especially interested in:</p>
|
|
</p>
|
|
<ul>
|
|
<li>Database load scripts.</li>
|
|
<li>Transformation scripts that convert UMLS data into other formats (for example, RDF or JSON).</li>
|
|
<li>Scripts that automate any aspect of UMLS installation.</li>
|
|
<li>Applications that leverage UMLS in the processing of text.</li>
|
|
</ul>
|
|
<p>We value your feedback! For more information about improvements we have made to the UMLS based on user feedback, as well as information about UMLS use in general, see our UMLS User Feedback Page: <a href="https://www.nlm.nih.gov/research/umls/implementation_resources/community/user_feedback.html">https://www.nlm.nih.gov/research/umls/implementation_resources/community/user_feedback.html</a></p>
|
|
</div>
|
|
<p class="articleParagraph">
|
|
|
|
|
|
|
|
|
|
</p>
|
|
</div>
|
|
<div class="footer">
|
|
<p class="footerLeft"><span class="footerissn"><strong>ISSN 2161-2986 (Online)</strong> Content not copyrighted; freely reproducible.</span><br/>
|
|
<a href="/">National Library of Medicine</a> 8600 Rockville Pike, Bethesda, MD 20894
|
|
<br/>
|
|
<a href="//www.nlm.nih.gov/socialmedia/index.html">Connect with NLM</a>,
|
|
<a href="//www.nlm.nih.gov/web_policies.html">Web Policies</a>,
|
|
<a href="//www.nlm.nih.gov/careers/jobopenings.html">Careers</a>,
|
|
<a href="//www.nlm.nih.gov/accessibility.html">Accessibility</a>,
|
|
<a href="//www.usa.gov/" id="anch_34">USA.gov</a>,
|
|
<a href="//www.hhs.gov/vulnerability-disclosure-policy/index.html">HHS Vulnerability Disclosure</a>
|
|
<br/>
|
|
|
|
<a href="//www.nih.gov/">NIH</a>,
|
|
<a href="https://www.hhs.gov/">HHS</a>,
|
|
<a href="//www.nih.gov/institutes-nih/nih-office-director/office-communications-public-liaison/freedom-information-act-office">FOIA</a>,
|
|
<a class="supportLink" href="//support.nlm.nih.gov?from=" target="_blank">NLM Support Center</a>
|
|
|
|
</p>
|
|
|
|
<p class="footerRight">
|
|
<strong>Last updated:</strong> 06 November 2023</p>
|
|
</div>
|
|
</div>
|
|
<map id="nlm_masthead_113" name="nlm_masthead_113">
|
|
<area shape="rect" alt="NLM Technical Bulletin" coords="1,15,396,45" href="//www.nlm.nih.gov/pubs/techbull/tb.html" title="NLM Technical Bulletin" />
|
|
<area shape="rect" alt="National Library of Medicine" coords="0,47,203,62" href="//www.nlm.nih.gov/" title="National Library of Medicine" />
|
|
<area shape="rect" coords="207,47,396,62" href="//www.nih.gov/" alt="National Institutes of Health" title="" />
|
|
</map>
|
|
<!--*****************************Content end*******************************-->
|
|
<script src="/scripts/support.js"></script>
|
|
<script src="/core/nlm-notifyExternal/1.0/nlm-notifyExternal.min.js"></script>
|
|
</body>
|
|
</html>
|
|
|