[](https://github.com/equinor/ecalc/actions/workflows/on-push-main-branch.yml)
[](https://github.com/psf/black)
# eCalc™
eCalc™ is a software tool for calculation of energy demand and greenhouse gas (GHG) emissions from oil and gas production and processing.
> **Note**
>
> eCalc™ is a work in progress and is by no means considered a finished and final product. We currently recommend to use the YAML API when using eCalc, and only
> fallback to the Python API when it is strictly needed.
> **Warning**
>
> The quality of the results produced by eCalc™ is highly dependent on the quality of the input data. Further, we do not make any guarantees and are not liable for the quality of results when using eCalc™.
---
---
## Reference Links
* [**Documentation**](/about/)
* [**Contribution**](CONTRIBUTING.md)
* [**Security**](SECURITY.md)
* [**Code of Conduct**](CODE_OF_CONDUCT.md)
* [**Source Code**](https://github.com/equinor/ecalc)
---
## Introduction
eCalc™ is a software tool for calculation of energy demand and GHG emissions from oil and gas production and processing. It enables the cross-disciplinary collaboration required to achieve high-quality and transparent energy and GHG emission prognosis and decision support.
eCalc™ performs energy and emission calculations by integrating data, knowledge and future plans from different disciplines. This could be production and injection profiles from the reservoir engineer, characteristics of energy consuming equipment units such as gas turbines, compressors and pumps from the facility engineer, and emission factors for different fuels from the sustainability engineer. The main idea is using physical or data-driven models to relate production rates and pressures to the required processing energy and resulting emissions. Integrated bookkeeping for all emission sources is offered.
eCalc™ uses a bottom-up approach to give high-quality installation and portfolio level forecasts at the same time as detailed insights about the energy drivers and processing capacities for the individual installation.
## Getting started
eCalc™ is both a Python library and has a command line interface (CLI) to use with eCalc YAML Models. We currently recommend using eCalc™ from the command line with eCalc YAML Models, since the Python API is about to change soon, but the YAML will
be more or less stable and backwards compatible.
To get started, please refer to the [eCalc™ Docs - Getting Started](/about/getting_started/),
or follow the quick guide below:
### Prerequisites
* [Python](https://www.python.org/), version 3.8 or higher
* Java, version 8 or higher
* [Docker](https://www.docker.com/) (Optional), Linux or MacOS
eCalc™ only supports Python 3, and will follow [Komodo](https://github.com/equinor/komodo) wrt. minimum requirement for Python, which currently is 3.8.
### Installation
```bash
pip install libecalc
ecalc --version
ecalc selftest
```
**Alternative using Docker**:
```bash
docker build --target build -t ecalc .
docker run -it ecalc /bin/bash
```
Inside the docker container, run:
```bash
ecalc --version
ecalc selftest
```
Please refer to [Docker Docs](https://docs.docker.com/) for details on how to use Docker.
### Create and run your first model
Please refer to the https://equinor.github.io/ecalc/docs/about/modelling/setup/ on how to set up your own model
with the YAML API and https://equinor.github.io/ecalc/docs/about/getting_started/cli/ on how to run it.
See [Examples](#examples) below to use one of our predefined examples.
## Development and Contribution
We welcome all kinds of contributions, including code, bug reports, issues, feature requests, and documentation.
The preferred way of submitting a contribution is to either make an issue on GitHub or by forking the project on GitHub
and making a pull request.
See [Contribution Document](CONTRIBUTING.md) on how to contribute.
See the [Developer Guide](/contribute/get-started) for details.
## Examples
Jupyter Notebook examples can be found in /examples. In order to run these examples, you need to install the optional
dependencies.
```bash
pip install libecalc[notebooks]
```
In the examples you will find examples using both the YAML specifications and Python models. See /examples
## Documentation
The documentation can be found at https://equinor.github.io/ecalc
Raw data
{
"_id": null,
"home_page": "https://github.com/equinor/ecalc",
"name": "libecalc",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.12,>=3.8",
"maintainer_email": null,
"keywords": "energy, emission, scientific, engineering",
"author": "eCalc Team",
"author_email": "fg_ecalc@equinor.com",
"download_url": "https://files.pythonhosted.org/packages/05/be/942c2a006a8a004d5d0ca7d1a90c118b4b4ec482999ff19767398d5f70bd/libecalc-8.15.1.tar.gz",
"platform": null,
"description": "\n\n[](https://github.com/equinor/ecalc/actions/workflows/on-push-main-branch.yml)\n\n[](https://github.com/psf/black)\n\n\n\n \n\n# eCalc\u2122\neCalc\u2122 is a software tool for calculation of energy demand and greenhouse gas (GHG) emissions from oil and gas production and processing.\n\n> **Note**\n>\n> eCalc\u2122 is a work in progress and is by no means considered a finished and final product. We currently recommend to use the YAML API when using eCalc, and only\n> fallback to the Python API when it is strictly needed.\n\n> **Warning**\n>\n> The quality of the results produced by eCalc\u2122 is highly dependent on the quality of the input data. Further, we do not make any guarantees and are not liable for the quality of results when using eCalc\u2122.\n\n---\n\n\n\n\n---\n## Reference Links\n\n* [**Documentation**](/about/)\n* [**Contribution**](CONTRIBUTING.md)\n* [**Security**](SECURITY.md)\n* [**Code of Conduct**](CODE_OF_CONDUCT.md)\n* [**Source Code**](https://github.com/equinor/ecalc)\n\n---\n\n## Introduction\n\neCalc\u2122 is a software tool for calculation of energy demand and GHG emissions from oil and gas production and processing. It enables the cross-disciplinary collaboration required to achieve high-quality and transparent energy and GHG emission prognosis and decision support.\n\neCalc\u2122 performs energy and emission calculations by integrating data, knowledge and future plans from different disciplines. This could be production and injection profiles from the reservoir engineer, characteristics of energy consuming equipment units such as gas turbines, compressors and pumps from the facility engineer, and emission factors for different fuels from the sustainability engineer. The main idea is using physical or data-driven models to relate production rates and pressures to the required processing energy and resulting emissions. Integrated bookkeeping for all emission sources is offered.\n\neCalc\u2122 uses a bottom-up approach to give high-quality installation and portfolio level forecasts at the same time as detailed insights about the energy drivers and processing capacities for the individual installation.\n\n## Getting started\n\neCalc\u2122 is both a Python library and has a command line interface (CLI) to use with eCalc YAML Models. We currently recommend using eCalc\u2122 from the command line with eCalc YAML Models, since the Python API is about to change soon, but the YAML will\nbe more or less stable and backwards compatible.\n\nTo get started, please refer to the [eCalc\u2122 Docs - Getting Started](/about/getting_started/),\nor follow the quick guide below:\n\n### Prerequisites\n\n* [Python](https://www.python.org/), version 3.8 or higher\n* Java, version 8 or higher\n* [Docker](https://www.docker.com/) (Optional), Linux or MacOS\n\neCalc\u2122 only supports Python 3, and will follow [Komodo](https://github.com/equinor/komodo) wrt. minimum requirement for Python, which currently is 3.8.\n\n### Installation\n\n```bash\npip install libecalc\necalc --version\necalc selftest\n```\n\n**Alternative using Docker**:\n\n```bash\ndocker build --target build -t ecalc .\ndocker run -it ecalc /bin/bash\n```\n\nInside the docker container, run:\n\n```bash\necalc --version\necalc selftest\n```\n\nPlease refer to [Docker Docs](https://docs.docker.com/) for details on how to use Docker.\n\n### Create and run your first model\n\nPlease refer to the https://equinor.github.io/ecalc/docs/about/modelling/setup/ on how to set up your own model\nwith the YAML API and https://equinor.github.io/ecalc/docs/about/getting_started/cli/ on how to run it.\n\nSee [Examples](#examples) below to use one of our predefined examples.\n\n## Development and Contribution\n\nWe welcome all kinds of contributions, including code, bug reports, issues, feature requests, and documentation.\nThe preferred way of submitting a contribution is to either make an issue on GitHub or by forking the project on GitHub\nand making a pull request.\n\nSee [Contribution Document](CONTRIBUTING.md) on how to contribute.\n\nSee the [Developer Guide](/contribute/get-started) for details.\n\n## Examples\nJupyter Notebook examples can be found in /examples. In order to run these examples, you need to install the optional\ndependencies.\n\n```bash\npip install libecalc[notebooks]\n```\n\nIn the examples you will find examples using both the YAML specifications and Python models. See /examples\n\n## Documentation\n\nThe documentation can be found at https://equinor.github.io/ecalc\n",
"bugtrack_url": null,
"license": "LGPL-3.0-only",
"summary": "eCalc\u2122 is a software tool for calculation of energy demand and greenhouse gas (GHG) emissions from oil and gas production and processing.",
"version": "8.15.1",
"project_urls": {
"Homepage": "https://github.com/equinor/ecalc",
"Repository": "https://github.com/equinor/ecalc"
},
"split_keywords": [
"energy",
" emission",
" scientific",
" engineering"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8cdbe1aacb415d66eaadacb670b4b0efea064d1609ee1e8f4c9e3513dd57b050",
"md5": "25dd269d507e4a6d8e16f7cda7872af9",
"sha256": "1cae38d01f6b5657bb197650ed128825acdec05f30d3c2cf6d9fd8a22b02e179"
},
"downloads": -1,
"filename": "libecalc-8.15.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "25dd269d507e4a6d8e16f7cda7872af9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.8",
"size": 28645872,
"upload_time": "2024-04-23T08:17:41",
"upload_time_iso_8601": "2024-04-23T08:17:41.435837Z",
"url": "https://files.pythonhosted.org/packages/8c/db/e1aacb415d66eaadacb670b4b0efea064d1609ee1e8f4c9e3513dd57b050/libecalc-8.15.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "05be942c2a006a8a004d5d0ca7d1a90c118b4b4ec482999ff19767398d5f70bd",
"md5": "3e9140d129699bce5de40ea9556fe979",
"sha256": "2803729471fd27385dd31b289b11b85eb077811e252c4d45dbe6069d8b960305"
},
"downloads": -1,
"filename": "libecalc-8.15.1.tar.gz",
"has_sig": false,
"md5_digest": "3e9140d129699bce5de40ea9556fe979",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.8",
"size": 28500767,
"upload_time": "2024-04-23T08:17:45",
"upload_time_iso_8601": "2024-04-23T08:17:45.435779Z",
"url": "https://files.pythonhosted.org/packages/05/be/942c2a006a8a004d5d0ca7d1a90c118b4b4ec482999ff19767398d5f70bd/libecalc-8.15.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-23 08:17:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "equinor",
"github_project": "ecalc",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "libecalc"
}
JSON
