https://github.com/bayer-group/bic-doris

Dose Response in Subgroups

https://github.com/bayer-group/bic-doris

Science Score: 13.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (8.5%) to scientific vocabulary

Keywords

bayer-not-classified bayer-reg-none beat-not-applicable clinical-trials shiny-apps subgroup-analysis visualization
Last synced: 6 months ago · JSON representation

Repository

Dose Response in Subgroups

Basic Info
Statistics
  • Stars: 5
  • Watchers: 1
  • Forks: 1
  • Open Issues: 8
  • Releases: 0
Topics
bayer-not-classified bayer-reg-none beat-not-applicable clinical-trials shiny-apps subgroup-analysis visualization
Created over 1 year ago · Last pushed 11 months ago
Metadata Files
Readme

README.md

DoRiS - Dose Response in Subgroups

Intention

One dose fits all? Not necessarily! There might not always be a single dose level that is adequately safe and effective in all patients. For some drugs individualized dosing would deliver significantly greater efficacy and/or safety. For other drugs individualized dosing might even be necessary due to a small therapeutic window. Individualized dosing can help to improve development success rates and competitiveness in clinical use.

Example

Imagine a higher dose response in females compared to males which might remain undetected by focusing on the overall study result.

The DoRiS (Dose Response in Subgroups) application can be used to identify such subgroups with a dose response that deviates from the remaining study participants. Therewith potential subgroups for individualized dosing can be identified.

How DoRiS works

Consider a dose finding study with three active dose levels and placebo. In figure 2, the potential dose response curve of a subgroup is shown in blue and the dose response curve in of the reference group in green. The reference group is chosen as the complement of the subgroup here. For finding a subgroup corresponding with a curve like the blue one, we specify in which pattern of deviation between the two dose response curves the user is interested in (Figure 1).

For example: equal – greater – greater – greater means the user is looking for a deviating subgroup with equal response after placebo and greater response after the active doses. Next, it is specified a clinically meaningful difference delta the user is interested in. If the target variable is the change in blood pressure the user may select a difference of 5 mmHg.

Figure 1: Identification of subgroups deviating from the overall dose response 

Figure 1 presents a screenshot from the DoRiS application showing the main settings, where the user can select a target variable and all subgroup defining factors. The other options are basically all about the pattern and how to compare the overall data. For the example in Figure 3 we selected a ‘manual’ pattern choice, the ‘subgroup complement’ as reference, the pattern ‘equal – smaller – smaller’, a clinically meaningful difference of delta=0.1 and a number of ‘1000’ runs for our the permutation test.

Fuzzy Logic

Fuzzy logic gives us a truth value for the required difference in each dose group to be true. For dose group D3 the truth value for the difference to be greater by delta is 1 because the difference is actually greater than delta. Same for dose group D2 – here the difference is exactly equal to delta. For dose group D1 the difference is only about 70% of delta, so the truth value is about 0.7. For the placebo group P the difference is almost 0, i.e. the truth value for being equal is very close to 1. Then a total truth value for the complete pattern of deviation is determined as the average of the single truth values weighted by the number of subjects in the dose groups.

Finally, a permutation test is performed (cf. Fig. 1). The subgroup affiliation within the dose groups is shuffled and the total truth value is calculated for each permutation. The location of the observed total truth value in the distribution of simulated values is then used to identify remarkable subgroups.

Figure 2: Settings to be selected in the DoRiS application.

What DoRiS provides

When all settings are done and executed the user receives a dashboard like in Figure 3. A list of all subgroups sorted by the total truth values with the best fitting subgroup at the top can be seen on the left side in the DoRiS application. On the right side the dose reponse curve for the respective subgroup is displayed together with a histogram of the total truth values from the 1000 permutations. Only very few of the simulated total truth values are larger than the observed total truth value in this example – which is presented as a dashed line – which results in a small p-value of 0.005.

Interesting deviating subgroups can then be further explored with the team. Can the exposure data explain the observed deviation? Do PK/PD models support the deviation in dose response? Is there any literature available describing mechanisms explaining the observed deviation?

Figure 3: Exemplary results of searching for subgroups deviating from the overall dose response based on the settings shown in Figure 1 for the example data set for DoRiS 

Getting started

Required packages

Some packages need to be available for running DoRiS. You may copy the subsequent statements for your convenience. r install.packages("devtools") install.packages("shiny") install.packages("shinyWidgets") install.packages("bslib") install.packages("bsplus") install.packages("shinyBS") install.packages("DT") install.packages("tidyr") install.packages("dplyr")

Installation

You can install and load the development version from GitHub with:

``` r

install.packages("devtools")

devtools::install_github("bayer-group/BIC-doris") library(doris) ```

and start the app with:

``` r

run_doris()

```

All needed packages are loaded automatically by the app. For a reason unknown until now it may be necessary to load “dplyr“ manually.

Download test data

Go into directory "data" and download file "dorisExampleData.csv" which includes simulated data. The first 4 records are: bmi,age,race,sex,type,dose,target low BMI,<40 years,White,Female,Acute disease,0,0.0526818366 high BMI,>=40 years,White,Female,Acute disease,0,-1.068076082 low BMI,>=40 years,White,Female,Acute disease,0,0.923497978

To download a single data set as a csv file, click on the file name, then on the raw button and save the file with the respective function of your browser.

Owner

  • Name: Bayer Open Source
  • Login: Bayer-Group
  • Kind: organization

Science for a better life

GitHub Events

Total
  • Issues event: 6
  • Watch event: 6
  • Member event: 2
  • Push event: 6
  • Fork event: 1
Last Year
  • Issues event: 6
  • Watch event: 6
  • Member event: 2
  • Push event: 6
  • Fork event: 1

Committers

Last synced: about 1 year ago

All Time
  • Total Commits: 3
  • Total Committers: 1
  • Avg Commits per committer: 3.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 3
  • Committers: 1
  • Avg Commits per committer: 3.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Bodo Kirsch 9****h 3

Issues and Pull Requests

Last synced: 12 months ago

All Time
  • Total issues: 2
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 1
  • Total pull request authors: 0
  • Average comments per issue: 0.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 2
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 1
  • Pull request authors: 0
  • Average comments per issue: 0.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • TammoReinders (6)
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels

Dependencies

DESCRIPTION cran
  • DT * imports
  • bslib * imports
  • dplyr * imports
  • shiny * imports
  • shinyBS * imports
  • shinyWidgets * imports
  • tidyr * imports