Difference between revisions of "Pcs combi fit.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Created page with "{{DISPLAYTITLE:function.m}} Combinatorial PCS fitting function. ==Syntax== d_shifts,p_shifts,pcs_theo,pcs_expt,chi,total_theo]=pcs_combi_fit(parameters) ==Description=...")
 
(sync with Spinach main f053e432: hyperfine tensors are in Gauss)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
{{DISPLAYTITLE:function.m}}
+
{{DISPLAYTITLE:pcs_combi_fit.m}} __NOTOC__
−
Combinatorial PCS fitting function.
+
Combinatorial PCS fitting function. This function takes into account potential ambiguities in diamagnetic and paramagnetic NMR assignments.
  
 
==Syntax==
 
==Syntax==
  
−
    d_shifts,p_shifts,pcs_theo,pcs_expt,chi,total_theo]=pcs_combi_fit(parameters)
 
  
−
==Description==
+
    [d_shifts,p_shifts,pcs_theo,pcs_expt,chi,total_theo]=pcs_combi_fit(parameters)
−
Takes into account potential ambiguities in diamagnetic and paramagnetic NMR assignments.
 
  
−
==Arguments==
+
==Parameters==
  
 
     parameters.hfcs  - cell array of 3x3 hyperfine tensors,
 
     parameters.hfcs  - cell array of 3x3 hyperfine tensors,
−
                         in MHz, usually out of gparse() or
+
                         in Gauss, usually out of gparse() or
 
                         something similar
 
                         something similar
 
   
 
   
Line 64: Line 62:
  
 
==See also==
 
==See also==
−
[[ppcs.m]], [[lpcs.m]], [[kpcs.m]], [[ipcs.m]]
+
[[ppcs.m]], [[lpcs.m]], [[kpcs.m]], [[ipcs.m]], [[centroid.m]], [[csa2racs.m]], [[eqmag.m]], [[fieldscan_enlev.m]], [[fieldscan_magn.m]], [[geffect.m]], [[hfc2pcs.m]], [[hfc2pms.m]], [[ippcs.m]], [[pcs2chi.m]], [[pms2chi.m]], [[probmax.m]], [[Built-in_experiments]]
−
 
 
  
 
''Version 2.1, authors: [[Ilya Kuprov]], [[Elizaveta Suturina]]''
 
''Version 2.1, authors: [[Ilya Kuprov]], [[Elizaveta Suturina]]''

Latest revision as of 07:04, 30 August 2026

Combinatorial PCS fitting function. This function takes into account potential ambiguities in diamagnetic and paramagnetic NMR assignments.

Syntax

    [d_shifts,p_shifts,pcs_theo,pcs_expt,chi,total_theo]=pcs_combi_fit(parameters)

Parameters

    parameters.hfcs   - cell array of 3x3 hyperfine tensors,
                        in Gauss, usually out of gparse() or
                        something similar

    parameters.isotopes - cell array of isotope specificati-
                          ons, e.g. {'1H','1H'}

    parameters.spin_groups - cell array of integer vectors
                             specifying the numbers of spins
                             that have each of the chemical 
                             shifts specified, e.g. 
                             {[28 22 30]; [25 33 81]}

    parameters.d_shifts - a vector of unique diamagnetic che-
                          mical shifts, in ppm

    parameters.p_shifts - a vector of unique paramagnetic 
                          chemical shifts, in ppm

    parameters.d_ambig - a cell array of integer vectors spe-
                         cifying the spins for which the dia-
                         magnetic assignment can potentially
                         be swapped around.

    parameters.p_ambig - a cell array of integer vectors spe-
                         cifying the spins for which the para-
                         magnetic assignment can potentially
                         be swapped around.

Outputs

    d_shifts - diamagnetic chemical shifts, optimally permuted

    p_shifts - paramagnetic chemical shifts, optimally permuted

    pcs_theo - theoretical pseudocontact shifts

    pcs_expt - experimental pseudocontact shifts from optimally
               permuted assignments

    chi      - rank 2 part of the magnetic susceptibility tensor,
               in cubic Angstrom

    total_theo - theoretical total NMR chemcial shifts, computed
                 as a sum of d_shifts and pcs_theo

Examples

See combi_fit_1.m and combi_fit_2.m files in examples/nmr_paramag directory.

Notes

Complexity scaling of the combinatorial procedure is very steep - specifying more than seven ambiguous atoms is not a good idea.

See also

ppcs.m, lpcs.m, kpcs.m, ipcs.m, centroid.m, csa2racs.m, eqmag.m, fieldscan_enlev.m, fieldscan_magn.m, geffect.m, hfc2pcs.m, hfc2pms.m, ippcs.m, pcs2chi.m, pms2chi.m, probmax.m, Built-in_experiments

Version 2.1, authors: Ilya Kuprov, Elizaveta Suturina