/patient-safety-processing-FAERS-notebook

Primary LanguageJupyter NotebookMIT LicenseMIT

Population-scale identification of differential adverse events before and during a pandemic

Authors: Xiang Zhang, Marissa Sumathipala, Marinka Zitnik

Paper on Nature Computational Science

Project website

Approach overview

We investigate 10,443,476 adverse event reports (involving 19,193 adverse events and 3,624 drugs) from the U.S. Food and Drug Administration (FDA) Adverse Event Reporting System (FAERS) dataset, collected from January 2013 to September 2020. To support safety surveillance of therapeutic products, the FAERS stores anonymized, manually reviewed adverse event reports received by the FDA.

We use the dataset to detect adverse events that are significantly associated with the pandemic, pinpoint clinically relevant drugs strongly connected with adverse drug events, and identify disparities in the distribution of adverse events across sex and age. To this end, we develop an approach that identifies clinically meaningful adverse events that meet three criteria: i) the reporting frequency of the adverse event changed significantly between 2019 and 2020, ii) the change cannot be explained by its trend in previous years (2013 to 2019), and iii) the adverse drug reaction is strongly associated with at least one drug and cannot be explained by drug interference.

Regenerating results following scripts

  • Step 1 1_rawdata_download.ipynb: Download raw FAERS data from 2013 Q1 to 2020 Q3 (31 quarters). We provide bash commands to efficiently download the quarterly dataset. See XML_NTS.pdf (provided in Dataset) for a better understanding of data structure and description.

  • Step 2 2_parsing_preprocessing.ipynb: Extract key information from FAERS raw XML data, including administration (version, report_id, case_id, country, qualify, serious, serious subtype list, receivedate, receiptdate), demographic (age, gender, weight), adverse events list (each element represents an adverse drug reaction including PT_code, PT, and outcome), and drug list (each element represents a drug, the key information is drug substance)). Some reports are incomplete, we fill a fixed number for missing values (more details are introduced in script). The files are parsed in quarter and then merged. We provide the curated and processed data at Dataset.

  • Step 3 3_generate_population_cohort.ipynb: Load processed dataset and narrow down based on reporting country (only keep reports occurred in the US) and reporter's qualification (only keep reports submitted by healthcare professionals). In order to conduct population-scale analysis, we generate cohorts for different populations: all patients, male, female, young (age:1-19), adult (20-65), and elderly (>65).

  • Step 4 4_disproportionality_estimation.ipynb: This script corresponds to the disproportionality estimation as introduced in the online methods in our paper. For each population, we conduct disproportionality estimation on each adverse event to examine the association between the adverse event and pandemic (March 11–September 30, 2020) in contrast to before the pandemic (March 11–September 30, 2019). We here use disproportionality analysis in a novel way that quantifying the association between adverse events and their submission periods. We calculate the significance values using Fisher’s exact test followed by the Bonferroni correction for multiple hypothesis testing. We keep only the adverse events, which pass both the significance test (adjusted p-value < 0.05) and the ROR criterion.

  • Step 5 5_AE_trajectories.ipynb: Implement AE reporting trajectories as described in our paper. For each adverse event, we calculate its incidence proportion from 2013 to 2019 and use 2-order auto-regressive regression to model its trajectory. We then define a dedicated pandemic-adverse event association index (PAEAI) to measure whether a medication’s incidence during the pandemic conforms to its trajectory. We only feed adverse events with positive PAEAI to the next step of our approach. In this file, we also map adverse events from Preferred Terms (PTs) level to System Organ Classes (SOCs) level, based on etiology (such as infections and infestations) and manifestation sites (such as gastrointestinal disorders) following the MedDRA hierarchy.

  • Step 6 6_remove_drug_interference.ipynb: Correspond to the step of drug interference in our approach. In this file, we check two aspects of the association among drugs, adverse events, and the pandemic. First, the adverse event (such as hallucination) should be significantly associated with the therapy of at least one drug (like Pimavanserin). Second, the formed drug-adverse event pair (like Pimavanserin-hallucination) should be significantly associated with the pandemic. Note: 1) exchange the order of the above two moves will not change the results. 2)this step is kind of computational expensive as containing nest loops.

  • Step 7 7_results_analysis.ipynb: This file mainly shows the results of our analysis, including the high-level comparison of different populations, enriched adverse events in each population, difference and common SOC of populations, significant drug-adverse event pairs in each population (both overrepresentation and underrepresentation), etc.

Configuration and run scripts

Our scripts are run in O2 cluster which is a platform for Linux-based high-performance computing at Harvard Medical School. The source codes are tested on Linux with Python 3.7, however, our scripts have no requirement of operating systems.

  1. We recommend the user run scripts in a virtual environment. Build a virtual environment named patientsafety and install Jupyter Notebook if you don't have it:
virtualenv patientsafety
source patientsafety/bin/activate
pip install jupyter

The installation will only takes a few minutes.

  1. Download our scripts to your local server/computer. Then creat a folder (such as Code) and copy all scripts in:
git clone https://github.com/mims-harvard/patient-safety.git
cd patient-safety
mkdir Code
mv *.ipynb Code/
  1. Create a new folder named Data at the same level as Code. Then create subfolders: curated for all necessary data to run our scripts including patient safety dataset and supporting files (such as drug and adverse event ontology); pandemic to save intermediate results; a subfolder of pandemic called results to save final analyze results; parsed for datasets parsed from raw data through 2_parsing_preprocessing.ipynb. You can do that in a terminal as following
mkdir Data
mkdir Data/curated
mkdir Data/pandemic/
mkdir Data/pandemic/results
mkdir Data/parsed

  1. Next we need to prepare the curated dataset and mapping dictionary (for drugs and adverse events). The necessary dataset to reproduce our work are processed patient safety reports (patient_safety.pk), drug mapping files (AE_mapping.pk , AE_dic.pk), and adverse event mapping (drug_mapping.pk ). Download them from here or here, and move data to folder Data/curated/. If your data path is different, please remember to revise file path accordingly. Note: we also provide a corresponding .csv version for all the necessary data. Find them in the same link.

  2. Before running the codes, please make sure you have configured the required environment. The dependencies and versions are listed in requirements.txt. All the necessary packages can be installed using the following command

pip install -r requirements.txt
  1. Open Jupyter Notebook and enjoy your analysis:
cd Code
jupyter notebook

About running time, 2_parsing_preprocessing.ipynb, 3_generate_population_cohort.ipynb, and 6_remove_drug_interference.ipynb will take a rather long time (like a few hours) due to large-scale dataset and nest loops; the other scripts are much faster (such as ten minutes).

Convert to python scripts

Our codes (*.ipynb) are written in Jupyter Notebook. It is very easy to convert codes to python scripts. Take 3_generate_population_cohort.ipynb as an example, run the following command in your terminal,

jupyter nbconvert --to script 3_generate_population_cohort.ipynb

The above command will generate a 3_generate_population_cohort.py which can be directly run in python IDEs (such as PyCharm) or in terminal.

python 3_generate_population_cohort.py

Apply our model to flexible scenarios

The users can easily modify 3_generate_population_cohort.ipynb to generate their interested cohorts as a function of reporting time, age, sex, weight, drug, adverse events, etc. For example, our work investigates the period from 03-11 to 09-30 from 2013 to 2020. If anyone wants to analyze a different period, just replace the start or end time: such as replace 09-30 by 12-31 to study the period from March 11 to December 31.

Dataset description

We provide all necessary dataset for reproducing our work, or direct download files here.

Data for running

In our scripts, data in pickle format are directly used to generate results. However, for preview and broader use, we also supply all required dataset in non-language-specific format (CSV version). See instructions for use these .pk files here.

Patient safety dataset

  • patient_safety.pk: Processed FAERS dataset (We depicted the procedure of raw data download, data parsing, and preprocessing in 1_rawdata_download.ipynb and 2_parsing_preprocessing.ipynb). Duplicated reports are already removed. This is a DataFrame where each row denotes an independent report. The rows represent the report version, report ID, case ID, country, qualify, severity, severity subtype 1, severity subtype 2, severity subtype 3, severity subtype 4, severity subtype 5, severity subtype 6, receivedate, receiptdate, age, gender, weight, adverse events list (each element represents an adverse drug reaction including PT_code, PT name, and outcome), and drug list (each element represents a drug, the key information is drug substance). Please find more details about the meaning of each column in 2_parsing_preprocessing.ipynb and XML_NTS.pdf.

  • XML_NTS.pdf: Included in raw data released by FDA. This file describes the data structure in the XML files in detail. Use of the XML file adheres to the original standards documents for E2b and the M2 implementation specifications.

Drug and adverse event ontology (mapping tables)

  • AE_mapping.pk: This is a DataFrame stored in pickle format. This file contains all adverse events in MedDRA ontology. Each row denotes one adverse event. The columns denote the name and code of the adverse event in different levels: PT (preferred terms), HLT (high-level term), HLGT (high-level group term), and SOC (system organ class). In particular, the columns are PT, PT_name, HLT, HLT_name, HLGT, HLGT_name, SOC, SOC_name, and SOC_abbr (abbreviation of SOC name).

  • AE_dic.pk: Extracted adverse event name (PT_name) from AE_mapping.pk and form as a dictionary, which enables fast indexing the adverse event.

  • drug_mapping.pk: Dictionary that maps drug substance from text to DrugBank identifier retrieved from DrugBank Vocabulary. The key of the dictionary is textural name of drug substance, the corresponding value is a list including two elements: DrugBank ID and a number representing the order in which the drug appeared in the FAERS dataset.

  • drug_ATC_mapping.csv: Anatomical Therapeutic Chemical (ATC) ontology. The ATC categorization is an internationally accepted classification system maintained by the WHO that classifies active ingredients of drugs according to the organ or system on which they act and their therapeutic, pharmacological, and chemical properties. This file contains the broad class of ATC codes, each subclass level in a separate column, the DrugBank ID, FAERS code ID, and string name.

Note: All data about MedDRA ontology are retrieved from MedDRA through Non-Profit/Non-Commercial License and can only be used in non-profit activities!

Data in CSV format

  • patient_safety.csv, AE_mapping.csv, and *drug_mapping.csv are the same files in CSV format of patient_safety.pk, AE_mapping.pk, and drug_mapping.pk. These CSV files are not used in our scripts but offer opportunities for researchers to study population-scale patient safety in various platforms and programming languages.

Analysis results

We share the intermediate and final results of our analysis.

Final results

The following results are organized in the same way: beta represents the association between adverse events and the pandemic period (p-value is measured by Fisher’s exact test, adjusted by Bonferroni correction). The adverse events are sorted in descending order of PAEAI. The defined PAEAI presents the extent (higher PAEAI suggests larger deviation) that adverse event deviates from its historical trend (Methods). All identified adverse events have positive PAEAI which indicates the reporting pattern during the pandemic doesn’t follow its trajectory. The ‘E’ and ‘P’ in the ‘E\P’ column denotes this adverse event is enriched or purified, respectively.

  • Identified_adverse_events_in_all_patients.csv: Summary of adverse events identified by our approach in all patients.

  • Identified_adverse_events_in_male.csv: Summary of adverse events identified by our approach in male patients.

  • Identified_adverse_events_in_female.csv: Summary of adverse events identified by our approach in female patients.

  • Identified_adverse_events_in_young.csv: Summary of adverse events identified by our approach in young patients.

  • Identified_adverse_events_in_adults.csv: Summary of adverse events identified by our approach in adult patients.

  • Identified_adverse_events_in_elderly.csv: Summary of adverse events identified by our approach in elderly patients.

Intermediate results

We present intermediate results during our analysis. The top 100 results (adverse events or drug-AE pairs) the lowest p-value are already reported in supplementary Tables 7-9. Here show the full table of them.

  • Associations_between_adverse_events_and_the_pandemic.csv: Evaluate the association between adverse events and the pandemic period. The Occur 2019 and Nonoccur 2019 denote the submitted reports that contain and do not contain the specific adverse event in 2019 (March 11 -- September 30), respectively. Similarly, Occur 2020 and Nonoccur 2020 denote the statistics in the same period of 2020. The p-value is measured by Fisher's exact test followed by Bonferroni correction. Higher beta and smaller p-value indicate the adverse event has stronger association with the pandemic.

  • Associations_between_adverse_events_and_the_pandemic_Top100.csv: The top 100 adverse events in Associations_between_adverse_events_and_the_pandemic.csv with the lowest p-values. Sorted in descending order of beta. Correspond to SI Table 7.

  • Associations_between_adverse_events_and_drugs.csv: Evaluate the association between adverse events and drugs during the pandemic period. Contains the number of patients who: exposed to the drug and have the adverse event (denoted by A); exposed to the drug but not have the adverse event (denoted by B); not exposed to the drug but have the adverse event (denoted by C); not exposed to the drug and not have the adverse event (denoted by D). All the numbers (A, B, C, and D) are measured during the pandemic period (March 11 -- September 30, 2020). We conduct patient matching and split patients into test group and control group. The size of control group is ten times of that of test group, which means that 10 *(A+B) = C+D (Methods). Higher gamma and smaller p-value indicate the adverse event has stronger association with the drug.

  • Associations_between_adverse_events_and_drugs_Top100.csv: The top 100 drug-adverse event pairs of Associations_between_adverse_events_and_drugs.csv with the lowest p-values. Sorted in descending order of gamma. Correspond to SI Table 8.

  • Associations_between_drug_adverse_event_pairs_and_the_pandemic.csv: Evaluate the association between drug-adverse event pairs and the pandemic. The Occur 2019 and Nonoccur 2019 denote the number of submitted reports that contain and do not contain the specific drug-adverse event pair in 2019 (March 11 -- September 30), respectively. Similarly, Occur 2020 and Nonoccur 2020 denote the statistics in the same period of 2020. The p-value is measured by Fisher's exact test followed by Bonferroni correction. Higher delta and smaller p-value indicate the pair has stronger connection with the pandemic.

  • Associations_between_drug_adverse_event_pairs_and_the_pandemic_Top100.csv: The top 100 drug-adverse event pairs of Associations_between_drug_adverse_event_pairs_and_the_pandemic.csv with the lowest p-values. Sorted in descending order of delta. Correspond to SI Table 9.

Dataset download

All files in dataset can be downloaded here. Download portals for separate files:

Data in pickle format

Data in CSV format

Results

Miscellaneous

Please send any questions you might have about the approach and/or the scripts to xiang_zhang@hms.harvard.edu.

License

This work is licensed under the MIT License.