GitHub Actions CI statuss Test coverage Documentation Status

scikit-surgeryutils is part of the SNAPPY software project, developed at the Wellcome EPSRC Centre for Interventional and Surgical Sciences, part of University College London (UCL).

scikit-surgeryutils containing small demo apps and utilities.


  • Common overlay apps - Examples of common uses of scikit-surgeryvtk’s VTKOverlayWindow. Includes overlaying on a video feed, duplicating a feed.

Command Line Apps

  • - shows a millisecond timer and video image to crudely measure measure lag.
  • - extracts charuco points and annotates video image with each id detected.
  • - renders a VTK model, over background image, using OpenCV camera intrinsics.
  • - Create a calibraiton dot pattern.
  • - DICOM reslice widget demo.
  • - VTK text overlay demo.
  • - Read a surface mesh (.vtk,.vtp,.stl,.ply file), transform by 4x4 matrix and write as .vtk.


You can pip install directly from the repository as follows:

pip install git+



You can clone the repository using the following command:

git clone

Running the tests

You can run the unit tests by installing and running tox:

pip install tox

Encountering Problems?

Please check list of common issues.


Please see the contributing guidelines.


Supported by Wellcome and EPSRC.