Documentation/4.0

From Slicer Wiki
Jump to: navigation, search
Home < Documentation < 4.0

Introduction

Slicer is undergoing a facelift with the transition from KW widgets to Qt widgets. This will take a while. During this time, some of the documentation on this page will be changing.

Documentation Guidelines

This section is intended primarily for the developers. However, improvements from the community are very welcome and encouraged.

Module documentation on the Slicer wiki

  • Please copy the template linked below, paste it into your page and customize it with your module's information.

Slicer4:Module_Documentation-4-alpha_Template

  • Please adhere to the naming scheme for the module documentation: [ [Modules:MyModuleNameNoSpaces-Documentation-3.7|My Module Name With Spaces] ] (First Last Name)
  • You can use the following python script to automatically generate some of the wiki documentation from your module's .xml file: SEMToMediaWiki.py


Documentation in the module

  • Short help file in the help section of the module. Keep in mind that our users are not computer scientists with a background in computer vision.
  • Please add a pointer to the documentation on the Slicer wiki to the the Help tab of the module. See the Editor module in Slicer for an example.
SlicerHelpExample.png
SlicerAcknowledgementExample.png
  • Acknowledgements:
    • The contributor (and their manager/advisor), the lab (with labs/institution logo) and the funding source (with grant number, logo optional) are listed in the Acknowledegment tab of the module. Please see the Models module for an example. The people listed in the acknowledgement will be the primary people for support and maintenance relative of the module. See here for more information.
    • Style Guide: All acknowledgment icons should be 100x100 pixels, preferably in png format.
    • Accessing logos: Icons for BIRN, NAC, NA-MIC and IGT are included in Slicer3/Base/GUI//vtkSlicerBaseAcknowledgementLogoIcons.cxx/h and resources for them are in Slicer3/Base/GUI/Resources/vtkSlicerBaseAcknowledgementLogos_ImageData.h. The API for vtkSlicerModuleGUI provides access to these icons.
    • Adding logos: Please add additional image resources and logo icons to these files as required in order to promote shared use (and to prevent duplication in the code.)

Requirements for Modules

  • The module is feature complete, it does everything that it advertises it can do
  • The module has a test. See here for more information.
  • Module has documentation on the Slicer wiki. Please use the template provided here to structure your page. Please k


Examples for the Help and

Acknowledgment Panels

Please adhere to the naming scheme for the module documentation:

  • [[Modules:MyModuleNameNoSpaces-Documentation-4-alpha|My Module Name With Spaces] ] (First Last Name)

Documentation Quality

Key for flagged modules below:

MissingOrStaleDoc.png: No 4.0 Documentation

MissingOrStaleDocLink.png: Missing or stale link to 4.0 Documentation from Help Panel in software module. If you're not sure how/where to add the link and module description:

  • for command line modules, see other xml files (such as that for the GradientAnisotropicDiffusion Module) for an example of how to add documentation and links to wiki help.
  • for interactive modules, see other modules in Base/GUI for an example.

WeakDoc.png: Weak or Incomplete 3.7 Documentation

Main GUI

Core Modules

Modules by Category

Extensions

Introduction

  • Slicer Extensions are the "on-ramp" to the Slicer "highway". They provide are a mechanism for anybody, including third parties, to provide modules which extend the functionality of 3d Slicer.
  • Beginning with Slicer 4, the process for adding modules to slicer will begin with all modules as extensions. In order to become part of the main slicer distribution, extensions will have to be distributed under the slicer license, live up to the claims in the documentation, being stable on the supported platforms, well documented and supported.
  • While the Slicer license is suggested for extensions, it is not required for extensions. Please review the documentation of the extension carefully.
  • For a subset of extensions, you can use the extension wizard in Slicer to find their webpages and to install/uninstall individual extensions.
  • The version that is available through the extension manager is chosen by the developer of that extension
  • Not all extensions are available on all platforms. See here for the extension status.
  • In case of problems with extensions, please talk directly to the developers of the extensions.
  • Information for developers can be found here.