cartoreader-lite
Lightweight reader with little to no postprocessing to read the CARTO3 file format from Biosense Webster.
Science Score: 67.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
✓CITATION.cff file
Found CITATION.cff file -
✓codemeta.json file
Found codemeta.json file -
✓.zenodo.json file
Found .zenodo.json file -
✓DOI references
Found 3 DOI reference(s) in README -
✓Academic publication links
Links to: zenodo.org -
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (15.7%) to scientific vocabulary
Repository
Lightweight reader with little to no postprocessing to read the CARTO3 file format from Biosense Webster.
Basic Info
- Host: GitHub
- Owner: thomgrand
- License: agpl-3.0
- Language: Python
- Default Branch: public
- Size: 94.7 KB
Statistics
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
- Releases: 2
Metadata Files
README.md
CARTOreader - lite
This repository is an inofficial reader to easily process exported CARTO3 data in Python. It does not provide the more extensive capabilities to analyze the signals, such as OpenEP, but is rather meant as a simple reader to import CARTO data. The loaded time data is imported in pandas and the meshes in VTK provided through PyVista, allowing for easy access, export and interoperatibility with existing software.
Installation
To install cartoreader_lite, you can simply install the package from PyPI:
bash
pip install cartoreader-lite
Alternatively, you can clone the repository and install the libary using pip.
bash
git clone https://github.com/thomgrand/cartoreader-lite
cd cartoreader-lite
pip install -e .
Usage
To test the library, you first need to get CARTO3 data. None is provided with this repository, but you can download the testing data provided by OpenEP to quickly try out the library (make sure the libary was installed first):
bash
python tests/generate_test_data.py
```python from cartoreader_lite import CartoStudy import pyvista as pv import numpy as np
studydir = "openep-testingdata/Carto/ExportStudy-1-11252021-15-01-32" studyname = "Study 1 11252021 15-01-32.xml" study = CartoStudy(studydir, studyname, cartomapkwargs={"discardinvalidpoints": False} #All points of the example are outside the WOI, which would be by default discarded ) ablationpoints = pv.PolyData(np.stack(study.ablationdata.sessionavgdata["pos"].tonumpy())) ablationpoints.pointdata["RFIndex"] = study.ablationdata.sessionavgdata["RFIndex"] plotter = pv.Plotter() plotter.addmesh(ablationpoints, cmap="jet") plotter.addmesh(study.maps[2].mesh) plotter.show() ```
You should see the recorded map of the OpenEP example, together with its recorded points like below.

Documentation
https://cartoreader-lite.readthedocs.io/en/latest
Citation
If you use the library in your scientific projects, please cite the associated Zenodo archive: https://zenodo.org/record/5918396.
bibtex
@software{grandits_2022_5918396,
author = {Thomas Grandits},
title = {CARTOreader - lite},
month = jan,
year = 2022,
publisher = {Zenodo},
version = {v1.0.1},
doi = {10.5281/zenodo.5918396},
url = {https://doi.org/10.5281/zenodo.5918396}
}
Owner
- Name: Thomas G.
- Login: thomgrand
- Kind: user
- Repositories: 3
- Profile: https://github.com/thomgrand
Citation (citation.cff)
cff-version: 1.2.0 message: "If you use this software, please cite it as below." authors: - family-names: "Grandits" given-names: "Thomas" title: "CARTOreader - lite" version: 1.0.1 doi: 10.5281/zenodo.5918396 date-released: 2022-01-29 url: "https://github.com/thomgrand/cartoreader-lite"
GitHub Events
Total
- Watch event: 1
Last Year
- Watch event: 1
Issues and Pull Requests
Last synced: 11 months ago
All Time
- Total issues: 0
- Total pull requests: 1
- Average time to close issues: N/A
- Average time to close pull requests: 25 minutes
- Total issue authors: 0
- Total pull request authors: 1
- Average comments per issue: 0
- Average comments per pull request: 1.0
- Merged pull requests: 1
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
- thomgrand (1)
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 7 last-month
- Total dependent packages: 0
- Total dependent repositories: 1
- Total versions: 2
- Total maintainers: 1
pypi.org: cartoreader-lite
Cartoreader-lite provides a simplified and easy low-level access to CARTO3 studies.
- Homepage: https://github.com/thomgrand/cartoreader-lite
- Documentation: https://cartoreader-lite.readthedocs.io/
- License: AGPL
-
Latest release: 1.0.1
published over 4 years ago
Rankings
Maintainers (1)
Dependencies
- numpy *
- trimesh *