You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: doc/itkTextureFeature.tex
+17-9Lines changed: 17 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -46,7 +46,7 @@
46
46
47
47
% Increment the release number whenever significant changes are made.
48
48
% The author and/or editor can define 'significant' however they like.
49
-
\release{1.0.1}
49
+
\release{2.0.0}
50
50
51
51
% At minimum, give your name and an email address. You can include a
52
52
% snail-mail address if you like.
@@ -123,13 +123,13 @@ \section{Introduction}
123
123
The chosen solution, described in this article, consists in creating a new ITK
124
124
remote module (called itkTextureFeature) dedicated to the computation of feature maps
125
125
for N-Dimensional images. The filters implemented in itkTextureFeature
126
-
computes the exact same features as \doxygen{CoocurrenceTextureFeaturesFilter} and \doxygen{ScalarImageToRunLengthFeaturesFilter}. However, the new algorithms are optimized (particularly thanks to multithreading, \doxygen{NeighborhoodIterator}, \doxygen{ImageBoundaryFacesCalculator}) to be able to compute the feature maps much faster.
126
+
computes the exact same features as \doxygen{ScalarImageToTextureFeaturesFilter} and \doxygen{ScalarImageToRunLengthFeaturesFilter}. However, the new algorithms are optimized (particularly thanks to multithreading, \doxygen{NeighborhoodIterator}, \doxygen{ImageBoundaryFacesCalculator}) to be able to compute the feature maps much faster.
127
127
128
128
All the features available in itkTextureFeature are presented in
129
129
Section~\ref{sec:features}. Section~\ref{sec:filterUsage} describes the
130
130
filters specifications (templates, inputs, parameters) of each filter and how
131
131
to customize the use of these filters to each different texture analysis
132
-
application. Section~\ref{sec:exemples} contain examples of code using
132
+
application. Section~\ref{sec:examples} contain examples of code using
133
133
itkTextureFeature filters in Python and C++. Finally,
134
134
Sections~\ref{sec:results} and \ref{sec:conclusions} present several
135
135
scenarios, results and conclusions obtained with itkTextureFeatures.
For each pixel of the input image, the itkCoocurrenceTextureFeaturesImageFilter will compute a serie of 10 run length texture features which will be contain in a vector. That way the output of the filter is a N-D image where each pixel will contain a vector of 10 scalars. Each texture map can be extracted from the output image afterward thanks to \doxygen{NthElementImageAdaptor}. By default the texture features are computed for each spatial direction and averaged afterward.
294
+
For each pixel of the input image, the itkRunLengthTextureFeaturesImageFilter will compute a serie of 10 run length texture features which will be contain in a vector. That way the output of the filter is a N-D image where each pixel will contain a vector of 10 scalars. Each texture map can be extracted from the output image afterward thanks to \doxygen{NthElementImageAdaptor}. By default the texture features are computed for each spatial direction and averaged afterward.
\item The size of the neighborhood radius. (Optional, defaults to 2.)
312
312
\end{itemize}
313
313
314
-
\subsection{Recomandations}
315
-
\label{sec:recomandations}
314
+
\subsection{Recommendations}
315
+
\label{sec:recommendations}
316
316
317
317
Using the itkTextureFeature's filters with the default settings will lead, in all likelihood, to meaningless results. In addition, those results might be really time consuming to compute.
318
318
@@ -323,9 +323,17 @@ \subsection{Recomandations}
323
323
In addition to the settings, particular attention should be payed to the input data. Please consider cropping the input are to contain only areas that will be interesting for the analysis. This will both help improving the computation time, thanks to a better distribution of the threaded regions and avoiding memory problems due to too large output data (considering that the output data is 8 or 10 times bigger than the input data).
324
324
325
325
The memory problem due to too large output data can also be solved by separating the output image containing all the feature maps into several images containing one feature map each thanks to the itk class \doxygen{VectorIndexSelectionCastImageFilter}.
326
+
327
+
\subsection{Python wheels}
328
+
\label{sec:PythonWheels}
329
+
330
+
Python wheels allow to easily install itkTextureFeatures and all its dependencies in order to have this texture filters ready to use in python code.They have been generated for the three main operating systems (Mac, Linux and Windows) and three versions of python (2.7, 3.5 and 3.6).
331
+
332
+
To install the python wheels use the following command-line: \$ pip install itk\_textureFextures
333
+
326
334
\newpage
327
-
\section{Practical exemples}
328
-
\label{sec:exemples}
335
+
\section{Practical examples}
336
+
\label{sec:examples}
329
337
330
338
\subsection{C++}
331
339
\label{sec:C++Ex}
@@ -569,7 +577,7 @@ \section{Conclusion}
569
577
570
578
\section*{Acknowledgements}
571
579
572
-
This work was supported by the National Institute of Health (NIH) National Institute for Dental and Craniofacial Research (NIDCR) R01EB021391 (Textural Biomarkers of Arthritis for the Subchondral Bone in the Temporomandibular Joint).
580
+
This work was supported by the National Institute of Health (NIH) National Institute for Dental and Craniofacial Research (NIDCR) grant R01EB021391 (Textural Biomarkers of Arthritis for the Subchondral Bone in the Temporomandibular Joint), NIDCR grant R01DE024450 (Quantification of 3D bony Changes in Temporomandibular Joint Osteoarthritis) and National Institute of Biomedical Imaging and Bioengineering (NIBIB) grant R01EB021391 (Shape Analysis Toolbox for Medical Image Computing Projects).
573
581
574
582
We would like to thank Dr. Larry Wolford from the Baylor University Medical Center for kindly providing the bone specimens from which we obtained the scans used in the paper. We would like to thank Drs. Lucia Cevidanes, Erika Benavides and Antonio Ruellas at the University of Michigan School of Dentistry as well, for generating the CBCT scans that were processed with the filters presented in the paper.
0 commit comments