lod-calculator

This application provides functionality to calculate limits of detection for microbes in a sample, based off of the work described in Sharp, Parker, and Hamilton (2023). It is built in Flask with Jinja2, Bootstrap, and jQuery.

https://github.com/xaridar/lod-calculator

Science Score: 54.0%

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

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: sciencedirect.com
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (11.8%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

This application provides functionality to calculate limits of detection for microbes in a sample, based off of the work described in Sharp, Parker, and Hamilton (2023). It is built in Flask with Jinja2, Bootstrap, and jQuery.

Basic Info
  • Host: GitHub
  • Owner: xaridar
  • Language: HTML
  • Default Branch: main
  • Size: 404 KB
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Created over 1 year ago · Last pushed over 1 year ago
Metadata Files
Readme Citation

README.md

Limits of Detection (LOD) Calculator

This application provides functionality to calculate limits of detection for microbes in a sample, based off of the work described in Sharp, Parker, and Hamilton (2023). It is built in Flask with Jinja2, Bootstrap, and jQuery.

More details can be found in the User Manual.

Parameters

The LOD Calculator uses 4 (or 5) parameters to calculate LOD: - Coefficient of Variation ($CV$) - Calculated as $σ/μ$ of the sample; defines the relative variability of the distribution - Mean ($μ$) - Mean of the distribution of CFUs; calculated from sample data - Standard Deviation ($σ$) - Standard Deviation of the distribution of CFUs; calculated from sample data - Type II Error Rate ($β$) - Rate of false negatives desired, provided as a proportion between 0 and 1; increasing $β$ allows a higher chance of error in the resulting LOD - Number of Independent Experiments ($n$) - Number of experiments conducted, provided as a counting number - Dilution Factor ($k$) - Dilution factor used for creating the sample, provided as a percentage from 0 to 1

Each of these parameters affects the LOD calculation:

$$d = \frac{1}{CV^2}$$

$$L{plate} = k\times L{original} \geq \left(\frac{d}{\sqrt[nd]{\beta}}\right)-d$$

Or, if $CV = 0$:

$$L{plate} = k\times L{original} \geq -\frac{\ln{\beta}}{n}$$

Options

There are two options for operating the calculator: - Population / Sample calculation ($L{original} / L{plate}$) - Toggles calculation between LOD per mL (default) and LOD per plated volume ($k=1$) - CV / Mean mode - Toggles control of $CV$ vs $σ/μ$ for calculations

Operation

The calculator supports two modes: Graph Mode and Discrete Calculation Mode.

Graph Mode

Graph Mode can be accessed by selecting any of the listed parameters to be displayed as the independent variable on the graph.

 

All other available parameters will become visibly accessible to be modified as desired, within a given range.

Altering the value of any variable will dynamically update the graphical view, allowing for live updates to the graph.

Variables can be changed via sliders with discrete values, or by entering values in the corresponding boxes.

The resulting graph will graph the chosen x variable against the calculated LOD, with all other parameter values being statically set to those chosen values.

Discrete Calculation Mode

Discrete Calculation Mode can be accessed by selecting "Calculate Discrete Value".

 

In this mode, any values can be input for the 4 previously mentioned parameters for an experiment.

The last box will show the LOD value given these parameter values.

PDF Output

Discrete Calculation Mode provides the option to export a calculated LOD as a PDF file.

Selecting "Download Report" in this mode will generate and download a PDF containing the current input and output values.

App developed by Elliot Topper, in collaboration with David Newton and Julia Sharp at NIST Boulder.

Acknowledgements

Owner

  • Name: Elliot Topper
  • Login: xaridar
  • Kind: user

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Topper"
  given-names: "Elliot"
  orcid: "https://orcid.org/0000-0003-1934-6231"
title: "LOD-Calculator"
version: 1.0.0
date-released: 2024-07-04
url: "https://github.com/xaridar/LOD-Calculator"

GitHub Events

Total
Last Year

Dependencies

requirements.txt pypi
  • Flask ==3.0.3
  • Jinja2 ==3.1.4
  • MarkupSafe ==2.1.5
  • Werkzeug ==3.0.3
  • blinker ==1.8.2
  • click ==8.1.7
  • colorama ==0.4.6
  • dominate ==2.9.1
  • itsdangerous ==2.2.0
  • python-dateutil ==2.9.0.post0
  • pytz ==2024.1
  • six ==1.16.0
  • tzdata ==2024.1
  • visitor ==0.1.3