ecat63p.c File Reference

Procedures for printing ECAT 6.3 header contents. More...

#include "libtpcimgio.h"

Go to the source code of this file.

Functions
void	ecat63PrintMainheader (ECAT63_mainheader *h, FILE *fp)
void	ecat63PrintImageheader (ECAT63_imageheader *h, FILE *fp)
void	ecat63PrintScanheader (ECAT63_scanheader *h, FILE *fp)
void	ecat63PrintAttnheader (ECAT63_attnheader *h, FILE *fp)
void	ecat63PrintNormheader (ECAT63_normheader *h, FILE *fp)
char *	ecat63Datatype (short int dtype)
char *	ecat63Unit (short int dunit)
void	float2parts (float *buf)
int	ecat6PrintSubheader (ECAT63_mainheader mh, FILE *fp, int plane, int frame, FILE *ofp)
char *	ecat63ScanstarttimeInt (const ECAT63_mainheader *h, char *buf)
	Convert scan_start_time in ECAT 6.3 main header into a null-terminated string of the form YYYY-MM-DD hh:mm:ss, with length of 19 characters and the null.

Detailed Description

Procedures for printing ECAT 6.3 header contents.

Author

Vesa Oikonen

Definition in file ecat63p.c.

Function Documentation

ecat63Datatype()

char * ecat63Datatype

(

short int

dtype

)

Return pointer to string describing the ECAT 6.3 data_type

Parameters

dtype

data type code

Returns

pointer to static string

Definition at line 218 of file ecat63p.c.

  {
  static char *ecat63_datatype[]={
  /*  0 */  "Unknown",
  /*  1 */  "BYTE_TYPE",
  /*  2 */  "VAX_I2",
  /*  3 */  "VAX_I4",
  /*  4 */  "VAX_R4",
  /*  5 */  "IEEE_R4",
  /*  6 */  "SUN_I2",
  /*  7 */  "SUN_I4",
  /*  8 */  "Unknown",
  /*  9 */  "Unknown"
  };
  if(dtype>=0 && dtype<10) return(ecat63_datatype[dtype]);
  else return(ecat63_datatype[0]);
}

Referenced by ecat63PrintAttnheader(), ecat63PrintImageheader(), ecat63PrintMainheader(), ecat63PrintNormheader(), ecat63PrintScanheader(), and ecat63ReadMainheader().

ecat63PrintAttnheader()

void ecat63PrintAttnheader	(	ECAT63_attnheader *	h,
		FILE *	fp )

Print ECAT 6.3 attnheader contents to specified file pointer

Parameters

h	Ecat 6.3 attenuation header
fp	target file pointer

Definition at line 173 of file ecat63p.c.

  {
  if(ECAT63_TEST) printf("ecat63PrintAttnheader()\n");
  fprintf(fp, "data_type := %d (%s)\n", h->data_type, ecat63Datatype(h->data_type));
  fprintf(fp, "dimension_1 := %d\n", h->dimension_1);
  fprintf(fp, "dimension_2 := %d\n", h->dimension_2);
  fprintf(fp, "sample_distance := %g cm\n", h->sample_distance);
  fprintf(fp, "attenuation_type := %d\n", h->attenuation_type);
  fprintf(fp, "scale_factor := %g\n", h->scale_factor);
  fprintf(fp, "x_origin := %g\ny_origin := %g\nx_radius := %g\ny_radius := %g\n",
    h->x_origin, h->y_origin, h->x_radius, h->y_radius);
  fprintf(fp, "tilt_angle := %g\nattenuation_coeff := %g\n",
    h->tilt_angle, h->attenuation_coeff);
}

Referenced by ecat63ReadAttnMatrix(), and ecat6PrintSubheader().

ecat63PrintImageheader()

void ecat63PrintImageheader	(	ECAT63_imageheader *	h,
		FILE *	fp )

Print ECAT 6.3 imageheader contents to specified file pointer

Parameters

h	Ecat 6.3 image header
fp	target file pointer

Definition at line 94 of file ecat63p.c.

  {
  if(ECAT63_TEST) printf("ecat63PrintImageheader()\n");
  fprintf(fp, "data_type := %d (%s)\n", h->data_type, ecat63Datatype(h->data_type));
  fprintf(fp, "dimension_1 := %d\n", h->dimension_1);
  fprintf(fp, "dimension_2 := %d\n", h->dimension_2);
  fprintf(fp, "x_origin := %g\ny_origin := %g\nrecon_scale := %g\n",
    h->x_origin, h->y_origin, h->recon_scale);
  fprintf(fp, "quant_scale := %g\nimage_min := %d\nimage_max := %d\n",
    h->quant_scale, h->image_min, h->image_max);
  fprintf(fp, "slice_width := %g\npixel_size := %g\n", h->slice_width, h->pixel_size);
  fprintf(fp, "frame_start_time := %d\nframe_duration := %d\n",
    h->frame_start_time, h->frame_duration );
/*
  fprintf(fp, "reconstruction_start := %02d.%02d.%04d %02d:%02d:%02d\n",
    h->recon_start_day, h->recon_start_month, h->recon_start_year,
    h->recon_start_hour, h->recon_start_min, h->recon_start_sec);
*/
  fprintf(fp, "reconstruction_start := %04d-%02d-%02d %02d:%02d:%02d\n",
    h->recon_start_year, h->recon_start_month, h->recon_start_day,
    h->recon_start_hour, h->recon_start_min, h->recon_start_sec);
  fprintf(fp, "filter_code := %d\nimage_rotation := %g\nintrinsic_tilt := %g\n",
    h->filter_code, h->image_rotation, h->intrinsic_tilt);
  fprintf(fp, "filter_params :=");
  for(int i=0; i<6; i++) fprintf(fp, " %g", h->filter_params[i]);
  fprintf(fp, "\n");
  fprintf(fp, "plane_eff_corr_fctr := %g\ndecay_corr_fctr := %g\nloss_corr_fctr := %g\n",
    h->plane_eff_corr_fctr, h->decay_corr_fctr, h->loss_corr_fctr);
  fprintf(fp, "quant_units := %d (%s)\n", h->quant_units, ecat63Unit(h->quant_units));
  fprintf(fp, "ecat_calibration_fctr := %g\nwell_counter_cal_fctr := %g\n",
    h->ecat_calibration_fctr, h->well_counter_cal_fctr);
  fprintf(fp, "annotation := %.40s\n", h->annotation);
}

Referenced by ecat63ReadImageMatrix(), ecat63WriteAllImg(), and ecat6PrintSubheader().

ecat63PrintMainheader()

void ecat63PrintMainheader	(	ECAT63_mainheader *	h,
		FILE *	fp )

Print ECAT 6.3 mainheader contents to specified file pointer.

Parameters

h	Ecat 6.3 main header
fp	file pointer

Definition at line 16 of file ecat63p.c.

  {
  char tmp[32];
 
  if(ECAT63_TEST) fprintf(stdout, "ecat63PrintMainheader()\n");
 
  fprintf(fp, "original_file_name := %.20s\n", h->original_file_name);
  fprintf(fp, "sw_version := %d\n", h->sw_version);
  fprintf(fp, "data_type := %d (%s)\n", 
          h->data_type, ecat63Datatype(h->data_type));
  fprintf(fp, "system_type := %d\n", h->system_type);
  if(h->file_type==1) strcpy(tmp, "sinogram");
  else if(h->file_type==2) strcpy(tmp, "image");
  else if(h->file_type==3) strcpy(tmp, "attenuation");
  else if(h->file_type==4) strcpy(tmp, "normalization");
  else strcpy(tmp, "unknown");
  fprintf(fp, "file_type := %d (%s)\n", h->file_type, tmp);
  fprintf(fp, "scan_start_time := %04d-%02d-%02d %02d:%02d:%02d\n",
          h->scan_start_year, h->scan_start_month, h->scan_start_day, 
          h->scan_start_hour, h->scan_start_minute, h->scan_start_second);
/*
  fprintf(fp, "scan start := %02d.%02d.%04d %02d:%02d:%02d\n",
    h->scan_start_day, h->scan_start_month, h->scan_start_year,
    h->scan_start_hour, h->scan_start_minute, h->scan_start_second);
*/
  fprintf(fp, "isotope_code := %.8s\n", h->isotope_code);
  fprintf(fp, "isotope_halflife := %E sec\n", h->isotope_halflife);
  fprintf(fp, "radiopharmaceutical := %.32s\n", h->radiopharmaceutical);
  fprintf(fp, "gantry_tilt := %g\n", h->gantry_tilt);
  fprintf(fp, "gantry_rotation := %g\n", h->gantry_rotation);
  fprintf(fp, "bed_elevation := %g\n", h->bed_elevation);
  fprintf(fp, "axial_fov := %g\n", h->axial_fov);
  fprintf(fp, "transaxial_fov := %g\n", h->transaxial_fov);
  fprintf(fp, "calibration_factor := %g\n", h->calibration_factor);
  fprintf(fp, "calibration_units := %d (%s)\n", 
               h->calibration_units, ecat63Unit(h->calibration_units));
  fprintf(fp, "study_name := %.12s\n", h->study_name);
  fprintf(fp, "patient_id := %.32s\n", h->patient_id);
  fprintf(fp, "patient_name := %.32s\n", h->patient_name);
 
  if(isalnum(h->patient_sex))
    fprintf(fp, "patient_sex := %c\n", h->patient_sex);
  else fprintf(fp, "patient_sex := \n");
 
  fprintf(fp, "patient_age := %.10s\n", h->patient_age);
  fprintf(fp, "patient_height := %.10s\n", h->patient_height);
  fprintf(fp, "patient_weigth := %.10s\n", h->patient_weight);
 
  if(isalnum(h->patient_dexterity))
    fprintf(fp, "patient_dexterity := %c\n", h->patient_dexterity);
  else fprintf(fp, "patient_dexterity := \n");
 
  fprintf(fp, "physician_name := %.32s\n", h->physician_name);
  fprintf(fp, "operator_name := %.32s\n", h->operator_name);
  fprintf(fp, "study_description := %.32s\n", h->study_description);
  fprintf(fp, "acquisition_type := %d\n", h->acquisition_type);
  fprintf(fp, "bed_type := %d\n", h->bed_type);
  fprintf(fp, "septa_type := %d\n", h->septa_type);
  fprintf(fp, "facility_name := %.20s\n", h->facility_name);
 
  fprintf(fp, "num_planes := %d\n", h->num_planes);
  fprintf(fp, "num_frames := %d\n", h->num_frames);
  fprintf(fp, "num_gates := %d\n", h->num_gates);
  fprintf(fp, "num_bed_pos := %d\n", h->num_bed_pos);
  fprintf(fp, "init_bed_position := %g\n", h->init_bed_position);
  fprintf(fp, "plane_separation := %g cm\n", h->plane_separation);
  fprintf(fp, "user_process_code := %.10s\n", h->user_process_code);
}

Referenced by atnMake(), ecat63AddImg(), ecat63ReadAllToImg(), ecat63ReadPlaneToImg(), ecat63WriteAllImg(), and imgWriteEcat63Frame().

ecat63PrintNormheader()

void ecat63PrintNormheader	(	ECAT63_normheader *	h,
		FILE *	fp )

Print ECAT 6.3 normheader contents to specified file pointer.

Parameters

h	Ecat 6.3 normalization header
fp	target file pointer

Definition at line 197 of file ecat63p.c.

  {
  if(ECAT63_TEST) printf("ecat63PrintNormheader()\n");
  fprintf(fp, "data_type := %d (%s)\n", h->data_type, ecat63Datatype(h->data_type));
  fprintf(fp, "dimension_1 := %d\n", h->dimension_1);
  fprintf(fp, "dimension_2 := %d\n", h->dimension_2);
  fprintf(fp, "scale_factor := %g\n", h->scale_factor);
  fprintf(fp, "norm_time := %04d-%02d-%02d %02d:%02d:%02d\n",
    h->norm_year, h->norm_month, h->norm_day,
    h->norm_hour, h->norm_minute, h->norm_second);
}

Referenced by ecat6PrintSubheader().

ecat63PrintScanheader()

void ecat63PrintScanheader	(	ECAT63_scanheader *	h,
		FILE *	fp )

Print ECAT 6.3 scanheader contents to specified file pointer

Parameters

h	Ecat 6.3 scan header
fp	target file pointer

Definition at line 137 of file ecat63p.c.

  {
  if(ECAT63_TEST) printf("ecat63PrintScanheader()\n");
  fprintf(fp, "data_type := %d (%s)\n", h->data_type, ecat63Datatype(h->data_type));
  fprintf(fp, "dimension_1 := %d\n", h->dimension_1);
  fprintf(fp, "dimension_2 := %d\n", h->dimension_2);
  fprintf(fp, "sample_distance := %g cm\n", h->sample_distance);
  fprintf(fp, "isotope_halflife := %g sec\n", h->isotope_halflife);
  fprintf(fp, "gate_duration := %d\nr_wave_offset := %d\n",
    h->gate_duration, h->r_wave_offset);
  fprintf(fp, "scale_factor := %g\n", h->scale_factor);
  fprintf(fp, "scan_min := %d\nscan_max := %d\n", h->scan_min, h->scan_max);
  fprintf(fp, "prompts := %d\ndelayed := %d\nmultiples := %d\nnet_trues := %d\n",
    h->prompts, h->delayed, h->multiples, h->net_trues);
  fprintf(fp, "cor_singles :=");
  for(int i=0; i<16; i++) fprintf(fp, " %8.0f", h->cor_singles[i]);
  printf("\n");
  fprintf(fp, "uncor_singles :=");
  for(int i=0; i<16; i++) fprintf(fp, " %8.0f", h->uncor_singles[i]);
  printf("\n");
  fprintf(fp, "tot_avg_cor := %g\ntot_avg_uncor := %g\n", h->tot_avg_cor, h->tot_avg_uncor);
  fprintf(fp, "total_coin_rate := %d\n", h->total_coin_rate);
  fprintf(fp, "frame_start_time := %d\nframe_duration := %d\n",
    h->frame_start_time, h->frame_duration);
  fprintf(fp, "loss_correction_fctr := %g\n", h->loss_correction_fctr);
}

Referenced by atnMake(), ecat63ReadScanMatrix(), ecat63WriteAllImg(), and ecat6PrintSubheader().

ecat63ScanstarttimeInt()

char * ecat63ScanstarttimeInt	(	const ECAT63_mainheader *	h,
		char *	buf )

Convert scan_start_time in ECAT 6.3 main header into a null-terminated string of the form YYYY-MM-DD hh:mm:ss, with length of 19 characters and the null.

Author

Vesa Oikonen

Returns

Returns pointer to the string, or null in case of an error.

Parameters

h	Pointer to ECAT 6.3 main header.
buf	Pointer to string where the date and time will be written. It must be pre-allocated for at least 20 characters.

Definition at line 391 of file ecat63p.c.

  {
  //printf("ecat63ScanstarttimeInt()\n");
  if(buf==NULL) return(NULL);
  buf[0]=(char)0;
  if(h==NULL) return(NULL);
  if(h->scan_start_year<0 || h->scan_start_year>9999) return(NULL);
  if(h->scan_start_month<0 || h->scan_start_month>12) return(NULL);
  if(h->scan_start_day<0 || h->scan_start_day>31) return(NULL);
  if(h->scan_start_hour<0 || h->scan_start_hour>24) return(NULL);
  if(h->scan_start_minute<0 || h->scan_start_minute>59) return(NULL);
  if(h->scan_start_second<0 || h->scan_start_second>59) return(NULL);
  sprintf(buf, "%04d-%02d-%02d %02d:%02d:%02d", 
          h->scan_start_year, h->scan_start_month, h->scan_start_day, 
          h->scan_start_hour, h->scan_start_minute, h->scan_start_second);
  return(buf);
}

Referenced by imgGetEcat63MHeader(), and imgWriteEcat63Frame().

ecat63Unit()

char * ecat63Unit

(

short int

dunit

)

Returns pointer to string describing the calibrated data unit (ECAT 6.3).

Parameters

dunit

data unit code

Returns

pointer to static string

Definition at line 243 of file ecat63p.c.

  {
  static char *ecat63_unit[]={
  /*  0 */  "Unknown",
  /*  1 */  "Unknown",
  /*  2 */  "ECAT counts",
  /*  3 */  "uCi/ml",
  /*  4 */  "LMRGlu",
  /*  5 */  "LMRUGlu umol/min/100g",
  /*  6 */  "LMRUGlu mg/min/100g",
  /*  7 */  "nCi/mL",
  /*  8 */  "Well counts",
  /*  9 */  "Becquerels",
  /* 10 */  "kBq/mL",
  /* 11 */  "1/min",
  /* 12 */  "mL/min/100g",
  /* 13 */  "sec*kBq/mL",
  /* 14 */  "sec*nCi/mL",
  /* 15 */  "1/sec",
  /* 16 */  "Unitless",
  /* 17 */  "Unknown"
  };
  if(dunit>=0 && dunit<18) return(ecat63_unit[dunit]);
  else return(ecat63_unit[0]);
}

Referenced by ecat63PrintImageheader(), and ecat63PrintMainheader().

ecat6PrintSubheader()

int ecat6PrintSubheader	(	ECAT63_mainheader	mh,
		FILE *	fp,
		int	plane,
		int	frame,
		FILE *	ofp )

Print ECAT63 subheader contents into specified file pointer.

Returns

Returns 0 when successful.

Parameters

mh	ECAT 6.3 mainheader (not printed but needed here)
fp	File pointer to ECAT 6.3 file.
plane	ECAT 6.3 plane; enter <0 to print all planes.
frame	ECAT 6.3 frame; enter <0 to print all frames.
ofp	Output is written to this file pointer; it can be stdout

Definition at line 293 of file ecat63p.c.

  {
  int                 mi, ret, nr=0;
  static MATRIXLIST   mlist;
  ECAT63_imageheader  image_header;
  ECAT63_scanheader   scan_header;
  ECAT63_attnheader   attn_header;
  ECAT63_normheader   norm_header;
  Matval              matval;
 
 
  /*  Read matrix list and nr */
  ecat63InitMatlist(&mlist);
  ret=ecat63ReadMatlist(fp, &mlist, ECAT63_TEST);
  if(ret) {
    fprintf(stderr, "Error (%d): cannot read matrix list.\n", ret);
    return 2;
  }
  if(mlist.matrixNr<=0) {
    fprintf(stderr, "Error: matrix list is empty.\n");
    return 2;
  }
  if(ECAT63_TEST>1) ecat63PrintMatlist(&mlist);
 
  /*
   *  Read and print subheaders one at a time
   */
  char errmsg[128]; int errCount=0;
  for(mi=nr=0; mi<mlist.matrixNr; mi++) {
    /* Get plane and frame nr */
    mat_numdoc(mlist.matdir[mi].matnum, &matval);
    /* Check if this is supposed to be listed or not */
    if(frame>=0 && frame!=matval.frame) continue;
    if(plane>=0 && plane!=matval.plane) continue;
    fprintf(ofp, "\nMatrix: plane %d frame %d gate %d bed %d\n",
      matval.plane, matval.frame, matval.gate, matval.bed);
    fflush(ofp);
    /* Read subheader */
    if(mh.file_type==IMAGE_DATA)
      ret=ecat63ReadImageheader(fp, mlist.matdir[mi].strtblk, &image_header, ECAT63_TEST-1, errmsg);
    else if(mh.file_type==RAW_DATA)
      ret=ecat63ReadScanheader(fp, mlist.matdir[mi].strtblk, &scan_header, ECAT63_TEST-1, errmsg);
    else if(mh.file_type==ATTN_DATA)
      ret=ecat63ReadAttnheader(fp, mlist.matdir[mi].strtblk, &attn_header, ECAT63_TEST-1, errmsg);
    else if(mh.file_type==NORM_DATA)
      ret=ecat63ReadNormheader(fp, mlist.matdir[mi].strtblk, &norm_header, ECAT63_TEST-1, errmsg);
    if(ret) {
      fprintf(stderr, "Error: %s.\n", errmsg);
      //fprintf(stderr, "Error: cannot read matrix %u subheader.\n", mlist.matdir[mi].matnum);
      //if(ECAT63_TEST>0) printf(" ret=%d\n", ret);
      /*ecat63EmptyMatlist(&mlist); return 4;*/
      errCount++;
      continue;
    }
    /* Print subheader */
    if(mh.file_type==IMAGE_DATA)
      ecat63PrintImageheader(&image_header, ofp);
    else if(mh.file_type==RAW_DATA)
      ecat63PrintScanheader(&scan_header, ofp);
    else if(mh.file_type==ATTN_DATA)
      ecat63PrintAttnheader(&attn_header, ofp);
    else if(mh.file_type==NORM_DATA)
      ecat63PrintNormheader(&norm_header, ofp);
    nr++; // counter
  } /* next matrix */
  ecat63EmptyMatlist(&mlist);
 
  if(errCount>0 && nr>0 && (plane<0 || frame<0)) {
    if(errCount==1) fprintf(stderr, "\nWarning: one matrix could not be read.\n");
    else fprintf(stderr, "\nWarning: %d matrices could not be read.\n", errCount);
  }
 
  if(nr==0 && (plane>=0 || frame>=0)) {
    fprintf(stderr, "Error: specified matrices not found.\n");
    return(11);
  }
 
  return(0);
}

float2parts()

void float2parts

(

float *

buf

)

Printfs separately the sign, mantissa, and exp part of a 32-bit float, which is pointed to by the argument. Code is not optimized; do not use this in routine operations!

Parameters

buf	printed float

Definition at line 277 of file ecat63p.c.

  {
  unsigned int u, exp, mantissa;
  char sign;
 
  memcpy(&u, buf, 4); if(u & 1L<<31) sign='-'; else sign='+';
  exp=u<<1; exp=exp>>24; mantissa=u<<9; mantissa=mantissa>>9;
  printf("%e = %c (%u/8388608 + 1)*2^(%u-127)\n", *buf, sign, mantissa, exp);
}