POSSUM Output

POSSUM creates the directory you have specified as your output directory. If you have not specified the name, POSSUM will create a directory called "simdir" in your current directory. If the directory with the name you have specified already exists , a "-" is added after the name of the old directory. Of course, all the above gets ignored if you explicitly set the output directory name.

There are two main outputs of POSSUM in the POSSUM directory:

  • image_abs.nii.gz: Output image (magnitude). The image can be seen in the fslview. It is obtained from the signal (see below) after reordering it into the k-space and then reconstructing using the Discrete Fourier Transform (which can be done using a command-line program signal2image). This is already done for you within the GUI so there is no need to do it again. However, you can use signal2image yourself if you would like to get your image in a complex form, or would like to get the k-space.

  • signal: Binary 2-row matrix. The most important output of POSSUM. It takes the longest to generate. It represents a raw signal (k-space data) in a similar form as the MRI scanner ouput. The first row is the data from the real channel and the second row is the data from the imaginary channel. This matrix can be seen using a MATLAB command read_pulse.m.
    signal2image
    
    signal2image [options] -i signal -p pulse -o image 
    signal2image -p pulse -c kcoord
    
    Compulsory arguments (You MUST set one or more of):
            -p,--pulse      pulse_sequence matrix (generated with the GUI)
    
    Optional arguments (You may optionally specify one or more of):
            -i,--in         input signal (default name= signal)
            -o,--out        outputs image (default name = image)
            -c, --kcoord    kspace coordinates (default name = kcoord)
            -k,--kout       outputs k-space (default name = kspace)
            -a,--abs        save absolute magnitude and phase
            -v,--verbose    switch on diagnostic messages
            -h,--help       display this message
    
    

    The other outputs saved in the POSSUM directory are:

  • signal_nonoise the same as signal just without any white (thermal) noise.

  • image_phase.nii.gz output image (phase).

  • image_real.nii.gz output image (real part). Can be obtained with signal2image.

  • image_imag.nii.gz output image (imaginary part). Can be obtained with signal2image.

  • kspace_abs.nii.gz output kspace (magnitude). Can be obtained with signal2image.

  • kspace_phase.nii.gz output kspace (phase). Can be obtained with signal2image.

  • kspace_real.nii.gz output kspace (real part). Can be obtained with signal2image.

  • kspace_imag.nii.gz output kspace (imaginary part). Can be obtained with signal2image.

  • brain.nii.gz input object.

  • T2.nii.gz input 3D activation image.

  • T2timecourse input activation modulation file (in time).

  • b0A_dA.nii.gz input 3D B0 inhomogeneity basis set (A=x,y,z).

  • pulse pulse sequence matrix (binary).

  • pulse.info file with parameters of the pulse sequence (used by POSSUM programs).

  • pulse.readme file with parameters of the pulse sequence (user friendly).

  • pulse.posx coordinate system of the input object (x-coordinate).

  • pulse.posy coordinate system of the input object (y-coordinate).

  • pulse.posz coordinate system of the input object (z-coordinate).

  • pulse.com command used to generate the pulse sequence.

  • noise file describing the white (thermal) noise parameters with values of SNR and sigma used in the simulation (madde by the POSSUM GUI).

  • motion input motion file.

  • slcprof input slice profile.

  • MRpar input MR parameters.

  • possum.com commands used when running POSSUM (to generate signal).

  • possum.fsf POSSUM setup file, describing everything about the POSSUM setup. This can be loaded into the POSSUM GUI using the command "Load".

  • possum.log log file for everything that happened when you ran POSSUM GUI (except the generation of the signal which is in the logs directory).

  • logs log directory which contains log files from each of the processors that generates the signal. The commands used for this are in possum.com. Files with the extension ".o" are the log files showing the process, and the files with the extension ".e" are the log files showing if there are any errors. Note that this directory is empty when there is no SGE enviroment.
    Copyright © 2007, University of Oxford. Ivana Drobnjak and Mark Jenkinson.