Difference between revisions of "Ppcs.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(sync with Spinach main f053e432: sxyz argument name, drop cell-array claim not in implementation)
 
(8 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
{{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.
 
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)
 
  
−
==Arguments==
+
    pcs=ppcs(nxyz,sxyz,chi)
 +
 
 +
==Parameters==
  
 
     chi    - electron magnetic susceptibility tensor in cubic  
 
     chi    - electron magnetic susceptibility tensor in cubic  
 
               Angstroms as a 3x3 matrix, or its five unique  
 
               Angstroms as a 3x3 matrix, or its five unique  
 
               components ordered as
 
               components ordered as
−
               
+
 
                 [chi(1,1) chi(1,2) chi(1,3) chi(2,2) chi(2,3)]
 
                 [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. If
+
               at which PCS is to be evaluated, in Angstroms.
−
              a cell array of such specifications is supplied,
 
−
              the average PCS over them is returned.
 
 
   
 
   
−
     mxyz   - paramagnetic centre coordinates as [x y z], in  
+
     sxyz   - susceptibility centre coordinates as [x y z], in  
 
               Angstroms.
 
               Angstroms.
  
Line 72: Line 72:
  
 
==See also==
 
==See also==
−
[[kpcs.m]], [[ippcs.m]], [[lpcs.m]], [[ilpcs.m]], [[ipcs.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]], [[Elizaveta 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