Skip to content

Commit

Permalink
Update Readme: Add gif, tutorial, sample datasets
Browse files Browse the repository at this point in the history
  • Loading branch information
haphantran committed May 14, 2024
1 parent 6eb8548 commit 9cc79b2
Showing 1 changed file with 34 additions and 22 deletions.
56 changes: 34 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,46 +1,58 @@
## SlicerTrack
# SlicerTrack

SlicerTrack is a 3D Slicer extension designed for easy target tracking of a ROI as it moves through a set of time-series medical images.

DISCLAIMER: This software is not intended for clinical use.

### Directory Tree Description
## What can SlicerTrack does?

`Track`
Please take a look at [documentation page](https://slicertrack.github.io/Documentation) on SlicerTrack's Homepage.
Here is a little demo

* Main SlicerTrack module directory
![Track.gif](https://github.com/slicertrack/slicertrack.github.io/blob/603168b23fd5b0adb6c4a1a495d314b104a438f1/resources/screenshots/Track.gif?raw=true)

`TrackingDataProcessor`
## Directory Tree Description

* Legacy target tracking implementation in C++
`Track`

`Track/Data`
* Main SlicerTrack module directory

* Sample medical image data to be used with SlicerTrack
`Track/Resources`

`Tack/Resources`
* Holds various resource files that may be used by SlicerTrack like Icon and UI elements

* Holds various resource files that may be used by SlicerTrack
## Quick Setup Instructions for developer

### Quick Setup Instructions
If you want to clone this demo and make it work with 3D Slicer software, please follow steps below

1) To access the module within your 3D Slicer installation you must first make the module available to 3D Slicer. Open 3D Slicer and click:

`Edit` -> `Application Settings` -> `Modules`
`Edit` -> `Application Settings` -> `Modules`

Now add the path to the `Track` folder within the `Additional module paths` selection box

* Hint: Click on the `>>` button to show the `Add` button
* Ensure to add the path to `SlicerTrack/Track`
* After the path is added, the program will restart

Now add the path to the `Track` folder within the `Additional module paths` selection box
- Hint: Click on the `>>` button to show the `Add` button
- Ensure to add the path to `SlicerTrack/Track`
- After the path is added, the program will restart
2) Reopen 3D Slicer and click on the module selection dropdown menu and find the SlicerTrack module under:

`Tracking` -> `Track`
`SlicerTrack` -> `Track`

3) Download sample dataset
You can use 2 datasets below:

* [Dataset 1](https://github.com/laboratory-for-translational-medicine/SlicerTrack/releases/download/v.1.0.0-slicertrack/Data.zip)
* [Dataset 2](https://drive.google.com/drive/folders/1qJj53YfGM4Q7atsI-XZyySvR-F98ENXA?usp=sharing)

4) Unzip the data into folder `Track/Data`
5) Use the input selectors to import the sample data from the `Track/Data` folder:

* Cine Images Folder : `Track/Data`
* Segmentation File : `Track/Data/Segmentation.mha`
* Transforms File : `Track/Data/Transforms.csv`

3) Use the input selectors to import the sample data from the `Track/Data` folder:
- Cine Images Folder : `Track/Data`
- Segmentation File : `Track/Data/Segmentation.mha`
- Transforms File : `Track/Data/Transforms.csv`
4) Press the `Play` button to begin playback
6) Press the `Play` button to begin playback

### Extension Development

Expand Down

0 comments on commit 9cc79b2

Please sign in to comment.