+/*****************************************************************************
+** This is part of the CTSim program
+** Copyright (C) 1983-2000 Kevin Rosenberg
+**
+** $Id: ir.h,v 1.6 2000/05/03 08:49:49 kevin Exp $
+** $Log: ir.h,v $
+** Revision 1.6 2000/05/03 08:49:49 kevin
+** Code cleanup
+**
+** Revision 1.5 2000/05/02 20:00:25 kevin
+** *** empty log message ***
+**
+** Revision 1.4 2000/05/02 15:31:39 kevin
+** code cleaning
+**
+** Revision 1.3 2000/04/29 23:24:29 kevin
+** *** empty log message ***
+**
+** Revision 1.2 2000/04/28 14:14:16 kevin
+** *** empty log message ***
+**
+** Revision 1.1.1.1 2000/04/28 13:02:43 kevin
+** Initial CVS import for first public release
+**
+**
+**
+** This program is free software; you can redistribute it and/or modify
+** it under the terms of the GNU General Public License (version 2) as
+** published by the Free Software Foundation.
+**
+** This program is distributed in the hope that it will be useful,
+** but WITHOUT ANY WARRANTY; without even the implied warranty of
+** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+** GNU General Public License for more details.
+**
+** You should have received a copy of the GNU General Public License
+** along with this program; if not, write to the Free Software
+** Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+******************************************************************************/
/* FILE IDENTIFICATION
*
* Name: ir.h Header File for Image Reconstruction System
IMAGE_VAL v; /* values of voxels in matrix form */
SDF_2D *dfp_2d; /* Pointer to disk image file */
int nx, ny; /* size of voxel matrix */
- double xmin, xmax, ymin, ymax; /* extent of voxel matrix in pic coord */
+ double xmin, xmax, ymin, ymax; /* extent of voxel matrix in phm coord */
char remark[LENREMARK]; /* description of voxel data */
float calctime; /* time to calculate voxels in seconds */
};
double xmin, xmax, ymin, ymax; /* object limits */
double radius; /* " */
struct { /* transform matrices */
- GRFMTX_2D p_to_o; /* map from pic to standard obj coords */
- GRFMTX_2D o_to_p; /* map from std object coords to pic coords */
+ GRFMTX_2D p_to_o; /* map from phm to standard obj coords */
+ GRFMTX_2D o_to_p; /* map from std object coords to phm coords */
} xform;
- struct object_st *next; /* pointer to next object in picture */
+ struct object_st *next; /* pointer to next object in PHANTOM */
};
typedef struct object_st OBJECT;
-struct pic_st { /* Picture structure */
+struct phm_st { /* PHANTOM structure */
OBJECT *objlist; /* object list */
int type;
- int numobj; /* number of objects in picture */
+ int numobj; /* number of objects in PHANTOM */
double xmin, xmax, ymin, ymax; /* extent of objects in object coordinates */
double radius; /* " " */
};
typedef struct image_st IMAGE;
-typedef struct pic_st PICTURE;
+typedef struct phm_st PHANTOM;
-#define P_OBJECTS 0 /* Picture made of objects */
-#define P_UNIT_PULSE 1 /* Special picture, not made of objects */
+#define P_OBJECTS 0 /* PHANTOM made of objects */
+#define P_UNIT_PULSE 1 /* Special PHANTOM, not made of objects */
#define P_FILTER 9 /* defined only by a type */
/*----------------------------------------------------------------------*/
struct detarray_st {
DETECT_TYPE *detval; /* Pointer to array of values recorded by detector */
- int ndet; /* Number of detectors in array */
+ int ndet; /* Number of detectors in array */
double view_angle; /* View angle in radians */
};
+#define DETECTOR_PARALLEL 1
+#define DETECTOR_EQUIANGLE 2
+#define DETECTOR_EQUILINEAR 3
+
struct detect_st {
+ int geometry; /* Geometry of detectory */
int ndet; /* Number of detectors in array */
int nview; /* Number of rotated views */
int nsample; /* Number of rays per detector */
double det_inc; /* Increment between centers of detectors */
double rot_inc; /* Increment in rotation angle between views */
double radius; /* Radius of rotation. Distance from */
- /* center of pic to center of det */
- double piclen; /* Maximum Length of picture or area of interest */
+ /* center of phm to center of det */
+ double phmlen; /* Maximum Length of PHANTOM or area of interest */
struct {
double xd1,yd1,xd2,yd2; /* Coordinates of detector endpoints */
double xs1,ys1,xs2,ys2; /* Coordinates of source endpoints */
double rot_start; /* starting view rotation */
double rot_inc; /* angle between rotations */
double det_start; /* distance of beginning detector to center */
- /* of picture */
+ /* of PHANTOM */
double det_inc; /* increment between detectors */
- double piclen; /* Length of picture edge (pic is square) */
+ double phmlen; /* Length of PHANTOM edge (phm is square) */
};
typedef struct detarray_st DETARRAY;
/* Defines coords for inside_obj() */
#define OBJ_COORD -1 /* Normalized Object Coordinates */
-#define PIC_COORD -2 /* User's Picture Coordinates */
+#define PHM_COORD -2 /* User's PHANTOM Coordinates */
/* Codes for Filter types */
#define I_2BSPLINE 4
#define I_3BSPLINE 5
-/* Constants for sizing picture */
+/* Constants for sizing PHANTOM */
-#define PERCENT_PIC_SIZE_INCR 0.0 /* Fractional increase in picture */
+#define PERCENT_PHM_SIZE_INCR 0.0 /* Fractional increase in PHANTOM */
/* limits compared to object size */
#define N_EXTRA_DETECTORS 4 /* Number of extra detectors */
/* widths when calculating detlen */
#define O_TRACE_NONE_STR "none"
#define O_TRACE_TEXT_STR "text"
-#define O_TRACE_PIC_STR "pic"
+#define O_TRACE_PHM_STR "phm"
#define O_TRACE_RAYS_STR "rays"
#define O_TRACE_PLOT_STR "plot"
#define O_TRACE_CLIPPING_STR "clipping"
#define TRACE_NONE 0 /* No tracing */
#define TRACE_TEXT 1 /* Minimal status */
-#define TRACE_PIC 2 /* Show picture */
+#define TRACE_PHM 2 /* Show PHANTOM */
#define TRACE_RAYS 3 /* Show all rays */
#define TRACE_PLOT 4 /* Plot raysums */
#define TRACE_CLIPPING 5 /* Plot clipping */
-#define O_PIC_HERMAN 1 /* Herman head phantom */
-#define O_PIC_ROWLAND 2 /* Rowland head phantom */
-#define O_PIC_BROWLAND 3 /* Bordered Rowland head phantom */
-#define O_PIC_UNITPULSE 4 /* Unit pulse phantom */
+#define O_PHM_HERMAN 1 /* Herman head phantom */
+#define O_PHM_ROWLAND 2 /* Rowland head phantom */
+#define O_PHM_BROWLAND 3 /* Bordered Rowland head phantom */
+#define O_PHM_UNITPULSE 4 /* Unit pulse phantom */
-#define O_PIC_HERMAN_STR "herman"
-#define O_PIC_ROWLAND_STR "rowland"
-#define O_PIC_BROWLAND_STR "browland"
-#define O_PIC_UNITPULSE_STR "unitpulse"
+#define O_PHM_HERMAN_STR "herman"
+#define O_PHM_ROWLAND_STR "rowland"
+#define O_PHM_BROWLAND_STR "browland"
+#define O_PHM_UNITPULSE_STR "unitpulse"
#define O_INTERP_NEAREST_STR "nearest"
#define O_INTERP_LINEAR_STR "linear"
/* bspline.c */
int bspline(int samples, int zoom_factor, int spline_order, double input[], double output[]);
-/* clip.c */
-int inside_obj(const OBJECT *obj, double x, double y, const int coord_type);
-int clipsegment(double *x1, double *y1, double *x2, double *y2, const double u, const double v);
-int clipsector(double *x1, double *y1, double *x2, double *y2, const double u, const double v);
-int clipcircle(double *x1, double *y1, double *x2, double *y2, const double cx, const double cy, const double radius, double t1, double t2);
-int cliptriangle(double *x1, double *y1, double *x2, double *y2, const double u, const double v, const int clip_xaxis);
/* convolve.c */
double convolve(const double f1[], const double f2[], const double dx, const int n, const int np, const int func_type);
double convolve_both(const double f1[], const double f2[], const double dx, const int n, const int np);
-/* ctsub.c */
-OBJECT *alloc_obj(int n);
-void dminmax(const double array[], const int pts, double *xmin, double *xmax);
void rotate2d(double x[], double y[], int pts, double angle);
void xlat2d(double x[], double y[], int pts, double xoffset, double yoffset);
void scale2d(double x[], double y[], int pts, double xfact, double yfact);
int circle_pts(double theta);
-/* filt.c */
-const char *interp_name_of(int interp_type);
-const char *filter_name_of(int filt_type);
-int interp_select(void);
-int filter_select(double *filt_param);
-double d_filtfunc(int filt_type, double x, double bw, double param, int n);
-double filter_freq(int filt_type, double u, double bw, double param);
-double a_filtfunc(int filt_type, double x, double bw, double param);
+/* dialogs.c */
+int add_objs_kb(PHANTOM *phm);
+PHANTOM *phm_select(void);
+int interpolation_select(void);
+int filter_select(double *filter_param);
+/* filter.c */
+double *filter_generate(int filt_type, double bw, double xmin, double xmax, int n, double param, int domain, int numint);
+double filter_spatial_response_calc(int filt_type, double x, double bw, double param, int n);
+double filter_spatial_response_analytic(int filt_type, double x, double bw, double param);
+double filter_frequency_response(int filt_type, double u, double bw, double param);
double sinc(double x, double mult);
double abscos_int(double u, double w);
-double *filter_generate(int filt_type, double bw, double xmin, double xmax, int n, double param, int domain, int numint);
-void image_filter_init(IMAGE *im, int domain, double bw, int filt_type, double filt_param, int opt_trace);
-/* im_draw.c */
-void image_show(IMAGE *im, int nxcell, int nycell, double densmin, double densmax, bool disp_scale);
-int image_paint(int dev, IMAGE *im, int xmin, int ymin, int nxcell, int nycell, double densmin, double densmax, bool disp_scale);
-int gs_image(GREYSCALE *gs, IMAGE *im, double densmin, double densmax, bool disp_scale);
-void paint_cscale(GREYSCALE *gs, int nx, int ny);
-GREYSCALE *gs_init(int dev, int xmin, int ymin, int nxcell, int nycell);
-void gs_pixel(GREYSCALE *gs, int x, int y, int gs_level);
-void gs_set_pos(GREYSCALE *gs, int x, int y);
-void gs_set_at_addr(GREYSCALE *gs, int gs_level);
-void gs_set_color_scale(void);
/* image.c */
IMAGE *image_create(const char *fname, const int nx, const int ny);
int image_clear(IMAGE *im);
int image_save(IMAGE *im);
IMAGE *image_load(const char *fname);
-/* ir_vars.c */
+void image_filter_response(IMAGE *im, int domain, double bw, int filt_type, double filt_param, int opt_trace);
/* options.c */
int opt_set_trace(const char *optarg, const char *program);
-const char *name_of_picture(const int picnum);
-int opt_set_picture(const char *optarg, const char *program);
+const char *name_of_phantom(const int phmid);
+int opt_set_phantom(const char *optarg, const char *program);
int opt_set_interpolation(const char *optarg, const char *program);
+const char *name_of_interpolation(int interp_type);
int opt_set_filter(const char *optarg, const char *program);
const char *name_of_filter(const int filter);
int opt_set_filter_domain(const char *optarg, const char *program);
const char *name_of_filter_domain(const int domain);
int opt_set_backproj(const char *optarg, const char *program);
const char *name_of_backproj(const int backproj);
-/* pic.c */
-PICTURE *select_pic(void);
-PICTURE *create_pic_from_file(const char *fname);
-PICTURE *create_pic(const int picnum);
-PICTURE *init_pic(void);
-int add_objs_kb(PICTURE *pic);
-int add_objs_file(PICTURE *pic, const char *fname);
-void addobject(PICTURE *pic, const int type, const double cx, const double cy,
+/* phm.c */
+PHANTOM *phm_create(const int phmid);
+PHANTOM *phm_create_from_file(const char *fname);
+PHANTOM *phm_init(void);
+int add_objs_kb(PHANTOM *phm);
+int add_objs_file(PHANTOM *phm, const char *fname);
+void addobject(PHANTOM *phm, const int type, const double cx, const double cy,
const double u, const double v, const double rot, const double atten);
int makeobjpts(OBJECT *obj);
void makeobjxform(OBJECT *obj);
void calc_arc(double x[], double y[], const int pts, const double xcent, const double ycent,
const double r, const double start, const double stop);
void calc_ellipse(double x[], double y[], const int pts, const double u, const double v);
-void prt_pic(PICTURE *pic);
-void show_pic(const PICTURE *pic);
-void draw_pic(const PICTURE *pic);
-/* pic2image.c */
-void pic_to_image(const PICTURE *pic, IMAGE *im, const int col_start, const int col_count,
+OBJECT *alloc_obj(void);
+void phm_print(PHANTOM *phm);
+#if HAVE_INTERACTIVE_GRAPHICS
+void phm_show(const PHANTOM *phm);
+void phm_draw(const PHANTOM *phm);
+#endif
+/* phm2image.c */
+void phm_to_image(const PHANTOM *phm, IMAGE *im, const int col_start, const int col_count,
const int nsample, const int trace);
+int inside_obj(const OBJECT *obj, double x, double y, const int coord_type);
+/* phmstd.c */
+void herm_head(PHANTOM *phm);
+void row_head(PHANTOM *phm);
+void row_bord_head(PHANTOM *phm);
/* ray.c */
-void rs_trace_showprm (const char *label, const char *fmt, int row, int color, ...);
-DETECTOR *detect_create(const PICTURE *pic, int ndet, int nview, int nsample, const double rot_anglen);
+DETECTOR *detect_create(const PHANTOM *phm, int ndet, int nview, int nsample, const double rot_anglen);
void detect_free(DETECTOR *det);
-int raysum_collect(RAYSUM *rs, const DETECTOR *det, const PICTURE *pic, const int start_view,
+double calc_rsum(const PHANTOM *phm, const double x1, const double y1, const double x2, const double y2);
+double calc_objsum(const OBJECT *obj, const double x1, const double y1, const double x2, const double y2);
+int clipobj(const OBJECT *obj, double *x1, double *y1, double *x2, double *y2);
+/* raycollect.c */
+int raysum_collect(RAYSUM *rs, const DETECTOR *det, const PHANTOM *phm, const int start_view,
const int trace, const int unit_pulse);
-void rayview(const PICTURE *pic, DETARRAY *darray, const DETECTOR *det,
+void rayview(const PHANTOM *phm, DETARRAY *darray, const DETECTOR *det,
const double xd1, const double yd1, const double xd2, const double yd2,
const double xs1, const double ys1, const double xs2, const double ys2, const int unit_pulse);
-double calc_rsum(const PICTURE *pic, const double x1, const double y1, const double x2, const double y2);
-double calc_objsum(const OBJECT *obj, const double x1, const double y1, const double x2, const double y2);
-int clipobj(const OBJECT *obj, double *x1, double *y1, double *x2, double *y2);
+void rs_trace_showprm (const char *label, const char *fmt, int row, int color, ...);
/* rayio.c */
-RAYSUM *raysum_create(const char *fname, const int nview, const int ndet, const int in_memory);
-RAYSUM *raysum_create_from_det(const char *fname, const DETECTOR *det, const int in_memory);
+RAYSUM *raysum_create(const char *fname, const int nview, const int ndet);
+RAYSUM *raysum_create_from_det(const char *fname, const DETECTOR *det);
RAYSUM *raysum_open(const char *filename);
void raysum_alloc_views(RAYSUM *rs);
void raysum_free(RAYSUM *rs);
int detarray_read(RAYSUM *rs, DETARRAY *darray, const int view_num);
int detarray_write(RAYSUM *rs, const DETARRAY *darray, const int view_num);
int raysum_print(const RAYSUM *rs);
-/* phantom.c */
-void herm_head(PICTURE *pic);
-void row_head(PICTURE *pic);
-void row_bord_head(PICTURE *pic);
-/* xform.c */
-void indent_mtx2(GRFMTX_2D m);
-void xlat_mtx2(GRFMTX_2D m, const double x, const double y);
-void scale_mtx2(GRFMTX_2D m, const double sx, const double sy);
-void rot_mtx2(GRFMTX_2D m, const double theta);
-void mult_mtx2(GRFMTX_2D m1, GRFMTX_2D m2, GRFMTX_2D result);
-void xform_mtx2(GRFMTX_2D m, double *x, double *y);
+
#endif