NIH | National Cancer Institute | NCI Wiki  

Versions Compared

Old Version 15

changes.mady.by.user Bauer, Scott (NIH/NCI) [C]

Saved on

compared with

New Version 16

changes.mady.by.user Bauer, Scott (NIH/NCI) [C]

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Description:

Gets minimal representations of coding schemes based on what was used to resolve a value set

Input:

CodingScheme cs: CodingScheme object with full metadata populated, entity representation not necessary

Output:

AbsoluteCodingSchemeVersionReferenceList:  Might be more than one coding scheme that defines this value set

Exception:

none

Implementation Details:

Implementation:
Call this method on the associated LexEVS Asserted Value Set service instance to determine what coding schemes define the value set. 
Sample Call:

  • Step 1:Instantiate SourceAssertedValueSetService if it is not done yet:

    Code Block
    org.lexgrid.valuesets.SourceAssertedValueSetServiceImpl  assVSServ = new SourceAssertedValueSetServiceImpl(new AssertedValueSetParameters.Builder().build());

  • Step 2: Get a coding scheme using one of the Asserted Value Set Service methods: 

    Code Block
    CodingScheme cs = assVSServ.getSourceAssertedValueSetForValueSetURI(new URI("http://evs.nci.nih.gov/valueset/CDISC/C12434")) ;

  • Step  3: List all the coding schemes defined by the top node designated by the unique identifier

    Code Block
    AbsoluteCodingSchemeVersionReferenceList list = assVSServ.getListOfCodingSchemeVersionsUsedInResolution(cs);

     

     

...

Concept Reference Read Functions

  • Get references for unique URI identifier - Unique identifier returns all value set members of that coding scheme representation of a value set.
  • Get a list of string unique identifiers of references that are a top node - All top nodes of a system are returned based on the identification of the node that has a reference to the top of the hierarchy

Get Resolved Concept References for the Coding Scheme Unique Identifier

Code Block
 getSourceAssertedValueSetIteratorForURI
getSourceAssertedValueSetEntitiesForURI

Description:

Gets Resolved Concept Reference representations of entity values in a value set based on the unique identifier of the coding scheme representation

Input:

String uri: String representation of the coding scheme unique identifier

Output:

ResolvedConceptReferenceList or ResolvedConceptReferencesIterator:  Entities listed or iterated over that are members of the value set defined by the unique URI designation

Exception:

none

Implementation Details:

Implementation:
Call this method on the associated LexEVS Asserted Value Set service instance to get entities from a unique value set
Sample Call:

  • Step 1:Instantiate SourceAssertedValueSetService if it is not done yet:

    Code Block
    org.lexgrid.valuesets.SourceAssertedValueSetServiceImpl  assVSServ = new SourceAssertedValueSetServiceImpl(new AssertedValueSetParameters.Builder().build());

  • Step 2: Get a coding scheme using one of the Asserted Value Set Service methods: an iterator over the entity members of the value set

    Code Block
    ResolvedConceptReferencesIterator iterator = assVSServ.getSourceAssertedValueSetIteratorForURI("http://evs.nci.nih.gov/valueset/CDISC/C119014");

  • or get a list

    Code Block
    ResolvedConceptReferenceList list = assVSServ.getSourceAssertedValueSetEntitiesForURI("http://evs.nci.nih.gov/valueset/CDISC/C119014");

     

     

 

Get Top Node References

Code Block
 

Description:

Gets String references to all top node leaves under a root node

Input:

String rootCode: String representation of the unique identifier of the Asserted Value Set root entity

Output:

List<String>:  String references to entity top node designations of the Asserted Value Sets

Exception:

none

Implementation Details:

Implementation:
Call this method on the associated LexEVS Asserted Value Set service instance to get all top node string identifier references
Sample Call:

  • Step 1:Instantiate SourceAssertedValueSetService if it is not done yet:

    Code Block
    org.lexgrid.valuesets.SourceAssertedValueSetServiceImpl  assVSServ = new SourceAssertedValueSetServiceImpl(new AssertedValueSetParameters.Builder().build());

  • Step 2: Get a list of all the top nodes in the Asserted Value Set system:

    Code Block
    List<String> list = assVSServ.getSourceAssertedValueSetTopNodesForRootCode("C54443");

     

     

Search Function

  • Get value set coding scheme reference based on a text match for a member entity - Can be used with a text match algorithm determining match type.

...