Difference between revisions of "Assume.m"
| Line 6: | Line 6: | ||
{| class="wikitable" | {| class="wikitable" | ||
| + | !assumption set | ||
| + | !description | ||
| + | |- | ||
|'nmr' | |'nmr' | ||
|Rotating frame approximation for electrons, rotating frame approximation for nuclei: secular g-tensor terms for electron Zeeman interactions, secular shielding terms for nuclear Zeeman interactions, secular coupling terms for spins belonging to the same species, weak coupling terms for spins belonging to different species, secular coupling terms for quadratic couplings. | |Rotating frame approximation for electrons, rotating frame approximation for nuclei: secular g-tensor terms for electron Zeeman interactions, secular shielding terms for nuclear Zeeman interactions, secular coupling terms for spins belonging to the same species, weak coupling terms for spins belonging to different species, secular coupling terms for quadratic couplings. | ||
Revision as of 12:50, 3 January 2017
Sets case-specific assumptions for various simulation contexts. This function determines the behaviour of the Hamiltonian generation function and should be called before the Hamiltonian is requested. Syntax:
spin_system=assume(spin_system,assumptions,retention)
The following assumption sets are supported:
| assumption set | description |
|---|---|
| 'nmr' | Rotating frame approximation for electrons, rotating frame approximation for nuclei: secular g-tensor terms for electron Zeeman interactions, secular shielding terms for nuclear Zeeman interactions, secular coupling terms for spins belonging to the same species, weak coupling terms for spins belonging to different species, secular coupling terms for quadratic couplings. |
| 'esr' | Rotating frame approximation for electrons, laboratory frame simulation for nuclei: secular g-tensor terms for electron Zeeman interactions, all shielding terms for nuclear Zeeman interactions, secular terms for inter-electron couplings, secular terms for electron zero-field splittings, secular and pseudosecular terms for hyperfine couplings, all terms for inter-nuclear couplings, all terms for nuclear quadrupolar couplings. |
| 'labframe' | Laboratory frame simulation for electrons, laboratory frame simulation for nuclei: all g-tensor terms for electron Zeeman interactions, all shielding terms for nuclear Zeeman interactions, all terms for all couplings. |
| 'qnmr' | Same as 'nmr', except all quadrupolar nuclei are kept in the laboratory frame. Their couplings to the rest of the system consequently have secular and pseudosecular terms retained. |
| 'deer' | Special set of secularity assumptions for DEER spectroscopy: secular g-tensor terms for electron Zeeman interactions, all shielding terms for nuclear Zeeman interactions, weak terms for inter-electron couplings, secular terms for electron zero-field splittings, secular and pseudosecular terms for hyperfine couplings, all terms for inter-nuclear couplings, all terms for nuclear quadrupolar couplings. |
The retention argument may be set to 'zeeman' (in which case all spin-spin couplings are ignored) or 'couplings' (in which case all Zeeman interactions are ignored).
Some pulse sequences (notably those dealing with DNP) set their own assumptions internally before calling the Hamiltonian generation function. To that end, assume.m function also contains more specialized assumption sets – see the function code for further information.
When calling kernel contexts assumptions should be passed as the last argument, for example:
fid=liquid(spin_system,@pulse_acquire,parameters,'nmr');
User-specified assumptions are ignored when generating thermal equilibrium states and relaxation superoperators – assumption sets for those functions are fixed by the nature of the physical problems that they solve.