LexEVS is supported by the Vocabulary Knowledge Center.
For more information on receiving support, please visit the Vocabulary Knowledge Center.
Tool Overview
LexEVS 6.0 is the current embodiment of work started under the LexBIG project (LexGrid Vocabulary Services for caBIG®), which was founded as part of caBIG® development activities. Over time, this technology was adopted as the strategic infrastructure for the caBIG® community and NCI's Enterprise Vocabulary Services (EVS).
NCI's EVS is a big user of the LexEVS services, but there are many others. You can consume controlled terminologies hosted by NCI's EVS without setting up your own servers to do so. Seeing what NCI has done with EVS is a good way to learn about what LexEVS can do. Refer to the NCI EVS Overview page and the EVS Wiki for further information.
Under the covers of LexEVS is a collection of programmable interfaces that provide users and developers with the ability to access either controlled terminologies available from the NCI EVS Project or your own terminologies. NCI's installation of LexEVS is not only a tool for the community to use. but also an example of what you can build for your organization. By building your own installation of LexEVS you get to control the content. You can have any set or subset of terminologies and mappings that you want. One installation can be used by multiple applications in your enterprise.
In short, LexEVS includes the following components:
- Terminology Server - An enterprise level terminology server
- Java API - A Java interface based on the LexGrid Object Model
- REST/HTTP Interface - Offers basic HTTP based query mechanism from which results are returned in either XML or HTML formats
- SOAP/Web Services Interface - Provides a programming language neutral Service-Oriented Architecture (SOA)
- Distributed API - A Java interface based on the LexGrid data model and relies on a LexEVS Proxy and *Distributed LexEVS Adapter to provide remote clients access to the native LexEVS API
- LexEVS Grid Services - An interface which uses the caGRID infrastructure to provide access to the native LexEVS API via the caGRID Services
- Developers GUIs - Server administration, query testing, and value set development can be performed by a developer
The name LexEVS came into use to highlight the merging of LexGrid, LexBIG, and EVS technologies, and is manifested in the LexEVS software releases. LexEVS is the entire suite of tools. In this suite, LexGrid is the underlying model for standard storage of controlled vocabularies and ontologies. The LexBIG API is the set of services that EVS adapters use to store and retrieve terminology metadata. LexEVS APIs are a combination of convenience methods and the LexBIG API (combining LexBIG and the EVS adapters into one set of services). For detailed information, refer to the [LexEVS architecture overview].
After you have a chance to get familiar with the LexEVS suite, consider looking through our [LexEVS functionality overview]. This lays out everything that can be done from a developer's or ontologist's point of view.
What's New
LexEVS 6.0 is the latest release. This release is primarily about alignment with standards. Other significant functionality, especially in the areas of authoring APIs, value sets, mappings, and exporters top the list of enhancements, is:
- LexEVS 6.0 adds comprehensive support of the [Common Terminology Services - Release 2] functionality as described in the [Health Level Seven (HL7)] CTS 2 Draft Standard for Trial Use (DSTU).
- LexGrid Model and database updates to support CTS 2 (See [LexEVS 6.0 Information Models])
- Loader and data access layer changes to support CTS 2 functions
- Additional versioning and value set / picklist functionality to support CTS 2 functions (See [LexEVS 6.0 Value Set and Pick List Definition Guide])
- New OWL/RDF Exporter (See LexEVS 6.0 CTS2 Administration 2 - Export Operation API)
- XML exporter enhancements to provide filtered export of code system (See LexEVS 6.0 CTS2 Administration 2 - Export Operation API)
- New Authoring API services to support CTS 2 functions (See LexEVS 6.0 CTS2 Authoring 2 - Code System Authoring Operation API)
- New Query API services to support CTS 2 functions (See LexEVS 6.0 CTS2 Query 3 - Concept Domain Query Operation API, LexEVS 6.0 CTS2 Query 4 - Usage Context Query Operation API, LexEVS 6.0 CTS2 Query 5 - Value Set Query Operation API)
- Associations/Mappings enhancements to support CTS 2 functions and user requirements (See LexEVS 6.0 CTS2 Authoring 1 - Association Authoring Operation API)
Previous Releases
For help with a migration from previous releases, refer to the [LexEVS 6.0 Migration Tips for 5.x Users].
To see any of the previous releases, refer to the LexEVS roadmap.
Installation and Downloads
For Beginners
Please visit [1 - LexEVS 6.0 Installation Overview]. Once you are familiar with the different environments that can be installed, then start with the [LexEVS 6.0 Installation Guide].
Installation Options
Refer to the LexEVS 6.0 Installation Options to understand the significance of each download file for each LexEVS environment that can be installed (Local Runtime, Distributed, and Grid Services).
LexEVS 6.0 Download Files
For those familiar with LexEVS who just want to directly download files, visit [LexEVS 6.0 Download Files].
Widget Library
The LexEVS Widget Library lists many widgets that have been developed for use by particular customers. These widgets have been found to be potentially useful to a wider audience. Each widget has a description for you to use in deciding if you'd like to dig deeper and find out the usefulness of the widget in your application.
Local Runtime Fixes
If you already have LexEVS 6.0 installed, fixes are now available:
Filename |
Description |
---|---|
Contains a list of the fixes and functions included in this release. |
|
LexEVS 6.0.1 patch. This file is installed after LexEVS 6.0 has already been [installed]. |
Documentation and Guides
Release Notes and Readme
The LexEVS 6.0 release notes and readme can be found on the [downloads] page.
LexEVS 6.0 Installation Guide
The [LexEVS 6.0 Installation Guide] outlines the supported configurations and technical installation instructions for LexEVS Vocabulary Services for caBIG®.
LexEVS 6.0 Administration Guide
The [LexEVS 6.0 Administration Guide] outlines the environment configuration from the perspective of an existing installation.
LexEVS 6.0 API/Programmer's Guide
The [LexEVS 6.0 Programmer's Guide] explains the LexEVS API (services, extensions, utilities, and GUI); also many related APIs.
LexEVS 6.0 Design and Architecture Guide
The [LexEVS 6.0 Design and Architecture Guide] explains the LexGrid model and the LexBIG services.
LexEVS 6.0 Value Set and Pick List Definition Guide
The [LexEVS 6.0 Value Set and Pick List Definition Guide] explain the LexEVS 6.0 Value Set and Pick List Definition documentation.
LexEVS 6.0 Loader Guide
The [LexEVS 6.0 Loader Guide] is intended for a LexEVS developer and provides information about the loaders provided, mapping, and how to create your own loaders using the loader framework.
LexEVS 6.0 OWL Export Guide
The [LexEVS 6.0 OWL Export Guide] will take you through the steps necessary to export content in OWL/RDF format.
LexEVS in SpringSource MVC Maven Project
The LexEVS in SpringSource MVC Maven Project guide will show you how to use a local instance of LexEVS in a Spring 3.0.x MVC project and how to deploy it to a Tomcat server from within the SpringSource Tool Suite.
LexEVS 6.0 Javadocs
There are several parts to the LexEVS Javadocs to consult depending on what you are looking for.
- If you have a local application accessing a Local Runtime, view the Local Runtime Javadoc online.
- To interact with a LexEVS server that is hosting terminologies remotely, whether it be your own or the services at NCI, view the Distributed Javadoc online.
- If you are using the Grid Analytical Services, view the Grid Analytical Services Javadoc online.
- The Grid Data Service for LexEVS sits behind a caGrid interface. Most users do not reach this service via the Java API and in fact only a single method in the caGrid API is of interest. It can be found in the Grid Data Service Implementation.
To download any of the Javadocs above, go to the [Javadocs section] on the downloads page. You will find one download including all the Javadocs.
Release Notes and Readme
The LexEVS 6.0 release notes and readme can be found on the [downloads] page.
Support
Contributions
In the spirit of open source caBIG invites you to participate in the community. The contribution process is described in LexEVS Community Code Contribution. LexEVS source code is in NCI SVN.
Presentations and Demos
Recent
- [LexEVS 6.0 Highlights Presentation|LexEVS 6.0 to Include^LexEVS_6.0_Highlights.ppt] (397 KB)
Scott Bauer
February 17, 2011
- LexEVS REST APIs demo at HHS and NIH the Health 2.0 Hack-a-Thon
Larry Brem
June 11, 2011
- caBIG Annual Meeting Semantic Infrastructure v2
Charlie Mead, Jane Brzozowski, Cecil Lynch, Raghu Chintalapati, Craig Stancl
September 14, 2010
Earlier Presentations
Additional Resources
- LexEVS 6.0 Design Document
If you would like to look through the information that gave rise to this release you can check out the design documents.
- Common Terminology Services - Release 2 Information
LexEVS 6.0 was developed during the definition phase of CTS 2 and implements some of the early versions of that upcoming standard.
- LexGrid Model and Schema
The LexGrid Model is the underlying informational model used to store terminological metadata. It is Mayo Clinic's proposal for standard storage of controlled vocabularies and ontologies. The model defines how vocabularies should be formatted and represented programmatically, and is intended to be flexible enough to accurately represent a wide variety of vocabularies and other lexically-based resources.
- LexBig Model and Schema
These are the extensions used to support EVS API adapters. The LexBIG vocabulary model extends the LexGrid model to provide unique constructs or granularity required by caBIG® that are not present in the core model.
- Tool Adopters LexEVS
A list of individuals and organizations using LexEVS
- CBIIT Download Page
A list of all available CBIIT EVS software components and tools.
- Enterprise Vocabulary Services (EVS)
Home page for Enterprise Vocabulary Services (EVS)
- NCI Thesaurus
NCI Thesaurus (NCIt) provides reference terminology for many NCI and other systems. It covers vocabulary for clinical care, translational and basic research, and public information and administrative activities.
- NCI Metathesaurus
NCI Metathesaurus (NCIm) is a wide-ranging biomedical terminology database that covers most terminologies used by NCI for clinical care, translational and basic research, and public information and administrative activities.
- [Common Terminology Services - Release 2 Information]