# <img src="https://raw.githubusercontent.com/inlab-geo/cofi/main/docs/source/_static/latte_art_cropped.png" width="5%" style="vertical-align:bottom"/> CoFI (Common Framework for Inference)
[](https://pypi.org/project/cofi/)
[](https://anaconda.org/conda-forge/cofi)
[](https://cofi.readthedocs.io/en/latest/?badge=latest)
[](https://codecov.io/gh/inlab-geo/cofi)
[](https://join.slack.com/t/inlab-community/shared_invite/zt-1ejny069z-v5ZyvP2tDjBR42OAu~TkHg)
<!-- [](https://pypi.org/project/cofi/) -->
> Related repositories by [InLab](https://inlab.edu.au/community/):
> - [CoFI Examples](https://github.com/inlab-geo/cofi-examples)
> - [Espresso](https://github.com/inlab-geo/espresso)
## Introduction
CoFI (Common Framework for Inference) is an open source initiative for interfacing between generic inference algorithms and specific geoscience problems.
With a mission to bridge the gap between the domain expertise and the inference expertise, CoFI provides an interface across a wide range of inference algorithms from different sources, underpinned by a rich set of domain relevant [examples](https://cofi.readthedocs.io/en/latest/examples/generated/index.html).
Read [the documentation](https://cofi.readthedocs.io/en/latest/), and let us know your feedback or any issues!
## Installation
From PyPI:
```console
$ pip install cofi
```
Or alternatively, from conda-forge:
```console
$ conda install -c conda-forge cofi
```
Check CoFI documentation -
[installation page](https://cofi.readthedocs.io/en/latest/installation.html)
for details on dependencies and setting up with virtual environments.
## Basic Usage
CoFI API has flexible ways of defining an inversion problem. For instance:
```python
from cofi import BaseProblem
inv_problem = BaseProblem()
inv_problem.set_objective(my_objective_func)
inv_problem.set_initial_model(my_starting_point)
```
Once a problem is defined, `cofi` can tell you what inference tools you can use based on what level of
information you've provided:
```python
inv_problem.suggest_tools() # a tree will be printed
```
Run an inversion with these lines:
```python
from cofi import InversionOptions, Inversion
inv_options = InversionOptions()
inv_options.set_solving_method("optimization")
inv_options.set_params(options={"maxiter":100})
inv = Inversion(inv_problem, inv_options)
result = inv.run()
print(result.success)
print(result.model)
```
And now an inversion is completed! Check out our [example gallery](https://cofi.readthedocs.io/en/latest/examples/generated/index.html)
and [tutorial](https://cofi.readthedocs.io/en/latest/tutorials/generated/index.html) pages for more
real-world or advanced use cases.
## Contributing
Interested in contributing? Please check out our [contributor's guide](https://cofi.readthedocs.io/en/latest/contribute.html).
## Licence
This project is distributed under a 2-clause BSD licence. A copy of this licence is
provided with distributions of the software.
Raw data
{
"_id": null,
"home_page": null,
"name": "cofi",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "inversion, inference, python package, geoscience, geophysics",
"author": "InLab, CoFI development team",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/b2/1e/3bfa90bf44b35a7ade9f9268fea69c47558dea42a107b6e820f2eaee73a2/cofi-0.2.8.tar.gz",
"platform": null,
"description": "\n\n# <img src=\"https://raw.githubusercontent.com/inlab-geo/cofi/main/docs/source/_static/latte_art_cropped.png\" width=\"5%\" style=\"vertical-align:bottom\"/> CoFI (Common Framework for Inference)\n\n[](https://pypi.org/project/cofi/)\n[](https://anaconda.org/conda-forge/cofi)\n[](https://cofi.readthedocs.io/en/latest/?badge=latest)\n[](https://codecov.io/gh/inlab-geo/cofi)\n[](https://join.slack.com/t/inlab-community/shared_invite/zt-1ejny069z-v5ZyvP2tDjBR42OAu~TkHg)\n<!-- [](https://pypi.org/project/cofi/) -->\n\n> Related repositories by [InLab](https://inlab.edu.au/community/):\n> - [CoFI Examples](https://github.com/inlab-geo/cofi-examples)\n> - [Espresso](https://github.com/inlab-geo/espresso)\n\n## Introduction\n\nCoFI (Common Framework for Inference) is an open source initiative for interfacing between generic inference algorithms and specific geoscience problems.\n\nWith a mission to bridge the gap between the domain expertise and the inference expertise, CoFI provides an interface across a wide range of inference algorithms from different sources, underpinned by a rich set of domain relevant [examples](https://cofi.readthedocs.io/en/latest/examples/generated/index.html).\n\nRead [the documentation](https://cofi.readthedocs.io/en/latest/), and let us know your feedback or any issues!\n\n## Installation\n\nFrom PyPI:\n\n```console\n$ pip install cofi\n```\n\nOr alternatively, from conda-forge:\n\n```console\n$ conda install -c conda-forge cofi\n```\n\nCheck CoFI documentation - \n[installation page](https://cofi.readthedocs.io/en/latest/installation.html) \nfor details on dependencies and setting up with virtual environments.\n\n## Basic Usage\n\nCoFI API has flexible ways of defining an inversion problem. For instance:\n\n```python\nfrom cofi import BaseProblem\n\ninv_problem = BaseProblem()\ninv_problem.set_objective(my_objective_func)\ninv_problem.set_initial_model(my_starting_point)\n```\n\nOnce a problem is defined, `cofi` can tell you what inference tools you can use based on what level of\ninformation you've provided:\n\n```python\ninv_problem.suggest_tools() # a tree will be printed\n```\n\nRun an inversion with these lines:\n\n```python\nfrom cofi import InversionOptions, Inversion\n\ninv_options = InversionOptions()\ninv_options.set_solving_method(\"optimization\")\ninv_options.set_params(options={\"maxiter\":100})\n\ninv = Inversion(inv_problem, inv_options)\nresult = inv.run()\nprint(result.success)\nprint(result.model)\n```\n\nAnd now an inversion is completed! Check out our [example gallery](https://cofi.readthedocs.io/en/latest/examples/generated/index.html)\nand [tutorial](https://cofi.readthedocs.io/en/latest/tutorials/generated/index.html) pages for more \nreal-world or advanced use cases.\n\n## Contributing\n\nInterested in contributing? Please check out our [contributor's guide](https://cofi.readthedocs.io/en/latest/contribute.html).\n\n\n## Licence\n\nThis project is distributed under a 2-clause BSD licence. A copy of this licence is \nprovided with distributions of the software.\n",
"bugtrack_url": null,
"license": null,
"summary": "Common Framework for Inference",
"version": "0.2.8",
"project_urls": null,
"split_keywords": [
"inversion",
" inference",
" python package",
" geoscience",
" geophysics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b5f681b679184f5a5b00f5b0891f123fbb55ca305fab499fb4356e87d8df9321",
"md5": "c45916fb67bf2c68d759cccb21462a14",
"sha256": "920588179c675b4319ebc8cb8ef2b202f711a29137092d8aab552428609e5c11"
},
"downloads": -1,
"filename": "cofi-0.2.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c45916fb67bf2c68d759cccb21462a14",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 59952,
"upload_time": "2024-03-21T05:45:29",
"upload_time_iso_8601": "2024-03-21T05:45:29.245779Z",
"url": "https://files.pythonhosted.org/packages/b5/f6/81b679184f5a5b00f5b0891f123fbb55ca305fab499fb4356e87d8df9321/cofi-0.2.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b21e3bfa90bf44b35a7ade9f9268fea69c47558dea42a107b6e820f2eaee73a2",
"md5": "70b576303ccae4e566478177930f6bd3",
"sha256": "32ff62a6d3d394a62bf5fcd8081107a9bf8b56b13a320bbc85658b71a8b2b9da"
},
"downloads": -1,
"filename": "cofi-0.2.8.tar.gz",
"has_sig": false,
"md5_digest": "70b576303ccae4e566478177930f6bd3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 56143,
"upload_time": "2024-03-21T05:45:31",
"upload_time_iso_8601": "2024-03-21T05:45:31.707791Z",
"url": "https://files.pythonhosted.org/packages/b2/1e/3bfa90bf44b35a7ade9f9268fea69c47558dea42a107b6e820f2eaee73a2/cofi-0.2.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-21 05:45:31",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "cofi"
}
JSON