Difference between revisions of "Ppcs.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(→‎Arguments)
(sync with Spinach main f053e432: sxyz argument name, drop cell-array claim not in implementation)
 
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
Point electron pseudocontact shift model.
+
{{DISPLAYTITLE:ppcs.m}} __NOTOC__
 +
Point electron pseudocontact shift model. This function computes pseudocontact shifts from a point electron with user-supplied coordinates and susceptibility tensor at the nuclear coordinates supplied.
  
 
==Syntax==
 
==Syntax==
  
−
    pcs=ppcs(nxyz,mxyz,chi)
 
  
−
==Description==
+
    pcs=ppcs(nxyz,sxyz,chi)
−
This function computes pseudocontact shifts from a point electron with user-supplied coordinates and susceptibility tensor at the nuclear coordinates supplied.
+
 
 +
==Parameters==
  
−
==Arguments==
 
 
     chi    - electron magnetic susceptibility tensor in cubic  
 
     chi    - electron magnetic susceptibility tensor in cubic  
−
               Angstroms.
+
               Angstroms as a 3x3 matrix, or its five unique
 +
              components ordered as
 +
 +
                [chi(1,1) chi(1,2) chi(1,3) chi(2,2) chi(2,3)]
 
   
 
   
 
     nxyz    - nuclear coordinates as [x y z] with multiple rows,
 
     nxyz    - nuclear coordinates as [x y z] with multiple rows,
 
               at which PCS is to be evaluated, in Angstroms.
 
               at which PCS is to be evaluated, in Angstroms.
 
   
 
   
−
     mxyz   - paramagnetic centre coordinates as [x y z], in  
+
     sxyz   - susceptibility centre coordinates as [x y z], in  
 
               Angstroms.
 
               Angstroms.
  
Line 41: Line 44:
 
           -4.533874147      0.000000000      0.000000000
 
           -4.533874147      0.000000000      0.000000000
 
             0.000000000      4.533874147      0.000000000];
 
             0.000000000      4.533874147      0.000000000];
−
 
+
 
     % Co(II) g-tensor eigenvalues
 
     % Co(II) g-tensor eigenvalues
 
     g_co=diag([3.0 3.0 2.0]);
 
     g_co=diag([3.0 3.0 2.0]);
Line 66: Line 69:
  
 
==Notes==
 
==Notes==
−
Point model fails for nuclei positioned closer than about 10 Angstroms to the paramagnetic centre. For room temperature systems, it is possible to convert the ''g''-tensor into the suscpetibility tensor using [[g2chi.m]] function.
+
Point model fails for nuclei positioned closer than about 10 Angstroms to the paramagnetic centre. For room temperature systems, it is possible to convert the ''g''-tensor into the susceptibility tensor using [[g2chi.m]] function.
  
 
==See also==
 
==See also==
−
[[kpcs.m]], [ippcs.m]], [[lpcs.m]]
+
[[kpcs.m]], [[ippcs.m]], [[lpcs.m]], [[ilpcs.m]], [[ipcs.m]], [[g2chi.m]], [[centroid.m]], [[chi_eff.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]], [[xyz2pms.m]], [[Built-in_experiments]], [[Hyperfine_shift_module]]
−
 
 
  
−
''Version 1.9, authors: [[Ilya Kuprov]], [[Liza Suturina]]''
+
''Version 1.9, authors: [[Ilya Kuprov]], [[Elizaveta Suturina]]''

Latest revision as of 07:04, 30 August 2026

Point electron pseudocontact shift model. This function computes pseudocontact shifts from a point electron with user-supplied coordinates and susceptibility tensor at the nuclear coordinates supplied.

Syntax

    pcs=ppcs(nxyz,sxyz,chi)

Parameters

    chi     - electron magnetic susceptibility tensor in cubic 
              Angstroms as a 3x3 matrix, or its five unique 
              components ordered as

               [chi(1,1) chi(1,2) chi(1,3) chi(2,2) chi(2,3)]

    nxyz    - nuclear coordinates as [x y z] with multiple rows,
              at which PCS is to be evaluated, in Angstroms.

    sxyz    - susceptibility centre coordinates as [x y z], in 
              Angstroms.

Returns

    pcs     - predicted pseudocontact shift (in ppm) at each of 
              the nuclei.

Examples

The following example is available in nmr_paramag/porphyrin_example_1.m function in the example set supplied with Spinach:

    function porphyrin_example_1()
    
    % Porphyrin ring proton coordinates
    nxyz=[ 4.551635888      2.658552774      0.000000000
           2.658552774      4.551635889      0.000000000
          -2.658552774      4.551635888      0.000000000
          -4.551635889      2.658552774      0.000000000
          -4.551635888     -2.658552774      0.000000000
          -2.658552774     -4.551635889      0.000000000
           2.658552774     -4.551635888      0.000000000
           4.551635889     -2.658552774      0.000000000
           4.533874147      0.000000000      0.000000000
           0.000000000     -4.533874147      0.000000000
          -4.533874147      0.000000000      0.000000000
           0.000000000      4.533874147      0.000000000];

    % Co(II) g-tensor eigenvalues
    g_co=diag([3.0 3.0 2.0]);
    
    % Cu(II) g-tensor eigenvalues
    g_cu=diag([2.0 2.0 2.2]);
    
    % Curie susceptibility tensors
    chi_co=g2chi(g_co,298);
    chi_cu=g2chi(g_cu,298);
    
    % Metal position 
    mxyz=[0 0 0];
    
    % PCS calculation
    point_pcs_co=ppcs(nxyz,mxyz,chi_co);
    point_pcs_cu=ppcs(nxyz,mxyz,chi_cu);
    
    % Output
    disp('Pseudocontact shifts [Co, Cu], ppm');
    disp([point_pcs_co point_pcs_cu]);
    
    end

Notes

Point model fails for nuclei positioned closer than about 10 Angstroms to the paramagnetic centre. For room temperature systems, it is possible to convert the g-tensor into the susceptibility tensor using g2chi.m function.

See also

kpcs.m, ippcs.m, lpcs.m, ilpcs.m, ipcs.m, g2chi.m, centroid.m, chi_eff.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, xyz2pms.m, Built-in_experiments, Hyperfine_shift_module

Version 1.9, authors: Ilya Kuprov, Elizaveta Suturina