ITK: Difference between revisions

From KitwarePublic
Jump to navigationJump to search
(Switch from GitWeb to GitHub as the Git repository URL where the ITK code dwells)
(117 intermediate revisions by 15 users not shown)
Line 1: Line 1:
= ITK Version 4 =
[[File:Itk.png|center|150x100px]]  
This section was added to inform the ITK community of the pending changes to the ITK toolkit that will be taking place over the next 6 months. This work is supported by ARRA funding from the NLM. The kick-off meeting for this project took place from [http://visual.nlm.nih.gov/itk/itk2010/agenda.html June 28-July 2 in Bethesda]. A beta version of the software will be available by the end of March 2011. Bug fixes will continue to be contributed to the ITK version 3 code.


*Move from cvs to git for distributed source code management
The National Library of Medicine '''[http://www.itk.org/ Insight Segmentation and Registration Toolkit]''' (ITK) is an open-source software system for medical image processing in two, three and more dimensions. 
*Remove support for the following compilers that have known incompatibilities with c++03 (http://en.wikipedia.org/wiki/C%2B%2B03#Language_standard)
**Visual Studio version 6
**Visual Studio version 7
**Borland version 5.5
**Sun Studio compilers
** IRIX compilers
** MWORKS compilers
** gcc 2.96 compilers (and perhaps some very early 3.0 series compilers)
*Improved ITK Wrapping
*Addition of simple ITK layer
*Enhanced modularity
*[[Refactoring itk::FEM framework - V4]]
*Improved DICOM support
*Add streaming for video
*Enhanced image registration framework


== ITK Version 4 -- Discussion Points ==
This is the '''''ITK Wiki''''', a collaborative hypertext database of information, documentation and resources.


*Strings are std::strings:  Filenames should be std::strings, not const char* _arg
__TOC__
** Set character string.  Creates member Set"name"() (e.g., SetFilename(char *)). The macro assumes that the class member (name) is declared a type std::string. */


* Threading model modifications:
== Overview ==
# Thread pools?
# Hierarchal thread handlers?
# Can threads deal with pushing data across hardware units with inconsistent memory models (i.e. 4 core SMP + GPU#1 + GPU#2)


* Need Explicit Transition Documentation:
* <big><strong>[[ITK/Getting Started|Getting Started with ITK]]</strong></big>
# To facilitate transition from ITK3 to ITK4, a set of migration documents and tools will be beneficial to researchers who will be migrating to their tools to ITK4.  As we adapt the reference applications to the changes occurring in ITK4, we will document the necessary source code changes to use the new version of ITK4.  When possible, we will write a set of scripting tools that transform ITK3 to ITK4, or identify old code that has become invalidated, and suggest alternative options.  We will deliver this documentation both as a standalone document and as an online WIKI-based web resource.
* [[ITK/About|About the Insight Toolkit]]
* [[ITK/FAQ|Frequently Asked Questions (FAQ)]]
* [[ITK/License Information| License Information]]


*Transforms:  
== Software Process ==
# Need ability to deal with concatenated physical space mappings (Rigid-»Affine-»BSpline-»Displacement-»Rigid-» etc)
* [https://github.com/InsightSoftwareConsortium/ITK Git repository] : The version controlled repository.
# Better protocols for reading/writing/ transforms including the ambiguous way that compound (i.e. not concatenated) transforms are represented.  
* [http://review.source.kitware.com/#/q/status:open+project:ITK,n,z Gerrit code review] : Our code review system.
* [http://issues.itk.org/ Issue tracking system] : Where we report and browse bugs.
* [http://www.cdash.org/CDash/index.php?project=Insight&date= Nightly build dashboard] : View the build status on a variety of platforms.
* [[ITK/Development | Development]]


*Image Physical Space/Domain:
== Resources ==
# There is a need an image layer that does NOT have a physical space representation
## ImageBase-»DigitalImage-»ContinuousImage-»[Image(the current interpretation)|GeoSpatialImage|Other physical space]
## Most PixelWise filters will be defined over the DigitalImage layer to explicitly identify them as not dealing with physical space
## Digital to Continuous conversion API is consistent (TransformIndexToPhysical & PhysicalToIndexTransform), but may be adaptable to address the needs of our expanding user base
## The current "Image" designator is explicitly defined as an (LPS anatomical, East|North|Altitude) with Direction cosigns, spacing, origin and appropriate
## Units:  A designation that can hint to the application level how to interpret physical space.  Perhaps the filters would just verify that units are the same.  (default being non-existing and therefore the same).


*Platform support (a platform is a [Hardware, OS, Compiler, Compiler options] )
* [[ITK/Documentation| Documentation]]
* [[ITK/Community | Community Corner]]
* [[ITK/Academic | Academic Corner]]
* [[ITK/Professional | Professional Corner]]
* [[ITK/Open_Science| Open Science]]
* [[ITK/Other_Software| Other Software]]


# Reduce build burden -- Explicit Templates & Pre-compiled headers:
{{ITKRegister}}
## Under the assumption that the scope of the simple & wrapping frameworks will define a large swath of instantiations that almost all applications also need.  By defining and pre-compling those common (perhaps driven by the wrapping choices) tools, compiling the application layers will be significantly faster.  This should reduce the burden on application developers by shifting build time costs away form the time of building the applications.
## We do have to be careful to limit this (or provide options to limit this) so that the default build does not take 10 hours.
## This does imply that the compiler MUST support explicit instantiation of templates
## ---- As a side note, perhaps we also need to investigate pre-compiled header support for compilers to lower the development burden 
# An explicit deprecation cycle for ALL compilers
## It is CRUCIAL that we define upfront a MINIMUM time frame for how long each version of ITK4 we commit to supporting all platforms.  It is expected that these dates will shift into the future, but not earlier.
### Windows 7, Visual Studio 2010 will be supported at least until Jan 1, 2017
### Windows XP, Visual Studio Express 8 will be supported at least until Jan 1, 2015
### Linux gcc version 4 (greater than 4.0.1) will be supported at least until Jan 1, 2012 
# Compilers need to be compliant with the C++03 standards. http://en.wikipedia.org/wiki/C%2B%2B
 
*IO interface changes:
# Transforms components "Can be written", but there is insufficient information to un-ambiguously derive the intent and appropriate use of those transform parameters.  In particular, the parameters for BSpline are written to disk in two components, and the BSpline parameters are linearly written, but the implied grid for those parameters is not specified in the output file. As a use case, the BSpline transform type SHOULD be able to be instantiated from just the information in the file.
# Are there IO factory simplifications that could be done? i.e. remove separatedFactories for each type
 
*Meta Data Dictionary:
# MetaData Dictionary items need "Traits"  to help identify the "social status" of the element (such as ITK_SUPPORTED_PUBLIC, ITK_SUPPORTED_PRIVATE, UNSUPPORTED_PRIVATE, UNSUPPORTED_PUBLIC).
# The first contribution of the Iowa ITK development team was to introduce the “MetaDataDictionary” storage mechanism to all ITK Objects that could contain arbitrary key-value pairs of data.  The MetaDataDictionary was not part of the original ITK framework definition, and has therefore not been consistently implemented throughout the ITK toolkit.  We propose to revisit the implementation of the MetaDataDictionary to improve and simplify the ABI so that it is easier to use.  In particular, the Encapsulate() and Expose() functions can now be simplified when using standards-compliant C++ compilers, and new features for describing a dynamically created dictionary at run time will be introduced. A common use of the MetaDataDictionary has been to temporally append features that were missing in the initial ITK framework.  In many cases, the use of the MetaDataDictionary was subsequently followed by addition of formal support of the feature to ITK, and this lead to redundancy of information that was not always kept synchronized.  Additionally, as new developers adopted the MetaDataDictionary for different uses, they each created inconsistent definitions for similar uses of the dictionary.  We will review the internal ITK uses of the MetaDataDictionary, remove uses that are now redundant with formal accepted functionality, and consolidate similar uses of the Dictionary. The MetaDataDictionary is most commonly used to pass additional information to or from the Input/Output mechanisms.  We will define a protocol so that data object histories can be tracked through consistent instrumentation of ITK process objects to tag output objects.  We will review the Input/Output and develop a standard practices guideline for how to map the extra data to and from ITK in a consistent way. Wherever possible, we will use tags and definitions consistent with the dictionaries specified in the DICOM standard.
 
* ITK Orientation 
# Instrument the itk::ImageIO methods to record spatial image orientation in the MetaDataDictionary prior to it’s inclusion as a formal feature.  This solution allowed representation of which of 48 possible 3D orientations the image was in.  This was represented symbolically by 3 letter combinations, based on permuting (A)nterior/(Posterier), (I)nferior/(S)uperior, (L)eft/(R)ight. For example RAS meant that the voxels are oriented Right-to-Left, Anterior-to-Posterior, Superior to Inferior, corresponding to Row/Column/Slice. This method of specifying orientation is useful but very limited; many anatomical scanners allow scanning at oblique angles with respect to anatomy.  So after long discussion in the ITK developer community, a more general method was developed, which represented the orientation as a direction cosine matrix (DCM). The direction cosines specify a general 3D rotation of the image voxels with respect to the anatomy being scanned. The long experience with brain imaging research at Iowa will inform our implementation of these changes.  However, we also recognize and highly value the expertise of the other members of the ITK developer community, and the implementation will be guided by the consensus judgment of the community as a whole. We will enhance the code infrastructure of ITK with respect to issues of position and orientation of images.  Deliverables will comprise both changes to the core ITK library code, and extensive regression tests to verify correct operation with the rest of the ITK Library. There are three ways in which the handling of orientation in ITK needs to be improved:
# Currently the size of the direction cosines is linked to the number of dimensions in the image – for a 2D Image, they comprise a 2x2 DCM, for a 3D Image 3x3, etc.  Conceptually, the use of the current orientation description is most suited for describing images with exactly 3 spatial dimensions.  We believe this needs to be changed and generalized to accommodate describing data sets within a higher dimensional space, or with respect measurement direction that is different from scanning direction.  First, any 2D scan of anatomy will have an implied third axes, parallel to the direction of image acquisition.  In particular, 2D DICOM slice images always report the three-dimensional image position of the scan with respect to the patient.  At present, when ITK reads a single 2D DICOM image, there is no way to preserve it’s relationship to 3D-space.  Finally, the orientation of a measurement frame with respect to sub-volumes is necessary to properly represent complex acquisition types (such as diffusion weighted imaging). Similarly, 2D Images can have a three-dimensional image origin with a well-defined anatomical meaning.  Discarding that when reading the image is a loss of information.  In both cases (orientation and origin) it will be necessary to enforce backwards compatibility.  This will be achieved in two ways: by adding new class methods that are explicitly three-dimensional, and by careful testing of all ITK classes to ensure their continued correct operation. 
 
*Need more FFT adaptors, and a slight refactoring of FFT adaptor base to meet several platform
 
# It would be nice to have a compliant FFT built in with reasonable performance (vnl does not work)
# Mac Accelerate framework, Intel MLK, 
 
* Need adaptors for some subsets of (SVD/LAPACK/BLAS) numerics:
# Should be able to take advantage of the Mac Acclerate, Intel MLK, Atlas or others with minimal end user configuration 
 
*Remove NeuralNetwork
# The current implementation in ITK requires that the network architecture and Input/Output routines be completely defined at compile-time.  This severely limits the utility of the current implementation.  The Input/Output mechanism of the current Neural Network currently only supports a proprietary network file format.  This limits the ability to analyze the networks with complex external tools such as Matlab Neural Network toolkit.
 
* Coding style, and enforcement:
# There should be some system somewhere that is compliant with the ITK coding style.  It would be preferable if the primary development editors (VS, vim, emacs) could all be configured to support the style consistently. 
# The uncrustify program MAY allow a conduit for helping new developers format to be KWSTYLE compliant.
 
* All process object outputs should be available as data objects (including native types)
# There are times when a filter computes a value that is used as input into later stages of the pipeline,  there needs to be  a way to easily link filters and have the pipeline work properly even when the linkage is a simple integer.
 
* Should the default behavior of all filters be to release their input data
# This may address the complaint that ITK has unacceptable memory usage.
 
* All class objects that end in "2" as a mechanism to fix bugs, and not break backwards compatibility should be removed.
 
* itk_hashtable.h should be investigated to determine if a more standard implementation could replace the existing version.  The current version has many different implementations for dealing with different compiler bases.
 
= ITK 10th Anniversary =
 
== Join us to Celebrate ==
* [[ITK 10th Anniversary Activities| ITK 10th Anniversary Activities]]
 
=== Dashboard Fests ===
* [[ITK 10th Anniversary Activities/Dashboard Fest 2.0 | Dashboard Fest 2.0 ]]
* [[ITK 10th Anniversary Activities/Dashboard Fest 1.0 | Dashboard Fest 1.0 ]]
 
=== Adopt-A-Bug 2.0 ===
* [[ITK 10th Anniversary Activities/Adopt-A-Bug 2.0 | Adopt-A-Bug 2.0 ]]
 
for historical reference:
* [[ITK 10th Anniversary Activities/Adopt-A-Bug 1.0 | Adopt-A-Bug 1.0 ]]
 
=== Share your ITK anecdotes ===
* [[ITK 10th Anniversary Activities/ITK Stories and anecdotes |ITK Stories and anecdotes]]
 
=== ITK CVS History ===
 
*  [[ITK 10th Anniversary Activities/ITK CVS History |ITK CVS History]]
 
= The Insight Segmentation and Registration Toolkit =
 
The National Library of Medicine '''Insight Segmentation and Registration Toolkit''' (ITK) is an open-source software system for medical image processing in two, three and more dimensions. 
 
This is the ''ITK Wiki'', a collaborative hypertext database of information, documentation and resources.
 
== Users ==
 
* [[ITK FAQ|Frequently Asked Questions (FAQ)]]
* [[ITK About|About the Insight Toolkit]]
* [[ITK License Information| License Information]]
* [[ITK Insight Applications|Insight Applications]]
* [[ITK Getting Started|Getting Started with ITK]]
 
* [[ITK Resources|ITK Resources]]
** [[ITK Documentation|Documentation]]
** [[ITK Tutorials|Tutorials]]
** [[ITK Best of the List|Best of the List]]
** [[ITK Related Software|Related Software]]
** [[ITK Third Party Applications|Third Party Applications]]
* [[2006 Survey Summary]]
* [[ITK Upcomings Events|ITK Upcoming Events]]
* [[ITK Procedure for Contributing New Classes and Algorithms|Procedure for Contributing New Classes and Algorithms to ITK]]
 
== Releases ==
 
* Most Recent Release
** [[ITK Release 3.18|What is new in release 3.18]] [[ITK Release 3.18 Changed From Previous |What changed since 3.16]]
 
* Next Recent Releases
** [[ITK Release 3.16|What is new in release 3.16]] [[ITK Release 3.16 Changed From Previous |What changed since 3.14]]
** [[ITK Release 3.14|What is new in release 3.14]] [[ITK Release 3.14 Changed From Previous |What changed since 3.12]]
** [[ITK Release 3.12|What is new in release 3.12]] [[ITK Release 3.12 Changed From Previous |What changed since 3.10]]
* [[ITK Past Releases| Past Releases]]
* [[ITK Release Schedule|Schedule of upcoming releases]]
* [[ITK Release 4.0|Release 4.0 wish list]]
 
== Software Engineering and Development ==
 
* [[ITK Coding Style Guide|Style Guide]]
* [[ITK Configuring and Building|Configuring and Building]]
** [[ITK Scripting|Scripting]]
** [[ITK MS Free Tool|MS Free Tool]]
 
== Academic Corner ==
 
* [[ITK Course Ware|Course Ware]]
* [[ITK File Formats|File Formats]]
* [[ITK Image Registration|Image Registration Topics]]
* [[ITK Image Segmentation|Image Segmentation Topics]]
 
== Professional Corner ==
 
* [[ITK Job Opportunities|Job Opportunities]]
* [[FDA Guidelines for Software Developement]]
 
== Open Society ==
 
* [[ITK Patent Bazaar|Patented Algoritms]]
* [[ITK Open Access Science|Open Access Science]]
* [[ITK The Insight Journal|The Insight Journal]]
* [[ITK The Insight Conference|The Insight Conference]]
 
== Developers Corner ==
 
=== Community Coordination ===
 
* [[ITK in Second Life|In Second Life]]
* [[Telephone Conference Agendas and Minutes]]
* [[ITK Oversight Committee|Oversight Committee]]
* [[ITK Working Groups|Working Groups]]
 
=== Policies and Procedures ===
 
* [[ITK Policies and Procedures]]
** [[ITK Policy and Procedure for Adding Dashboards|Adding Dashboard Submissions]]
** [[Build Instructions for Developers]]
** [[ITK Procedure for Contributing New Classes and Algorithms|Procedure for Contributing New Classes and Algorithms]]
** [[ITK Procedure for Contributing Bug Fixes|Procedure for Contributing Bug Fixes]]
** [[ITK Procedure for Adding a Test|Procedure for Adding a Test]]
** [[ITK Rules for CVS Contributors|Rules for CVS Contributors]]
 
=== Statistics ===
 
* [http://www.ohloh.net/projects/3240?p=Insight+Toolkit ITK in Ohloh]
* [[ITK Code Coverage per Developer|Code Coverage per Developer]]
* [http://public.kitware.com/pub/itk/InsightStatCVS/index.html StatCVS ITK Statistics (Generated:2009-11-05)]
* [http://www.itk.org/Testing/StatCVS/ ITK CVS Statistics (Generated: 2/28/08)]
* [[ITK Code Swarms]]
 
{{ITK/Template/Footer}}

Revision as of 11:58, 17 March 2018

Itk.png

The National Library of Medicine Insight Segmentation and Registration Toolkit (ITK) is an open-source software system for medical image processing in two, three and more dimensions.

This is the ITK Wiki, a collaborative hypertext database of information, documentation and resources.

Overview

Software Process

Resources