Difference between revisions of "Residual.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Sync syntax/arguments/outputs with current Spinach source)
(Update function See also links and function index membership)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{DISPLAYTITLE:residual.m}} __NOTOC__
 
{{DISPLAYTITLE:residual.m}} __NOTOC__
 
 
Sets up interaction tensors under partial ordering in a liquid crystal with the user-supplied order matrix. All adjustable parameters are set during the call to [[create.m]] function.
 
Sets up interaction tensors under partial ordering in a liquid crystal with the user-supplied order matrix. All adjustable parameters are set during the call to [[create.m]] function.
  
 
==Syntax==
 
==Syntax==
  
spin_system=residual(spin_system)
+
    spin_system=residual(spin_system)
  
==Arguments==
+
==Parameters==
  
spin_system  -  the output of create.m containing
+
      spin_system  -  the output of create.m containing
 
                       spin system and interaction infor-
 
                       spin system and interaction infor-
 
                       mation, which must include the or-
 
                       mation, which must include the or-
Line 16: Line 15:
 
==Outputs==
 
==Outputs==
  
spin_system  -  the same object with anisotropic
+
      spin_system  -  the same object with anisotropic  
 
                       parts of all interaction tensors
 
                       parts of all interaction tensors
 
                       replaced with their partial order
 
                       replaced with their partial order
 
                       residuals.
 
                       residuals.
 
Note: this function is only applicable to weak residual order
 
      in high-field NMR spectroscopy.
 
 
Note: the function overwrites the interaction tensors supplied
 
      by the user. Relaxation superoperator, if required, must
 
      be computed before this function is called.
 
 
Note: this function is invoked automatically by liquid.m con-
 
      text when when parameters.needs cell array contains 'rdc'.
 
 
ledwards@cbs.mpg.de
 
ilya.kuprov@weizmann.ac.il
 
  
 
==Examples==
 
==Examples==
 
 
Below are the outputs of examples/liquid_crystals/rdc_fourspin.m simulation of CLIP-HSQC experiment on a four-spin system in the presence(left) and absence (right) of residual order.
 
Below are the outputs of examples/liquid_crystals/rdc_fourspin.m simulation of CLIP-HSQC experiment on a four-spin system in the presence(left) and absence (right) of residual order.
  
Line 41: Line 26:
  
 
==Notes==
 
==Notes==
 
 
# This function is only applicable to high-field NMR.
 
# This function is only applicable to high-field NMR.
 
# The function overwrites the interaction tensors supplied by the user. Relaxation superoperator, if required, must be computed before this function is called.
 
# The function overwrites the interaction tensors supplied by the user. Relaxation superoperator, if required, must be computed before this function is called.
Line 47: Line 31:
  
 
==See also==
 
==See also==
 
+
[[dipolar.m]], [[clip_hsqc.m]], [[create.m]], [[liquid.m]], [[assume.m]], [[Kernel_functions]], [[Spin_system_specification]]
[[dipolar.m]], [[clip_hsqc.m]]
 
 
 
[[Spin_system_specification#Liquid_crystal_order_matrix|Liquid crystal order matrix]]
 
 
 
  
 
''Version 2.8, authors: [[Luke Edwards]], [[Ilya Kuprov]]''
 
''Version 2.8, authors: [[Luke Edwards]], [[Ilya Kuprov]]''

Latest revision as of 19:40, 6 June 2026

Sets up interaction tensors under partial ordering in a liquid crystal with the user-supplied order matrix. All adjustable parameters are set during the call to create.m function.

Syntax

    spin_system=residual(spin_system)

Parameters

     spin_system  -  the output of create.m containing
                     spin system and interaction infor-
                     mation, which must include the or-
                     der matrix

Outputs

     spin_system  -  the same object with anisotropic 
                     parts of all interaction tensors
                     replaced with their partial order
                     residuals.

Examples

Below are the outputs of examples/liquid_crystals/rdc_fourspin.m simulation of CLIP-HSQC experiment on a four-spin system in the presence(left) and absence (right) of residual order.

Clip hsqc saupe.png Clip hsqc nosaupe.png

Notes

  1. This function is only applicable to high-field NMR.
  2. The function overwrites the interaction tensors supplied by the user. Relaxation superoperator, if required, must be computed before this function is called.
  3. This function is involed automatically by liquid.m context when parameters.needs cell array contains 'rdc'.

See also

dipolar.m, clip_hsqc.m, create.m, liquid.m, assume.m, Kernel_functions, Spin_system_specification

Version 2.8, authors: Luke Edwards, Ilya Kuprov