Skip to content

Latest commit

 

History

History
68 lines (55 loc) · 4.37 KB

README.md

File metadata and controls

68 lines (55 loc) · 4.37 KB
Raw

Characterization of Inflammatory Bowel Disease Patient Cohorts

Study Status: Results Available

  • Analytics use case(s): Characterization
  • Study type: Clinical Application
  • Tags: OHDSI, IBD, Crohn's disease, Ulcerative colitis
  • Study lead: Chen Yanover
  • Study lead forums tag: cyanover
  • Study start date: Mar 1, 2022
  • Study end date: Sep 1, 2022
  • Protocol: Word Doc
  • Publications: -
  • Results explorer: Shiny app

In this study we will describe the baseline demographic and clinical characteristics, as well as the occurrence of treatments and outcomes of individuals diagnosed with inflammatory bowel disease (IBD) and, specifically, with Crohn’s disease and ulcerative colitis. The analysis package is a near-duplicate of the CHARYBDIS characterization code for SARS-CoV-2 and COVID-19, replacing cohort, stratum, and feature definitions with IBD ones.

Package Requirements

Installing the Package

Install the IBD characterization package using either of the following methods:

  • renv (RECOMMENDED): To install the IBD characterization package along with all its dependencies in an encapsulated environment (and leaving your main R unchanged), run the code in extras/renvInitScr.R or follow the instructions here.

  • GitHub: To install the package directly from GitHub (you may need to create a Personal Access Token, see instructions here), open an R or RStudio console and run:

install.packages("devtools")
devtools::install_github("ohdsi-studies/IbdCharacterization")
  • Zip file: To preserve the GitHub directory structure, download the repository zip file, copy it into your R or RStudio environment, and unzip it. Then double click on IbdCharacterization.Rproj to open it in R Studio, switch to the Build View and hit Install and Restart. For more details, see The Book of OHDSI.

Running the Study

  1. Edit .Renviron to include the parameters used to connect to your database server (for more information see http://ohdsi.github.io/DatabaseConnector/); for example:
DBMS = "postgresql"
DB_SERVER = "database.server.com"
DB_PORT = 5432
DB_USER = "database_user_name "
DB_PASSWORD = "your_secret_password"
PATH_TO_DB_DRIVER = "C:\temp\jdbcDrivers"
  1. Edit extras/CodeToRun.R to show your database info (db ID, name, and description; CDM schema; cohort schema and tables) and output folder location, as follows:
# Details specific to the database:
databaseId <- "<dbId>"
databaseName <- "<dbName>"
databaseDescription <- "<dbDesc>"

# Details for connecting to the CDM and storing the results
outputFolder <- file.path("D:/results/IbdCharacterization/Runs", databaseId)
cdmDatabaseSchema <- "<cdmDbSchema>"
cohortDatabaseSchema <- "<cohortDbSchema>"
cohortTable <- paste0("IbdCharacterization_", databaseId)
cohortStagingTable <- paste0(cohortTable, "_stg")
featureSummaryTable <- paste0(cohortTable, "_smry")

  1. Run extras/CodeToRun.R to first generate diagnostics info for the Crohn's disease and ulcerative colitis cohorts, then extract the characterization statistics. Once done, you can review cohort diagnostics and characterization using the corresponding shiny apps.

  2. Upload the result files to OHDSI SFTP server (more info to come)