scikit-surgeryutils
===============================
.. image:: https://github.com/SciKit-Surgery/scikit-surgeryutils/raw/master/sksutils_logo.png
:height: 128px
:width: 128px
:target: https://github.com/SciKit-Surgery/scikit-surgeryutils
:alt: Logo
|
.. image:: https://github.com/SciKit-Surgery/scikit-surgeryutils/workflows/.github/workflows/ci.yml/badge.svg
:target: https://github.com/SciKit-Surgery/scikit-surgeryutils/actions
:alt: GitHub Actions CI statuss
.. image:: https://coveralls.io/repos/github/SciKit-Surgery/scikit-surgeryutils/badge.svg?branch=master&service=github
:target: https://coveralls.io/github/SciKit-Surgery/scikit-surgeryutils?branch=master
:alt: Test coverage
.. image:: https://readthedocs.org/projects/scikit-surgeryutils /badge/?version=latest
:target: http://scikit-surgeryutils .readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. image:: https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg
:target: CODE_OF_CONDUCT.md
.. image:: https://img.shields.io/twitter/follow/scikit_surgery?style=social
:target: https://twitter.com/scikit_surgery?ref_src=twsrc%5Etfw
:alt: Follow scikit_surgery on twitter
Author(s): Miguel Xochicale, Thomas Dowrick, Stephen Thompson and Matt Clarkson;
Contributor(s): Mian Ahmad.
scikit-surgeryutils containing small demo apps and utilities.
scikit-surgeryutils is part of the `SciKit-Surgery`_ software project, developed at the `Wellcome EPSRC Centre for Interventional and Surgical Sciences`_, part of `University College London (UCL)`_.
scikit-surgeryvtk is tested on Python 3.8. and may support other Python versions.
.. features-start
Features
--------
* `Common overlay apps <https://scikit-surgeryutils.readthedocs.io/en/latest/module_ref.html#module-sksurgeryutils.common_overlay_apps>`_ - Examples of common uses of scikit-surgeryvtk's VTKOverlayWindow. Includes overlaying on a video feed, duplicating a feed.
Command line applications
-------------------------
Open a terminal, load your virtual environment and run the application as `python sk*.py`.
* sksurgeryvideolag.py - shows a millisecond timer and video image to crudely measure measure lag.
* sksurgerycharucotest.py - extracts charuco points and annotates video image with each id detected.
* sksurgeryrendermodelslikecamera.py - renders a VTK model, over background image, using OpenCV camera intrinsics.
* sksurgerymakecalibrationdots.py - Create a calibraiton dot pattern.
* sksurgeryreslice.py - DICOM reslice widget demo.
* sksurgerytextoverlay.py - VTK text overlay demo.
* sksurgerytransformpolydata.py - Read a surface mesh (.vtk,.vtp,.stl,.ply file), transform by 4x4 matrix and write as .vtk.
.. features-end
Installing
----------
You can pip install directly from the repository as follows:
::
pip install git+https://github.com/SciKit-Surgery/scikit-surgeryutils
Developing
----------
Cloning
^^^^^^^
You can clone the repository using the following command:
::
git clone https://github.com/SciKit-Surgery/scikit-surgeryutils
Running the tests
^^^^^^^^^^^^^^^^^
You can run the unit tests by installing and running tox:
::
pip install tox
tox
tox -e docs
tox -e lint
Encountering Problems?
^^^^^^^^^^^^^^^^^^^^^^
Please get in touch or raise an `issue`_.
Contributing
^^^^^^^^^^^^
Please see the `contributing guidelines`_.
Useful links
^^^^^^^^^^^^
* `Source code repository`_
* `Documentation`_
Licensing and copyright
-----------------------
Copyright 2018 University College London.
scikit-surgeryutils is released under the BSD-3 license. Please see the `license file`_ for details.
Acknowledgements
----------------
Supported by `Wellcome`_ and `EPSRC`_.
.. _`Wellcome EPSRC Centre for Interventional and Surgical Sciences`: http://www.ucl.ac.uk/weiss
.. _`source code repository`: https://github.com/SciKit-Surgery/scikit-surgeryutils
.. _`Documentation`: https://scikit-surgeryutils.readthedocs.io
.. _`SciKit-Surgery`: https://github.com/SciKit-Surgery/
.. _`University College London (UCL)`: http://www.ucl.ac.uk/
.. _`Wellcome`: https://wellcome.ac.uk/
.. _`EPSRC`: https://www.epsrc.ac.uk/
.. _`contributing guidelines`: https://github.com/SciKit-Surgery/scikit-surgeryutils/blob/master/CONTRIBUTING.rst
.. _`license file`: https://github.com/SciKit-Surgery/scikit-surgeryutils/blob/master/LICENSE
.. _`issue`: https://github.com/SciKit-Surgery/scikit-surgeryutils/issues/new
Raw data
{
"_id": null,
"home_page": "https://github.com/SciKit-Surgery/scikit-surgeryutils",
"name": "scikit-surgeryutils",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "medical imaging",
"author": "Matt Clarkson",
"author_email": "m.clarkson@ucl.ac.uk",
"download_url": "https://files.pythonhosted.org/packages/1a/35/6a4d5c19a39d07d51b3b2c996401c6b1f26e27bb9dc561b0dc0a1acc1e18/scikit-surgeryutils-2.0.1.tar.gz",
"platform": null,
"description": "scikit-surgeryutils \n===============================\n\n.. image:: https://github.com/SciKit-Surgery/scikit-surgeryutils/raw/master/sksutils_logo.png\n :height: 128px\n :width: 128px\n :target: https://github.com/SciKit-Surgery/scikit-surgeryutils \n :alt: Logo\n\n|\n\n.. image:: https://github.com/SciKit-Surgery/scikit-surgeryutils/workflows/.github/workflows/ci.yml/badge.svg\n :target: https://github.com/SciKit-Surgery/scikit-surgeryutils/actions\n :alt: GitHub Actions CI statuss\n\n.. image:: https://coveralls.io/repos/github/SciKit-Surgery/scikit-surgeryutils/badge.svg?branch=master&service=github\n :target: https://coveralls.io/github/SciKit-Surgery/scikit-surgeryutils?branch=master\n :alt: Test coverage\n\n.. image:: https://readthedocs.org/projects/scikit-surgeryutils /badge/?version=latest\n :target: http://scikit-surgeryutils .readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\n.. image:: https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg\n :target: CODE_OF_CONDUCT.md\n\n.. image:: https://img.shields.io/twitter/follow/scikit_surgery?style=social\n :target: https://twitter.com/scikit_surgery?ref_src=twsrc%5Etfw\n :alt: Follow scikit_surgery on twitter\n\nAuthor(s): Miguel Xochicale, Thomas Dowrick, Stephen Thompson and Matt Clarkson;\nContributor(s): Mian Ahmad.\n\nscikit-surgeryutils containing small demo apps and utilities.\n\nscikit-surgeryutils is part of the `SciKit-Surgery`_ software project, developed at the `Wellcome EPSRC Centre for Interventional and Surgical Sciences`_, part of `University College London (UCL)`_.\n\nscikit-surgeryvtk is tested on Python 3.8. and may support other Python versions.\n\n.. features-start\n\nFeatures\n--------\n* `Common overlay apps <https://scikit-surgeryutils.readthedocs.io/en/latest/module_ref.html#module-sksurgeryutils.common_overlay_apps>`_ - Examples of common uses of scikit-surgeryvtk's VTKOverlayWindow. Includes overlaying on a video feed, duplicating a feed.\n\nCommand line applications\n-------------------------\nOpen a terminal, load your virtual environment and run the application as `python sk*.py`.\n\n* sksurgeryvideolag.py - shows a millisecond timer and video image to crudely measure measure lag.\n* sksurgerycharucotest.py - extracts charuco points and annotates video image with each id detected.\n* sksurgeryrendermodelslikecamera.py - renders a VTK model, over background image, using OpenCV camera intrinsics.\n* sksurgerymakecalibrationdots.py - Create a calibraiton dot pattern.\n* sksurgeryreslice.py - DICOM reslice widget demo.\n* sksurgerytextoverlay.py - VTK text overlay demo.\n* sksurgerytransformpolydata.py - Read a surface mesh (.vtk,.vtp,.stl,.ply file), transform by 4x4 matrix and write as .vtk.\n\n.. features-end\n\nInstalling\n----------\n\nYou can pip install directly from the repository as follows:\n\n::\n\n pip install git+https://github.com/SciKit-Surgery/scikit-surgeryutils\n\n\nDeveloping\n----------\n\nCloning\n^^^^^^^\n\nYou can clone the repository using the following command:\n\n::\n\n git clone https://github.com/SciKit-Surgery/scikit-surgeryutils\n\n\nRunning the tests\n^^^^^^^^^^^^^^^^^\n\nYou can run the unit tests by installing and running tox:\n\n::\n\n pip install tox\n tox\n tox -e docs\n tox -e lint\n\n\nEncountering Problems?\n^^^^^^^^^^^^^^^^^^^^^^\nPlease get in touch or raise an `issue`_.\n\nContributing\n^^^^^^^^^^^^\n\nPlease see the `contributing guidelines`_.\n\n\nUseful links\n^^^^^^^^^^^^\n\n* `Source code repository`_\n* `Documentation`_\n\n\nLicensing and copyright\n-----------------------\n\nCopyright 2018 University College London.\nscikit-surgeryutils is released under the BSD-3 license. Please see the `license file`_ for details.\n\n\nAcknowledgements\n----------------\n\nSupported by `Wellcome`_ and `EPSRC`_.\n\n\n.. _`Wellcome EPSRC Centre for Interventional and Surgical Sciences`: http://www.ucl.ac.uk/weiss\n.. _`source code repository`: https://github.com/SciKit-Surgery/scikit-surgeryutils\n.. _`Documentation`: https://scikit-surgeryutils.readthedocs.io\n.. _`SciKit-Surgery`: https://github.com/SciKit-Surgery/\n.. _`University College London (UCL)`: http://www.ucl.ac.uk/\n.. _`Wellcome`: https://wellcome.ac.uk/\n.. _`EPSRC`: https://www.epsrc.ac.uk/\n.. _`contributing guidelines`: https://github.com/SciKit-Surgery/scikit-surgeryutils/blob/master/CONTRIBUTING.rst\n.. _`license file`: https://github.com/SciKit-Surgery/scikit-surgeryutils/blob/master/LICENSE\n.. _`issue`: https://github.com/SciKit-Surgery/scikit-surgeryutils/issues/new\n",
"bugtrack_url": null,
"license": "BSD-3 license",
"summary": "scikit-surgeryutils - Tests/demos utilities, based around opencv-contrib-python-headless and PySide6",
"version": "2.0.1",
"project_urls": {
"Homepage": "https://github.com/SciKit-Surgery/scikit-surgeryutils"
},
"split_keywords": [
"medical",
"imaging"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "141e81b539d86688c95d5c638cb8ae98450192e649cb0ab0b104277c79613a6c",
"md5": "7f3f387c41177181b04523088b13d898",
"sha256": "0c54737459fbf17373bfe0a31e581e25e5f161f3115a8629dd36f30e728fc82f"
},
"downloads": -1,
"filename": "scikit_surgeryutils-2.0.1-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "7f3f387c41177181b04523088b13d898",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 35769,
"upload_time": "2025-02-03T11:37:24",
"upload_time_iso_8601": "2025-02-03T11:37:24.626013Z",
"url": "https://files.pythonhosted.org/packages/14/1e/81b539d86688c95d5c638cb8ae98450192e649cb0ab0b104277c79613a6c/scikit_surgeryutils-2.0.1-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1a356a4d5c19a39d07d51b3b2c996401c6b1f26e27bb9dc561b0dc0a1acc1e18",
"md5": "8b8ab78dfa7fa8c9dcf21a218ce4c269",
"sha256": "3d480c90953f9671bfaa06ea94102f98b8dfa3025f1b350edf983744ecda8fe4"
},
"downloads": -1,
"filename": "scikit-surgeryutils-2.0.1.tar.gz",
"has_sig": false,
"md5_digest": "8b8ab78dfa7fa8c9dcf21a218ce4c269",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 35939,
"upload_time": "2025-02-03T11:37:26",
"upload_time_iso_8601": "2025-02-03T11:37:26.469119Z",
"url": "https://files.pythonhosted.org/packages/1a/35/6a4d5c19a39d07d51b3b2c996401c6b1f26e27bb9dc561b0dc0a1acc1e18/scikit-surgeryutils-2.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-02-03 11:37:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SciKit-Surgery",
"github_project": "scikit-surgeryutils",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [
{
"name": "numpy",
"specs": [
[
"<",
"2.0.0"
]
]
},
{
"name": "PySide6",
"specs": [
[
">=",
"6.5.1.1"
]
]
},
{
"name": "opencv-contrib-python-headless",
"specs": [
[
">=",
"4.2.0.32"
]
]
},
{
"name": "scikit-surgerycore",
"specs": [
[
">=",
"0.1.7"
]
]
},
{
"name": "scikit-surgeryimage",
"specs": [
[
">=",
"0.10.1"
]
]
},
{
"name": "scikit-surgeryvtk",
"specs": [
[
">=",
"2.2.1"
]
]
},
{
"name": "scikit-surgeryarucotracker",
"specs": []
},
{
"name": "scikit-surgerycalibration",
"specs": [
[
">=",
"0.2.5"
]
]
}
],
"tox": true,
"lcname": "scikit-surgeryutils"
}