README

   1 COPYRIGHT
   2 =========
   3 This program is written by Kevin M. Rosenberg, M.D.
   4
   5 It is covered by the GNU General Public License (GPL) which
   6 allows copying and modifying this code with restrictions. See the
   7 file COPYING for complete details.
   8
   9
  10 HISTORY
  11 =======
  12
  13 CTSim development began in 1983 while I was in medical school.  It was
  14 written using Lattice C and MS-DOS. I used assembly language to write
  15 directly to an IBM EGA video adapter.
  16
  17 In 1999, I ported CTsim to GNU/Linux. In April 2000, the source code
  18 for CTSim was published on the Internet.
  19
  20 In June 2000, entire code for revised and converted to C++.
  21
  22
  23 STATUS
  24 ======
  25
  26 The official home for CTsim is http://www.ctsim.org. From this site,
  27 you can download the CTsim source code and use CTSim online using a
  28 beowulf cluster.
  29
  30 I would be very pleased to have other developers join me in the
  31 development of CTSim. Please see the TODO list for the most obvious
  32 ideas.
  33
  34 Interactive graphics have not yet been implemented. I am still researching
  35 cross-platform tools to create a graphical interface with interactive
  36 graphics of the simulation and reconstruction processes.
  37
  38
  39 OVERVIEW
  40 ========
  41
  42 CTSim simulates the collection of x-rays by a CT scanner. These x-rays
  43 of objects are called projections.
  44
  45 Phantom objects are defined. Several built-in phantoms are included,
  46 as well as an extension to load files of phantom definitions.
  47
  48 CTsim uses cross-platform compatible file formats for projection data and
  49 image data.
  50
  51
  52 THE PROGRAMS
  53 ============
  54
  55 phm2if - generates an image file of a phantom object
  56
  57 phm2pj - Simulates the collection of CT data, or projections, of a phantom
  58 object
  59
  60 ctrec - Performs an CT reconstruction, also known as image
  61 reconstruction from projections. Reads a projection file and writes a SDF
  62 file.
  63
  64 pj2if - Converts projection data to a raw sinugram image
  65
  66 if2img - Converts an image file to a variety of 8-bit and 16-bit image formats
  67
  68 ifinfo - Show statistics and history labels of SDF files
  69
  70
  71 TYPICAL USAGE
  72 =============
  73
  74 When evaluating CT simulation, in general, these steps are followed:
  75
  76 Create a phantom image and viewable image file
  77   phm2if ...
  78   if2img ...
  79
  80 Simulate CT data collection and create a viewable image of raw projections
  81   phm2pj ...
  82   pj2if ...
  83   if2img ...
  84
  85 Perform CT reconstruction and create viewable image file
  86   ctrec ...
  87   if2img ...
  88
  89 Display image information and comparative statistics
  90   ifinfo ...
  91
  92 There is a sample shell script installed called 'sample-ctsim.sh' that performs
  93 the above commands.n
  94
  95 These functions can be invoked via a web interface with a CGI program
  96 as described in the INSTALL file.
  97
  98
  99 CLOSING
 100 =======
 101
 102 Please enjoy CTSim. I'd like to hear any feedback
 103
 104 Kevin M. Rosenberg, M.D.
 105 kevin@rosenberg.net
 106
 107
 108