Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Readme: Add gif, tutorial, sample datasets #151

Merged
merged 1 commit into from
May 14, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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