ippcs.m

From Spinach Documentation Wiki
Revision as of 19:38, 6 June 2026 by Kuprov (talk | contribs) (Update function See also links and function index membership)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Point electron PCS model fitting. This function fits the point electron model PCS to the experimental pseudocontact shift coordinates and values. It returns the point electron coordinate, the predicted susceptibility tensor, along with the standard deviations for both.

Syntax

    [mxyz,chi,pred_pcs,s_mxyz,s_chi]=ippcs(nxyz,mguess,expt_pcs)

Parameters

    nxyz     - nuclear coordinates as [x y z] with multiple rows,
               at which PCS is to be evaluated, in Angstroms. If
               a cell array of such specifications is supplied,
               the average PCS over them is being used.

    mguess   - initial guess for the unpaired electron coordina-
               tes as [x y z], in Angstroms.

    expt_pcs - pseudocontact shift in ppm at each nucleus.

Returns

    mxyz     - optimized paramagnetic centre coordinates as [x y z],
               in Angstroms.

    chi      - optimized magnetic susceptibility tensor in cubic
               Angstroms.

    pred_pcs - predicted pseudocontact shift at each nucleus with
               the optimized mxyz and chi, ppm.

    s_mxyz   - standard deviations of paramagnetic centre 
               coordinates as [x y z], in Angstroms.

    s_chi    - standard deviations of magnetic susceptibility 
               tensor elements in cubic Angstroms.

Examples

Multiple examples of point model fits are provided in /nmr_paramag/calbindin and /nmr_paramag/carb_anh directories of the example set supplied with Spinach.

Notes

A good initial guess for the electron location is essential for a successful fit. Point model fails for nuclei positioned closer than about 10 Angstroms to the paramagnetic centre.

See also

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

Version 1.9, authors: Ilya Kuprov, Elizaveta Suturina