Difference between revisions of "Dilute.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Update function See also links and function index membership)
 
(11 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
{{DISPLAYTITLE:dilute.m.m}}
+
{{DISPLAYTITLE:dilute.m}} __NOTOC__
−
Splits the spin system into several independent subsystems, each containing only one instance of a user specified isotope that is deemed "dilute". All spin system data is updated accordingly and basis set information, if found, is destroyed.
+
Splits the spin system into several independent subsystems, each containing only one instance of a user specified isotope or isotope tuple that is deemed "dilute". All spin system data is updated accordingly. Basis set information, if found, is destroyed.
  
 
==Syntax==
 
==Syntax==
  
−
     spin_systems=dilute(spin_system,isotope)
+
     subsystems=dilute(spin_system,isotope,tuples)
  
−
==Arguments==
+
==Parameters==
  
 
     spin_system  - spin system object obtained  
 
     spin_system  - spin system object obtained  
Line 13: Line 13:
 
     isotope      - isotope specification string,
 
     isotope      - isotope specification string,
 
                     for example '13C'
 
                     for example '13C'
 +
 +
    tuples        - 1 returns all subsystems with
 +
                    a single instance of the isoto-
 +
                    pe, 2 returns all subsystems
 +
                    where two instances of the iso-
 +
                    tope are present, etc.
  
 
==Outputs==
 
==Outputs==
Line 20: Line 26:
 
                     responding to one of the new-
 
                     responding to one of the new-
 
                     ly formed isotopomers.
 
                     ly formed isotopomers.
−
 
  
 
==Examples==
 
==Examples==
−
HSQC and HMQC examples in examples/nmr_liquids folder use this function.
+
HSQC and HMQC examples in examples/nmr_liquids folder use this function for single-spin dilution. INADEQUATE examples use it for spin pair dilution.
−
 
 
−
==Notes==
 
−
Infinite dilution assumed - only one magnetic nucleus of the specified type per molecule.
 
  
 
==See also==
 
==See also==
−
[[kill_spin.m]], [[create.m]], [[coherence.m]]
+
[[kill_spin.m]], [[create.m]], [[coherence.m]], [[inadequate.m]], [[hsqc.m]], [[hmqc.m]], [[coloc.m]], [[chemshifts.m]], [[cubic_lattice.m]], [[get_coupling.m]], [[gtensorof.m]], [[idxof.m]], [[iselectron.m]], [[isnucleus.m]], [[isoswap.m]], [[nearest_spin.m]], [[shift_iso.m]], [[Kernel_utilities]]
−
 
 
  
−
''Version 2.2, authors: [[Ilya Kuprov]], [[Luke Edwards]]''
+
''Version 2.4, authors: [[Ilya Kuprov]], [[Bud Macaulay]], [[Luke Edwards]]''

Latest revision as of 19:35, 6 June 2026

Splits the spin system into several independent subsystems, each containing only one instance of a user specified isotope or isotope tuple that is deemed "dilute". All spin system data is updated accordingly. Basis set information, if found, is destroyed.

Syntax

    subsystems=dilute(spin_system,isotope,tuples)

Parameters

   spin_system   - spin system object obtained 
                   from create.m function

   isotope       - isotope specification string,
                   for example '13C'

   tuples        - 1 returns all subsystems with
                   a single instance of the isoto-
                   pe, 2 returns all subsystems
                   where two instances of the iso-
                   tope are present, etc.

Outputs

   spin_systems  - a cell array of spin system 
                   objects, with each cell cor-
                   responding to one of the new-
                   ly formed isotopomers.

Examples

HSQC and HMQC examples in examples/nmr_liquids folder use this function for single-spin dilution. INADEQUATE examples use it for spin pair dilution.

See also

kill_spin.m, create.m, coherence.m, inadequate.m, hsqc.m, hmqc.m, coloc.m, chemshifts.m, cubic_lattice.m, get_coupling.m, gtensorof.m, idxof.m, iselectron.m, isnucleus.m, isoswap.m, nearest_spin.m, shift_iso.m, Kernel_utilities

Version 2.4, authors: Ilya Kuprov, Bud Macaulay, Luke Edwards