<h1 align="center">eyepy</h1>
<p align="center">
Use Python to import, analyse and visualize retinal imaging data.
</p>
[](https://MedVisBonn.github.io/eyepy)
[](https://badge.fury.io/py/eyepie)
[](https://zenodo.org/badge/latestdoi/292547201)
The `eyepy` python package provides a simple interface to import and process OCT volumes. Everything you import with one of our import functions becomes an `EyeVolume` object which provides a unified interface to the data. The `EyeVolume` object provides methods to plot the localizer (fundus) image and B-scans as well as to compute and plot quantifications of voxel annotations such as drusen. Check out the [documentation](https://MedVisBonn.github.io/eyepy), especially the [Cookbook](https://medvisbonn.github.io/eyepy/cookbook/) chapter, for more information.
## Features
* Import Data (Heyex-E2E, Heyex-VOL, Heyex-XML, Topcon-FDA, B-Scan collections, [RETOUCH Challenge](https://retouch.grand-challenge.org/), [AMD Dataset from Duke University](https://people.duke.edu/~sf59/RPEDC_Ophth_2013_dataset.htm))
* Analyze OCT volumes (compute and quantify drusen)
* Visualize OCT volumes with annotations and quantifications
* Save and load EyeVolume objects
## Getting Started
### Installation
To install the latest version of eyepy run `pip install -U eyepie`. It is `eyepie` and not `eyepy` for installation with pip.
### Getting Started
When you don't hava a supported OCT volume at hand you can check out our sample dataset to get familiar with `eyepy`.
```python
from eyepy.data import load
ev = load("drusen_patient")
```
If you have data at hand use one of eyepys import functions.
```python
# Import HEYEX E2E export
ev = ep.import_heyex_e2e("path/to/file.e2e")
# Import HEYEX XML export
ev = ep.import_heyex_xml("path/to/folder")
# Import HEYEX VOL export
ev = ep.import_heyex_vol("path/to/file.vol")
# Import Topcon FDA export
ev = ep.import_topcon_fda("path/to/file.fda")
# Import volume from Duke public dataset
ev = ep.import_duke_mat("path/to/file.mat")
# Import volume form RETOUCH challenge
ev = ep.import_retouch("path/to/volume_folder")
```
# Related Projects:
+ [OCT-Converter](https://github.com/marksgraham/OCT-Converter): Extract raw optical coherence tomography (OCT) and fundus data from proprietary file formats. (.fds/.fda/.e2e/.img/.oct/.dcm)
+ [eyelab](https://github.com/MedVisBonn/eyelab): A GUI for annotation of OCT data based on eyepy
+ Projects by the [Translational Neuroimaging Laboratory](https://github.com/neurodial)
+ [LibOctData](https://github.com/neurodial/LibOctData)
+ [LibE2E](https://github.com/neurodial/LibE2E)
+ [OCT-Marker](https://github.com/neurodial/OCT-Marker)
+ [UOCTE](https://github.com/TSchlosser13/UOCTE) Unofficial continuation of https://bitbucket.org/uocte/uocte
+ [OCTAnnotate](https://github.com/krzyk87/OCTAnnotate)
+ [heyexReader](https://github.com/ayl/heyexReader)
+ [OCTExplorer](https://www.iibi.uiowa.edu/oct-reference) Iowa Reference Algorithm
Raw data
{
"_id": null,
"home_page": "https://github.com/MedVisBonn/eyepy",
"name": "eyepie",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<3.11",
"maintainer_email": "",
"keywords": "ophthalmology,oct,visualization,spectralis",
"author": "Olivier Morelle",
"author_email": "oli4morelle@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/5a/dd/359e1e2ad6fc9f5992063a2202dcd6155bd5c28ea708f46059df8f5279c3/eyepie-0.11.3.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">eyepy</h1>\n<p align=\"center\">\nUse Python to import, analyse and visualize retinal imaging data.\n</p>\n\n\n\n[](https://MedVisBonn.github.io/eyepy)\n[](https://badge.fury.io/py/eyepie)\n[](https://zenodo.org/badge/latestdoi/292547201)\n\n\nThe `eyepy` python package provides a simple interface to import and process OCT volumes. Everything you import with one of our import functions becomes an `EyeVolume` object which provides a unified interface to the data. The `EyeVolume` object provides methods to plot the localizer (fundus) image and B-scans as well as to compute and plot quantifications of voxel annotations such as drusen. Check out the [documentation](https://MedVisBonn.github.io/eyepy), especially the [Cookbook](https://medvisbonn.github.io/eyepy/cookbook/) chapter, for more information.\n\n## Features\n\n* Import Data (Heyex-E2E, Heyex-VOL, Heyex-XML, Topcon-FDA, B-Scan collections, [RETOUCH Challenge](https://retouch.grand-challenge.org/), [AMD Dataset from Duke University](https://people.duke.edu/~sf59/RPEDC_Ophth_2013_dataset.htm))\n* Analyze OCT volumes (compute and quantify drusen)\n* Visualize OCT volumes with annotations and quantifications\n* Save and load EyeVolume objects\n\n## Getting Started\n\n### Installation\nTo install the latest version of eyepy run `pip install -U eyepie`. It is `eyepie` and not `eyepy` for installation with pip.\n\n### Getting Started\nWhen you don't hava a supported OCT volume at hand you can check out our sample dataset to get familiar with `eyepy`.\n\n```python\nfrom eyepy.data import load\nev = load(\"drusen_patient\")\n```\n\nIf you have data at hand use one of eyepys import functions.\n\n```python\n# Import HEYEX E2E export\nev = ep.import_heyex_e2e(\"path/to/file.e2e\")\n# Import HEYEX XML export\nev = ep.import_heyex_xml(\"path/to/folder\")\n# Import HEYEX VOL export\nev = ep.import_heyex_vol(\"path/to/file.vol\")\n# Import Topcon FDA export\nev = ep.import_topcon_fda(\"path/to/file.fda\")\n# Import volume from Duke public dataset\nev = ep.import_duke_mat(\"path/to/file.mat\")\n# Import volume form RETOUCH challenge\nev = ep.import_retouch(\"path/to/volume_folder\")\n```\n\n# Related Projects:\n\n+ [OCT-Converter](https://github.com/marksgraham/OCT-Converter): Extract raw optical coherence tomography (OCT) and fundus data from proprietary file formats. (.fds/.fda/.e2e/.img/.oct/.dcm)\n+ [eyelab](https://github.com/MedVisBonn/eyelab): A GUI for annotation of OCT data based on eyepy\n+ Projects by the [Translational Neuroimaging Laboratory](https://github.com/neurodial)\n + [LibOctData](https://github.com/neurodial/LibOctData)\n + [LibE2E](https://github.com/neurodial/LibE2E)\n + [OCT-Marker](https://github.com/neurodial/OCT-Marker)\n+ [UOCTE](https://github.com/TSchlosser13/UOCTE) Unofficial continuation of https://bitbucket.org/uocte/uocte\n+ [OCTAnnotate](https://github.com/krzyk87/OCTAnnotate)\n+ [heyexReader](https://github.com/ayl/heyexReader)\n+ [OCTExplorer](https://www.iibi.uiowa.edu/oct-reference) Iowa Reference Algorithm\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A python package to read, analyse and visualize OCT and fundus data form various sources.",
"version": "0.11.3",
"split_keywords": [
"ophthalmology",
"oct",
"visualization",
"spectralis"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c4208fe3f84d577f1ef3833b00c6df93d0ad128cf2cea9255139d1a8c5c06ebb",
"md5": "c103abd79bf63447d4eab9d8d2580fd1",
"sha256": "ce4e34ef0feb24b48a2d77db515fce64cc019a12a30dd1139f41e92e09be9cf3"
},
"downloads": -1,
"filename": "eyepie-0.11.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c103abd79bf63447d4eab9d8d2580fd1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<3.11",
"size": 56832,
"upload_time": "2023-04-04T22:03:37",
"upload_time_iso_8601": "2023-04-04T22:03:37.251877Z",
"url": "https://files.pythonhosted.org/packages/c4/20/8fe3f84d577f1ef3833b00c6df93d0ad128cf2cea9255139d1a8c5c06ebb/eyepie-0.11.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5add359e1e2ad6fc9f5992063a2202dcd6155bd5c28ea708f46059df8f5279c3",
"md5": "f41110518cd9ea067f5840d5ea1c49ec",
"sha256": "df2bbfe2bddf2c25cc8719a2010066ec6315616ae7e42d756503c46e8ea6dcb5"
},
"downloads": -1,
"filename": "eyepie-0.11.3.tar.gz",
"has_sig": false,
"md5_digest": "f41110518cd9ea067f5840d5ea1c49ec",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<3.11",
"size": 48694,
"upload_time": "2023-04-04T22:03:38",
"upload_time_iso_8601": "2023-04-04T22:03:38.899021Z",
"url": "https://files.pythonhosted.org/packages/5a/dd/359e1e2ad6fc9f5992063a2202dcd6155bd5c28ea708f46059df8f5279c3/eyepie-0.11.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-04 22:03:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "MedVisBonn",
"github_project": "eyepy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "eyepie"
}
JSON
