geo-espresso

Name	geo-espresso JSON
Version	0.3.16 JSON
	download
home_page	None
Summary	Earth Science PRoblems for the Evaluation of Strategies, Solvers and Optimizers
upload_time	2024-11-12 02:28:18
maintainer	None
docs_url	None
author	InLab, Espresso development team
requires_python	>=3.8
license	None
keywords	inversion inference python package geoscience geophysics
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # Espresso

[![PyPI version](https://img.shields.io/pypi/v/geo-espresso?logo=pypi&style=flat-square&color=bde0fe&labelColor=f8f9fa)](https://pypi.org/project/geo-espresso/)
[![build](https://img.shields.io/github/actions/workflow/status/inlab-geo/espresso/build_wheels.yml?branch=main&logo=githubactions&style=flat-square&color=ccd5ae&labelColor=f8f9fa)](https://github.com/inlab-geo/espresso/actions/workflows/build_wheels.yml)
[![Documentation Status](https://img.shields.io/readthedocs/geo-espresso?logo=readthedocs&style=flat-square&color=fed9b7&labelColor=f8f9fa&logoColor=eaac8b)](https://geo-espresso.readthedocs.io/en/latest/?badge=latest)
[![Slack](https://img.shields.io/badge/Slack-InLab_community-4A154B?logo=slack&style=flat-square&color=cdb4db&labelColor=f8f9fa&logoColor=9c89b8)](https://join.slack.com/t/inlab-community/shared_invite/zt-1ejny069z-v5ZyvP2tDjBR42OAu~TkHg)

> Related repositories by [InLab](https://inlab.edu.au/community/)
> - [CoFI](https://github.com/inlab-geo/cofi)
> - [CoFI Examples](https://github.com/inlab-geo/cofi-examples)

## Introduction

**E**arth **S**cience **PR**oblems for the **E**valuation of **S**trategies, 
**S**olvers and **O**ptimizers (Espresso) is a collection of datasets, and 
associated simulation codes, spanning a wide range of geoscience problems. 
Together they form a suite of real-world test problems that can be used to 
support the development, evaluation and benchmarking of a wide range of tools
and algorithms for inference, inversion and optimisation. All problems are 
designed to share a common interface, so that changing from one test problem
to another requires changing one line of code. 

The Espresso project is a community effort - if you think it sounds useful,
please consider contributing an example or two from your own research. The project
is currently being coordinated by InLab, with support from the CoFI development
team.

For more information, please visit [our
documentation](https://geo-espresso.readthedocs.io).


## Installation

```console
$ pip install geo-espresso
```

Check Espresso documentation - 
[installation page](https://geo-espresso.readthedocs.io/en/latest/user_guide/installation.html) 
for details on dependencies and setting up with virtual environments.

## Basic usage

Once installed, each test problem can be imported using the following command:

```python
from espresso import <testproblem>
```

Replace ``<testproblem>`` with an actual problem class in Espresso, such as
`SimpleRegression` and `FmmTomography`. See 
[here](https://geo-espresso.readthedocs.io/en/latest/user_guide/contrib/index.html) 
for a full list of problems Espresso currently includes.

Once a problem is imported, its main functions can be called using the same 
structure for each problem. For instance:

```python
from espresso import FmmTomography

problem = FmmTomography(example_number=1)
model = problem.good_model
data = problem.data
pred = problem.forward(model)
fig_model = problem.plot_model(model)
```

You can access related metadata programatically:

```python
print(FmmTomography.metadata["problem_title"])
print(FmmTomography.metadata["problem_short_description"])
print(FmmTomography.metadata["author_names"])
```

Other problem-specific parameters can be accessed through the problem instance. For instance:

```python
print(problem.extent)
print(problem.model_shape)
```

Which additional values are set is highly problem-specific and we suggest to 
consult the 
[Espresso Documentation on the problems](https://geo-espresso.readthedocs.io/en/latest/user_guide/contrib/index.html).


## Contributing

Interested in contributing? Please check out our [contributor's guide](https://geo-espresso.readthedocs.io/en/latest/contributor_guide/index.html).


## Licence

Espresso is a community driven project to create a large suite of forward
simulations to enable researchers to get example data without the need to 
understand each individual problem in detail.

Licensing is done individually by each contributor. If a contributor wants to freely share their code example we recommend the MIT licence or a 
2-clause BSD licence. To determine the licence of an existing Espresso
problem, please consult the documentation section of that problem.

All the other core functions of Espresso written by InLab Espresso developer
team are 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": "geo-espresso",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "inversion, inference, python package, geoscience, geophysics",
    "author": "InLab, Espresso development team",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/51/3b/c7e7e50fa61f8250116c346157462f5e25fe246599bbd89753b6ca4db937/geo_espresso-0.3.16.tar.gz",
    "platform": null,
    "description": "# Espresso\n\n[![PyPI version](https://img.shields.io/pypi/v/geo-espresso?logo=pypi&style=flat-square&color=bde0fe&labelColor=f8f9fa)](https://pypi.org/project/geo-espresso/)\n[![build](https://img.shields.io/github/actions/workflow/status/inlab-geo/espresso/build_wheels.yml?branch=main&logo=githubactions&style=flat-square&color=ccd5ae&labelColor=f8f9fa)](https://github.com/inlab-geo/espresso/actions/workflows/build_wheels.yml)\n[![Documentation Status](https://img.shields.io/readthedocs/geo-espresso?logo=readthedocs&style=flat-square&color=fed9b7&labelColor=f8f9fa&logoColor=eaac8b)](https://geo-espresso.readthedocs.io/en/latest/?badge=latest)\n[![Slack](https://img.shields.io/badge/Slack-InLab_community-4A154B?logo=slack&style=flat-square&color=cdb4db&labelColor=f8f9fa&logoColor=9c89b8)](https://join.slack.com/t/inlab-community/shared_invite/zt-1ejny069z-v5ZyvP2tDjBR42OAu~TkHg)\n\n> Related repositories by [InLab](https://inlab.edu.au/community/)\n> - [CoFI](https://github.com/inlab-geo/cofi)\n> - [CoFI Examples](https://github.com/inlab-geo/cofi-examples)\n\n## Introduction\n\n**E**arth **S**cience **PR**oblems for the **E**valuation of **S**trategies, \n**S**olvers and **O**ptimizers (Espresso) is a collection of datasets, and \nassociated simulation codes, spanning a wide range of geoscience problems. \nTogether they form a suite of real-world test problems that can be used to \nsupport the development, evaluation and benchmarking of a wide range of tools\nand algorithms for inference, inversion and optimisation. All problems are \ndesigned to share a common interface, so that changing from one test problem\nto another requires changing one line of code. \n\nThe Espresso project is a community effort - if you think it sounds useful,\nplease consider contributing an example or two from your own research. The project\nis currently being coordinated by InLab, with support from the CoFI development\nteam.\n\nFor more information, please visit [our\ndocumentation](https://geo-espresso.readthedocs.io).\n\n\n## Installation\n\n```console\n$ pip install geo-espresso\n```\n\nCheck Espresso documentation - \n[installation page](https://geo-espresso.readthedocs.io/en/latest/user_guide/installation.html) \nfor details on dependencies and setting up with virtual environments.\n\n## Basic usage\n\nOnce installed, each test problem can be imported using the following command:\n\n```python\nfrom espresso import <testproblem>\n```\n\nReplace ``<testproblem>`` with an actual problem class in Espresso, such as\n`SimpleRegression` and `FmmTomography`. See \n[here](https://geo-espresso.readthedocs.io/en/latest/user_guide/contrib/index.html) \nfor a full list of problems Espresso currently includes.\n\nOnce a problem is imported, its main functions can be called using the same \nstructure for each problem. For instance:\n\n```python\nfrom espresso import FmmTomography\n\nproblem = FmmTomography(example_number=1)\nmodel = problem.good_model\ndata = problem.data\npred = problem.forward(model)\nfig_model = problem.plot_model(model)\n```\n\nYou can access related metadata programatically:\n\n```python\nprint(FmmTomography.metadata[\"problem_title\"])\nprint(FmmTomography.metadata[\"problem_short_description\"])\nprint(FmmTomography.metadata[\"author_names\"])\n```\n\nOther problem-specific parameters can be accessed through the problem instance. For instance:\n\n```python\nprint(problem.extent)\nprint(problem.model_shape)\n```\n\nWhich additional values are set is highly problem-specific and we suggest to \nconsult the \n[Espresso Documentation on the problems](https://geo-espresso.readthedocs.io/en/latest/user_guide/contrib/index.html).\n\n\n## Contributing\n\nInterested in contributing? Please check out our [contributor's guide](https://geo-espresso.readthedocs.io/en/latest/contributor_guide/index.html).\n\n\n## Licence\n\nEspresso is a community driven project to create a large suite of forward\nsimulations to enable researchers to get example data without the need to \nunderstand each individual problem in detail.\n\nLicensing is done individually by each contributor. If a contributor wants to freely share their code example we recommend the MIT licence or a \n2-clause BSD licence. To determine the licence of an existing Espresso\nproblem, please consult the documentation section of that problem.\n\nAll the other core functions of Espresso written by InLab Espresso developer\nteam are 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": "Earth Science PRoblems for the Evaluation of Strategies, Solvers and Optimizers",
    "version": "0.3.16",
    "project_urls": null,
    "split_keywords": [
        "inversion",
        " inference",
        " python package",
        " geoscience",
        " geophysics"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c8e864419e8d2c4e51dfc30f5d934f529a5fe7f65a5206013f1bb9efbec6d26f",
                "md5": "b7605246e8871ed3dc3880501ae610eb",
                "sha256": "dbb5f59f1b5280b2c1245f38fc6bffb0c7af7d6a9cdc3caeec2876146381678a"
            },
            "downloads": -1,
            "filename": "geo_espresso-0.3.16-cp310-cp310-macosx_11_0_arm64.whl",
            "has_sig": false,
            "md5_digest": "b7605246e8871ed3dc3880501ae610eb",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": ">=3.8",
            "size": 73977737,
            "upload_time": "2024-11-12T02:27:26",
            "upload_time_iso_8601": "2024-11-12T02:27:26.754969Z",
            "url": "https://files.pythonhosted.org/packages/c8/e8/64419e8d2c4e51dfc30f5d934f529a5fe7f65a5206013f1bb9efbec6d26f/geo_espresso-0.3.16-cp310-cp310-macosx_11_0_arm64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d90c1dd98253a3f2a94dd3ba3d94b39664b281786cb7c8ea44cebe4b14b137d9",
                "md5": "9dd1ca991702991f60c627ec93c6f7d9",
                "sha256": "e5c96888878ed1bd9a1d5c738adaa4178cfa866368b61f22dcb2b2a599d9f8a5"
            },
            "downloads": -1,
            "filename": "geo_espresso-0.3.16-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "9dd1ca991702991f60c627ec93c6f7d9",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": ">=3.8",
            "size": 74982884,
            "upload_time": "2024-11-12T02:27:32",
            "upload_time_iso_8601": "2024-11-12T02:27:32.081118Z",
            "url": "https://files.pythonhosted.org/packages/d9/0c/1dd98253a3f2a94dd3ba3d94b39664b281786cb7c8ea44cebe4b14b137d9/geo_espresso-0.3.16-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "1eed9fdd7cd206af12e420a531a55ba2e3cc9a55503dd964c6695d72d0cdad10",
                "md5": "e5a445920330c01b110ca947e198eca1",
                "sha256": "f386a818fdb518d76db0d73874d054cf51d411d072f0838ac919e0b6621e329d"
            },
            "downloads": -1,
            "filename": "geo_espresso-0.3.16-cp311-cp311-macosx_11_0_arm64.whl",
            "has_sig": false,
            "md5_digest": "e5a445920330c01b110ca947e198eca1",
            "packagetype": "bdist_wheel",
            "python_version": "cp311",
            "requires_python": ">=3.8",
            "size": 73977622,
            "upload_time": "2024-11-12T02:27:36",
            "upload_time_iso_8601": "2024-11-12T02:27:36.578119Z",
            "url": "https://files.pythonhosted.org/packages/1e/ed/9fdd7cd206af12e420a531a55ba2e3cc9a55503dd964c6695d72d0cdad10/geo_espresso-0.3.16-cp311-cp311-macosx_11_0_arm64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5c82a33f5ef4c6b5fe95e5423761ab2aaa2183b47f2ff55b2b94a1ad4345d9e2",
                "md5": "f82b0f15b869ff2c7a4c831ddce621d4",
                "sha256": "35e98f7665d4b89dc863ef3cd40486440e51700bca3826f9b948f1892edf8f52"
            },
            "downloads": -1,
            "filename": "geo_espresso-0.3.16-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "f82b0f15b869ff2c7a4c831ddce621d4",
            "packagetype": "bdist_wheel",
            "python_version": "cp311",
            "requires_python": ">=3.8",
            "size": 74982703,
            "upload_time": "2024-11-12T02:27:41",
            "upload_time_iso_8601": "2024-11-12T02:27:41.863239Z",
            "url": "https://files.pythonhosted.org/packages/5c/82/a33f5ef4c6b5fe95e5423761ab2aaa2183b47f2ff55b2b94a1ad4345d9e2/geo_espresso-0.3.16-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "af2bfbec2b74c697e111600b4ff247d652fb0e45b23feef792d78f679e9bc3de",
                "md5": "c41232886e4826c2516af030200e73a0",
                "sha256": "7855b1f8a2fc3aa3535fce1045553248f48b87aad176ed8a93f251cbc3709474"
            },
            "downloads": -1,
            "filename": "geo_espresso-0.3.16-cp313-cp313-macosx_11_0_arm64.whl",
            "has_sig": false,
            "md5_digest": "c41232886e4826c2516af030200e73a0",
            "packagetype": "bdist_wheel",
            "python_version": "cp313",
            "requires_python": ">=3.8",
            "size": 73973662,
            "upload_time": "2024-11-12T02:27:47",
            "upload_time_iso_8601": "2024-11-12T02:27:47.009852Z",
            "url": "https://files.pythonhosted.org/packages/af/2b/fbec2b74c697e111600b4ff247d652fb0e45b23feef792d78f679e9bc3de/geo_espresso-0.3.16-cp313-cp313-macosx_11_0_arm64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b05cb233f587e80418e43a0d007f2244e90aa9ef2b7ddbfab027b0ac54ed2bc5",
                "md5": "33fc1827db0d67b37cd51ed8e7bddeba",
                "sha256": "bfe44c20e602f53c542c712e512379fc5f049cec1305d5a9b83174aeca083dde"
            },
            "downloads": -1,
            "filename": "geo_espresso-0.3.16-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "33fc1827db0d67b37cd51ed8e7bddeba",
            "packagetype": "bdist_wheel",
            "python_version": "cp313",
            "requires_python": ">=3.8",
            "size": 74978625,
            "upload_time": "2024-11-12T02:27:52",
            "upload_time_iso_8601": "2024-11-12T02:27:52.223412Z",
            "url": "https://files.pythonhosted.org/packages/b0/5c/b233f587e80418e43a0d007f2244e90aa9ef2b7ddbfab027b0ac54ed2bc5/geo_espresso-0.3.16-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "beb35d105606d62e451fa73f6c24f915bbb1dd7251ec84ff98bed824b7a6797b",
                "md5": "5be3d9fa07f84b10b26b4ff10ef4a776",
                "sha256": "0edd4c7ea26170a7f7508a93b8f1e6b0ec2864a790606045c438a36365c1ce00"
            },
            "downloads": -1,
            "filename": "geo_espresso-0.3.16-cp38-cp38-macosx_11_0_arm64.whl",
            "has_sig": false,
            "md5_digest": "5be3d9fa07f84b10b26b4ff10ef4a776",
            "packagetype": "bdist_wheel",
            "python_version": "cp38",
            "requires_python": ">=3.8",
            "size": 73977196,
            "upload_time": "2024-11-12T02:27:56",
            "upload_time_iso_8601": "2024-11-12T02:27:56.700036Z",
            "url": "https://files.pythonhosted.org/packages/be/b3/5d105606d62e451fa73f6c24f915bbb1dd7251ec84ff98bed824b7a6797b/geo_espresso-0.3.16-cp38-cp38-macosx_11_0_arm64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e036ce9cb8f4a08bf0b8c0c0329e0813d43e08359b95713612361492e3079955",
                "md5": "9bb6856ef49ce38af27bb9daabbc50d7",
                "sha256": "e1bf55f68d5ec203ea1898a3a07818b2e1ec9348c62683bb17fbf15abcc40436"
            },
            "downloads": -1,
            "filename": "geo_espresso-0.3.16-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "9bb6856ef49ce38af27bb9daabbc50d7",
            "packagetype": "bdist_wheel",
            "python_version": "cp38",
            "requires_python": ">=3.8",
            "size": 74981532,
            "upload_time": "2024-11-12T02:28:02",
            "upload_time_iso_8601": "2024-11-12T02:28:02.658350Z",
            "url": "https://files.pythonhosted.org/packages/e0/36/ce9cb8f4a08bf0b8c0c0329e0813d43e08359b95713612361492e3079955/geo_espresso-0.3.16-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9e706f0735897c098aea663c1a1d6095030dc968cc0563417cde402723b48265",
                "md5": "fa17e2d1e8c65df8b561d402805c802d",
                "sha256": "b7973fd9ffd00194496899cd83b26fbf3120affd961da7dad18da0af6b10bb8e"
            },
            "downloads": -1,
            "filename": "geo_espresso-0.3.16-cp39-cp39-macosx_11_0_arm64.whl",
            "has_sig": false,
            "md5_digest": "fa17e2d1e8c65df8b561d402805c802d",
            "packagetype": "bdist_wheel",
            "python_version": "cp39",
            "requires_python": ">=3.8",
            "size": 73978532,
            "upload_time": "2024-11-12T02:28:07",
            "upload_time_iso_8601": "2024-11-12T02:28:07.891332Z",
            "url": "https://files.pythonhosted.org/packages/9e/70/6f0735897c098aea663c1a1d6095030dc968cc0563417cde402723b48265/geo_espresso-0.3.16-cp39-cp39-macosx_11_0_arm64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "00aac4506123619b8af65c0d5dbb385c3912a580336a064e520cfc8b6bea7d8a",
                "md5": "b62fdd25972428bef8c6444b8ae54e6a",
                "sha256": "2eef757f1a4a8b7655db573c6808beb4d401a6352018d96660da77c726c9cd03"
            },
            "downloads": -1,
            "filename": "geo_espresso-0.3.16-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "b62fdd25972428bef8c6444b8ae54e6a",
            "packagetype": "bdist_wheel",
            "python_version": "cp39",
            "requires_python": ">=3.8",
            "size": 74983416,
            "upload_time": "2024-11-12T02:28:13",
            "upload_time_iso_8601": "2024-11-12T02:28:13.370895Z",
            "url": "https://files.pythonhosted.org/packages/00/aa/c4506123619b8af65c0d5dbb385c3912a580336a064e520cfc8b6bea7d8a/geo_espresso-0.3.16-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "513bc7e7e50fa61f8250116c346157462f5e25fe246599bbd89753b6ca4db937",
                "md5": "1e185afb32e0920df24a5371dc18bc2f",
                "sha256": "3c5c5b8c644c4d9ec3bb947f3215444b6a596d75152643fd09e87ec695e25140"
            },
            "downloads": -1,
            "filename": "geo_espresso-0.3.16.tar.gz",
            "has_sig": false,
            "md5_digest": "1e185afb32e0920df24a5371dc18bc2f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 73417988,
            "upload_time": "2024-11-12T02:28:18",
            "upload_time_iso_8601": "2024-11-12T02:28:18.720494Z",
            "url": "https://files.pythonhosted.org/packages/51/3b/c7e7e50fa61f8250116c346157462f5e25fe246599bbd89753b6ca4db937/geo_espresso-0.3.16.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-12 02:28:18",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "geo-espresso"
}