Tutorials - PerkTutor/PerkEvaluator GitHub Wiki

To replay a saved procedure:

  1. Press the "Import" button, and select a procedure file to load. This will populate the scene with the relevant transforms. The procedure must be of the saved procedure XML file format.
  • Note: The procedure will be imported to and overwrite the currently selected buffer; if no buffer is currently selected, a new buffer will be automatically created for the procedure.
  1. Apply the populated transforms to models of the tools. For example, create needle models using the CreateModels module from the SlicerIGT extension and drag the needle models onto the relevant transforms in the Data module.
  2. Use the VCR-style controls or the slider to play the procedure.
  • Note: The "Play" button plays the procedure back at 10 frames per second.

To compute motion efficiency metrics for a saved procedure:

  1. Press the "Import" button, and select a procedure file to load. This will populate the scene with the relevant transforms.
  2. Add a model of the tissue and select as the "Tissue model node". (optional)
  3. Choose the transform associated with the needle and select as the "Needle transform node" and choose the orientation of the needle.
  4. Change the "Mark Begin" and "Mark End" spin boxes to encompass the relevant portions of the procedure.
  5. Press the "Analyze" button.

To add user-configurable metrics:

  1. Create each user-configurable metric in a single python script. See User-Configurable Metrics for details.
  • A collection of common metrics are available: Download metrics (unzip the folder prior to use).
  1. Put all python scripts defining user configurable metrics into a single directory.
  2. Click the "Metrics Directory" button and select the directory in which the python scripts are stored.

To modify messages associated with a saved procedure:

  1. Press the "Import" button, and select a procedure file to load. This will populate the messages widget with the previously recorded messages.
  2. To add a message, use the VCR-style controls to navigate to the desired time. Press the "Add Message" button, and enter the name of the message.
  3. To remove a message, select the desired message. Press the "Remove Message" button.
  4. To clear all messages, press the "Clear" Messages button.
  5. To save the messages, press the "Save" button. The procedure will be saved in the saved procedure XML file format.