What is ultraspy?
-----------------
Ultraspy is a package designed to efficiently manipulate ultrasound data using
GPU. The most common beamforming or Doppler methods are implemented (such as
DAS, RF to I/Qs, Color/Power Doppler, ...), along with some state-of-the-art
methods (Capon beamforming, Vector Doppler, alias-free Doppler velocity, ...).
A set of metrics (PSL, FWHM, SNR) is also provided so anyone can validate the
quality of their ultrasound data and beamforming operations.
The package is designed to work with both RF and I/Q signals, in 2D or 3D, and
with any type of probe (linear, convex, or matrix). The core code can run both
on CPU and GPU, making it ideal for any real-time application. All beamforming
parameters (f-number, compounding, apodization…) can be freely customized at
any time for research purposes.
The package has been thought to be as flexible as possible, so that anyone
could eventually clone it and add its own research methods and test it in real
time. A set of tutorials is provided to facilitate user learning and adoption,
along with some instruction on how to contribute to the lib if you feel like
your research method should be added to help the community.
Features
========
- General beamforming methods, flexible to Radio-Frequency or In-phase
Quadrature data, working on CPU and GPU. Mainly DAS and FDMAS for the
plane-wave imaging, but also TFM for Beam Focusing imaging
- Advanced beamforming methods (p-DAS or Capon), with a dedicated tutorial to
understand how these are implemented and how to implement your own methods
- Basic Doppler methods (Color and Power maps), and their dedicated utilities
functions (matched filtering, RF to I/Qs conversion)
- Advanced Doppler methods, such as a proposition for alias-free alias-free
Doppler velocities (using dual-wavelength method). This still lacks of
methods, and should include Vector Doppler or so in future releases
- Basic metrics for evaluation of the data quality (SNR), or of our beamforming
algorithms (FWHM, PSL, CNR)
Documentation
=============
Full documentation can be found in the 'docs' folder, and is also available at
https://ultraspy.readthedocs.io/en/latest. You will find there all the detailed
information about how to install ultraspy and how to use it.
Installation
============
Installation can be easily done using pypi:
.. code-block:: console
$ pip install ultraspy
Also, if you want to run it on GPU, you need to install the proper version of
`cupy` based on your CUDA version:
.. code-block:: console
$ pip install cupy-cudaXXx
Contribute
==========
- Issue Tracker: https://gitlab.com/pecarlat/ultraspy/-/issues/
- Source Code: https://gitlab.com/pecarlat/ultraspy
- Documentation: https://ultraspy.readthedocs.io/en/latest
License
=======
The project is under the MIT license.
Raw data
{
"_id": null,
"home_page": "https://gitlab.com/pecarlat/ultraspy",
"name": "ultraspy",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "ultrasound, python, beamforming, doppler",
"author": "Pierre Ecarlat, Fabien Millioz",
"author_email": "pierre.ecarlat@gmail.com, fabien.millioz@univ-lyon1.fr",
"download_url": null,
"platform": null,
"description": "What is ultraspy?\n-----------------\nUltraspy is a package designed to efficiently manipulate ultrasound data using\nGPU. The most common beamforming or Doppler methods are implemented (such as\nDAS, RF to I/Qs, Color/Power Doppler, ...), along with some state-of-the-art\nmethods (Capon beamforming, Vector Doppler, alias-free Doppler velocity, ...).\nA set of metrics (PSL, FWHM, SNR) is also provided so anyone can validate the\nquality of their ultrasound data and beamforming operations.\n\nThe package is designed to work with both RF and I/Q signals, in 2D or 3D, and\nwith any type of probe (linear, convex, or matrix). The core code can run both\non CPU and GPU, making it ideal for any real-time application. All beamforming\nparameters (f-number, compounding, apodization\u2026) can be freely customized at\nany time for research purposes.\n\nThe package has been thought to be as flexible as possible, so that anyone\ncould eventually clone it and add its own research methods and test it in real\ntime. A set of tutorials is provided to facilitate user learning and adoption,\nalong with some instruction on how to contribute to the lib if you feel like\nyour research method should be added to help the community.\n\n\nFeatures\n========\n- General beamforming methods, flexible to Radio-Frequency or In-phase\n Quadrature data, working on CPU and GPU. Mainly DAS and FDMAS for the\n plane-wave imaging, but also TFM for Beam Focusing imaging\n\n- Advanced beamforming methods (p-DAS or Capon), with a dedicated tutorial to\n understand how these are implemented and how to implement your own methods\n\n- Basic Doppler methods (Color and Power maps), and their dedicated utilities\n functions (matched filtering, RF to I/Qs conversion)\n\n- Advanced Doppler methods, such as a proposition for alias-free alias-free\n Doppler velocities (using dual-wavelength method). This still lacks of\n methods, and should include Vector Doppler or so in future releases\n\n- Basic metrics for evaluation of the data quality (SNR), or of our beamforming\n algorithms (FWHM, PSL, CNR)\n\n\nDocumentation\n=============\nFull documentation can be found in the 'docs' folder, and is also available at\nhttps://ultraspy.readthedocs.io/en/latest. You will find there all the detailed\ninformation about how to install ultraspy and how to use it.\n\n\nInstallation\n============\nInstallation can be easily done using pypi:\n\n.. code-block:: console\n\n $ pip install ultraspy\n\nAlso, if you want to run it on GPU, you need to install the proper version of\n`cupy` based on your CUDA version:\n\n.. code-block:: console\n\n $ pip install cupy-cudaXXx\n\n\nContribute\n==========\n\n- Issue Tracker: https://gitlab.com/pecarlat/ultraspy/-/issues/\n\n- Source Code: https://gitlab.com/pecarlat/ultraspy\n\n- Documentation: https://ultraspy.readthedocs.io/en/latest\n\n\nLicense\n=======\nThe project is under the MIT license.\n",
"bugtrack_url": null,
"license": null,
"summary": "Ultrasound toolbox for GPU",
"version": "1.2.4",
"project_urls": {
"Bug Tracker": "https://gitlab.com/pecarlat/ultraspy/-/issues/",
"Documentation": "https://ultraspy.readthedocs.io/en/latest/",
"Homepage": "https://gitlab.com/pecarlat/ultraspy"
},
"split_keywords": [
"ultrasound",
" python",
" beamforming",
" doppler"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1b12a054b28a4342d39b682eaf725f10ae53c5888d3613dddb3ec70d172de4ae",
"md5": "2c7acea9aa5c8c45a0586b244e11ef2d",
"sha256": "70bd2109a9c8c69725c7c5487fd6c5c6ca1f2c6cd0bb8d4d6471956e7f8d0f72"
},
"downloads": -1,
"filename": "ultraspy-1.2.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2c7acea9aa5c8c45a0586b244e11ef2d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 166336,
"upload_time": "2024-07-11T14:27:22",
"upload_time_iso_8601": "2024-07-11T14:27:22.298904Z",
"url": "https://files.pythonhosted.org/packages/1b/12/a054b28a4342d39b682eaf725f10ae53c5888d3613dddb3ec70d172de4ae/ultraspy-1.2.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-11 14:27:22",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "pecarlat",
"gitlab_project": "ultraspy",
"lcname": "ultraspy"
}
JSON