liquid.m

From Spinach Documentation Wiki
Jump to: navigation, search

Liquid-phase interface to pulse sequences. Generates a Liouvillian superoperator and passes it on to the pulse sequence function, which should be supplied as a handle.

This interface handles residual order: if the 'rdc' need is specified, it would use the order matrices supplied by the user during the call to create.m to compute the residual anisotropies of all interactions.

Syntax

    answer=liquid(spin_system,pulse_sequence,parameters,assumptions)

Parameters

 pulse_sequence     - pulse sequence function handle. See the
                      experiments directory for the list of
                      pulse sequences that ship with Spinach.

 parameters.spins   - a cell array giving the
                      spins that the pulse sequence works on, in
                      the order of channels, e.g. {'1H','13C'}

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

 parameters.needs   - a cell array of strings specifying additional
                      information required by the sequence:

                      'zeeman_op' - Zeeman part of the Hamiltonian
                      in the laboratory frame, to be placed into
                      parameters.hzeeman and sent to pulse sequence

                      'rdc' - triggers the processing of residual
                      anisotropic couplings due to partial order

                      'rho_eq' - thermal equilibrium state at the
                      specified temperature with respect to the
                      isotropic part of the Hamiltonian; this is
                      placed into parameters.rho0

 parameters.rframes - rotating frame specification, e.g.
                      {{'13C',2},{'14N,3}} requests second
                      order rotating frame transformation
                      with respect to carbon-13 and third
                      order rotating frame transformation
                      with respect to nitrogen-14. When
                      this option is used, the assumptions
                      on the respective spins should be
                      laboratory frame.

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

 assumptions       -  context-specific assumptions ('nmr', 'epr',
                      'labframe', etc.) - see the pulse sequence
                      header for information on this setting.

Outputs

This function returns whatever it is that the pulse sequence returns.

Notes

Arbitrary order rotating frame transformation is supported, including infinite order. See rotframe.m for further information.

See also

create.m, rotframe.m, crystal.m, doublerot.m, floquet.m, gridfree.m, imaging.m, meshflow.m, powder.m, singlerot.m, Kernel contexts, Built-in_experiments

Version 2.8, authors: Ilya Kuprov