Difference between revisions of "Holeburn.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Created page with "Hole burning experiment. The soft pulse is simulated using Fokker-Planck formalism. Syntax: fid=holeburn(spin_system,parameters,H,R,K) Parameters: parameter...")
 
(Update function See also links and function index membership)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Hole burning experiment. The soft pulse is simulated using  
+
{{DISPLAYTITLE:holeburn.m}} __NOTOC__
Fokker-Planck formalism. Syntax:
+
Hole burning experiment - a soft pulse follwed by a hard pi/2 observation pulse. The soft pulse is simulated using Fokker-Planck formalism.
  
          fid=holeburn(spin_system,parameters,H,R,K)
+
==Syntax==
  
Parameters:
+
    fid=holeburn(spin_system,parameters,H,R,K)
  
    parameters.soft_frq - frequency of the soft pulse, Hz
+
==Parameters==
  
     parameters.soft_phi - phase of the soft pulse, rad
+
     parameters.pulse_frq - frequency of the soft pulse, Hz
 +
 +
    parameters.pulse_phi - phase of the soft pulse, rad
 +
 +
    parameters.pulse_pwr - power of the soft pulse, rad/s
 +
 +
    parameters.pulse_dur - duration of the sof pulse, s
 +
 +
    parameters.pulse_rnk - Fokker-Planck cut-off rank
 +
 +
    parameters.offset    - receiver offset for the time
 +
                            domain detection, Hz
 +
 +
    parameters.sweep    - sweep width for time domain
 +
                            detection, Hz
 +
 +
    parameters.npoints  - number of points in the free
 +
                            induction decay
 +
 +
    parameters.rho0      - initial state
 +
 +
    parameters.coil      - detection state
 +
 +
    parameters.method    - soft puse propagation method,
 +
                            'expv' for Krylov propagation,
 +
                            'expm' for exponential propa-
 +
                            gation, 'evolution' for Spin-
 +
                            ach evolution function
 +
 +
    H    - Hamiltonian matrix, received from context
 +
            function
 +
 +
    R    - relaxation superoperator, received from
 +
            context function
 +
 +
    K    - kinetics superoperator, received from
 +
            context function
  
    parameters.soft_pwr - power of the soft pulse, Hz
+
==Outputs==
  
     parameters.soft_dur - duration of the sof pulse, s
+
     fid  -  free induction decay seen by the state speci-
 +
            fied in parameters coil after the hole burning
 +
            pulse followed by a hard pi/2 pulse.
  
    parameters.soft_rnk - Fokker-Planck cut-off rank
+
==Examples==
 +
The following hole is produced by examples/esr_solids/holeburn_nitroxide_powder.m file:
  
The last parameter should be increased until convergence is
+
[[File:holeburn.png]]
achieved in the output.
+
 
 +
==Notes==
 +
The rank parameter should be increased until convergence is achieved in the output.
 +
 
 +
==See also==
 +
[[shaped_pulse_af.m]], [[shaped_pulse_xy.m]], [[sp_acquire.m]], [[hp_acquire.m]], [[acquire.m]], [[cpmg.m]], [[impound.m]], [[relaxan.m]], [[slowpass.m]], [[traject.m]], [[Built-in_experiments]]
 +
 
 +
''Version 2.2, authors: [[Ilya Kuprov]]''

Latest revision as of 19:37, 6 June 2026

Hole burning experiment - a soft pulse follwed by a hard pi/2 observation pulse. The soft pulse is simulated using Fokker-Planck formalism.

Syntax

    fid=holeburn(spin_system,parameters,H,R,K)

Parameters

    parameters.pulse_frq - frequency of the soft pulse, Hz

    parameters.pulse_phi - phase of the soft pulse, rad

    parameters.pulse_pwr - power of the soft pulse, rad/s

    parameters.pulse_dur - duration of the sof pulse, s

    parameters.pulse_rnk - Fokker-Planck cut-off rank

    parameters.offset    - receiver offset for the time
                           domain detection, Hz

    parameters.sweep     - sweep width for time domain
                           detection, Hz

    parameters.npoints   - number of points in the free
                           induction decay 

    parameters.rho0      - initial state

    parameters.coil      - detection state

    parameters.method    - soft puse propagation method,
                           'expv' for Krylov propagation,
                           'expm' for exponential propa-
                           gation, 'evolution' for Spin-
                           ach evolution function

   H     - Hamiltonian matrix, received from context 
           function

   R     - relaxation superoperator, received from 
           context function

   K     - kinetics superoperator, received from 
           context function

Outputs

    fid  -  free induction decay seen by the state speci-
            fied in parameters coil after the hole burning 
            pulse followed by a hard pi/2 pulse. 

Examples

The following hole is produced by examples/esr_solids/holeburn_nitroxide_powder.m file:

Holeburn.png

Notes

The rank parameter should be increased until convergence is achieved in the output.

See also

shaped_pulse_af.m, shaped_pulse_xy.m, sp_acquire.m, hp_acquire.m, acquire.m, cpmg.m, impound.m, relaxan.m, slowpass.m, traject.m, Built-in_experiments

Version 2.2, authors: Ilya Kuprov