1 \chapter{ctsimtext}\label{ctsimtext}\index{ctsimtext}%
2 \setheader{{\it CHAPTER \thechapter}}{}{}{}{}{{\it CHAPTER \thechapter}}%
3 \setfooter{\thepage}{}{}{}{}{\thepage}%
5 \ctsimtext\ is a master shell for all of the command-line utilities.
8 \ctsimtext\ can be executed without any parameters. In that case, \ctsimtext\
9 offers a command-line to enter the function-names and their parameters. The output of the command is displayed. Further commands may be given to \ctsimtext. The shell is exited by the \texttt{quit} command.
11 \ctsimtext\ can also be called to execute a single command. This is especially useful for batch files containing multiple \ctsimtext\ commands. This is invoked by calling \par
12 \texttt{ctsimtext function-name parameters...}.
14 The available functions are:
16 \section{if1}\label{if1}\index{ctsimtext,if1}%
17 Perfoms math functions on a single image.
20 \begin{itemize}\itemsep=0pt
28 \section{if2}\label{if2}\index{ctsimtext,if2}%
29 Perfoms math functions on a two images.
32 \begin{itemize}\itemsep=0pt
41 \section{ifexport}\label{ifexport}\index{ctsimtext,ifexport}%
42 Export an imagefile to a standard graphics file.
45 \begin{itemize}\itemsep=0pt
47 \begin{itemize}\itemsep=0pt
54 \begin{itemize}\itemsep=0pt
60 \begin{itemize}\itemsep=0pt
73 \section{ifinfo}\label{ifinfo}\index{ctsimtext,ifinfo}%
75 Displays information about an imagefile.
78 \begin{itemize}\itemsep=0pt
86 \section{phm2pj}\label{phm2pj}\index{ctsimtext,phm2pj}%
87 Simulates collection of X-rays data (projections) around a phantom object.
90 phm2pj projection-file-name number-of-detectors number-of-views [options...]
91 \begin{itemize}\itemsep=0pt
93 Select a standard phantom
94 \begin{itemize}\itemsep=0pt
101 Load a phantom definition definition
104 \begin{itemize}\itemsep=0pt
111 Number of samples per each detector
114 Sets the rotation amount as a multiple of pi. For parallel geometries use
115 a rotation angle of 1 and for equilinear and equiangular geometries use a rotation angle of 2.
117 \item --field-of-view
118 Sets the field of view as a ratio of the diameter of the phantom. For parallel geometries, using a value of 1.0 is fine. For other geometies, this should be at least 1.3 to avoid artifacts.
121 Sets the distance of the radiation source and detectors from the center of the object as a ratio of the radius of the object. For parallel geometries, a value of 1.0 is fine. For other geometries, this should be at least 2.0 to avoid artifacts.
124 The Herman phantom is taken with permission from Gabor Hermans 1980 book\cite{HERMAN80}. The Shepp-Logan phantom was published in 1974\cite{SHEPP74}.
126 \section{phm2if}\label{phm2if}\index{ctsimtext,phm2if}%
127 Converts a geometric phantom object into an imagefile. The size of the
128 imagefile in pixels must be specified as well as the number of samples
129 to average per pixel.
132 \begin{itemize}\itemsep=0pt
136 \section{pj2if}\label{pj2if}\index{ctsimtext,pj2if}%
137 Convert a projection file into an imagefile.
140 \begin{itemize}\itemsep=0pt
141 \item --help Print brief online help
144 \section{pjinfo}\label{pjinfo}\index{ctsimtext,pjinfo}%
145 Displays information about a projection file.
148 \begin{itemize}\itemsep=0pt
156 \section{pjrec}\label{pjrec}\index{ctsimtext,pjrec}%
157 Reconstructs the interior of an object from a projection file.
161 \twocolitemruled{\textbf{Parameter}}{\textbf{Options}}
162 \twocolitem{\textbf{--filter}}{Selects which filter to apply to each projection. To properly reconstruct an image, this filter should be multiplied
163 by the absolute value of distance from zero frequency.
164 \begin{itemize}\itemsep=0pt
170 \twocolitem{\textbf{\-\-filter-parameter}}{Sets the alpha level for Hamming
171 window. At setting of 0.54, this equals the Hanning window.}
173 \twocolitem{\textbf{\-\-filter-method}}{Selects the filtering method. For large numbers of detectors, \texttt{rfftw} is optimal. For smaller numbers of detectors, \texttt{convolution} might be a bit faster.
174 \begin{itemize}\itemsep=0pt
182 \twocolitem{\textbf{\-\-filter-generation}}{Selects the filter generation. With convolution, \texttt{direct} is the proper method to select. With any of the frequency methods, \texttt{inverse-fourier} is the best method.
183 \begin{itemize}\itemsep=0pt
185 \item inverse-fourier
188 \twocolitem{\textbf{--interpolation}}{Interpolation technique. \texttt{linear} is optimal.
189 \begin{itemize}\itemsep=0pt
194 \twocolitem{\textbf{-backprojection}}{Selects the backprojection technique. A setting of \texttt{idiff3} is optimal.
195 \begin{itemize}\itemsep=0pt
204 \twocolitem{\textbf{--zeropad}}{Zeropad factor. A setting of \texttt{1} is optimal.}
206 \twocolitem{\textbf{--preinterpolate}}{Selects preinterpolation interpolation technique and sets the preinterpolation factor. Currently, this is experimental and does not work well.}