dive-EPR


Namedive-EPR JSON
Version 0.2.1 PyPI version JSON
download
home_pageNone
SummaryPython package for Bayesian analysis of dipolar EPR spectroscopy data through Markov chain Monte Carlo sampling with PyMC.
upload_time2024-08-14 16:46:36
maintainerNone
docs_urlNone
authorSarah Sweger, Lukas Zha
requires_python>=3.9
licenseMIT License Copyright (c) 2024 Sarah Sweger, Julian Cheung, Lukas Zha, Stephan Pribitzer, Stefan Stoll Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords epr deer bayesian mcmc
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # dive

### About
`dive` is a Python package for Bayesian analysis of dipolar EPR (electron paramagnetic resonance) spectroscopy data through Markov chain Monte Carlo (MCMC) sampling with the Python package [PyMC](https://www.pymc.io).

### Requirements

`dive` is available for Windows, Mac and Linux systems and requires **Python 3.9** or later and **PyMC 5.0** or later.
 
### Features

`dive`'s features include:
- An output InferenceData object containing many random posterior samples for each parameter
- Full uncertainty quantification for all model parameters, including the distance distribution
- Visualizations for ensembles of fitted signals and residuals
- Visualizations for ensembles of fitted distance distributions
- Histograms for margnialized posteriors of other parameters such as modulation depth and background decay rate

### Setup

You can install `dive` using `pip`. Please note that the PyPI package name is `dive-EPR`.

    pip install dive-EPR

You can also directly clone the `dive` directory. Please make sure to also import the necessary packages.

    pip install pymc deerlab scipy matplotlib numpy pandas mkl-service h5netcdf pytest
    git clone https://github.com/StollLab/dive

`dive` can then be used by importing the package as usual.

    import dive

### Documentation

See the [documentation](https://stolllab.github.io/dive) for a detailed guide on how to use `dive`. An IPython Notebook guide on using `dive` can also be found under the `examples/` directory.

### Citation

When you use `dive` in your work, please cite the following publication:

 **Bayesian Probabilistic Analysis of DEER Spectroscopy Data Using Parametric Distance Distribution Models** <br>
Sarah R. Sweger, Stephan Pribitzer, and Stefan Stoll <br>
 *J. Phys. Chem. A* 2020, 124, 30, 6193–6202 <br>
 <a href="https://doi.org/10.1021/acs.jpca.0c05026"> doi.org/10.1021/acs.jpca.0c05026</a>


### License

`dive` is licensed under the [MIT License](LICENSE).

Copyright © 2024:  Sarah Sweger, Julian Cheung, Lukas Zha, Stephan Pribitzer, Stefan Stoll

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "dive-EPR",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "EPR, DEER, Bayesian, MCMC",
    "author": "Sarah Sweger, Lukas Zha",
    "author_email": "Julian Cheung <julianc2477@gmail.com>, Stephan Pribitzer <stephapr@uw.edu>, Stefan Stoll <stst@uw.edu>",
    "download_url": "https://files.pythonhosted.org/packages/44/81/bbff8a09aa01dde6d99c8ae468fe7d8eea2365656c6cb96260fcf8e05fc9/dive_epr-0.2.1.tar.gz",
    "platform": null,
    "description": "# dive\n\n### About\n`dive` is a Python package for Bayesian analysis of dipolar EPR (electron paramagnetic resonance) spectroscopy data through Markov chain Monte Carlo (MCMC) sampling with the Python package [PyMC](https://www.pymc.io).\n\n### Requirements\n\n`dive` is available for Windows, Mac and Linux systems and requires **Python 3.9** or later and **PyMC 5.0** or later.\n \n### Features\n\n`dive`'s features include:\n- An output InferenceData object containing many random posterior samples for each parameter\n- Full uncertainty quantification for all model parameters, including the distance distribution\n- Visualizations for ensembles of fitted signals and residuals\n- Visualizations for ensembles of fitted distance distributions\n- Histograms for margnialized posteriors of other parameters such as modulation depth and background decay rate\n\n### Setup\n\nYou can install `dive` using `pip`. Please note that the PyPI package name is `dive-EPR`.\n\n    pip install dive-EPR\n\nYou can also directly clone the `dive` directory. Please make sure to also import the necessary packages.\n\n    pip install pymc deerlab scipy matplotlib numpy pandas mkl-service h5netcdf pytest\n    git clone https://github.com/StollLab/dive\n\n`dive` can then be used by importing the package as usual.\n\n    import dive\n\n### Documentation\n\nSee the [documentation](https://stolllab.github.io/dive) for a detailed guide on how to use `dive`. An IPython Notebook guide on using `dive` can also be found under the `examples/` directory.\n\n### Citation\n\nWhen you use `dive` in your work, please cite the following publication:\n\n **Bayesian Probabilistic Analysis of DEER Spectroscopy Data Using Parametric Distance Distribution Models** <br>\nSarah R. Sweger, Stephan Pribitzer, and Stefan Stoll <br>\n *J. Phys. Chem. A* 2020, 124, 30, 6193\u20136202 <br>\n <a href=\"https://doi.org/10.1021/acs.jpca.0c05026\"> doi.org/10.1021/acs.jpca.0c05026</a>\n\n\n### License\n\n`dive` is licensed under the [MIT License](LICENSE).\n\nCopyright \u00a9 2024:  Sarah Sweger, Julian Cheung, Lukas Zha, Stephan Pribitzer, Stefan Stoll\n",
    "bugtrack_url": null,
    "license": "MIT License  Copyright (c) 2024 Sarah Sweger, Julian Cheung, Lukas Zha, Stephan Pribitzer, Stefan Stoll  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ",
    "summary": "Python package for Bayesian analysis of dipolar EPR spectroscopy data through Markov chain Monte Carlo sampling with PyMC.",
    "version": "0.2.1",
    "project_urls": {
        "Documentation": "https://stolllab.github.io/dive",
        "Repository": "https://github.com/StollLab/dive"
    },
    "split_keywords": [
        "epr",
        " deer",
        " bayesian",
        " mcmc"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9f3d7b15969d1bf3893b910b5e5fecf190392c0ba6ca85e3d261554d1dfe0d8c",
                "md5": "230b71d2d6702e42cdbfd6105f2ea021",
                "sha256": "6a3f0b8c7c51a7439ba21e2dd604ab06b1159b35d575fb0648b81f43aa13dd2a"
            },
            "downloads": -1,
            "filename": "dive_EPR-0.2.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "230b71d2d6702e42cdbfd6105f2ea021",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 29812,
            "upload_time": "2024-08-14T16:46:35",
            "upload_time_iso_8601": "2024-08-14T16:46:35.106011Z",
            "url": "https://files.pythonhosted.org/packages/9f/3d/7b15969d1bf3893b910b5e5fecf190392c0ba6ca85e3d261554d1dfe0d8c/dive_EPR-0.2.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4481bbff8a09aa01dde6d99c8ae468fe7d8eea2365656c6cb96260fcf8e05fc9",
                "md5": "0514b7ff26094b398f4ebc65eaa1891c",
                "sha256": "db401b96cbfc9eaa6497fbbfe4601153406561ed0212131932e42647d6249912"
            },
            "downloads": -1,
            "filename": "dive_epr-0.2.1.tar.gz",
            "has_sig": false,
            "md5_digest": "0514b7ff26094b398f4ebc65eaa1891c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 28641,
            "upload_time": "2024-08-14T16:46:36",
            "upload_time_iso_8601": "2024-08-14T16:46:36.377938Z",
            "url": "https://files.pythonhosted.org/packages/44/81/bbff8a09aa01dde6d99c8ae468fe7d8eea2365656c6cb96260fcf8e05fc9/dive_epr-0.2.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-14 16:46:36",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "StollLab",
    "github_project": "dive",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "dive-epr"
}
        
Elapsed time: 4.61544s