Main Page | Modules | Alphabetical List | Data Structures | File List | Data Fields | Globals

Experience creation and manipulation


Functions

EXPERIENCE3DAllocExperience ()
 Allocate a pointer on an EXPERIENCE3D structure.

void FreeExperience (EXPERIENCE3D *expr)
 Free the EXPERIENCE3D structure pointer.

void FreeExperienceSgn (EXPERIENCE3D *expr)
 Free the RF signal table of the EXPERIENCE3D structure.

void ResetToExperience (EXPERIENCE3D *expr)
 Zero setting of the 'To' value for the T2* effect.

void InitToExperience (EXPERIENCE3D *expr)
 'To' table creation for the T2* management

void SetResonanceExperience (EXPERIENCE3D *expr, int flag)
 Setting of the RESONANCE FLAG that affects the taking into account of the frequency shift during pulse application.

void SetFlagdechExperience (EXPERIENCE3D *expr, int flag)
 Setting of the FLAG DECH that affects the taking into account of the field inhomogeneity.

void SetT1Experience (EXPERIENCE3D *expr, OBJECT3D *object, int component)
 T1 table creation.

void SetT2Experience (EXPERIENCE3D *expr, OBJECT3D *object, int component)
 T2 table creation.

void SetRoExperience (EXPERIENCE3D *expr, OBJECT3D *object, int component)
 Ro table creation.

void InitMagstateExperience (EXPERIENCE3D *expr)
 Magnetization state table initialization.

void SetB0Experience (EXPERIENCE3D *expr, double B0)
 Static field definition.

void SetB0DefExperience (EXPERIENCE3D *expr, double valmax)
 Static field default definition.

void SetGdechExperience (EXPERIENCE3D *expr, OBJECT3D *object)
 Creation of the field inhomogeneity table It is scaled by B0 and will localy modify the resonance frequency of the spin.

void SetDeltaB0Experience (EXPERIENCE3D *expr, OBJECT3D *object)
 Creation of the DeltaB0 table that allows T2* weigthing DeltaB0 is given in Tesla and weigthed by B0.

void SetObjectExperienceComponent (EXPERIENCE3D *expr, OBJECT3D *object, int component, int FLAG_DECH)
 Copy the (Ro,T1,T2) values of one object componentinto the EXPERIENCE3D structure.

void SetNameExperience (EXPERIENCE3D *expr, char *name)
 Give a name to a given EXPERIENCE3D structure.

void InitRFSigExperience (EXPERIENCE3D *expr)
 Creation of the RF signal table.

void SetAcqExperience (EXPERIENCE3D *expr, int ntx, int nty, int ntz, double tacq)
 Define the acquisition parameter of an experience.

EXPERIENCE3DAllocExperienceSgn (int ntx, int nty, int ntz)
 RF signal part allocation.

void SetFovExperience (EXPERIENCE3D *expr, double fovx, double fovy, double fovz, double obx, double oby, double obz)
 Definition of the EXPERIENCE3D FOV.

PPPVOLUME_COMPLEX_DOUBLE GetSignalRFComplexFromExperience (EXPERIENCE3D *expr)
 Get the RF volume from the EXPERIENCE3D structure.

void NormalizeRFSignal (EXPERIENCE3D *expr)
 RF Signal normalisation taking into account the object discretisation (number of voxels and size).

PPPVOLUME_FLOAT GetSignalRFComponentFromExperience (EXPERIENCE3D *expr, int comp)
 Get one one of the RF component obtained after an experience.

PPIMAGE_UCHAR GetkSpaceImage2DFromExperience (EXPERIENCE3D *expr, int haut, int dir)
 Get an image (in unsigned char) of the RF signals (X or Y) stored in the k space. Useful for a quick visualization.

PPPVOLUME_FLOAT GetSignalRFModuleFromExperience (EXPERIENCE3D *expr)
 Get the module of the RF signal.

PPPVOLUME_FLOAT GetSignalRFPhaseFromExperience (EXPERIENCE3D *expr)
 Get the phase of the RF signal.


Function Documentation

EXPERIENCE3D* AllocExperience  ) 
 

Allocate a pointer on an EXPERIENCE3D structure.

Returns:
Pointer on the EXPERIENCE3D structure

Definition at line 47 of file experience.c.

References _Experience3D::B0, _Experience3D::b0def, _Experience3D::deltaB0, _Experience3D::FLAG_DECH, _Experience3D::FLAG_RESONANCE, _Experience3D::fovx, _Experience3D::fovy, _Experience3D::fovz, _Experience3D::G_deche, _Experience3D::G_edw, _Experience3D::magstate, _Experience3D::name, _Experience3D::nfovx, _Experience3D::nfovy, _Experience3D::nfovz, _Experience3D::obx, _Experience3D::oby, _Experience3D::obz, ON, _Experience3D::pt, _Experience3D::px, _Experience3D::py, _Experience3D::pz, _Experience3D::ro, _Experience3D::sgn, _Experience3D::t1, _Experience3D::t2, _Experience3D::to, _Experience3D::xf, _Experience3D::yf, and _Experience3D::zf.

Referenced by AllocExperienceSgn(), TestEchoGradient1D(), TestEchoSpin1D(), TestFID1D(), TestSequence2D(), TestSequence3D(), TestSimulatedEcho(), TestTrainEchoGradient1D(), and TestTrainEchoSpin1D().

EXPERIENCE3D* AllocExperienceSgn int  ntx,
int  nty,
int  ntz
 

RF signal part allocation.

Parameters:
ntx x dimension of the k space
nty y dimension of the k space
ntz z dimension of the k space
Returns:
Pointer on the EXPERIENCE3D structure

Definition at line 746 of file experience.c.

References AllocExperience(), InitRFSigExperience(), _Experience3D::ntx, _Experience3D::nty, and _Experience3D::ntz.

Referenced by GetDiffSignalRFComplex(), and GetSumSignalRFComplex().

void FreeExperience EXPERIENCE3D expr  ) 
 

Free the EXPERIENCE3D structure pointer.

Parameters:
expr Pointer on the EXPERIENCE3D structure

Definition at line 94 of file experience.c.

References _Experience3D::deltaB0, _Experience3D::G_deche, _Experience3D::magstate, _Experience3D::nfovx, _Experience3D::ntx, _Experience3D::ro, _Experience3D::sgn, _Experience3D::t1, and _Experience3D::t2.

Referenced by TestEchoGradient1D(), TestEchoSpin1D(), and TestFID1D().

void FreeExperienceSgn EXPERIENCE3D expr  ) 
 

Free the RF signal table of the EXPERIENCE3D structure.

Parameters:
expr Pointer on the EXPERIENCE3D structure

Definition at line 143 of file experience.c.

References _Experience3D::sgn.

PPIMAGE_UCHAR GetkSpaceImage2DFromExperience EXPERIENCE3D expr,
int  haut,
int  dir
 

Get an image (in unsigned char) of the RF signals (X or Y) stored in the k space. Useful for a quick visualization.

Parameters:
expr Pointer on the EXPERIENCE3D structure
haut Number of signals considered
dir Direction considered (0 > X, 1 >Y)
Returns:
Pointer on the unsigned char image of the k space part

Definition at line 915 of file experience.c.

References IdImaAlloc(), IdImaFree, IdImaSignalToImage(), IdSigAlloc(), IdSigFree, IMA_FLOAT, IMA_UCHAR, _Experience3D::ntx, _Experience3D::nty, _Experience3D::ntz, PPIMAGE_FLOAT, PPIMAGE_UCHAR, PSIGNAL_FLOAT, _Experience3D::sgn, SIG_FLOAT, and x.

PPPVOLUME_COMPLEX_DOUBLE GetSignalRFComplexFromExperience EXPERIENCE3D expr  ) 
 

Get the RF volume from the EXPERIENCE3D structure.

Parameters:
expr Pointer on the EXPERIENCE3D structure
Returns:
Pointer on the RF volume

Definition at line 791 of file experience.c.

References IdVolAlloc(), COMPLEX_DOUBLE::im, max, min, _Experience3D::ntx, _Experience3D::nty, _Experience3D::ntz, COMPLEX_DOUBLE::re, _Experience3D::sgn, VOL_COMPLEX_DOUBLE, and x.

Referenced by GetSignalRFModuleFromExperience(), GetSignalRFPhaseFromExperience(), RecVolIFFTComplexe(), SeqFreeInduction1D(), SeqGradientEcho1D(), SeqGradientEcho2D(), SeqGradientEcho3D(), SeqInversionRecuperation1D(), SeqInversionRecuperation2D(), SeqInversionRecuperation3D(), SeqSpinEcho1D(), SeqSpinEcho2D(), SeqSpinEcho3D(), SeqTrueFisp1D(), SeqTrueFisp2D(), SeqTrueFisp3D(), SeqTurboSpinEcho2D(), SequenceSE2D_sel(), TestEchoGradient1D(), TestEchoSpin1D(), and TestFID1D().

PPPVOLUME_FLOAT GetSignalRFComponentFromExperience EXPERIENCE3D expr,
int  comp
 

Get one one of the RF component obtained after an experience.

Parameters:
expr Pointer on the EXPERIENCE3D structure
int One RF component (0->X, 1->Y, (2->Z,non available in real world))
Returns:
Pointer on the component required

Definition at line 885 of file experience.c.

References IdVolAlloc(), _Experience3D::ntx, _Experience3D::nty, _Experience3D::ntz, PPPVOLUME_FLOAT, _Experience3D::sgn, VOL_FLOAT, and x.

Referenced by TestEchoGradient1D(), TestEchoSpin1D(), TestFID1D(), TestSimulatedEcho(), TestTrainEchoGradient1D(), and TestTrainEchoSpin1D().

PPPVOLUME_FLOAT GetSignalRFModuleFromExperience EXPERIENCE3D expr  ) 
 

Get the module of the RF signal.

Parameters:
expr Pointer on the EXPERIENCE3D structure
Returns:
Pointer on the volume in float

Definition at line 971 of file experience.c.

References b, GetSignalRFComplexFromExperience(), IdVolAlloc(), IdVolFree, _Experience3D::ntx, _Experience3D::nty, _Experience3D::ntz, PPPVOLUME_FLOAT, COMPLEX_DOUBLE::re, VOL_FLOAT, and x.

Referenced by WriteSignalRFModule().

PPPVOLUME_FLOAT GetSignalRFPhaseFromExperience EXPERIENCE3D expr  ) 
 

Get the phase of the RF signal.

Parameters:
expr Pointer on the EXPERIENCE3D structure
Returns:
Pointer on the volume in float

Definition at line 1004 of file experience.c.

References b, GetSignalRFComplexFromExperience(), IdVolAlloc(), IdVolFree, _Experience3D::ntx, _Experience3D::nty, _Experience3D::ntz, PPPVOLUME_FLOAT, COMPLEX_DOUBLE::re, VOL_FLOAT, and x.

void InitMagstateExperience EXPERIENCE3D expr  ) 
 

Magnetization state table initialization.

Parameters:
expr Pointer on the EXPERIENCE3D structure

Definition at line 355 of file experience.c.

References _Experience3D::magstate, _Experience3D::nfovx, _Experience3D::nfovy, and _Experience3D::nfovz.

Referenced by SetObjectExperienceComponent().

void InitRFSigExperience EXPERIENCE3D expr  ) 
 

Creation of the RF signal table.

Parameters:
expr Pointer on the EXPERIENCE3D structure

Definition at line 656 of file experience.c.

References _Experience3D::ntx, _Experience3D::nty, _Experience3D::ntz, and _Experience3D::sgn.

Referenced by AllocExperienceSgn(), and SetAcqExperience().

void InitToExperience EXPERIENCE3D expr  ) 
 

'To' table creation for the T2* management

Parameters:
expr Pointer on the EXPERIENCE3D structure

Definition at line 169 of file experience.c.

References _Experience3D::to.

Referenced by SetObjectExperienceComponent().

void NormalizeRFSignal EXPERIENCE3D expr  ) 
 

RF Signal normalisation taking into account the object discretisation (number of voxels and size).

Parameters:
expr Pointer on the EXPERIENCE3D structure

Definition at line 863 of file experience.c.

References _Experience3D::ntx, _Experience3D::nty, _Experience3D::ntz, _Experience3D::px, _Experience3D::py, _Experience3D::pz, _Experience3D::sgn, and x.

Referenced by SeqFreeInduction1D(), SeqGradientEcho1D(), SeqGradientEcho2D(), SeqGradientEcho3D(), SeqInversionRecuperation1D(), SeqInversionRecuperation2D(), SeqInversionRecuperation3D(), SeqSpinEcho1D(), SeqSpinEcho2D(), SeqSpinEcho3D(), SeqTrueFisp1D(), SeqTrueFisp2D(), SeqTrueFisp3D(), and SeqTurboSpinEcho2D().

void ResetToExperience EXPERIENCE3D expr  ) 
 

Zero setting of the 'To' value for the T2* effect.

Parameters:
expr Pointer on the EXPERIENCE3D structure

Definition at line 158 of file experience.c.

References _Experience3D::to.

Referenced by DoPulseRect(), SeqGradientEcho1D_0(), SeqGradientEcho2D_0(), SeqGradientEcho3D_0(), SeqInversionRecuperation1D_0(), SeqInversionRecuperation2D_0(), SeqInversionRecuperation3D_0(), SeqSpinEcho1D_0(), SeqSpinEcho2D_0(), SeqSpinEcho3D_0(), SeqTrueFisp1D_0(), SeqTrueFisp2D_0(), and SeqTrueFisp3D_0().

void SetAcqExperience EXPERIENCE3D expr,
int  ntx,
int  nty,
int  ntz,
double  tacq
 

Define the acquisition parameter of an experience.

Warning:
Parameters:
expr Pointer on the EXPERIENCE3D structure
ntx x dimension of the k space
nty y dimension of the k space
ntz z dimension of the k space
duree Acquisition time of one line of the k space given in seconds

Definition at line 718 of file experience.c.

References InitRFSigExperience(), _Experience3D::ntx, _Experience3D::nty, _Experience3D::ntz, _Experience3D::pt, and _Experience3D::readout_time.

Referenced by TestEchoGradient1D(), TestEchoSpin1D(), TestFID1D(), TestSequence2D(), TestSequence3D(), TestSimulatedEcho(), TestTrainEchoGradient1D(), and TestTrainEchoSpin1D().

void SetB0DefExperience EXPERIENCE3D expr,
double  valmax
 

Static field default definition.

Parameters:
expr Pointer on the EXPERIENCE3D structure
valmax Maximum value of the parabolic static field default (centered on the object)

Definition at line 422 of file experience.c.

References _Experience3D::b0def.

Referenced by TestSequence2D(), and TestSequence3D().

void SetB0Experience EXPERIENCE3D expr,
double  B0
 

Static field definition.

Parameters:
expr Pointer on the EXPERIENCE3D structure
B0 Main static field value

Definition at line 410 of file experience.c.

References _Experience3D::B0.

Referenced by TestEchoGradient1D(), TestEchoSpin1D(), TestFID1D(), TestSequence2D(), TestSequence3D(), TestSimulatedEcho(), TestTrainEchoGradient1D(), and TestTrainEchoSpin1D().

void SetDeltaB0Experience EXPERIENCE3D expr,
OBJECT3D object
 

Creation of the DeltaB0 table that allows T2* weigthing DeltaB0 is given in Tesla and weigthed by B0.

Parameters:
expr Pointer on the EXPERIENCE3D structure
object Pointer on the OBJECT3D structure

Definition at line 533 of file experience.c.

References _Experience3D::B0, _Experience3D::deltaB0, _Experience3D::nfovx, _Experience3D::nfovy, _Experience3D::nfovz, object, and x.

Referenced by SetObjectExperienceComponent().

void SetFlagdechExperience EXPERIENCE3D expr,
int  flag
 

Setting of the FLAG DECH that affects the taking into account of the field inhomogeneity.

Parameters:
expr Pointer on the EXPERIENCE3D structure
Flag Flag value (1 > active, 0 > inactive)

Definition at line 195 of file experience.c.

References _Experience3D::FLAG_DECH.

Referenced by TestSequence2D(), and TestSequence3D().

void SetFovExperience EXPERIENCE3D expr,
double  fovx,
double  fovy,
double  fovz,
double  obx,
double  oby,
double  obz
 

Definition of the EXPERIENCE3D FOV.

Parameters:
expr Pointer on the EXPERIENCE3D structure
fovx Fov dimension in meter for x
fovy Fov dimension in meter for y
fovz Fov dimension in meter for z
obx Excentering of the object in meter for x
oby Excentering of the object in meter for y
obz Excentering of the object in meter for z

Definition at line 771 of file experience.c.

References _Experience3D::fovx, _Experience3D::fovy, _Experience3D::fovz, _Experience3D::obx, _Experience3D::oby, and _Experience3D::obz.

Referenced by TestEchoGradient1D(), TestEchoSpin1D(), TestFID1D(), TestSequence2D(), TestSequence3D(), TestSimulatedEcho(), TestTrainEchoGradient1D(), and TestTrainEchoSpin1D().

void SetGdechExperience EXPERIENCE3D expr,
OBJECT3D object
 

Creation of the field inhomogeneity table It is scaled by B0 and will localy modify the resonance frequency of the spin.

Parameters:
expr Pointer on the EXPERIENCE3D structure
object Pointer on the OBJECT3D structure

Definition at line 435 of file experience.c.

References _Experience3D::B0, _Experience3D::b0def, _Experience3D::FLAG_DECH, _Experience3D::G_deche, _Experience3D::nfovx, _Experience3D::nfovy, _Experience3D::nfovz, object, and x.

Referenced by SetObjectExperienceComponent().

void SetNameExperience EXPERIENCE3D expr,
char *  name
 

Give a name to a given EXPERIENCE3D structure.

Parameters:
expr Pointer on the EXPERIENCE3D structure
name EXPERIENCE3D name

Definition at line 645 of file experience.c.

References _Experience3D::name.

void SetObjectExperienceComponent EXPERIENCE3D expr,
OBJECT3D object,
int  component,
int  FLAG_DECH
 

Copy the (Ro,T1,T2) values of one object componentinto the EXPERIENCE3D structure.

Warning:
Parameters:
expr Pointer on the EXPERIENCE3D structure
object Pointer on the OBJECT3D structure
component Component number, for instance (0=WATER 1=FAT)
FLAG_DECH Accounting flag for field default (0=NO 1=YES object 2=YES B0 3=1+2)
B0 Value in Tesla of the main field B0, Impact the field default value

Definition at line 584 of file experience.c.

References FAT, _Experience3D::FLAG_DECH, _Experience3D::fovx, _Experience3D::fovy, _Experience3D::fovz, _Experience3D::G_edw, InitMagstateExperience(), InitToExperience(), _Experience3D::lx, _Experience3D::ly, _Experience3D::lz, _Experience3D::nfovx, _Experience3D::nfovy, _Experience3D::nfovz, object, _Experience3D::px, _Experience3D::py, _Experience3D::pz, SetDeltaB0Experience(), SetGdechExperience(), SetRoExperience(), SetT1Experience(), SetT2Experience(), WATER, _Experience3D::xf, _Experience3D::yf, and _Experience3D::zf.

Referenced by RunSequence(), TestEchoGradient1D(), TestEchoSpin1D(), TestFID1D(), TestSimulatedEcho(), TestTrainEchoGradient1D(), and TestTrainEchoSpin1D().

void SetResonanceExperience EXPERIENCE3D expr,
int  flag
 

Setting of the RESONANCE FLAG that affects the taking into account of the frequency shift during pulse application.

Parameters:
expr Pointer on the EXPERIENCE3D structure
Flag Resonance flag value (1 > ON-RESONANCE, 0 > OFF-RESONANCE)

Definition at line 182 of file experience.c.

References _Experience3D::FLAG_RESONANCE.

Referenced by TestSequence2D(), and TestSequence3D().

void SetRoExperience EXPERIENCE3D expr,
OBJECT3D object,
int  component
 

Ro table creation.

Parameters:
expr Pointer on the EXPERIENCE3D structure
object Pointer on the OBJECT3D structure
component Number of the considered object component

Definition at line 307 of file experience.c.

References _Experience3D::nfovx, _Experience3D::nfovy, _Experience3D::nfovz, object, and _Experience3D::ro.

Referenced by SetObjectExperienceComponent().

void SetT1Experience EXPERIENCE3D expr,
OBJECT3D object,
int  component
 

T1 table creation.

Parameters:
expr Pointer on the EXPERIENCE3D structure
object Pointer on the OBJECT3D structure
component Number of the considered object component

Definition at line 208 of file experience.c.

References _Experience3D::nfovx, _Experience3D::nfovy, _Experience3D::nfovz, object, and _Experience3D::t1.

Referenced by SetObjectExperienceComponent().

void SetT2Experience EXPERIENCE3D expr,
OBJECT3D object,
int  component
 

T2 table creation.

Parameters:
expr Pointer on the EXPERIENCE3D structure
object Pointer on the OBJECT3D structure
component Number of the considered object component

Definition at line 257 of file experience.c.

References _Experience3D::nfovx, _Experience3D::nfovy, _Experience3D::nfovz, object, and _Experience3D::t2.

Referenced by SetObjectExperienceComponent().


Generated on Wed Oct 19 09:28:37 2005 for SIMRI3D by doxygen 1.3.7