Name | fenics-beat JSON |
Version |
0.1.1
JSON |
| download |
home_page | None |
Summary | Library to run cardiac EP simulations |
upload_time | 2024-08-17 07:26:11 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.8 |
license | MIT |
keywords |
cardiac
electrophysiology
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
<p align="center">
<img width="300" height="300" src="https://raw.githubusercontent.com/finsberg/fenics-beat/main/docs/_static/fenics-beat-logo.png">
</p>
[![pre-commit](https://github.com/finsberg/fenics-beat/actions/workflows/pre-commit.yml/badge.svg)](https://github.com/finsberg/fenics-beat/actions/workflows/pre-commit.yml)
[![Create and publish a Docker image](https://github.com/finsberg/fenics-beat/actions/workflows/docker-image.yml/badge.svg)](https://github.com/finsberg/fenics-beat/pkgs/container/fenics-beat)
[![Build docs](https://github.com/finsberg/fenics-beat/actions/workflows/build_docs.yml/badge.svg)](https://github.com/finsberg/fenics-beat/actions/workflows/build_docs.yml)
[![Test package](https://github.com/finsberg/fenics-beat/actions/workflows/main.yml/badge.svg)](https://github.com/finsberg/fenics-beat/actions/workflows/main.yml)
[![PyPI version](https://badge.fury.io/py/fenics-beat.svg)](https://badge.fury.io/py/fenics-beat)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.13323643.svg)](https://doi.org/10.5281/zenodo.13323643)
---
# fenics-beat
Library for running cardiac electrophysiology simulations.
- Source code: https://github.com/finsberg/fenics-beat
- Documentation: https://finsberg.github.io/fenics-beat
## Getting started
Check out the examples at https://finsberg.github.io/fenics-beat/
## Install
### Using docker (recommended)
The simplest way to use `fenics-beat` is to use the provided docker image. You can get this image by pulling it from the github registry
```
docker pull ghcr.io/finsberg/fenics-beat:latest
```
It is also possible to pull a specific version by changing the tag, e.g.
```
docker pull ghcr.io/finsberg/fenics-beat:v0.0.8
```
will use version 0.0.8.
In order to start a container you can use the [`docker run`](https://docs.docker.com/engine/reference/commandline/run/) command. For example the command
```
docker run --rm -v $(pwd):/home/shared -w /home/shared -ti ghcr.io/finsberg/fenics-beat:latest
```
will run the latest version and share your current working directory with the container.
The source code of `fenics-beat` is located at `/repo` in the docker container.
### Using pip
`fenics-beat` is also available on [pypi](https://pypi.org/project/fenics-beat/) and can be installed with
```
python3 -m pip install fenics-beat
```
However this requires FEniCS to already be installed. Currently, FEniCS can be installed by building [from source](https://bitbucket.org/fenics-project/dolfin/src/master/), using [conda](https://anaconda.org/conda-forge/fenics) or use some of the [pre-built docker images](https://github.com/orgs/scientificcomputing/packages?repo_name=packages)
## Automated tests
Upon pushing new code to the repository, a number of tests run:
* pre-commit tests.
- Install `pre-commit`:
```
python3 -m pip install pre-commit
```
- Run pre-commit hooks:
```
pre-commit run --all
```
* unit and integration tests can be found in `tests` folder
- Install tests dependencies:
```
python3 -m pip install -e .[test]
```
- Run tests
```
python3 -m pytest
```
* Examples: All examples are run as part of building the documentation
## Contributing guidelines
Detailed contributing guidelines are given [here](https://finsberg.github.io/fenics-beat/CONTRIBUTING.html).
## License
MIT
## Need help or having issues
Please submit an [issue](https://github.com/finsberg/fenics-beat/issues)
Raw data
{
"_id": null,
"home_page": null,
"name": "fenics-beat",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "cardiac, electrophysiology",
"author": null,
"author_email": "Henrik Finsberg <henriknf@simula.no>",
"download_url": "https://files.pythonhosted.org/packages/d6/66/d18e0d196156eca4aa7ed79fd81592beb0ff61fbf21519b44c40cbf20baa/fenics_beat-0.1.1.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <img width=\"300\" height=\"300\" src=\"https://raw.githubusercontent.com/finsberg/fenics-beat/main/docs/_static/fenics-beat-logo.png\">\n</p>\n\n[![pre-commit](https://github.com/finsberg/fenics-beat/actions/workflows/pre-commit.yml/badge.svg)](https://github.com/finsberg/fenics-beat/actions/workflows/pre-commit.yml)\n[![Create and publish a Docker image](https://github.com/finsberg/fenics-beat/actions/workflows/docker-image.yml/badge.svg)](https://github.com/finsberg/fenics-beat/pkgs/container/fenics-beat)\n[![Build docs](https://github.com/finsberg/fenics-beat/actions/workflows/build_docs.yml/badge.svg)](https://github.com/finsberg/fenics-beat/actions/workflows/build_docs.yml)\n[![Test package](https://github.com/finsberg/fenics-beat/actions/workflows/main.yml/badge.svg)](https://github.com/finsberg/fenics-beat/actions/workflows/main.yml)\n[![PyPI version](https://badge.fury.io/py/fenics-beat.svg)](https://badge.fury.io/py/fenics-beat)\n[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.13323643.svg)](https://doi.org/10.5281/zenodo.13323643)\n\n---\n\n# fenics-beat\n\nLibrary for running cardiac electrophysiology simulations.\n\n- Source code: https://github.com/finsberg/fenics-beat\n- Documentation: https://finsberg.github.io/fenics-beat\n\n\n## Getting started\n\nCheck out the examples at https://finsberg.github.io/fenics-beat/\n\n## Install\n\n### Using docker (recommended)\nThe simplest way to use `fenics-beat` is to use the provided docker image. You can get this image by pulling it from the github registry\n```\ndocker pull ghcr.io/finsberg/fenics-beat:latest\n```\nIt is also possible to pull a specific version by changing the tag, e.g.\n```\ndocker pull ghcr.io/finsberg/fenics-beat:v0.0.8\n```\nwill use version 0.0.8.\n\nIn order to start a container you can use the [`docker run`](https://docs.docker.com/engine/reference/commandline/run/) command. For example the command\n```\ndocker run --rm -v $(pwd):/home/shared -w /home/shared -ti ghcr.io/finsberg/fenics-beat:latest\n```\nwill run the latest version and share your current working directory with the container.\nThe source code of `fenics-beat` is located at `/repo` in the docker container.\n\n### Using pip\n`fenics-beat` is also available on [pypi](https://pypi.org/project/fenics-beat/) and can be installed with\n```\npython3 -m pip install fenics-beat\n```\nHowever this requires FEniCS to already be installed. Currently, FEniCS can be installed by building [from source](https://bitbucket.org/fenics-project/dolfin/src/master/), using [conda](https://anaconda.org/conda-forge/fenics) or use some of the [pre-built docker images](https://github.com/orgs/scientificcomputing/packages?repo_name=packages)\n\n\n## Automated tests\nUpon pushing new code to the repository, a number of tests run:\n* pre-commit tests.\n - Install `pre-commit`:\n ```\n python3 -m pip install pre-commit\n ```\n - Run pre-commit hooks:\n ```\n pre-commit run --all\n ```\n* unit and integration tests can be found in `tests` folder\n - Install tests dependencies:\n ```\n python3 -m pip install -e .[test]\n ```\n - Run tests\n ```\n python3 -m pytest\n ```\n* Examples: All examples are run as part of building the documentation\n\n## Contributing guidelines\n\nDetailed contributing guidelines are given [here](https://finsberg.github.io/fenics-beat/CONTRIBUTING.html).\n\n## License\nMIT\n\n## Need help or having issues\nPlease submit an [issue](https://github.com/finsberg/fenics-beat/issues)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Library to run cardiac EP simulations",
"version": "0.1.1",
"project_urls": {
"Documentation": "https://finsberg.github.io/fenics-beat",
"Homepage": "https://finsberg.github.io/fenics-beat",
"Source": "https://github.com/finsberg/fenics-beat",
"Tracker": "https://github.com/finsberg/fenics-beat/issues"
},
"split_keywords": [
"cardiac",
" electrophysiology"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "994ce6c1bd2794b04cfc9e50d9e8976a120d4f22bba60acf32fd0dcc8bdbe089",
"md5": "e771bfa86a74fab3fcddc6d4f948e25f",
"sha256": "17200b60365e3270e526fa3dae621e8b4933dabd932299c9899ce1fb18dbe153"
},
"downloads": -1,
"filename": "fenics_beat-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e771bfa86a74fab3fcddc6d4f948e25f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 163639,
"upload_time": "2024-08-17T07:26:08",
"upload_time_iso_8601": "2024-08-17T07:26:08.622818Z",
"url": "https://files.pythonhosted.org/packages/99/4c/e6c1bd2794b04cfc9e50d9e8976a120d4f22bba60acf32fd0dcc8bdbe089/fenics_beat-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d666d18e0d196156eca4aa7ed79fd81592beb0ff61fbf21519b44c40cbf20baa",
"md5": "c17a9718739b9b82e3cb8631acfe3cbe",
"sha256": "2e1457d598900800502e5cfa24412c9bb8182b50d5fb2cf2da9af50d3423bc77"
},
"downloads": -1,
"filename": "fenics_beat-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "c17a9718739b9b82e3cb8631acfe3cbe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 160043,
"upload_time": "2024-08-17T07:26:11",
"upload_time_iso_8601": "2024-08-17T07:26:11.399152Z",
"url": "https://files.pythonhosted.org/packages/d6/66/d18e0d196156eca4aa7ed79fd81592beb0ff61fbf21519b44c40cbf20baa/fenics_beat-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-17 07:26:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "finsberg",
"github_project": "fenics-beat",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "fenics-beat"
}