{scrollbar:icons=false}

h1. {page-info:title}
{panel:title=Contents}
{toc:minLevel=2}
{panel}
{panel:title=Document Information}
*Author:* Traci St.Martin/Craig Stancl
*Email:* stmartin.traci@mayo.edu
*Team:* LexEVS
*Contract:* 28XS112
*Client:* NCI CBIIT
National Institutes of Heath
US Department of Health and Human Services
{panel}
|| Sign off || Date || Role \\ || CBIIT or Stakeholder Organization \\ ||
| Hartel | 7/2/09 \\ | PM | NCI EVS \\ |
| Raghu | 7/2/09 \\ | PM | caDSR and EVS Project Manager \\ |
The *purpose of this document* is to collect, analyze, and define high-level needs and features of the National Cancer Institute Center for Biomedical Informatics and Information Technology (NCI CBIIT) caCORE LexEVS Release 5.1. This document focuses on the functionalities proposed by the product stakeholders and target users in order to make it a better product. The use-case and supplementary specifications document will detail how the framework will fulfill these needs.

h2. Vision and Needs

The *objective of this release* of the LexEVS 5.1 is to support the Metathesaurus Browser project by enhancing search and sorting performance as well as RRF loader changes to more accurately reflect the data. In addition we will explore enhancements to the loader framework and provide a recommendation/implementation for value set/domain support.

h3. Current Solution

LexEVS 5.0

h3. Proposed Solutions

LexEVS 5.1

h2. Functional Requirements

Each enhancement, modification or new feature is described in detail below.
|| GForge number \\
(hyperlinked) || Brief description of functional requirement \\
(enhancement or new feature) \\ || Status \\
(Approved or Proposed) || Iteration \\ ||
| [21182|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21882&group_id=491&atid=1853] | Value Set Support recommendation/implementation | --- | --- |
| [21976|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21976&group_id=491&atid=1853] | Improved loading framework | --- | --- |
| [21979|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21979&group_id=491&atid=1904] | Ability to load custom data - custom loading feasibility/recommendation report | --- | --- |
| [21978|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21978&group_id=491&atid=1904] | BDA support for 5.1 | --- | --- |
| --\- | Update RRF loader to support Metathesaurus (Please see GForge items below) | --- | --- |
| --\- | Improve the API to efficiently support expanded search options and large concept relationships sets (Please see Gforge items below) | --- | --- |

h2. Functional Bug Fixes

Each bug fix included in this release is described in detail below.
|| GForge number \\
(hyperlinked) || Brief description of bug \\ || Status \\
(Approved or Proposed) || Iteration \\ ||
| [15975|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=15975&group_id=491&atid=1853] | The NCI_Thesaurus association Has_Salt_Form and Has_Free_Acid_Or_Base needs reverse name | --- | --- |
| [20875|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=20875&group_id=491&atid=1853] | Unescaping XML character data in complex properties | --- | --- |
| [20896|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=20896&group_id=491&atid=1850] | {color:#202020}User question about Metathesaurus Term-group{color} | --- | --- |
| [21278|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21278&group_id=491&atid=1850] | {color:#202020}Displaying multiple concept status.{color} | --- | --- |
| [21287|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21287&group_id=491&atid=1850] | {color:#202020}SNOMED Full Name instead of Full form.{color} | --- | --- |
| [21336|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21336&group_id=491&atid=1850] | {color:#202020}Lucene Max Clause Count exceeded on broad NCI MetaThesaurus RegExp Restrictions{color} | --- | --- |
| [21567|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21567&group_id=491&atid=1850] | ResourceManager cache not Thread-safe | --- | --- |
| [21716|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21716&group_id=491&atid=1853] | Add data from MRSAT file to NCI Meta data | --- | --- |
| [21717|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21717&group_id=491&atid=1853] | MRSAB conifgured to load for NCI Meta data | --- | --- |
| [21718|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21718&group_id=491&atid=1853] | MRREL data for NCi Meta - needs more data loaded | --- | --- |
| [21719|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21719&group_id=491&atid=1853] | Load MRRANK data for NCI Meta | --- | --- |
| [21720|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21720&group_id=491&atid=1853] | Load all MRMAP data | --- | --- |
| [21721|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21721&group_id=491&atid=1853] | Add some additional data from MRHIER | --- | --- |
| [21722|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21722&group_id=491&atid=1853] | Make sure MRDOC data for NCI Meta is loaded | --- | --- |
| [21723|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21723&group_id=491&atid=1853] | Add more data from MRDEF file for NCI Meta | --- | --- |
| [21724|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21724&group_id=491&atid=1853] | Add data from MRCONSO file to NCI Meta data | --- | --- |
| [21739|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21739&group_id=491&atid=1850] | CodedNodeGraph resolveAsList distributed method encountered Jaa heap space error | --- | --- |
| [21740|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21740&group_id=491&atid=1850] | Heap space error on Double Metaphone MetaThesaurus query | --- | --- |
| [21849|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21849&group_id=491&atid=1853] | Add an algorithm for supporting case-insensitive substring search. | --- | --- |
| [21850|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21850&group_id=491&atid=1853] | Add a search algorithm for supporting case-insensitive substring search with an additional spelling-error tolerant feature. | --- | --- |
| [21851|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21851&group_id=491&atid=1853] | Add a sort option for ranking matched concepts by similarity score. | --- | --- |
| [21879|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21879&group_id=491&atid=1853] | Improve error messages (e.g., CNS.resolve, CNS.resolveToList, CNG.resolveToList) | --- | --- |
| [21880|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21880&group_id=491&atid=1853] | Make sample programs (in the examples folder) runnable under both local and distributed modes. | --- | --- |
| [21881|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21881&group_id=491&atid=1853] | Improve ResolvedConceptReferencesIterator performance by reducing client-server network traffic in distributed mode. | --- | --- |
| [21923|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21923&group_id=491&atid=1850] | Connection Leak on SQLImplementedMethods 'mapToCodingSchemeName' | --- | --- |
| [21935|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21935&group_id=491&atid=1850] | OWL loader processing associations incorrectly | --- | --- |
| [21980|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21980&group_id=491&atid=1853] | Optimize Lucene code to improve search performance | --- | --- |
| [21982|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21982&group_id=491&atid=1853] | Implement a server side sort to improve performance | --- | --- |

h2. Non-Functional Requirements

This section describes in detail all the related requirements which must be met for this release but do not add functionality. These requirements are included in the scope and project plan due to level of effort or relative importance to the overall success of delivery of the release.
|| GForge number (hyperlinked) || Brief description of non-functional requirement \\ || Status \\
(Approved or Proposed) || Iteration \\ ||
| [21981|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21981&group_id=491&atid=1904] | {color:black}Project plan for 5.1{color} | --- | --- |
| [21988|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21988&group_id=491&atid=1904] | {color:black}Test plan & test results{color} | --- | --- |
| [21990|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21990&group_id=491&atid=1904] | {color:black}Design and Implementation plan{color} | --- | --- |
| [21991|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21991&group_id=491&atid=1904] | Release notes for 5.1 | --- | --- |
| [21992|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21992&group_id=491&atid=1904] | {color:black}Updated programmer's guide and users guide documentation on VKC Wiki for 5.1{color} | --- | --- |
| [21993|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21993&group_id=491&atid=1904] | {color:black}5.1 Deployment to Dev Tier{color} | --- | --- |
| [21994|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21994&group_id=491&atid=1904] | {color:black}5.1 Deployment to QA Tier{color} | --- | --- |
| [21995|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21995&group_id=491&atid=1904] | {color:black}5.1 Deployment to Stage Tier{color} | --- | --- |
| [21996|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=21996&group_id=491&atid=1904] | {color:black}5.1 Deployment to Production Tier{color} | --- | --- |

h2. General Support Activities

This section describes in detail all the related activities which must be performed for this release but do not add functionality. These activities are included in the scope and project plan due to level of effort or relative importance to the overall success of delivery of the release.
|| GForge number (hyperlinked) || Brief description of general support activity || Status \\
(Approved or Proposed) || Iteration \\ ||
| --- | Identify any 5.x/6.x requirements from caCORE teams as they migrate from EVS 3.x to LexEVS | --- | --- |

h2. Stakeholder Summary

|| *Customer Name* \\ || *Role* \\ || *Interest/Need* \\ ||
| George Komatsoulis | NCICB Application Infrastructure | Oversees NCICB Application Infrastructure |
| Avinash Shanbhag | NCICB Application Infrastructure | Oversees NCICB caCORE Software Engineering |
| Frank Hartel \\ | EVS Product Manager | Directs EVS Projects |
| Denise Warzel | CORE Product Line Manager | Trans-CORE requirement coordination |
| Gilberto Fragoso | Associate Director EVS Infrastructure | Technical Direction |
| Jason Lucas | NCI Metathesaurus Browser Project Manager | Project schedule and task management for browser team |
| Raghu Chintalapati | EVS Project Manager | Project schedule and task management |
| Craig Stancl | Mayo Clinic Technical Lead | Technical Direction and Implementation |
| Traci St.Martin | Mayo Clinic Project Manager | Project schedule and task management |
| Larry Brem | SAIC caBIG ARCH and VCDE Technical Program Manager | Contract governance |

h2. Technical Environment

This product uses the following technical components which have been derived from the current [NCICB Technology Stack|https://gforge.nci.nih.gov/docman/index.php?group_id=27&selected_doc_group_id=460&language_id=1].
|| Client Interface \\ | * NCI browsers
* Programs accessing through caCORE/EVS APIs ||
|| Application Server | Jboss application server ||
|| Database Server | MySQL ||
|| Operating System \\ | * Windows 2000, XP
* Unix (Sun Solaris) ||

h2. Product Dependencies

This release is dependent on the caCORE components or products documented in the [CORE Product Dependency Matrix|https://wiki.nci.nih.gov/x/hIx8].

h2. Out of Scope Items

Items that are out of scope were evaluated as part of the initial scoping activities for this release, and subsequently not included in the final approved scope. These items are also documented in the cumulative backlog of requirements found on the product GForge site. They include out-of-scope functional requirements (enhancements or new features), bug fixes, non-functional requirements, and general support activities.
|| GForge number (hyperlinked) || Brief description of item moved from the in-scope section \\
with brief explanation added of why it was not included in this release \\ || Iteration during which the item \\
was removed from in-scope \\ ||
| [15667|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=15667&group_id=491&atid=1850] | gov.nih.nci.evs.domain.Atom.getLUI does not return value. Per the tracker, Consensus says to deprecate. Lexbig does not load LUI and no user has noticed. Therefore this bug is deferred. | Inception |
| [16678|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=16678&group_id=491&atid=1850] | Serializer Exception on org.apache.lucene.search.regex.JavaUtilRegexCapabilities. Per the tracker, I've replicated what this method does and and called it outside the DLBAdapter and things work fine. Therefore this bug is deferred due to low priority. | Inception |
| [19406|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=19406&group_id=491&atid=1850] | Results not Deserializing Properly when using QueryModifiers on CQL Queries. This bug was discussed in our technical meeting and is deferred due to low priority | Inception |
| [20590|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=20590&group_id=491&atid=1850] | Not all concept status property values are accessible through the API. This item has been discussed and is deferred due to low priority | Inception |
| [20653|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=20653&group_id=491&atid=1850] | Anonymous class hierarchy with unions not showing up correctly. This item has been discussed and is not an issue for 5.0. Deferred due to low priority | Inception |
| [20661|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=20661&group_id=491&atid=1850] | Ontology for Genetic Interval hierarchy does not match up Protege. This item has been discussed and is not an issue for 5.0. Deferred due to low priority | Inception |
| [20665|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=20665&group_id=491&atid=1850] | ECG Ontology missing Description, Date, Source and Creator fields. This item has been discussed and is not an issue for 5.0. Deferred due to low priority | Inception |
| [20684|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=20684&group_id=491&atid=1850] | Cannot compute root node for OBI version v1.0.1423. This item has been discussed and is not an issue for 5.0. Deferred due to low priority | Inception |
| [20797|https://gforge.nci.nih.gov/tracker/index.php?func=detail&aid=20797&group_id=491&atid=1850] | Strict Owl Processing. This item has been discussed and is not an issue for 5.0. Deferred due to low priority | Inception |

h2. Document History

|| Document Version: \\ | Click the Info tab. View the Recent Changes or click the link to view the page history. \\ ||
|| \*Last Modified: \\ | Refer to the first line displayed in the document window. \\ ||
|| Project GForge site: \\ | [https://gforge.nci.nih.gov/projects/lexevs/] ||
|| Most current version: \\ | Unless the display includes a notice that you are viewing a previous version, you are viewing the most current version of this Scope Document for the release indicated in the title. \\ ||
|| Revision history: \\ | Click the Info tab. In the Recent Changes area, click the link to view the page history. \\ ||
|| Review history: \\ | Click the Info tab. In the Recent Changes area, note the developer who made each change and the date and time. Refer to the [Key People Directory|https://wiki.nci.nih.gov/x/Cg5y] for their roles. Click the link to view any page or to view the page history, and then click the link for a page. When the page opens, view the comments and changes made in that version. \\ ||
|| Related documents: \\ | \[EVS:Name and URL of each related document\] \\ ||

h2. Project Information

|| CBIIT Management \\ || Role || Responsibilities ||
| Frank Hartel | Product Manager \\ | Oversees development of the product: features, functions, definition of stakeholders, priorities within the scope, timeframe for release \\ |
| Avinash Shanbhag \\ | Engineering Manager \\ | Oversees NCICB caCORE software engineering practices, conducts design reviews, guides technical development \\ |
| Denise Warzel \\ | Product Line Manager \\ | Oversees NCICB caCORE product line. Responsible for overall product integration, major and minor release cycles. Supports Product Manager. \\ |
\\
{scrollbar:icons=false}