## EIT Dashboard
Visualize and manipulate EIT in a code free way using the open source
[eitprocessing](https://github.com/EIT-ALIVE/eitprocessing) software.
**Important:** While the software code is open source, your data may not be. Once the dashboard is downloaded (and/or
updated) on your local machine, no online interaction is needed. Your data remains local and is not shared or uploaded by
this software.
| Badges | |
| :----------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code repository | [](git@github.com:EIT-ALIVE/eit_dash) |
| license | [](git@github.com:EIT-ALIVE/eit_dash) |
| community registry | [](https://www.research-software.nl/software/eit_dash) [](https://pypi.python.org/project/eit_dash/) |
| howfairis | [](https://fair-software.eu) |
| Documentation | [](https://eit_dash.readthedocs.io/en/latest/?badge=latest) |
## Getting started
##### Install EIT Dashboard
The first time that the dashboard is used, the repository needs to be cloned and the package has to be
installed as follows:
- Create fresh environment
- Make sure you are in your base environment: `conda activate`
- Create a new environment: `conda create -n <envname> python=3.10`
- Activate new environment: `conda activate <envname>`
- Clone and install
- Clone the repository: `git clone git@github.com:EIT-ALIVE/eit_dash.git`
- Install:
- Run `pip install -e .`
### 2. Running EIT Dashboard
To run the installed dashboard the following command can be used:
```console
eit-dash run
```
Open the resulting link in a browser (often something like `http://127.0.0.1:8050/`).
Note that while the dashboard should work on any browser, if you are experiencing issues we recommend switching to
Chrome or Firefox, as these are the browser where we do most of the testing.
Please see our [user manual](docs/user_manual.md) for instructions on how to use the dashboard.
## For developers
### 1. Installation
##### Install Poetry
EIT Dashboard uses of [poetry](https://python-poetry.org/) to easily manage the needed packages.
Poetry can be installed as follows. Please refer to the [official installation instructions](https://python-poetry.org/docs/#installation) if problems arise:
In Linux (and WSL) or macOS
```console
curl -sSL https://install.python-poetry.org | python3 -
```
Alternatively, you can use Homebrew in macOS:
```console
brew install poetry
```
In Windows (using PowerShell)
```console
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -
```
Alternatively, poetry can also be installed [using pip](https://pypi.org/project/poetry/) or [conda](https://anaconda.org/conda-forge/poetry) in a virtual environment of choice.
##### Install EIT Dashboard
The first time that the dashboard is used, the repository needs to be cloned and the needed dependencies have to be
installed by navigating to the path where it should be installed and running:
```console
git clone git@github.com:EIT-ALIVE/eit_dash.git
cd eit_dash
poetry install
```
### 2. Running EIT Dashboard
##### Stay up to date
To ensure you are using the newest version, including any updates since you last used it, navigate to the folder where
the dashboard is installed and run:
```console
git pull
poetry install
```
##### Run dashboard
Run the command below to run the dashboard with the latest change made in the code,
and follow the link displayed.
```console
poetry run python eit_dash/main.py
```
## Documentation
Include a link to your project's full documentation here.
## Contributing
If you want to contribute to the development of eit_dash,
have a look at the [contribution guidelines](CONTRIBUTING.md).
## Credits
This package was created with [Cookiecutter](https://github.com/audreyr/cookiecutter) and the [NLeSC/python-template](https://github.com/NLeSC/python-template).
## License
This source code is licensed using a standard [Apache 2.0 License](LICENSE)
Raw data
{
"_id": null,
"home_page": null,
"name": "eit-dash",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": null,
"keywords": "EIT - Electrical Impedance Tomography, GUI",
"author": "Your Name",
"author_email": "you@example.com",
"download_url": "https://files.pythonhosted.org/packages/7e/e8/b15ae6037b8bfefadd5574e5377d7f43129e435f50b6f20938df07f2a095/eit_dash-0.0.1.tar.gz",
"platform": null,
"description": "## EIT Dashboard\n\nVisualize and manipulate EIT in a code free way using the open source\n[eitprocessing](https://github.com/EIT-ALIVE/eitprocessing) software.\n\n**Important:** While the software code is open source, your data may not be. Once the dashboard is downloaded (and/or\nupdated) on your local machine, no online interaction is needed. Your data remains local and is not shared or uploaded by\nthis software.\n\n| Badges | |\n| :----------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| code repository | [](git@github.com:EIT-ALIVE/eit_dash) |\n| license | [](git@github.com:EIT-ALIVE/eit_dash) |\n| community registry | [](https://www.research-software.nl/software/eit_dash) [](https://pypi.python.org/project/eit_dash/) |\n| howfairis | [](https://fair-software.eu) |\n| Documentation | [](https://eit_dash.readthedocs.io/en/latest/?badge=latest) |\n\n## Getting started\n\n##### Install EIT Dashboard\n\nThe first time that the dashboard is used, the repository needs to be cloned and the package has to be\ninstalled as follows:\n\n- Create fresh environment\n - Make sure you are in your base environment: `conda activate`\n - Create a new environment: `conda create -n <envname> python=3.10`\n - Activate new environment: `conda activate <envname>`\n- Clone and install\n - Clone the repository: `git clone git@github.com:EIT-ALIVE/eit_dash.git`\n - Install:\n - Run `pip install -e .`\n\n### 2. Running EIT Dashboard\n\nTo run the installed dashboard the following command can be used:\n\n```console\neit-dash run\n```\nOpen the resulting link in a browser (often something like `http://127.0.0.1:8050/`).\nNote that while the dashboard should work on any browser, if you are experiencing issues we recommend switching to\nChrome or Firefox, as these are the browser where we do most of the testing.\n\nPlease see our [user manual](docs/user_manual.md) for instructions on how to use the dashboard.\n\n## For developers\n\n### 1. Installation\n\n##### Install Poetry\n\nEIT Dashboard uses of [poetry](https://python-poetry.org/) to easily manage the needed packages.\nPoetry can be installed as follows. Please refer to the [official installation instructions](https://python-poetry.org/docs/#installation) if problems arise:\n\nIn Linux (and WSL) or macOS\n\n```console\ncurl -sSL https://install.python-poetry.org | python3 -\n```\n\nAlternatively, you can use Homebrew in macOS:\n\n```console\nbrew install poetry\n```\n\nIn Windows (using PowerShell)\n\n```console\n(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -\n```\n\nAlternatively, poetry can also be installed [using pip](https://pypi.org/project/poetry/) or [conda](https://anaconda.org/conda-forge/poetry) in a virtual environment of choice.\n\n##### Install EIT Dashboard\n\nThe first time that the dashboard is used, the repository needs to be cloned and the needed dependencies have to be\ninstalled by navigating to the path where it should be installed and running:\n\n```console\ngit clone git@github.com:EIT-ALIVE/eit_dash.git\ncd eit_dash\npoetry install\n```\n\n### 2. Running EIT Dashboard\n\n##### Stay up to date\n\nTo ensure you are using the newest version, including any updates since you last used it, navigate to the folder where\nthe dashboard is installed and run:\n\n```console\ngit pull\npoetry install\n```\n\n##### Run dashboard\n\nRun the command below to run the dashboard with the latest change made in the code, \nand follow the link displayed.\n\n```console\npoetry run python eit_dash/main.py\n```\n\n## Documentation\n\nInclude a link to your project's full documentation here.\n\n## Contributing\n\nIf you want to contribute to the development of eit_dash,\nhave a look at the [contribution guidelines](CONTRIBUTING.md).\n\n## Credits\n\nThis package was created with [Cookiecutter](https://github.com/audreyr/cookiecutter) and the [NLeSC/python-template](https://github.com/NLeSC/python-template).\n\n## License\n\nThis source code is licensed using a standard [Apache 2.0 License](LICENSE)\n\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "GUI to load and analyze image data from electrical impedance tomography (EIT)",
"version": "0.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/EIT-ALIVE/eit_dash/issues",
"repository": "https://github.com/EIT-ALIVE/eit_dash"
},
"split_keywords": [
"eit - electrical impedance tomography",
" gui"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8d2f8f88fdf98b424fce35e98d1118215710e464e9143176420457046e6c1b54",
"md5": "95d9fce51c266e8c12853032ce72d95d",
"sha256": "6a59806186f46147abc7865f2ebe67460137bbcddf3e48698885452fe55e07f9"
},
"downloads": -1,
"filename": "eit_dash-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "95d9fce51c266e8c12853032ce72d95d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 33535,
"upload_time": "2024-08-20T12:35:21",
"upload_time_iso_8601": "2024-08-20T12:35:21.076931Z",
"url": "https://files.pythonhosted.org/packages/8d/2f/8f88fdf98b424fce35e98d1118215710e464e9143176420457046e6c1b54/eit_dash-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7ee8b15ae6037b8bfefadd5574e5377d7f43129e435f50b6f20938df07f2a095",
"md5": "854e182480ff2609ce9751cc8d40fca1",
"sha256": "ed95c050ab99e2aca8f7ce3ad9aee45775dff3efbca23b45fd17fb54b50704d3"
},
"downloads": -1,
"filename": "eit_dash-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "854e182480ff2609ce9751cc8d40fca1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 28472,
"upload_time": "2024-08-20T12:35:22",
"upload_time_iso_8601": "2024-08-20T12:35:22.774797Z",
"url": "https://files.pythonhosted.org/packages/7e/e8/b15ae6037b8bfefadd5574e5377d7f43129e435f50b6f20938df07f2a095/eit_dash-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-20 12:35:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "EIT-ALIVE",
"github_project": "eit_dash",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "eit-dash"
}
JSON
