scikit-surgeryutils


Namescikit-surgeryutils JSON
Version 2.0.1 PyPI version JSON
download
home_pagehttps://github.com/SciKit-Surgery/scikit-surgeryutils
Summaryscikit-surgeryutils - Tests/demos utilities, based around opencv-contrib-python-headless and PySide6
upload_time2025-02-03 11:37:26
maintainerNone
docs_urlNone
authorMatt Clarkson
requires_pythonNone
licenseBSD-3 license
keywords medical imaging
VCS
bugtrack_url
requirements numpy PySide6 opencv-contrib-python-headless scikit-surgerycore scikit-surgeryimage scikit-surgeryvtk scikit-surgeryarucotracker scikit-surgerycalibration
Travis-CI No Travis.
coveralls test coverage
            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"
}
        
Elapsed time: 0.75010s