Difference between revisions of "ITK/Procedure for Contributing New Classes and Algorithms"

From KitwarePublic
< ITK
Jump to navigationJump to search
Line 17: Line 17:
 
# Hold a continuously open forum where algorithmic, and performance issues are discussed.
 
# Hold a continuously open forum where algorithmic, and performance issues are discussed.
  
 +
Since some of these goals may be conflicting, it will be the prerrogative of the [[ITK Oversight Committee|Oversight Committee]] to rule on whether one criteria should be given more importance over another one.
  
Since some of these goals may be conflicting, it will be the prerrogative of the [[ITK Oversight Committee|Oversight Committee]] to rule on whether one criteria should be given more importance over another one.
+
== Technical Correctness ==
 +
 
 +
The community should pounder whether the technical concepts behind a new algorithm are acceptable. Technical correctness requires the contributor to provide a background on the proposed algorithm. Some algorithms may be so widely known that a simple citation to a major paper describing the algorithm may be enough for satisfying the requirement of technical correctness. Less known algorithms would require more detailed descriptions in order to make the case for their technical correctness. There are no hard rules on how deep this description should be. The only clear cut criteria is that it should be clear enough  for not raising major objections from the community.
  
 
= The Procedure =
 
= The Procedure =

Revision as of 10:57, 2 December 2005

Introduction

This page describes the procedure for contributing new algorithms and classes to the Insight Toolkit.

The Rationale

The rationale behind this procedure is to pursue the following goals

  1. Technical correctness of new contributions
  2. Avoid duplication of functionalities
  3. Maximize reuse of existing code
  4. Maximize generalization of the algorithm implementations
  5. Enforce validation, testing and code coverage
  6. Maximize maintainability
  7. Ensure that new algorithms are properly documented
  8. Gather feedback from the community
  9. Hold a continuously open forum where algorithmic, and performance issues are discussed.

Since some of these goals may be conflicting, it will be the prerrogative of the Oversight Committee to rule on whether one criteria should be given more importance over another one.

Technical Correctness

The community should pounder whether the technical concepts behind a new algorithm are acceptable. Technical correctness requires the contributor to provide a background on the proposed algorithm. Some algorithms may be so widely known that a simple citation to a major paper describing the algorithm may be enough for satisfying the requirement of technical correctness. Less known algorithms would require more detailed descriptions in order to make the case for their technical correctness. There are no hard rules on how deep this description should be. The only clear cut criteria is that it should be clear enough for not raising major objections from the community.

The Procedure

The procedure for contributing new classes and algorithms is the following.

  1. An Author will propose an algorithm to the developers list or to the weekly tcon.
    This