README.md

bmdrc

Python library for the calculation of BenchMark Dose Response Curves (bmdrc)

General Schematic

The bmdrc library was built to calculate benchmark dose (BMD) response curves for dichotomous (morphological) and light photomotor response datasets, where continuous variables are transformed to dichotomous as described in Thomas et al 2019. Potential outputted files include a csv file of all final BMDs and their estimation errors, a csv file of model fits (AIC) for each endpoint, and an html report containing information on how much data was filtered and why, as well as interactive response curve plots. Users may specify their outputs of interest.

1. Input Data Module: Import data into the python library

2. Pre-Processing Module: Combine and remove endpoints as needed

3. Filtering Modules: Apply the EPA recommendations for filtering

4. Model Fitting Modules: Fit EPA-recommended models to data

5. Output Modules: Select tables to output as csvs. View plots in a HTML report.

How to install the package

First, install the package from pip using:

pip install bmdrc

Or from github using:

pip install git+https://github.com/PNNL-CompBio/bmdrc

How to use the package

Vignettes

An example vignette for the dichotomous (binary) data is located here and an example vignette for the light photomotor response data (continuous converted to dichotomous) is located here.

Example Data

Example data for dichotomous and light photomotor response data can be found here.

Example Report

A sample for the generated report for dichotomous (binary) data can be found here

A sample for the generated report for light photomotor response data can be found here

Test function coverage using coverage.py

Name	Stmts	Miss	Cover
bmdrc/BinaryClass.py	138	0	100%
bmdrc/LPRClass.py	211	0	100%
bmdrc/filtering.py	146	0	100%
bmdrc/model_fitting.py	687	5	99%
bmdrc/output_modules.py	125	2	98%
bmdrc/preprocessing.py	59	0	100%
TOTAL	1366	7	99%