i2b2 Web Client Help
The Find Terms view is designed to allow users to search for concepts. Users can search by the name or by a particular code. Once the appropriate concept is found it can be used in many of the i2b2 views and plug-ins, such as the Query Tool view.
This section describes the layout and contents of this view.
The Find Terms view allows users to search for a concept, group of concepts, and their associated modifiers. There are basically two methods of searching available;(1) by name and (2) by code.
|
NOTE: Regardless of how you search for the concept the layout of both tabs is the same. |
This section has two tabs; one is to Search by Name and the other Search by Code. Depending on which tab is active will determine which search method is used to find the concept.
There are three fields in this section; (1) Qualifier, (2) Text and (3) Category
The qualifier is used to tell the system whether or not you are looking for an exact match or just a partial match. There are four different options to choose from.
The text box is where you will enter what you are searching for.
The category / coding system selection field allows you to narrow down the search to a particular table or set of codes.
The results section displays the concepts that were found based on the search criteria.
The clinical vocabulary that resides in the Ontology Management Cell was partially built using terminology from several standard coding systems. These codes can be used to search for a particular term (see section on Search by Code). The following are some examples of standard coding systems.
Example:
Code: 414.9
Description: Chronic Ischemic Heart Disease, unspecified
Example:
Code: 13969-1
Description: CPK-MB
Example:
Code: 12783-*178-87
Description: Briston-Myers Squibb, Pravachol, 20 mg tablets
Example:
Code: C0001403
Description: Addison's Disease
An additional section called Find Modifiers is located at the bottom of the Find Terms view. This section is only visible once you find a term and select to find the modifiers from the pop-up menu (see section on Finding Modifiers).
The functionality of finding modifiers is very similar to finding terms in that you can search by name or by code and you can define the search criteria to be used when performing the search.
There are two fields in this section; (1) Qualifier, and (2) Text
The qualifier is used to tell the system whether or not you are looking for an exact match or just a partial match. There are four different options to choose from.
The text box is where you will enter what you are searching for.
There are three methods of searching for a modifier; (1) Find Name, (2) Find Code and (3) Get All.
The text entered will be used to search for the name of the modifier.
Example:
Severity: Mild
The text entered will be used to search for the code of the modifier.
Example:
255604002 (this is the SNOMED code for Mild Severity)
The Get All button will return all the modifiers associated with a term regardless of what qualifier and text have been entered.
The results section displays the concepts that were found based on the search criteria.
Depending on the search criteria, the results section may display groups of concepts which are contained in folders as well as individual concepts. The folders can be expanded to see the listing of concepts in that grouping by clicking on the plus sign (
) or negative sign (
) next to the folder icon.
|
NOTE: The ability to expand and collapse folders also extends to the modifier result section which can contain modifiers. |
) next to the folder in the results section of Find Terms view or the Modifier folder in the Find Modifiers section.
) next to the folder in the results section of Find Terms view or the Modifier folder in the Find Modifiers section.
Users can define how many concepts to display and whether or not to show hidden terms and/or synonyms. The display options are set in the Find Terms Options dialog window, which can be accessed by clicking on the Show Options button (
).
The Maximum number of children to display is used when retrieving the search results to be displayed in the results section of the Find Terms view. Once the maximum number is reached a message will appear informing you that the query has reached the maximum number of terms and suggests you try searching again with a more specific query. Running a search with a more specific query will narrow your results as the selection criteria will not be as broadly defined.
In the metadata table, an attribute is set to determine whether or not a term is active, inactive or hidden. If an item is marked as hidden it will not appear in the list of terms. Selecting Show Hidden Terms will display those items marked to be hidden. For easy identification, hidden terms will be red when displayed in the results list.
Some terms may be flagged in the metadata table as a synonym of another term. Selecting Show Synonymous Terms will display both the original term and the synonym in the Find Terms view. For easy identification, synonymous terms will be blue when displayed in the results list.
The Enable patient counts option will display the total number of patients that have an observation fact entered for that item.
By default, the tooltip that displays when you hover over an item will contain the entire path name and the tooltip that is specific to that item. Enabling the Use short tooltips option will only display the tooltip information; the path will not be included.
In addition to showing the tooltip, this option will also display the concept_cd associated to the item.
The ability to search for modifiers will not be available if the Disable modifiers option is checked off.
This section describes how to search for a term using one of the two available methods; (1) Search by Name and (2) Search by Code.
Regardless of whether you are searching by name or by code, the first step in entering the search criteria is defining a qualifier. The first field is the “qualifier” and it is a drop-down list with four options:
The results returned will contain only those terms whose name or code begins with the text entered in the search box.
The results returned will contain only those terms whose name or code ends with the text entered in the search box.
The results returned will be those terms whose name or code ends with the text entered in the search box.
|
NOTE: This search will return the broadest range of results. |
The results returned will be those terms whose name or code matches exactly to the text entered in the search box.
|
NOTE: This search will return the narrowest range of results. |
The method of searching by the name is exactly what it sounds like; you can search for a concept by its name.
Some of the concepts have a standard code associated with them. This code can be used to search for a specific concept or a grouping of concepts.
|
NOTE: The steps listed in this section walk you through a code search using LOINC codes. These same steps can be used when doing a search of any type of code. In step 4, replace LOINC with the coding system you want to search. |
A modifier is associated with a single term or a group of terms. Therefore in order to search for a modifier you must first search for the term. Once the term is found you can begin the process of finding the modifier. Overall the process of finding modifiers is very similar to searching for a term; you can search by name or by code.
Regardless of whether you are searching by name or by code, the first step in entering the search criteria is defining a qualifier. The first field is the “qualifier” and it is a drop-down list with four options:
The results returned will contain only those modifiers whose name or code begins with the text entered in the search box.
The results returned will contain only those modifiers whose name or code ends with the text entered in the search box.
The results returned will be those modifiers whose name or code ends with the text entered in the search box.
|
NOTE: This search will return the broadest range of results. |
The results returned will contain only those modifiers whose name or code matches exactly to the text entered in the search box.
|
NOTE: This search will return the narrowest range of results. |
The method of searching by the name is exactly what it sounds like; you can search for a modifier by its name.
|
NOTE: As stated above you must first search for the term before you can find the associated modifiers. |
) or folder (
).
) or folder ().
) or folder ().
) or folder ().
Some of the modifiers have a standard code associated with them. This code can be used to search for a specific modifier or a grouping of modifiers.
|
NOTE: As stated above you must first search for the term before you can find the associated modifiers. |
) or folder ().
In the Find Modifiers section of the Find Terms view there is a Get All button. This button will return all the modifiers associated to a term.
|
NOTE: As stated above you must first search for the term before you can find the associated modifiers. |
) or folder ().
This section describes how to use a concept or group of concepts.
Individual as well as groups of concepts and modifiers can be dragged and dropped (copied) from the Find Terms View to other views in the i2b2 Web Client.
A folder () and all its concepts (children) can be added to other views by dragging the folder name from Find Terms to one of the following views.
A modifier folder (
) and all its concepts (children) can be added to other views by dragging the folder name from Find Terms to one of the following views.
A concept () can be added to other views by dragging the name of the concept from Find Terms to one of the following views.
A modifier (
) can be added to other views by dragging the name of the modifier from Find Terms to one of the following views.
A folder, individual concept, or modifier can be added to the query tool view by simply dragging the item from Find Terms view and dropping it into one of the panels in the Query Tool view.
) by clicking on the name of the folder.
) by clicking on the name of the concept.
) by clicking on the name of the modifier.
Information in the workplace is related to the most common concepts and queries that an individual uses and in essence becomes their personal workplace.
) by clicking on the name of the folder.
) by clicking on the name of the concept.
) by clicking on the name of the modifier.
