X-Git-Url: http://git.kpe.io/?p=ctsim.git;a=blobdiff_plain;f=doc%2Fctsim-gui.tex;h=964313727a43c0fbf80509a6c05586cf6cc5e229;hp=6637303801207b8b6ae0947c6f81f5876ca56a43;hb=64de9c0b821ceae63e8979815039ff97ba3a5edd;hpb=a4b718a2681d65cb56e62400cec28bc09f9509e1 diff --git a/doc/ctsim-gui.tex b/doc/ctsim-gui.tex index 6637303..9643137 100644 --- 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. @@ -153,6 +152,14 @@ lying at point \texttt{100,50} would be 50 units from the center of the filter. value of \texttt{1}.} \end{twocollist} +\subsection{File - Import}\label{IDH_DLG_IMPORT} +This command allows the importing of non-\ctsim\ file formats into +\ctsim. \texttt{PPM} and \texttt{PNG} formats will be read into an +imagefile window. Color images will be converted to grayscale. If a +\texttt{DICOM} library was linked in with your version of \ctsim, +then you can also import \texttt{DICOM} projection files and image +files. + \subsection{File - Preferences}\label{IDH_DLG_PREFERENCES}\index{Dialog!Preferences} This command displays a dialog box that allows users to control the behavior of \ctsim. These options are saved across \ctsim\ sessions. @@ -185,7 +192,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 +492,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 +508,30 @@ 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}. + +\subsubsection{Theta Range}\label{IDH_DLG_THETA_RANGE} +This dialog box allows the constraint of Theta values for the +T-Theta Sampling scattergram. + \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 +620,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!ReconstructionRebin} +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: