Mercurial > repos > imgteam > imagej2_skeletonize3d

comparison imagej2_skeletonize3d.xml @ 0:f6df6830d5ec draft

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
"planemo upload for repository https://github.com/bgruening/galaxytools/tree/master/tools/image_processing/imagej2 commit b08f0e6d1546caaf627b21f8c94044285d5d5b9c-dirty"
author imgteam
date Tue, 17 Sep 2019 16:57:15 -0400
parents
children 768825d9034a
comparison
equal deleted inserted replaced
-1:000000000000 0:f6df6830d5ec
1 <?xml version='1.0' encoding='UTF-8'?>
2 <tool id="imagej2_skeletonize3d" name="Skeletonize" version="@WRAPPER_VERSION@.0">
3 <description></description>
4 <macros>
5 <import>imagej2_macros.xml</import>
6 </macros>
7 <expand macro="fiji_requirements" />
8 <command>
9 <![CDATA[
10 python $__tool_directory__/imagej2_skeletonize3d.py
11 --input "$input"
12 --input_datatype $input.ext
13 --black_background $black_background
14 --jython_script $__tool_directory__/imagej2_skeletonize3d_jython_script.py
15 --output "$output"
16 --output_datatype $output.ext
17 ]]>
18 </command>
19 <inputs>
20 <param format="bmp,eps,gif,jpg,pcx,pgm,png,psd,tiff" name="input" type="data" label="Select grayscale image"/>
21 <expand macro="black_background_param" />
22 </inputs>
23 <outputs>
24 <data name="output" format_source="input" label="${tool.name} on ${on_string}"/>
25 </outputs>
26 <tests>
27 <test>
28 <param name="input" value="blobs.gif" />
29 <param name="input_datatype" value="gif" />
30 <param name="output_datatype" value="gif" />
31 <output name="output" file="skeletonized_blobs.gif" compare="sim_size" />
32 </test>
33 <test>
34 <param name="input" value="clown.jpg" />
35 <param name="input_datatype" value="jpg" />
36 <param name="output_datatype" value="jpg" />
37 <output name="output" file="skeletonized_clown.jpg" compare="sim_size" />
38 </test>
39 </tests>
40 <help>
41
42 .. class:: warningmark
43
44 @requires_binary_input@
45
46 **What it does**
47
48 <![CDATA[
49 Skeletonizes a 2D or 3D binary (8-bit) image. As Hanno Homman explains in his paper, binary thinning is
50 used for finding the centerlines (”skeleton”) of objects in the input image. The general idea is to erode
51 the object’s surface iteratively until only the skeleton remains. Erosion has to be performed symmetrically
52 in order to the guarantee medial position of the skeleton lines and such that the connectedness of the
53 object is preserved. Care has to be taken in order not to create holes or cavities in the object.
54
55 There are two major approaches to image thinning: a) kernel-based filters and b) decision trees. Kernel-based
56 filters apply a structuring element to the image and can generally be extended to dimensions higher than 3D,
57 to find computationally efficient solutions for 4D and higher dimensions is subject of ongoing research.
58 Methods based on decision trees are thus far limited to 2D and 3D, but are potentially faster than morphological
59 filters, if they are well designed and can find more deletable points at each iteration.
60
61 In 3D there are 67,108,864 possible binary combinations of object and background voxels in a 26-neighborhood,
62 which cannot be completely captured by kernel-based filters. Lee et al. have demonstrated in their work that
63 their solution, based on a decision tree, can handle all these cases correctly and find all deletable surface
64 points at each iteration. Thus their algorithm allows for a very fast iterative erosion process.
65 ]]>
66 </help>
67 <citations>
68 <citation type="doi">10.1006/cgip.1994.1042</citation>
69 <citation type="doi">10.1038/nmeth.2102</citation>
70 </citations>
71 </tool>