Skip to content

Commit b0c09ce

Browse files
authored
Merge pull request #19 from InsightSoftwareConsortium/docUpdate
New release version version
2 parents 8e4791e + 325123d commit b0c09ce

File tree

2 files changed

+18
-10
lines changed

2 files changed

+18
-10
lines changed

doc/itkTextureFeature.tex

Lines changed: 17 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@
4646

4747
% Increment the release number whenever significant changes are made.
4848
% The author and/or editor can define 'significant' however they like.
49-
\release{1.0.1}
49+
\release{2.0.0}
5050

5151
% At minimum, give your name and an email address. You can include a
5252
% snail-mail address if you like.
@@ -123,13 +123,13 @@ \section{Introduction}
123123
The chosen solution, described in this article, consists in creating a new ITK
124124
remote module (called itkTextureFeature) dedicated to the computation of feature maps
125125
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.
127127

128128
All the features available in itkTextureFeature are presented in
129129
Section~\ref{sec:features}. Section~\ref{sec:filterUsage} describes the
130130
filters specifications (templates, inputs, parameters) of each filter and how
131131
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
133133
itkTextureFeature filters in Python and C++. Finally,
134134
Sections~\ref{sec:results} and \ref{sec:conclusions} present several
135135
scenarios, results and conclusions obtained with itkTextureFeatures.
@@ -291,7 +291,7 @@ \subsection{itkCoocurrenceTextureFeaturesImageFilter}
291291
\subsection{itkRunLengthTextureFeaturesImageFilter}
292292
\label{sec:RLFilter}
293293

294-
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.
295295

296296
Template Parameters:
297297
\begin{itemize}
@@ -311,8 +311,8 @@ \subsection{itkRunLengthTextureFeaturesImageFilter}
311311
\item The size of the neighborhood radius. (Optional, defaults to 2.)
312312
\end{itemize}
313313

314-
\subsection{Recomandations}
315-
\label{sec:recomandations}
314+
\subsection{Recommendations}
315+
\label{sec:recommendations}
316316

317317
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.
318318

@@ -323,9 +323,17 @@ \subsection{Recomandations}
323323
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).
324324

325325
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+
326334
\newpage
327-
\section{Practical exemples}
328-
\label{sec:exemples}
335+
\section{Practical examples}
336+
\label{sec:examples}
329337

330338
\subsection{C++}
331339
\label{sec:C++Ex}
@@ -569,7 +577,7 @@ \section{Conclusion}
569577
570578
\section*{Acknowledgements}
571579
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).
573581
574582
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.
575583

setup.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@
1212

1313
setup(
1414
name='itk-texturefeatures',
15-
version='1.0.1',
15+
version='2.0.0',
1616
author='Insight Software Consortium',
1717
author_email='[email protected]',
1818
packages=['itk'],

0 commit comments

Comments
 (0)