ITK/Release 4/Modularization/Add an external module (external module): Difference between revisions

From KitwarePublic
Jump to navigationJump to search
Line 15: Line 15:


The ITK method for handling test data is the [[ITK/Git/Develop/Data#ExternalData | CMake/ExternalData]] method, where MD5 hashes of the data are stored in the repository, then the files corresponding to the hashes are fetched at build time from a list of data servers.  These data servers can be an Apache server you have at your webhost, a [http://midasplatform.org/ Midas server], a Dropbox account, an Amazon S3 account, a Rackspace Cloud File account, etc.
The ITK method for handling test data is the [[ITK/Git/Develop/Data#ExternalData | CMake/ExternalData]] method, where MD5 hashes of the data are stored in the repository, then the files corresponding to the hashes are fetched at build time from a list of data servers.  These data servers can be an Apache server you have at your webhost, a [http://midasplatform.org/ Midas server], a Dropbox account, an Amazon S3 account, a Rackspace Cloud File account, etc.
To use the ExternalData mechanism with your own data server:
# Add testing data references in you ''test/CMakeLists.txt'' as you normally would, i.e. use '''itk_add_test''' and with '''DATA{Baseline/image.mha}'''.
# As usual, copy the image to its location specifie within ''DATA{}''.
# As usual, next time ''cmake'' is executed, a message will appear like: ''Linked Modules/External/ITKMyNewModule/test/Baseline/image.mha.md5 to ExternalData MD5/a3519cb25bb2afeda999378a2f8103cc''
# Copy the file ''ExternalData/MD5/a3519cb25bb2afeda999378a2f8103cc'' to a location on your publically available data server, such as ''http://www.example.com/ITKExternalData/MD5/a3519cb25bb2afeda999378a2f8103cc''.


=== Make available to the community ===
=== Make available to the community ===

Revision as of 17:48, 14 July 2012

Synopsis

An External Module is distributed outside the ITK main repository, but it could be built into ITK as a module once downloaded into the local copy of ITK source tree.

Organization

The organization of an External Module should be the same as an Internal Module: Add a module (Internal Module)

To build an External Module, users download it into a local copy of ITK source tree under: ITK/Modules/External/. Then simply rerun the CMake step to configure the new External Module together with other enabled ITK modules.

Adding testing data

Testing data, such an input and baseline images, are typically kept outside of the Git repository to keep the repository small.

The ITK method for handling test data is the CMake/ExternalData method, where MD5 hashes of the data are stored in the repository, then the files corresponding to the hashes are fetched at build time from a list of data servers. These data servers can be an Apache server you have at your webhost, a Midas server, a Dropbox account, an Amazon S3 account, a Rackspace Cloud File account, etc.

To use the ExternalData mechanism with your own data server:

  1. Add testing data references in you test/CMakeLists.txt as you normally would, i.e. use itk_add_test and with DATA{Baseline/image.mha}.
  2. As usual, copy the image to its location specifie within DATA{}.
  3. As usual, next time cmake is executed, a message will appear like: Linked Modules/External/ITKMyNewModule/test/Baseline/image.mha.md5 to ExternalData MD5/a3519cb25bb2afeda999378a2f8103cc
  4. Copy the file ExternalData/MD5/a3519cb25bb2afeda999378a2f8103cc to a location on your publically available data server, such as http://www.example.com/ITKExternalData/MD5/a3519cb25bb2afeda999378a2f8103cc.

Make available to the community

An example is demonstrated in the Lesion Sizing Toolkit: Lesion Sizing Toolkit Wiki

Once you have your External Module, you can make it available as a Remote Module so it has broader exposure to the ITK community.