Learn R Programming

Biodose Tools

Overview

Biodose Tools (Hernández et al. 2023) is an open source project that aims to be a tool to perform all different tests and calculations needed by biological dosimetry laboratories. The app is developed using the R programming language and Shiny as a framework to offer an online, easy-to-use solution. Although the intention is to provide the application as a website, all R routines are available as an R package, which can be downloaded for improvement or personal use.

We also aim to clarify and explain the tests used and to propose those considered most appropriate. Each laboratory in its routine work should choose the most suitable method, but the project aims to reach a consensus that will help us in case of mutual assistance or intercomparisons.

The project is initially developed by RENEB association, but contributions are always welcome.

Installation

You can install the released version of {biodosetools} from CRAN with:

install.packages("biodosetools")

Or install the development version from GitHub with:

devtools::install_github("biodosetools-team/biodosetools")

Examples

To run the Biodose Tools app locally, we can run the following command on the R console, which will invoke the Shiny user interface:

library(biodosetools)
run_app()

Detailed examples using {biodosetools}’s Shiny user interface as well as its R API to perform dose-effect fitting and dose estimation for the dicentric and translocation assays are available on https://biodosetools-team.github.io/documentation/ in the “Using Biodose Tools” chapters.

Citation

If you use data, results or conclusion from this work, please cite:

Hernández, A., Endesfelder, D., Einbeck, J., Puig, P., Benadjaoud, M. A., Higueras, M., Ainsbury, E., Gruel, G., Oestreicher, U., Barrios, L., & Barquinero, J. F. (2023). Biodose Tools: an R shiny application for biological dosimetry. International Journal of Radiation Biology, 1-13. https://doi.org/10.1080/09553002.2023.2176564

A BibTeX entry for LaTeX users is:

@article{BiodoseTools2023,
  author        = {Alfredo Hern{'{a}}ndez and David Endesfelder and Jochen Einbeck and Pedro Puig and Mohamed Amine Benadjaoud and Manuel Higueras and Elizabeth Ainsbury and Ga{"{e}}tan Gruel and Ursula Oestreicher and Leonardo Barrios and Joan Francesc Barquinero},
  title         = {{Biodose Tools: an R shiny application for biological dosimetry}},
  journal       = {International Journal of Radiation Biology},
  pages         = {1-13},
  year          = {2023},
  publisher     = {Taylor & Francis},
  doi           = {10.1080/09553002.2023.2176564},
  note          = {PMID: 36731491},
  URL           = {https://doi.org/10.1080/09553002.2023.2176564},
  eprint        = {https://doi.org/10.1080/09553002.2023.2176564}
}

Copy Link

Version

Install

install.packages('biodosetools')

Monthly Downloads

12,024

Version

3.7.2

License

GPL-3

Issues

Pull Requests

Stars

Forks

Maintainer

Anna Frances-Abellan

Last Published

December 16th, 2025

Functions in biodosetools (3.7.2)

correct_boundary

Correct boundary of irradiated fractions to be bounded by 0 and 1
calculate_model_stats

Calculate model statistics
calculate_yield_infimum

Calculate theoretical yield infimum
calculate_table

Calculate the characteristic limits table
calculate_trans_rate_manual

Calculate manual translocation rate
correct_yield

Correct yields if they are below the curve
dose_boxplot

Boxplot dose estimates
dose_estimation_mx

Prepare data to dose estimate using mixed fields manual
curves_plot

Plot curves
dna_content_fractions_morton

DNA Content Fractions of Human Chromosomes (Morton 1991)
dna_content_fractions_ihgsc

DNA Content Fractions of Human Chromosomes (IHGSC)
correct_conf_int

Correct yield confidence interval
correct_negative_vals

Correct negative values
get_deltamethod_std_err

Get standard errors using delta method
include_help

Include Markdown help
estimate_hetero_mixed_poisson

Heterogeneous dose estimation (Mixed Poisson model)
estimate_partial_body_dolphin

Partial-body dose estimation (Dolphin's method)
fun.estimate.criticality

Calculate absorbed dose for mixed fields exposure
estimate_whole_body_delta

Whole-body dose estimation (delta method)
fit_glm_method

Perform GLM (Generalised Linear Model) fitting
fit

Perform dose-effect fitting algorithm
estimate_whole_body_merkle

Whole-body dose estimation (Merkle's method)
fit_maxlik_method

Perform max-likelihood optimization fitting
fun.curve

Calculate curve
generate_plot_and_download

Plot at the UI and save
plot_interlab_deviation

Plot deviation
plot_deviation_all

Plot Deviaition from ref dose all blind samples
load_manual_data

Load manual data
load_rds_data

Load and show rds files
plot_estimated_dose_curve

Plot dose estimation curve
plot_estimated_dose_curve_mx

Criticality Plot
plot_interlab_v2

Plot zscore v2
load_rmd_report

Load RMarkdown report
plot_fit_dose_curve

Plot fit dose curve
%>%

Pipe operator
update_outputs

Update dose estimation box with yield values
plot_triage

Plot triage
project_yield

Project yield into dose-effect fitting curve
plot_zscore_all

Plot Z-scores all blind samples
plot_triage_interlab

Plot triage interlab
u_test_plot

U-test
yield_boxplot

Boxplot yield
yield_error_fun

Calculate yield error
protracted_g_function

Calculate protracted function \(G(x)\)
run_app

Run the Shiny Application
prepare_maxlik_count_data

Prepare count data for max-likelihood optimization fitting
summary_curve_tables

Summary and curve tables
yield_fun

Calculate yield
R_factor

Calculate R regression confidence factor
AIC_from_data

Calculate AIC (Akaike's 'An Information Criterion')
DI_plot

Dispersion index
biodosetools-package

biodosetools package
calculate_aberr_table

Calculate aberrations table
M_estimate

Calculate algB
QHampel

Calculate QHampel
calculate_genome_factor

Calculate genomic conversion factor
calc.zValue.new

Calculate ZScore
bar_plots

Bar plots dosimetry
calculate_aberr_IRR

Calculate IRR (this is the same as the Odds-Ratio calculation in IAEA2011)
calculate_aberr

Aberration calculation functions
calculate_yield

Calculate yield from dose
calculate_trans_rate_sigurdson

Calculate Sigurdson's translocation rate
calculate_characteristic_limits

Characteristic limits function-----------------------------------------------