From Protege Wiki
Revision as of 15:12, October 23, 2008 by JenniferVendetti (talk | contribs) (added instructions for setting the umls.dbyear property)

Jump to: navigation, search


by Qi Li, Philip Shilane


Type Tab Widget
Author(s) Qi Li, Philip Shilane
Last Update September 14, 2006
License Mozilla Public License
Homepage UMLS Tab website
For Application

Allows users to search the National Library of Medicine's Unified Medical Language System (UMLS) and annotate Protege ontologies with terms, concept IDs, synonyms, relations, and other information from the UMLS.

Versions & Compatibility

This section lists available versions of UMLS Tab.

VersionCompatible withDependencies
UMLS Tab 2.0Protege-Frames 3.3.1UMLS Metathesaurus License Agreement

If you click on the button below to add a new version of UMLS Tab, you will be asked to define a page title for the new version. Please adhere to the naming convention of UMLS Tab X.X.X when you define the new page!


VersionChanges in this version
UMLS Tab 2.0no change log was maintained for this version

More Information

The UMLS Tab is a customized interface for browsing and searching the UMLS from within Protege, and directly annotating a Protege ontology with information from the UMLS. New instances and classes can be created in Protege or slot values added by directly importing search results from the UMLS.

Troubleshooting Connection Problems

Many people report problems connecting to the UMLSKS servers in the form of remote or connect exceptions. Examples of what these exceptions might look like are: Operation timed out: connect

java.rmi.RemoteException: Connection refused; invalid client IP address

To successfully connect, please verify that you have completed the following items:

  • You are a registered UMLSKS user. If you have not registered, you may request an account on the home page of the UMLSKS Web site.
  • You have added your IP address to your account profile on the UMLSKS Web site. Instruction for doing this are as follows:
    • Go to the UMLSKS Web site.
    • Login to their site using your UMLSKS LoginID and password.
    • Click on the Views/Profiles link on the navigation bar that runs along the top of the page.
    • Add your static IP address to the "IP Address(es)" text area.
    • Click Update Changes to save your changes.
  • If you are running from behind a firewall, confirm that the firewall is configured to allow outside connection to the default RMI service port of 1099.

It is also possible that the UMLSKS system may be down for maintenance or be encountering problems. If the UMLSKS is encountering problems, you can contact them ( and notify them of the problem.

UMLS Releases

The user interface of the UMLS Tab does not allow you to specify which release version of Metathesaurus data to query. As a workaround, we have provided an additional property in the Protege.lax file called "UMLSTab.dbyear" that allows you to specify the desired Metathesaurus release number. The default value is 2004AA. A list of release numbers can be found in the documentation section of the UMLS portion of the National Library of Medicine's Web site.

To modify the UMLSTab.dbyear property in Protege:

  • Select File | Preferences...
  • Click on the Property Files tab in the Preferences dialog.
  • Click on the Protege.lax tab.
  • Locate the entry for the UMLSTab.dbyear property in the Property Table.


  • Double-click in the Value column to edit the value of the UMLS release.


The UMLS Tab and its source code (like Protege) are freely available under the open source Mozilla Public License.

Anyone who wishes to use this plug-in should be aware that the National Library of Medicine requires a signed license agreement in order to use or access UMLS content. The license is free of charge and you are responsible for abiding by the license terms, which protect the rights of the providers of some component vocabularies. You can obtain a copy of the license agreement from the UMLS Information Web site.

Level of Support

This plug-in is no longer under active development. Since the Protege community continues to express interest in the UMLS Tab, the Protege team will answer questions about the tab (as time permits) via the protege-discussion mailing list. We also recompile the UMLS Tab to make sure that it works with each new version of Protege.

The source code for the UMLS Tab is available in the Protege Subversion repository. The URL to browse the code via a Web interface is: The URL to download the source code with a Subversion client is: