-
Notifications
You must be signed in to change notification settings - Fork 9
Negative Controls In ATLAS
Erica Voss edited this page Nov 14, 2019
·
3 revisions
If you are using ATLAS release 2.4.0 or higher you can generate negative controls. The tool is set up for use in the public OHDSI ATLAS however can be configured internally.
- Navigate to OHDSI ATLAS
- Create a concept set with your exposure or conditions of interest.
- The list should either be drugs or conditions; given drugs you will receive condition negative controls and given conditions you’ll receive drug negative controls.
- You want to generate one list of negative controls for all exposures or conditions of interest. No need to generate separate concept sets for each exposure or condition of interest, put them all together in one list.
- Within you concept set, navigate to the “Explore Evidence” tab.
- On the “Explore Evidence” tab there are two optional "Generation Settings": to note concepts to include and concepts to exclude. In order to add concepts to these lists, generate a "Concept Set" and then add that concept set to the include/exclude option using the folder icon.
- What concepts do you want to include as known negative controls? (Optional) - If you already have a list of concepts you know you would like to use, add them here. Note that this does not force concepts into the list, it merely highlights concepts that you already believe are good. The process may also note the concept you wanted to include is not a good negative control. Adding concepts here is for information purposes only.
- What concepts do you want to exclude as known positive controls? (Optional) - If you already have a list of concepts you know you would like to exclude, add them here. For example, concepts used within your cohort definition are good concepts to consider adding to the exclude list. Excluded concepts defined by the users will be eliminated from consideration as good negative controls regardless of what the system believes.
- Hit the "Generate Button", it may take several moments to generate your list however the system will communicate its status while doing so.
- Once the "Generation Status" is listed as "COMPLETE", hit the "View Evidence" button.
- A list all concept considered will be displayed below the "View Evidence" button:
-
Left Hand Navigation
This can be used to filter the results.- "Suggested Negative Control" allows users to filter to just items that the system deems to be good negative controls.
- "Found in Publications" allows user to filter publication evidence.
- "Found on Product Label" allows user to filter product label evidence.
- "Signal in FAERS" allows user to filter on spontaneous report information.
- "User Specified" allows user to filter to conditions specified above as concepts to include.
-
Record Counts
There are two columns in the evidence, one for "RC" which stands for "record counts" and another "DRC" which stands for "descendant record counts". These columns will show you how often the exact concept appears in your data (i.e. RC) and how often the concept and its descendants show up in your data (i.e. DRC). The drop down allows you to select your data set to use to show these counts. If you are using the public OHDSI ATLAS it is using SYNPUF a synthetic data set, in this case the counts are meaningless. - Table of Results - the table shows the evidence generated from the CommonEvidenceModel for your concept set. Column details can be found in the "Columns of Evidence" section below.
-
Column visibility
Not all columns are shown by default however they can be exposed by hitting the "Column Visibility" and selecting the columns of interest. - Exporting Results - press the CSV button to export the results.
- Save New Concept Set From Selection Below - you can create a concept set from the list, it will only select concepts that are being shown (e.g. if you filter to Suggested Negative Control = "Yes" and press the button to save as new concept set, it will save the filtered concepts to the list)
Column | Description |
---|---|
ID | OMOP CONCEPT_ID reviewed for evidence. |
Name | OMOP CONCEPT_NAME reviewed for evidence. |
Domain | What the concept belongs to, this will either be condition or drug (however it is possible a concept moved domain and if they are not in the domain of interest do not use). |
Suggested Negative Control | A list of suggested negative controls based on the following:
|
Sort Order | In the Negative Controls Prep of a Concept Universe processing of the CommonEvidenceModel and order is generated off patient level data. It is meant to give the user a perspective on order of importance and has been abstracted to 1 through N. |
Publication Count (Descendant Concept Match) | For descendants of this concept, how many publications exist. |
Publication Count (Exact Concept Match) | For this concept, how many publications exist. |
Publication Count (Parent Concept Match) | For parents of this concept, how many publications exist. |
Publication Count (Ancestor Concept Match) | For ancestors of this concept, how many publications exist. |
Indicated | Does the OMOP Vocabulary associate this drug and condition in an “indication” or "contraindication" relationship? |
Broad Concept | Is this concept determined to be too broad for use? |
Drug Induced Concept | Is this a concept already suggesting an association between a drug and condition and should be avoided? |
Pregnancy Concept | Is this concept related to pregnancy and should be avoided? |
Product Label Count (Descendant Concept Match) | For descendants of this concept, does the US structure product label suggest that this drug and condition are in an adverse event. |
Product Label (Exact Concept Match) | For this concept, does the US structure product label suggest that this drug and condition are in an adverse event. |
Product Label (Parent Concept Match) | For parents of this concept, does the US structure product label suggest that this drug and condition are in an adverse event. |
Product Label (Ancestor Concept Match) | For ancestors of this concept, does the US structure product label suggest that this drug and condition are in an adverse event. |
FAERS Count (Descendant Concept Match) | For descendants of this concept, do spontaneous reports from the US FAERS system suggest there a possible signal (PRR >= 2, case count >= 3, and chi-squared >= 4) (Evans et al). |
FAERS Count (Exact Concept Match | For this concept, do spontaneous reports from the US FAERS system suggest there a possible signal (PRR >= 2, case count >= 3, and chi-squared >= 4) (Evans et al). |
FAERS Count (Parent Concept Match) | For parents of this concept, do spontaneous reports from the US FAERS system suggest there a possible signal (PRR >= 2, case count >= 3, and chi-squared >= 4) (Evans et al). |
FAERS Count (Ancestor Concept Match) | For ancestors of this concept, do spontaneous reports from the US FAERS system suggest there a possible signal (PRR >= 2, case count >= 3, and chi-squared >= 4) (Evans et al). |
User Excluded | Identifies any concepts the user added to the interface to exclude. This will eliminate the concept from consideration as a negative control. |
User Included | Identifies any concepts the user added to the interface to include. This is for information purposes only, it does not affect the processing and does not add the concept if it was not considered by the system. |
Optimized Out | A concept is removed from consideration if a parent concept already exists on the list as defined by the OMOP Vocabulary. |
Not Prevalent | Excluded concept if not considered prevalent enough in the data. |
RC | "RC" which stands for "record counts" and shows the users how often the exact concept appears in in the selected database. |
DRC | "DRC" which stands for "descendant record counts" and shows how often the concept and its descendants show up in the selected database. |
If you would like to set up ATLAS to generate negative controls within your own environment, you need the following exported tables from CEM:
- CEM_UNIFIED - All translated evidence in CEM is placed into one unified table structure.
- NC_LU_CONCEPT_UNIVERSE - a list of potential exposure-outcome pairs source from a large US claims database
Information about the table structures can be found here: CEM Documentation
Additionally you will need this OMOP Vocabulary table:
- CONCEPT_ANCESTOR - from the OMOP Vocabulary and provides a complete hierarchical relationship between concepts.
Information about the CONCEPT_ANCESTOR table structure can be found on the CDM GitHub: CDM GitHub
Contact Erica Voss, Anthony Sena, or Lee Evans support in generating negative controls in your local ATLAS environment.
- Evans SJ, Waller PC, Davis S. Use of proportional reporting ratios (PRRs) for signal generation from spontaneous adverse drug reaction reports. Pharmacoepidemiol Drug Saf. 2001 Oct-Nov;10(6):483-6. PubMed PMID: 11828828.
- "Common Data Model: CONCEPT_ANCESTOR." from https://github.com/OHDSI/CommonDataModel/wiki/CONCEPT_ANCESTOR.
CommonEvidenceModel (CEM)