{"id":21081319,"url":"https://github.com/clberube/bisip","last_synced_at":"2025-05-16T08:32:53.236Z","repository":{"id":57415325,"uuid":"62168095","full_name":"clberube/BISIP","owner":"clberube","description":"BISIP | Bayesian inversion of spectral induced polarization laboratory data","archived":false,"fork":false,"pushed_at":"2024-11-19T17:19:10.000Z","size":170420,"stargazers_count":10,"open_issues_count":0,"forks_count":3,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-11-19T18:23:07.949Z","etag":null,"topics":["bayesian-inference","cython","emcee","geophysics","inversion","linux","macosx","markov-chain-monte-carlo","physics-simulation","python","spectral-induced-polarization","windows-10"],"latest_commit_sha":null,"homepage":"https://bisip.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/clberube.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-06-28T19:23:36.000Z","updated_at":"2024-11-19T17:19:14.000Z","dependencies_parsed_at":"2022-09-12T12:03:04.477Z","dependency_job_id":null,"html_url":"https://github.com/clberube/BISIP","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clberube%2FBISIP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clberube%2FBISIP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clberube%2FBISIP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clberube%2FBISIP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clberube","download_url":"https://codeload.github.com/clberube/BISIP/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225419612,"owners_count":17471433,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bayesian-inference","cython","emcee","geophysics","inversion","linux","macosx","markov-chain-monte-carlo","physics-simulation","python","spectral-induced-polarization","windows-10"],"created_at":"2024-11-19T20:08:17.113Z","updated_at":"2024-11-19T20:08:18.124Z","avatar_url":"https://github.com/clberube.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BISIP | Bayesian inversion of SIP data\n[![Documentation Status](https://readthedocs.org/projects/bisip/badge/?version=latest)](https://bisip.readthedocs.io/en/latest/?badge=latest)\n[![Build Status](https://www.travis-ci.com/clberube/BISIP.svg?branch=main)](https://www.travis-ci.com/clberube/BISIP)\n\nBISIP is a fast, robust and open-source Python program for bayesian inversion of spectral induced polarization (SIP) data. It allows the evaluation of SIP parameters and their uncertainties by propagating measurement errors through the inversion process. Dias, Cole-Cole, Debye and Warburg decomposition schemes are currently implemented. Additional models will be included in the future.\n\nIn 2019 BISIP was re-written from the ground up with a powerful ensemble MCMC sampler, better code practice and improved [documentation](https://bisip.readthedocs.io/en/latest/). See our original [2017 paper](https://doi.org/10.1016/j.cageo.2017.05.001) in Computers \u0026 Geosciences.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"/figures/ExampleFit_K389369.png\" width=\"50%\"\u003e\n\u003c/p\u003e\n\n## Documentation\nVisit https://bisip.readthedocs.io for the full documentation including API docs, tutorials and data file templates.\n\n## Requirements\n- [Python 3.6+](https://www.python.org/downloads/)\n- [emcee](https://emcee.readthedocs.io/en/stable/)\n- [NumPy](https://numpy.org/)\n- [matplotlib](https://matplotlib.org/)\n\n### Optional dependencies\n- [tqdm](https://tqdm.github.io/): enables progress bars\n- [corner](https://corner.readthedocs.io/en/latest/): enables beautiful corner plots\n\n## Installation\nClone this repository to your computer. Then navigate to the bisip directory. Finally run the setup.py script with Python. The `-f` option forces a reinstall if a previous version of the package was already installed.\n\n```zsh\n$ git clone https://github.com/clberube/bisip\n$ cd bisip\n$ python setup.py install -f\n```\n\n## Quickstart\nUsing BISIP is as simple as importing a SIP model, initializing it and fitting it to a data set. BISIP also offers many utility functions for plotting and analyzing inversion results. See the [tutorials](https://bisip.readthedocs.io/en/latest/tutorials/quickstart.html) for more examples.\n\n```python\nfrom bisip import PolynomialDecomposition\n\n# Define a data file to invert\nfilepath = '/path/to/DataFile_1.csv'\n# Initialize the inversion model\nmodel = PolynomialDecomposition(filepath=filepath,\n                                nwalkers=32,  # number of walkers\n                                nsteps=1000,  # number of MCMC steps\n                                )\n# Fit the model to this data file\nmodel.fit()\n```\n```\nOut:\n100%|██████████| 1000/1000 [00:01\u003c00:00, 558.64it/s]\n```\n\n## 2017 archive\nThe original BISIP code from the 2017 paper is archived in the `bisip1-archive` branch.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclberube%2Fbisip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclberube%2Fbisip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclberube%2Fbisip/lists"}