r1883: *** empty log message ***

[ctsim.git] / doc / ctsim-gui.tex

diff --git a/doc/ctsim-gui.tex b/doc/ctsim-gui.tex
index 6637303801207b8b6ae0947c6f81f5876ca56a43..a7fe7dc98dd9838b98177135c87b176c535f0c2a 100644 (file)
--- a/doc/ctsim-gui.tex
+++ b/doc/ctsim-gui.tex
@@ -5,17 +5,16 @@
 
 \ctsim\ is the graphical shell for the CTSim project. This shell uses
 the \urlref{wxWindows}{http://www.wxwindows.org} library for
-cross-platform compatibility. The graphical shell is compatible
-with Microsoft Windows, \urlref{GTK}{http://www.gtk.org}, and
+cross-platform compatibility. The graphical shell is compatible with
+Microsoft Windows, \urlref{GTK}{http://www.gtk.org}, and
 \urlref{Motif}{http://www.openmotif.org} graphical environments.
 
 \section{Starting CTSim}
 \usage \texttt{ctsim [files to open...]}
 
-You can invoke \ctsim\ by itself on the command line, or include
-any number of files that you want \ctsim\ to
-automatically open. \ctsim\ can open projection files, image
-files, phantom files, and plot files.
+You can invoke \ctsim\ by itself on the command line, or include any
+number of files that you want \ctsim\ to automatically open. \ctsim\
+can open projection files, image files, phantom files, and plot files.
 
 On Microsoft Windows platforms, the simplest way to invoke \ctsim\ is
 via the \emph{Start} menu under the \emph{Programs} sub-menu.
@@ -185,7 +184,10 @@ helpful tips when \ctsim\ is started.}
 new installations. With this option set, \ctsim\ execute lengthy calculations in the
 background. A background window will appear when processes are running in the background
 and will disappear when no background processes are executing. This background window shows
-the status and progress of all background processes.}
+the status and progress of all background processes. 
+\textbf{NOTE:} Due to limitations of \texttt{wxWindows}, this function is
+only supported on Microsoft Windows.
+}
 
 \end{twocollist}
 
@@ -482,6 +484,10 @@ The displayed properties include:
 \item The parameters used when generating the projections from the phantom.
 \end{itemize}
 
+\subsection{Process - Convert Rectangular}
+The commands takes the projection data and creates an image file using
+the projection data.
+
 \subsection{Process - Convert Polar}\label{IDH_DLG_POLAR}\index{Polar conversion}
 This command creates an image file with the polar conversion of the projection data.
 The parameters to set are:
@@ -494,12 +500,27 @@ Currently, the \texttt{bilinear} option provides the highest
 quality interpolation.}
 \end{twocollist}
 
-\subsection{Process - Convert FFT Polar}
+\subsection{Convert - Convert FFT Polar}
 The parameters for this option are the same as the \helprefn{Convert
 Polar Dialog}{convertpolardialog}. For this command, though, the
 projections are Fourier transformed prior to conversion to polar
 image.
 
+\subsection{Convert - Interpolate to Parallel}
+This command filters divergent projection data (equiangular or
+equilinear) and interpolates (or rebins) to estimate the projection
+data if the projections had been collected with parallel geometry.
+
+\subsection{Analyze - Plot Histogram}
+Plots a histogram of projection data attenuations.
+
+\subsection{Analyze - Plot T-Theta Sampling}
+Plots a 2-dimensional scattergram showing the \texttt{T} and
+\texttt{Theta} values for each data point in the projection data.
+This is especially instructive when scanning with divergent
+geometries and the scan ratio is close to \texttt{1}.
+
+
 \subsection{Reconstruct - Filtered Backprojection}\label{IDH_DLG_RECONSTRUCTION}\index{Dialog!Reconstruction}
 This command displays a dialog to set the parameters for reconstructing an image from projections
 using the filtered backprojection technique. The parameters available are:
@@ -588,8 +609,19 @@ frequency-based filtering. A setting of \texttt{1} is optimal whereas
 a setting of \texttt{0} disables zero padding. Settings greater than \texttt{1}
 perform larger amounts of zero padding but without any significant benefit.}
 
+\twocolitem{\textbf{ROI}}{These four settings control the
+\textit{region of interest} for the reconstruction. The default values
+match the dimensions of the entire phantom. By constraining the ROI to
+be a smaller square, the reconstruction will be magnified.}
+
 \end{twocollist}
 
+\subsection{Reconstruct - Filtered Backprojection (Rebin to Parallel)}\label{IDH_DLG_RECONSTRUCTION_REBIN}\index{Dialog!Reconstruction_Rebin}
+The command reconstructs the projection data via filtered backprojection
+as described above. As opposed to the above command, this command also
+rebins divergent projection data to parallel prior to reconstruction.
+This greatly speeds reconstruction of divergent geometry projections.
+
 \section{Plot Menus}
 \subsection{File - Properties}
 The displayed properties include: