https://github.com/shapiromatron/bmds-server

A web application for EPA's BMDS software
https://github.com/shapiromatron/bmds-server

Last synced: 2 months ago
JSON representation

A web application for EPA's BMDS software

• Host: GitHub
• URL: https://github.com/shapiromatron/bmds-server
• Owner: shapiromatron
• License: mit
• Created: 2016-11-07T21:51:07.000Z (about 8 years ago)
• Default Branch: main
• Last Pushed: 2024-01-31T19:29:06.000Z (12 months ago)
• Last Synced: 2024-01-31T20:35:00.228Z (12 months ago)
• Language: CSS
• Homepage:
• Size: 4.18 MB
• Stars: 1
• Watchers: 4
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Changelog: HISTORY.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
BMDS webserver

======================================

.. image:: https://readthedocs.org/projects/bmds-server/badge/?version=master

        :target: https://bmds-server.readthedocs.io/en/master/

        :alt: Documentation Status

.. image:: https://zenodo.org/badge/73124145.svg

   :target: https://zenodo.org/badge/latestdoi/73124145

Run a webserver that will batch process dose-response data using the US EPA's

benchmark dose modeling software (`BMDS`_).  Under the hood, this web application

uses the `BMDS Python interface`_.

To use the webserver, specify a new BMDS Job using a input file formatted

like this.

.. _`BMDS`: https://www.epa.gov/bmds

.. _`BMDS Python interface`: https://pypi.python.org/pypi/bmds

.. code:: javascript

    {

        "dataset_type": "D",

        "bmds_version": "BMDS2601",

        "datasets": [

            {

                "doses": [0, 1.96, 5.69, 29.75],

                "ns": [75, 49, 50, 49],

                "incidences": [5, 1, 3, 14]

            },

            {

                "doses": [0, 1.96, 5.69, 29.75],

                "ns": [75, 49, 50, 49],

                "incidences": [0, 0, 11, 27]

            }

        ]

    }

You'll receive a Job ID back, and you can check the website to see when the job

is complete. Then, results can be downloaded. Results include:

- The dfile created for each model

- The outfile created for each model

- The parsed output file for each model

- A recommended best-fitting model, using guidance from `Wignall et al. 2014`_ (optional)

.. _`Wignall et al. 2014`: https://dx.doi.org/10.1289/ehp.1307539

To run your own BMDS webserver, you'll need a Windows server. Deployment steps

have been documented using a Windows Server 2012 and IIS 8.5; it may be possible

to run in other environments.