Difference between revisions of "Pms2chi.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(Created page with "Uses linear least squares procedure on top of Equation 10 from http://dx.doi.org/10.1039/c4cp03106g to extract the susceptibi- lity tensor from DFT hyperfine coupling tensors ...")
 
(sync with Spinach main f053e432: drop removed nel argument, syntax and units to head)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
Uses linear least squares procedure on top of Equation 10 from
+
{{DISPLAYTITLE:pms2chi.m}} __NOTOC__
−
http://dx.doi.org/10.1039/c4cp03106g to extract the susceptibi-
+
Runs a least squares fitting procedure on top of Equation 10 from http://dx.doi.org/10.1039/c4cp03106g to extract the susceptibility tensor from DFT hyperfine coupling tensors and experimentally observed paramagnetic (contact + pseudocontact) shifts.
−
lity tensor from DFT hyperfine coupling tensors and experiment-
+
 
−
ally observed paramagnetic (contact + pseudocontact) shifts.
+
==Syntax==
 +
 
 +
    [chi,err]=pms2chi(hfcs,shifts,isotopes)
 +
 
 +
==Parameters==
 +
 
 +
        hfcs  - cell array of 3x3 hyperfine coupling tensors
 +
                in Gauss
 
   
 
   
−
              chi=pms2chi(hfcs,shifts,isotopes)
+
      shifts  - vector of the observed pseudocontact shifts,
 +
                excluding the diamagnetic contribution, ppm
 +
 +
    isotopes  - cell array of character strings specifying
 +
                isotopes that exhibit each of the chemical
 +
                shifts supplied, for example {'1H','13C'}
 +
 
 +
==Outputs==
 +
 
 +
        chi   - the fitted magnetic susceptibility tensor,
 +
                cubic Angstroms
 +
 +
        err  - least squares error
 +
 
 +
==Examples==
 +
See the paramagnetic shift [[Pseudocontact_shift_analysis|getting started guide]].
 +
 
 +
==Notes==
 +
Gauss units are used for hyperfine couplings because they do not depend on the electron g-tensor.
 +
 
 +
==See also==
 +
[[lpcs.m]], [[kpcs.m]], [[ipcs.m]], [[hfc2pcs.m]], [[hfc2pms.m]], [[pcs2chi.m]], [[centroid.m]], [[csa2racs.m]], [[eqmag.m]], [[fieldscan_enlev.m]], [[fieldscan_magn.m]], [[geffect.m]], [[ippcs.m]], [[pcs_combi_fit.m]], [[ppcs.m]], [[probmax.m]], [[Built-in_experiments]]
  
−
where hfcs is a cell array of 3x3 hyperfine coupling tensors in
+
''Version 2.2, authors: [[Elizaveta Suturina]], [[Ilya Kuprov]]''
−
MHz, shifts is a vector of the observed paramagnetic shifts, ex-
 
−
cluding the diamagnetic contribution, and isotopes is a cell ar-
 
−
ray of character strings specifying isotopes that exhibit each
 
−
of the chemical shifts supplied, for example {'1H','13C'}.
 

Latest revision as of 07:04, 30 August 2026

Runs a least squares fitting procedure on top of Equation 10 from http://dx.doi.org/10.1039/c4cp03106g to extract the susceptibility tensor from DFT hyperfine coupling tensors and experimentally observed paramagnetic (contact + pseudocontact) shifts.

Syntax

    [chi,err]=pms2chi(hfcs,shifts,isotopes)

Parameters

       hfcs   - cell array of 3x3 hyperfine coupling tensors
                in Gauss

     shifts   - vector of the observed pseudocontact shifts,
                excluding the diamagnetic contribution, ppm

   isotopes   - cell array of character strings specifying
                isotopes that exhibit each of the chemical
                shifts supplied, for example {'1H','13C'}

Outputs

        chi   - the fitted magnetic susceptibility tensor,
                cubic Angstroms

        err   - least squares error

Examples

See the paramagnetic shift getting started guide.

Notes

Gauss units are used for hyperfine couplings because they do not depend on the electron g-tensor.

See also

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

Version 2.2, authors: Elizaveta Suturina, Ilya Kuprov