|
1 |
| -# Introduction |
| 1 | + |
| 2 | +<div id="main_title" class="my-class"> |
| 3 | +PhenEx |
| 4 | +</div> |
| 5 | + |
| 6 | + |
2 | 7 |
|
3 | 8 | Implementing observational studies using real-world data (RWD) is challenging, requiring expertise in epidemiology, medical practice, and data engineering. Currently, observational studies are often implemented as bespoke software packages by individual data analysts or small teams. While tools exist, such as open-source tools from the OHDSI program in the R language and proprietary tools from vendors like Aetion or Panalgo, there are no open-source tools for Python-based implementation of observational studies using RWD.
|
4 | 9 |
|
5 | 10 | PhenEx (Automated Phenotype Extraction) aims to fill this gap. PhenEx is a Python-based software package that aims to provide reusuable and end-to-end tested implementations of commonly performed operations in the implementation of observational studies. PhenEx is designed with a focus on ease of writing and reading cohort definitions. Medical domain knowledge should be clear and simple, without requiring an understanding of complex data schemas. Ideally, a cohort definition should read like free text.
|
6 | 11 |
|
7 |
| -# Basics of PhenEx design |
8 |
| - |
9 |
| -## The Phenotype class |
10 | 12 |
|
| 13 | +## Basics of PhenEx design |
| 14 | +### The Phenotype class |
11 | 15 | The most basic concept in PhenEx is the phenotype. A Phenotype is a set of criteria that define a cohort of patients. In a clinical setting, a Phenotype is usually identified by the phrase "patient presents with ...". For example, a phenotype could be "patient presents with diabetes". In the observational setting, we would cacluate the phenotype "patient presents with diabetes" by looking for patients who have a diagnosis of diabetes in their medical record in certain time frame.
|
12 | 16 |
|
13 | 17 | A phenotype can reference other phenotypes. For instance, the phenotype "untreated diabetic patients" might translate to real-world data as "having a diagnosis of diabetes but not having a prescription for insulin or metformin". In this case, the prescription phenotype refers to the diabetes phenotype to build the overall phenotype. In PhenEx, your job is to simply specify these criteria. PhenEx will take care of the rest.
|
14 | 18 |
|
15 | 19 | All studies are built through the calculation of various phenotypes:
|
16 | 20 |
|
17 |
| -- entry criterion phenotype |
18 |
| -- inclusion phenotypes |
19 |
| -- exclusion phenotypes |
20 |
| -- baseline characteristic phenotypes, and |
21 |
| -- outcome phenotypes. |
| 21 | +* entry criterion phenotype |
| 22 | +* inclusion phenotypes |
| 23 | +* exclusion phenotypes |
| 24 | +* baseline characteristic phenotypes, and |
| 25 | +* outcome phenotypes. |
22 | 26 |
|
23 | 27 | After defining the parameters of all these phenotypes in the study definition file, PhenEx will compute the phenotypes and return a cohort table, which contains the set of patients which satisfied all the inclusion / exclusion / entry criteria for the specified study. Additionally, a baseline characteristics table will be computed and reports generated, including a waterfall chart, the distributions of baseline characteristics.
|
24 | 28 |
|
25 |
| -# Architecture |
| 29 | +### Architecture |
| 30 | + |
26 | 31 |
|
27 | 32 | Below is an illustration of the basic design of the PhenEx in the evidence generation ecosystem.
|
28 | 33 |
|
29 | 34 | .. image:: architecture.jpg
|
30 |
| -:width: 500 |
| 35 | + :width: 500 |
31 | 36 |
|
32 | 37 | # Getting started
|
33 |
| - |
34 | 38 | To get started, please head over to our tutorial and demos.
|
0 commit comments