Difference between revisions of "Projects:RegistrationDocumentation"

From NAMIC Wiki
Jump to: navigation, search
m (Text replacement - "http://www.slicer.org/slicerWiki/index.php/" to "https://www.slicer.org/wiki/")
 
(122 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
[[Category:Registration]]
 +
[[Projects:ARRASuplements|Back to ARRA main page]]
 
==Use Case Library==
 
==Use Case Library==
*this will contain a list of the most common scenarios encountered for Slicer Registration. Each case will contain a dataset, a parameter set, a guided tutorial with example result. The hierarchy will be represented graphically as a tree and as a list with links to the abovementioned data. The library will be as exhaustive as possible, containin brain and non-brain, different modalities (MRI, CT, PET/SPECT).
+
*'''[[Projects:RegistrationDocumentation:UseCaseInventory| Registration Case Library ]]'''
*considered is also a list of troubleshooting cases, i.e. a list of the most common sources of registration failure, again complete with dataset, tutorial and remedy.
+
*'''[[Projects:RegistrationDocumentation:UseCaseAdvertisement|Use Case Sharing Advertisment Page]]'''
 +
*[[Projects:RegistrationDocumentation:UseCaseInventoryNotes|Notes & concepts about the Registration Case Library]]
 +
 
 +
== Development Efforts ==
 +
*Slicer4: '''[[Projects:RegistrationDocumentation:Developer4|Notes & feedbacl for GUI and algorithm implementation. Testing Summaries]]'''
 +
*Slicer3: [[Projects:RegistrationDocumentation:Developer|Notes & ideas for GUI and algorithm implementation. Discussion platform with the developer group]]
 +
*[[Projects:RegistrationDocumentation:RegEval_Anisotropy|'''Effects of Voxel Anisotropy and Intensity-Inhomogeneity on Image-Based 3D Registration''' ]]
 +
*[[Projects:RegistrationDocumentation:Benchmarking|'''Benchmarking''']]
 +
*[[Projects:RegistrationDocumentation:ParameterTesting|Parameter Exploration]]
 +
*[[Projects:RegistrationDocumentation:Evaluation|Result Evaluation & Visualization]]
 +
*[[Projects:RegistrationImprovement|Kitware Wiki on developer efforts]]
 +
 
 
==Reference Manual==
 
==Reference Manual==
*This will contain detailed descriptions of each parameter and each control element within the slicer registration module. The description should help the user understand what exactly that function/parameter does and if/how useful it will be for their specific registration problem
+
*The reference manual will be organized by submodules and contain detailed descriptions of each parameter and each control element within the slicer registration module. The description should help the user understand what exactly that function/parameter does and if/how useful it will be for their specific registration problem.
*Preferred formats:  Slicer Wiki, maybe PDF
+
* Each entry will have one short description (that could also serve as tooltip) and one longer, more technical explanation.
==User Manuals==
+
* links to journal articles for in depth algorithm info
*this documentation will discussing the main registration module functionality as a whole, focusing not on the individual controls but the main workflow.
+
*Preferred formats:  Slicer Wiki, maybe PDF, cross-linking required
formats: Slicer Wiki, PowerPoint.
+
*'''[[Projects:RegistrationDocumentation:ReferenceManual|Draft Registration Reference Manual]]'''
*Also included in this category are Background Tutorials, explaining the basics of registration, formats: PowerPoint. Minimal understanding of the inner workings of a registration optimization algorithm is essential to understand and judge the results obtained and obtainable.
 
==Training Video Tutorials==
 
  
[[Image:TrainingMovieThumbnail.jpg|thumb|frame| [[Media:VideoTutorialDemo_v1_0.mov|Training Movie Demo (1min)]]]]
+
==User Manuals & Tutorials==
*These movies contain step by step instructions, running through each of the use-cases described above.  
+
*[https://www.slicer.org/wiki/Slicer3:Registration#Registration_in_3D_Slicer|'''Main Registration Portal Page''']
*An example of the features/character of a video tutorial is here: [[Media:VideoTutorialDemo_v1_0.mov]]
+
*[[Media:NCIGT2010_RegistrBreakout_Slides_v3_1.ppt|'''Registration Basics, Registration Tools & User Support in Slicer''' (Powerpoint, 14MB)]]
*video tutorials have become a popular and widespread form to document GUI interactions, particularly tutorials
+
*[https://www.slicer.org/wiki/Slicer-3-6-FAQ '''FAQ & Cookbooks''']
* they can have almost  the quality of direct tutoring
+
*The user manual will contain a systematic overview of registration functionality within 3DSlicer. formats: Slicer Wiki, PowerPoint.  
*they are compact in length and filesize (because the changes are local and small over time, MPEG compression is very effective with little quality loss), which makes them ideal for online distribution
+
**[[Projects:RegistrationDocumentation:UserManual|Draft Registration User Manual]]
*movie viewing capability is mainstream, i.e. all OS will have this capability, viewers can be downloaded for free
+
**[[Projects:RegistrationDocumentation:DocumentationResources|notes and documentation resources]]
*the audio track can provide main instructions, motivation, commentary and an abundance of detail information at the right juncture, something very difficult to provide in other formats without overloading a tutorial
+
*Tutorials will be case oriented and always demonstrate a particular task or feature
*the step by step interaction is captured unambiguously. We do not spend a lot of time and space in showing slides with screen captures.
+
**[[Projects:RegistrationDocumentation:VideoTutorials|Video Tutorials: showcase of specific workflow]]
*since they are easy to make and great software is inexpensive, potential use even for developer communication can be considered, e.g. to document complex bugs
+
**Background Tutorials, explaining the basics of registration, formats: PowerPoint. Minimal understanding of the inner workings of a registration optimization algorithm is essential to understand and judge the results obtained and obtainable.
*they have a low usage threshold, i.e. users are more inclined to watch a video than to dig through a power point presentation
 
*they are not all that useful for reference or main documentation material, e.g. a tutorial on main registration concepts is probably still better in PPT.
 
*formats: video files (quicktime, WMV, mp4 , Flash), optimized for streaming or download
 
  
== Ideas for Developent Efforts ==
+
== Contact ==
*This will contain lists on function improvements that require develoment effort, e.g. new GUI features, but also strategic notes on data and algorithm structure
+
*if there is anything you think would be of help to the 3DSlicer registration user, be that documentation, examples or features, we'd love to hear about it:
*direct links to Reference Manual from Widget tooltips?
+
**any questions/concerns are welcome on the slicer user mailing list: mailto:slicer-users@bwh.harvard.edu
 +
**particular questions/concerns re. these pages or Registration Documentation drop a line to mailto:meier@bwh.harvard.edu
 +
----
  
 +
== Links ==
 +
*[[Downloads|Data links]]
 +
*[https://www.predict-hd.net huntington data]
  
----
+
*[[ITK_Registration_Optimization|Register Images Reference Material]]
==Meeting Minutes==
 
*action items & notes from meetings, TCONs and reviews
 
  
<showhide>
+
*[[Events:Registration_Summit_August_2009|Registration Summit Aug'09]]
* Meeting 2009-09-30 __HIDER__
+
*[[2009_Summer_Project_Week_Slicer3_registration]]
<hide>
+
*[https://www.slicer.org/wiki/Documentation-3.5 Slicer Documentation 3.5]
**main effort in first few months will be building of a use case library: starting with a tree of use case scenarios (brain-non-brain, inter- vs. intramodality, MR-MR inter-contrast, inter-subject vs. intra-subject, DTI to structural. Emphasis is on applications/cases, not technology, i.e. no distinction between implementation (e.g. fiducials, cost function etc.). Whole body scenarios: PET-CT, PET-CT with follow-up to track tumor growth, image-guided therapy applications
+
*[http://na-mic.org/Mantis/my_view_page.php|Slicer Bug Tracker]
**aside/along with a graphic representation of this tree is a table with links to 1) the dataset, 2) the parameter settings, 3) the tutorial running the example set
+
*[[AHM_2010]]
**setup a weekly meeting. Current: Wed. 9.30am . ca. 30min
+
*[[2010_Winter_Project_Week_RegistrationCaseLibrary|AHM 2010 Project Week: Registration Case Library Project Page]]
**include considerations of precision vs. speed and vs. robustness. The interactive nature of Slicer sets a ~10minute effort limit per case as a guideline
+
*[https://www.slicer.org/wiki/Slicer3:Slicer3Brand#3D_Slicer_Visual_Communication_Guide Slicer Logo & Communication Guide]
**write up a brief spec.aim for Stuart Silverman for sharing his intra-operative data: for the NAC supplement we plan to establish a library of use cases to guide segmentation efforts. This library an associated registration strategies will be shared on the Web.
+
*NAMIC registration:
**documentation for ARRA via a NAC website, which follows a wiki2web self-service structure. Marianna is contact for details
+
*Contact: Dominik Meier : mailto:meier@bwh.harvard.edu
**day-to-day documentation on the NAMIC wiki. Create my own Regsitration page.
 
**support personnel: Casey as developer, Andy as "super-user". Twice weekly interaction with Casey is recommended.
 
**Ron supports the single module/tab with all parameters + presets menu option. It is a clean design and highly expandable.
 
**Ron suggests Casey touch base with J.C. (Jean Christophe Fillion Robin) also @ Kitware, who works on the QT widget issue, so that he's aware of new capabilities such as Webkit that enable displaying "live" online documentation directly in the program.
 
</hide>
 
</showhide>
 
  
== Links ==
+
=== Bundled Registration and Tests ===
*Developer efforts (Kitware): [[Projects:RegistrationImprovement]]
+
* http://www.na-mic.org/Wiki/index.php/Projects:DBP2:Harvard:Registration_Documentation
*Slicer Wiki:  
+
* http://www.na-mic.org/Wiki/index.php/MeningiomaMRIRegistrationStudy#Limitations_of_the_Slicer_registration_tools
*NAMIC registration
+
* [http://www.na-mic.org/Wiki/index.php/Vervet_MRI_registration Vervet head MRI atlas-to-subject registration]
*
+
* [http://www.na-mic.org/Wiki/index.php/MeningiomaMRIRegistrationStudy Head MRI registration between different timepoints (human subjects, changing pathology present)]
 +
* [https://www.slicer.org/wiki/Slicer3:Registration Side by side comparisons in slicer2 and slicer3 with data and images]
 +
* http://mindboggle.info/papers/index.php
 +
*testing on the Vanderbuild database: [http://www.insight-journal.org/RIRE/ RIRE]
 +
* [[ITK_Registration_Optimization#Algorithmic_Requirements_and_Use_Cases|ITK Registration Optimization Sets]]
 +
*[[DTI-non-rigid]]
 +
*[[Projects:DBP2:Harvard:Registration_Documentation:Compare#Case_to_case_registration]]

Latest revision as of 17:41, 10 July 2017

Home < Projects:RegistrationDocumentation

Back to ARRA main page

Use Case Library

Development Efforts

Reference Manual

  • The reference manual will be organized by submodules and contain detailed descriptions of each parameter and each control element within the slicer registration module. The description should help the user understand what exactly that function/parameter does and if/how useful it will be for their specific registration problem.
  • Each entry will have one short description (that could also serve as tooltip) and one longer, more technical explanation.
  • links to journal articles for in depth algorithm info
  • Preferred formats: Slicer Wiki, maybe PDF, cross-linking required
  • Draft Registration Reference Manual

User Manuals & Tutorials

Contact

  • if there is anything you think would be of help to the 3DSlicer registration user, be that documentation, examples or features, we'd love to hear about it:

Links

Bundled Registration and Tests