Skip to content

Commit e701337

Browse files
committed
ENH: Use non-breaking space before references
cite, ref, pageref, Figure, Table should have the reference information adjacent to the preceeding text for clarity.
1 parent b466f06 commit e701337

25 files changed

Lines changed: 104 additions & 114 deletions

SoftwareGuide/Latex/Appendices/CodingStyleGuide.tex

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -273,8 +273,8 @@ \subsection{CMake Build Environment}%
273273
CMake web pages at \href{https://www.cmake.org}{https://www.cmake.org} for more
274274
information.
275275

276-
See Section~\ref{sec:UsingCMakeForConfiguringAndBuildingITK} on page
277-
\pageref{sec:UsingCMakeForConfiguringAndBuildingITK} for specifics about the use
276+
See Section~\ref{sec:UsingCMakeForConfiguringAndBuildingITK}
277+
on page~\pageref{sec:UsingCMakeForConfiguringAndBuildingITK} for specifics about the use
278278
of CMake in ITK.
279279

280280
Section~\ref{sec:CMakeStyle} on page~\pageref{sec:CMakeStyle} provides a
@@ -358,7 +358,7 @@ \section{Copyright}%
358358
\end{minted}
359359
\normalsize
360360

361-
See Chapter \ref{sec:InsightToolkitLicense} for further details on the ITK
361+
See Chapter~\ref{sec:InsightToolkitLicense} for further details on the ITK
362362
license.
363363

364364

@@ -631,7 +631,7 @@ \subsubsection{Naming Tests}%
631631
\label{subsubsec:NamingTests}
632632
633633
Following the \code{TestDriver} philosophy, see Section~\ref{sec:Tests} on
634-
page \pageref{sec:Tests}, test files must be named with the same name used to
634+
page~\pageref{sec:Tests}, test files must be named with the same name used to
635635
name the \code{main} method contained in the test file (\code{.cxx}). This
636636
name should generally be indicative of the class tested, e.g.
637637
\small
@@ -646,8 +646,8 @@ \subsubsection{Naming Tests}%
646646
647647
Note that all test files should start with the lowercase \code{itk} prefix.
648648
Hence, the main method name in a test is the sole exception to the method naming
649-
convention of starting all method names with capitals (see
650-
\ref{subsec:NamingMethodsAndFunctions}).
649+
convention of starting all method names with capitals
650+
(see~\ref{subsec:NamingMethodsAndFunctions}).
651651
652652
A test's input argument number should always be named \code{argc}, and the input
653653
arguments \code{argv} for the sake of consistency.

SoftwareGuide/Latex/Appendices/GitWorkflow.tex

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -415,7 +415,7 @@ \subsubsection{Development}%
415415
This is where the real work happens. Edit, stage, and commit files
416416
repeatedly as needed for your work.
417417

418-
During this step, avoid the \ref{par:UrgeToMerge} from an integration branch.
418+
During this step, avoid the~\ref{par:UrgeToMerge} from an integration branch.
419419
Keep your commits focused on the topic at hand.
420420

421421
\begin{minted}[baselinestretch=1,fontsize=\footnotesize,linenos=false,bgcolor=ltgray]{bash}

SoftwareGuide/Latex/Architecture/Iterators.tex

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ \chapter{Iterators}%
99
which are highly specialized to simplify common image processing tasks.
1010

1111
The next section is a brief introduction that defines iterators in the context
12-
of ITK. Section \ref{sec:IteratorsInterface} describes the programming
12+
of ITK. Section~\ref{sec:IteratorsInterface} describes the programming
1313
interface common to most ITK image iterators.
1414
Sections~\ref{sec:ImageIterators}--\ref{sec:NeighborhoodIterators} document
1515
specific ITK iterator types and provide examples of how they are used.
@@ -807,8 +807,8 @@ \subsection{ShapedNeighborhoodIterator}%
807807

808808
The functionality and interface of the shaped neighborhood iterator is best
809809
described by example. We will use the ShapedNeighborhoodIterator to
810-
implement some binary image morphology algorithms (see \cite{Gonzalez1993},
811-
\cite{Castleman1996}, et al.). The examples that follow implement erosion and
810+
implement some binary image morphology algorithms (see~\cite{Gonzalez1993},~\cite{Castleman1996}, et al.).
811+
The examples that follow implement erosion and
812812
dilation.
813813

814814
\subsubsection{Shaped neighborhoods: morphological operations}%

SoftwareGuide/Latex/Architecture/SystemOverview.tex

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -98,14 +98,14 @@ \subsection{Generic Programming}%
9898
\index{template}
9999

100100
Generic programming is a method of organizing libraries consisting of
101-
generic---or reusable---software components \cite{Musser1996}. The idea is to
101+
generic---or reusable---software components~\cite{Musser1996}. The idea is to
102102
make software that is capable of ``plugging together'' in an efficient,
103103
adaptable manner. The essential ideas of generic programming are
104104
\emph{containers} to hold data, \emph{iterators} to access the data, and
105105
\emph{generic algorithms} that use containers and iterators to create
106106
efficient, fundamental algorithms such as sorting. Generic programming is
107107
implemented in C++ with the \emph{template} programming mechanism and the
108-
use of the STL Standard Template Library \cite{Austern1999}.
108+
use of the STL Standard Template Library~\cite{Austern1999}.
109109

110110
C++ templating is a programming technique allowing users to write software in
111111
terms of one or more unknown types \code{T}. To create executable code, the
@@ -330,7 +330,7 @@ \subsection{Event Handling}%
330330
\index{InvokeEvent()}
331331

332332
Event handling in ITK is implemented using the Subject/Observer design
333-
pattern \cite{Gamma1995} (sometimes referred to as the Command/Observer
333+
pattern~\cite{Gamma1995} (sometimes referred to as the Command/Observer
334334
design pattern). In this approach, objects indicate that they are watching
335335
for a particular event---invoked by a particular instance---by registering
336336
with the instance that they are watching. For example, filters in ITK

SoftwareGuide/Latex/DesignAndFunctionality/AnisotropicDiffusionFiltering.tex

Lines changed: 12 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -12,10 +12,10 @@
1212
fine structure of the image and thereby changes subtle aspects of the
1313
anatomical shapes in question.
1414

15-
Perona and Malik \cite{Perona1990} introduced an alternative to
15+
Perona and Malik~\cite{Perona1990} introduced an alternative to
1616
linear-filtering that they called \emph{anisotropic diffusion}. Anisotropic
17-
diffusion is closely related to the earlier work of Grossberg
18-
\cite{Grossberg1984}, who used similar nonlinear diffusion processes to model
17+
diffusion is closely related to the earlier work of Grossberg~\cite{Grossberg1984},
18+
who used similar nonlinear diffusion processes to model
1919
human vision. The motivation for anisotropic diffusion (also called
2020
\emph{nonuniform} or \emph{variable conductance} diffusion) is that a Gaussian
2121
smoothed image is a single time slice of the solution to the heat equation,
@@ -41,7 +41,7 @@
4141
conductance parameter, $k$, and the time parameter, $t$, that is analogous to
4242
$\sigma$, the effective width of the filter when using Gaussian kernels.
4343

44-
Equation \ref{eq:aniso} is a nonlinear partial differential equation that can
44+
Equation~\ref{eq:aniso} is a nonlinear partial differential equation that can
4545
be solved on a discrete grid using finite forward differences. Thus, the
4646
smoothed image is obtained only by an iterative process, not a convolution or
4747
non-stationary, linear filter. Typically, the number of iterations required
@@ -50,10 +50,9 @@
5050
purpose, single-processor computers. The technique applies readily and
5151
effectively to 3D images, but requires more processing time.
5252

53-
In the early 1990's several research groups \cite{Gerig1991,Whitaker1993d}
53+
In the early 1990's several research groups~\cite{Gerig1991,Whitaker1993d}
5454
demonstrated the effectiveness of anisotropic diffusion on medical images. In
55-
a series of papers on the subject
56-
\cite{Whitaker1993,Whitaker1993b,Whitaker1993c,Whitaker1993d,Whitaker-thesis,Whitaker1994},
55+
a series of papers on the subject~\cite{Whitaker1993,Whitaker1993b,Whitaker1993c,Whitaker1993d,Whitaker-thesis,Whitaker1994},
5756
Whitaker described a detailed analytical and empirical analysis, introduced a
5857
smoothing term in the conductance that made the process more robust, invented a
5958
numerical scheme that virtually eliminated directional artifacts in the
@@ -78,19 +77,18 @@
7877
separately, but linked through the conductance term. Vector-valued diffusion
7978
is also useful for processing registered data from different devices or for
8079
denoising higher-order geometric or statistical features from scalar-valued
81-
images \cite{Whitaker1994,Yoo1993}.
80+
images~\cite{Whitaker1994,Yoo1993}.
8281

8382
The output of anisotropic diffusion is an image or set of images that
8483
demonstrates reduced noise and texture but preserves, and can also enhance,
8584
edges. Such images are useful for a variety of processes including
8685
statistical classification, visualization, and geometric feature extraction.
87-
Previous work has shown \cite{Whitaker-thesis} that anisotropic diffusion, over
86+
Previous work has shown~\cite{Whitaker-thesis} that anisotropic diffusion, over
8887
a wide range of conductance parameters, offers quantifiable advantages over
8988
linear filtering for edge detection in medical images.
9089

9190
Since the effectiveness of nonlinear diffusion was first demonstrated, numerous
92-
variations of this approach have surfaced in the literature \cite{Romeny1994}.
93-
These include alternatives for constructing dissimilarity measures
94-
\cite{Sapiro1996}, directional (i.e., tensor-valued) conductance terms
95-
\cite{Weickert1996,Alvarez1994} and level set interpretations
96-
\cite{Whitaker2001}.
91+
variations of this approach have surfaced in the literature~\cite{Romeny1994}.
92+
These include alternatives for constructing dissimilarity measures~\cite{Sapiro1996},
93+
directional (i.e., tensor-valued) conductance terms~\cite{Weickert1996,Alvarez1994}
94+
and level set interpretations~\cite{Whitaker2001}.

SoftwareGuide/Latex/DesignAndFunctionality/ConfidenceConnectedOnBrainWeb.tex

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ \subsubsection{Application of the Confidence Connected filter on the Brain Web D
66
The previous code was used in this example replacing the image dimension by 3.
77
Gradient Anistropic diffusion was applied to smooth the image. The filter used 2 iterations, a time step of 0.05 and a conductance value of 3. The smoothed volume was then segmented using the Confidence Connected approach. Five seed points were used at coordinate locations (118,85,92), (63,87,94), (63,157,90), (111,188,90), (111,50,88). The ConfidenceConnnected filter used the parameters, a neighborhood radius of 2, 5 iterations and an $f$ of 2.5 (the same as in the previous example). The results were then rendered using VolView.
88

9-
Figure \ref{fig:3DregionGrowingScreenshot1} shows the rendered volume. Figure \ref{fig:SlicesBrainWeb} shows an axial, sagittal and a coronal slice of the volume.
9+
Figure~\ref{fig:3DregionGrowingScreenshot1} shows the rendered volume. Figure~\ref{fig:SlicesBrainWeb} shows an axial, sagittal and a coronal slice of the volume.
1010

1111
\begin{figure}
1212
\centering

SoftwareGuide/Latex/DesignAndFunctionality/DeformableRegistration.tex

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ \subsection{FEM-Based Image Registration}%
2424

2525
\input{DeformableRegistration1.tex}
2626

27-
Figure \ref{fig:DeformableRegistration1Output} presents the results of
27+
Figure~\ref{fig:DeformableRegistration1Output} presents the results of
2828
the FEM-based deformable registration applied to two time-separated
2929
slices of a living rat dataset. Checkerboard comparisons of the two
3030
images are shown before registration (left) and after registration

SoftwareGuide/Latex/DesignAndFunctionality/DeformableRegistration4OnBrain.tex

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@
1414
\code{ImageDimension} by 3.
1515

1616
The registration method uses B-splines and an LBFGS optimizer. The trace in
17-
Table. \ref{tab:LBFGStrace} prints the trace of the optimizer through the
17+
Table~\ref{tab:LBFGStrace} prints the trace of the optimizer through the
1818
search space.
1919

2020
\begin{table}
@@ -45,9 +45,9 @@
4545
minimum, $x$. ``Function Value" is the current value of the function, f(x).
4646

4747
The resulting deformation field that maps the moving to the fixed image is
48-
shown in \ref{fig:DeformationFieldOutput}. A difference image of two slices
49-
before and after registration is shown in
50-
\ref{fig:DefRegistrationDiffScreenshot}. As can be seen from the figures, the
48+
shown in~\ref{fig:DeformationFieldOutput}. A difference image of two slices
49+
before and after registration is shown in~\ref{fig:DefRegistrationDiffScreenshot}.
50+
As can be seen from the figures, the
5151
deformation field is in close agreement to the one generated from the Thin
5252
plate spline warping.
5353

SoftwareGuide/Latex/DesignAndFunctionality/DemonsRegistration.tex

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,7 @@
1010
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1111

1212
For the problem of intra-modality deformable registration, the Insight
13-
Toolkit provides an implementation of Thirion's ``demons'' algorithm
14-
\cite{Thirion1995b,Thirion1998}.
13+
Toolkit provides an implementation of Thirion's ``demons'' algorithm~\cite{Thirion1995b,Thirion1998}.
1514
In this implementation, each image is viewed as a set of iso-intensity
1615
contours. The main idea is that a regular grid of forces deform an image by
1716
pushing the contours in the normal direction. The orientation and magnitude
@@ -25,7 +24,7 @@
2524
In the above equation, $f(\textbf{X})$ is the fixed image, $m(\textbf{X})$
2625
is the moving image to be registered, and $\textbf{D}(\textbf{X})$ is the displacement
2726
or optical flow between the images. It is well known in optical flow
28-
literature that Equation \ref{eqn:OpticalFlow} is insufficient to specify
27+
literature that Equation~\ref{eqn:OpticalFlow} is insufficient to specify
2928
$\textbf{D}(\textbf{X})$ locally and is usually determined using some form of
3029
regularization. For registration, the projection of the vector on the
3130
direction of the intensity gradient is used:
@@ -53,9 +52,8 @@
5352
invariant to the pixel scaling of the images.
5453

5554
Starting with an initial deformation field $\textbf{D}^{0}(\textbf{X})$, the demons
56-
algorithm iteratively updates the field using Equation
57-
\ref{eqn:DemonsDisplacement} such that the field at the $N$-th iteration is
58-
given by:
55+
algorithm iteratively updates the field using Equation~\ref{eqn:DemonsDisplacement} such
56+
that the field at the $N$-th iteration is given by:
5957

6058
\begin{equation}
6159
\textbf{D}^{N}(\textbf{X}) = \textbf{D}^{N-1}(\textbf{X}) - \frac

SoftwareGuide/Latex/DesignAndFunctionality/Filtering.tex

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -227,8 +227,7 @@ \subsection{Blurring}%
227227
of the most commonly used kernels is the Gaussian. Two implementations of
228228
Gaussian smoothing are available in the toolkit. The first one is based on a
229229
traditional convolution while the other is based on the application of IIR
230-
filters that approximate the convolution with a Gaussian
231-
\cite{Deriche1990,Deriche1993}.
230+
filters that approximate the convolution with a Gaussian~\cite{Deriche1990,Deriche1993}.
232231

233232
\subsubsection{Discrete Gaussian}%
234233
\label{sec:DiscreteGaussianImageFilter}

0 commit comments

Comments
 (0)