Difference between revisions of "Gridfree.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Created page with "Fokker-Planck magic angle spinning and SLE context. Generates a Liouvil- lian superoperator and passes it on to the pulse sequence function, which should be supplied as a hand...")
 
(Update function See also links and function index membership)
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
Fokker-Planck magic angle spinning and SLE context. Generates a Liouvil-
+
{{DISPLAYTITLE:gridfree.m}} __NOTOC__
lian superoperator and passes it on to the pulse sequence function, which
+
Fokker-Planck magic angle spinning and SLE context that uses full Wigner D-function basis and therefore solved directly for the powder average - a spherical grid is not required. This function generates the Fokker-Planck Hamiltonian, external relaxation superoperator, kinetics superoperator, applies the necessary offsets, updates the parameter set, and passes all of that to the pulse sequence, which should be supplied as a handle.
should be supplied as a handle. Syntax:
 
  
    answer=fplanck(spin_system,pulse_sequence,parameters,assumptions)
+
==Syntax==
  
where pulse sequence is a function handle to one of the pulse sequences
+
    answer=gridfree(spin_system,@pulse_sequence,parameters,assumptions)
located in the experiments directory, assumptions is a string that would
 
be passed to assume.m when the Hamiltonian is built and parameters is a
 
structure with the following subfields:
 
  
  parameters.rate    - spinning rate in Hz
+
==Parameters==
  
  parameters.axis    - spinning axis, given as a normalized
+
    @pulse_sequence    - pulse sequence function handle
                        3-element vector
+
 +
    parameters.rate    - spinning rate in Hz
 +
 +
    parameters.axis    - spinning axis, given as a normalized
 +
                          3-element vector
 +
 +
    parameters.spins    - a cell array giving the spins that
 +
                          the pulse sequence involves, e.g.
 +
                          {'1H','13C'}
 +
 +
    parameters.offset  - a cell array giving transmitter off-
 +
                          sets in Hz on each of the spins listed
 +
                          in parameters.spins array
 +
 +
    parameters.max_rank - maximum D-function rank to retain in
 +
                          the solution (increase till conver-
 +
                          gence is achieved, approximately
 +
                          equal to the number of spinning si-
 +
                          debands in the spectrum)
 +
 +
    parameters.tau_c    - correlation times (in seconds) for rotational
 +
                          diffusion. Single number for isotropic rotati-
 +
                          onal diffusion, and a 3x3 matrix for anisotro-
 +
                          pic rotational diffusion.
 +
 +
    parameters.*        - additional subfields may be required by your
 +
                          pulse sequence - check its documentation page
  
  parameters.spins    - a cell array giving the spins that
+
Additional subfields may be required by the pulse sequence. The parameters structure is passed to the pulse sequence with the following additional parameters set:
                        the pulse sequence involves, e.g.
 
                        {'1H','13C'}
 
  
  parameters.offset  - a cell array giving transmitter off-
+
    parameters.spc_dim  - matrix dimension for the spatial
                        sets in Hz on each of the spins listed
+
                          dynamics subspace
                        in parameters.spins array
+
 +
    parameters.spn_dim  - matrix dimension for the spin
 +
                          dynamics subspace
  
  parameters.max_rank - maximum D-function rank to retain in
+
==Outputs==
                        the solution (increase till conver-
+
This function returns the powder average of whatever it is that the pulse sequence returns.
                        gence is achieved, approximately
 
                        equal to the number of spinning si-
 
                        debands in the spectrum)
 
  
  parameters.tau_c - correlation times (in seconds) for rotational dif-
+
==Notes==
                      fusion under 'sle' option. Single number for iso-
+
#The choice of the Wigner D function rank truncation level depends on on the spinning rate (the slower the spinning, the greater ranks are required). The rank should be set approximately equal to the expected number of spinning sidebands. For diffusive dynamics, increase till the answer stops changing.
                      tropic rotational diffusion, two for axial and
+
#Rotational correlation times for SLE go into parameters.tau_c, not inter.tau_c (the latter is only used by the Redfield theory module).
                      three for rhombic rotational diffusion. Other in-
+
#The state projector assumes a powder - single crystal MAS is not supported, use [[singlerot.m]] instead.
                      teractions and coordinates are assumed to be spe-
+
#Perturbative corrections to the rotating frame transformation are not supported - use [[singlerot.m]] instead.
                      cified in the rotational diffusion tensor eigenframe.
 
  
Additional subfields may be required by the pulse sequence. The parameters
+
==See also==
structure is passed to the pulse sequence with the following additional
+
[[singlerot.m]], [[crystal.m]], [[doublerot.m]], [[floquet.m]], [[imaging.m]], [[liquid.m]], [[meshflow.m]], [[powder.m]], [[Kernel contexts]], [[Built-in_experiments]]
parameters set:
 
  
  parameters.spc_dim  - matrix dimension for the spatial
+
''Version 2.8, authors: [[Ilya Kuprov]]''
                        dynamics subspace
 
 
 
  parameters.spn_dim  - matrix dimension for the spin
 
                        dynamics subspace
 
 
 
This function returns the powder average of whatever it is that the pulse
 
sequence returns.
 
 
 
Note: the choice of the Wigner function rank truncation level depends on
 
the spinning rate (the slower the spinning, the greater ranks are
 
required).
 
 
 
Note: rotational correlation times for SLE go into parameters.tau_c, not
 
inter.tau_c (the latter is only used by the Redfield theory module).
 
 
 
Note: the state projector assumes a powder -- single crystal MAS is not
 
currently supported.
 

Latest revision as of 19:37, 6 June 2026

Fokker-Planck magic angle spinning and SLE context that uses full Wigner D-function basis and therefore solved directly for the powder average - a spherical grid is not required. This function generates the Fokker-Planck Hamiltonian, external relaxation superoperator, kinetics superoperator, applies the necessary offsets, updates the parameter set, and passes all of that to the pulse sequence, which should be supplied as a handle.

Syntax

    answer=gridfree(spin_system,@pulse_sequence,parameters,assumptions)

Parameters

    @pulse_sequence     - pulse sequence function handle

    parameters.rate     - spinning rate in Hz

    parameters.axis     - spinning axis, given as a normalized
                          3-element vector

    parameters.spins    - a cell array giving the spins that 
                          the pulse sequence involves, e.g. 
                          {'1H','13C'}

    parameters.offset   - a cell array giving transmitter off-
                          sets in Hz on each of the spins listed
                          in parameters.spins array

    parameters.max_rank - maximum D-function rank to retain in
                          the solution (increase till conver-
                          gence is achieved, approximately
                          equal to the number of spinning si-
                          debands in the spectrum)

    parameters.tau_c    - correlation times (in seconds) for rotational 
                          diffusion. Single number for isotropic rotati-
                          onal diffusion, and a 3x3 matrix for anisotro-
                          pic rotational diffusion. 

    parameters.*        - additional subfields may be required by your
                          pulse sequence - check its documentation page 

Additional subfields may be required by the pulse sequence. The parameters structure is passed to the pulse sequence with the following additional parameters set:

    parameters.spc_dim  - matrix dimension for the spatial
                          dynamics subspace

    parameters.spn_dim  - matrix dimension for the spin 
                          dynamics subspace

Outputs

This function returns the powder average of whatever it is that the pulse sequence returns.

Notes

  1. The choice of the Wigner D function rank truncation level depends on on the spinning rate (the slower the spinning, the greater ranks are required). The rank should be set approximately equal to the expected number of spinning sidebands. For diffusive dynamics, increase till the answer stops changing.
  2. Rotational correlation times for SLE go into parameters.tau_c, not inter.tau_c (the latter is only used by the Redfield theory module).
  3. The state projector assumes a powder - single crystal MAS is not supported, use singlerot.m instead.
  4. Perturbative corrections to the rotating frame transformation are not supported - use singlerot.m instead.

See also

singlerot.m, crystal.m, doublerot.m, floquet.m, imaging.m, liquid.m, meshflow.m, powder.m, Kernel contexts, Built-in_experiments

Version 2.8, authors: Ilya Kuprov