Difference between revisions of "Tikhonov.m"

From Spinach Documentation Wiki
Jump to: navigation, search
(See also)
(Sync syntax/arguments/outputs with current Spinach source)
Line 1: Line 1:
 
{{DISPLAYTITLE:tikhonov.m}} __NOTOC__
 
{{DISPLAYTITLE:tikhonov.m}} __NOTOC__
 +
 
Tikhonov regularised solution to K*x=y with a positivity constraint on x using regularised Newton-Raphson method.
 
Tikhonov regularised solution to K*x=y with a positivity constraint on x using regularised Newton-Raphson method.
  
 
==Syntax==
 
==Syntax==
  
    [x,err,reg]=tikhonov(K,D,KtK,DtD,H,y,lambda)
+
[x,err,reg]=tikhonov(K,D,KtK,DtD,H,y,lambda)
  
 
==Arguments==
 
==Arguments==
  
    K      - kernel matrix, may be complex, may be non-square
+
K      - kernel matrix, may be complex, may be non-square
 
   
 
   
 
     D      - regularisation matrix, leave empty to use finite
 
     D      - regularisation matrix, leave empty to use finite
Line 29: Line 30:
 
==Outputs==
 
==Outputs==
  
    x      - a real vector, a minimum (subject to positivity)
+
x      - a real vector, a minimum (subject to positivity)
 
             of norm(K*x-y,2)^2+lambda*norm(D*x,2)^2
 
             of norm(K*x-y,2)^2+lambda*norm(D*x,2)^2
+
 
 
     err    - error signal norm(K*x-y,2)^2
 
     err    - error signal norm(K*x-y,2)^2
+
 
 
     reg    - regularisation signal norm(D*x,2)^2
 
     reg    - regularisation signal norm(D*x,2)^2
 +
 +
Note: for best numerical performance, scale K to have approxima-
 +
      tely unit 2-norm, and y to have approximately unit 1-norm.
 +
 +
Note: see tikhoind.m for the indeterminate solver.
 +
 +
ilya.kuprov@weizmann.ac.il
 +
a.acharya@soton.ac.uk
  
 
==Notes==
 
==Notes==
 +
 
For best numerical performance, scale K to have approximately unit 2-norm, and y to have approximately unit 1-norm.
 
For best numerical performance, scale K to have approximately unit 2-norm, and y to have approximately unit 1-norm.
  
 
==See also==
 
==See also==
 +
 
[[Import,_export,_and_visualisation#Miscellaneous_data_processing|Miscellaneous data processing]]
 
[[Import,_export,_and_visualisation#Miscellaneous_data_processing|Miscellaneous data processing]]
  

Revision as of 15:06, 5 April 2026


Tikhonov regularised solution to K*x=y with a positivity constraint on x using regularised Newton-Raphson method.

Syntax

[x,err,reg]=tikhonov(K,D,KtK,DtD,H,y,lambda)

Arguments

K - kernel matrix, may be complex, may be non-square

   D      - regularisation matrix, leave empty to use finite
            difference second derivative matrix

   KtK    - K'*K, for repeated calls it may be faster to pre-
            compute this quantity, leave empty otherwise

   DtD    - D'*D, for repeated calls it may be faster to pre-
            compute this quantity, leave empty otherwise

   H      - Tikhonov Hessian 2*real(KtK+lambda*DtD), for re-
            peated calls it may be faster to precompute this
            quantity, leave empty otherwise

   y      - a column vector, may be complex

   lambda - Tikhonov regularisation parameter

Outputs

x - a real vector, a minimum (subject to positivity)

            of norm(K*x-y,2)^2+lambda*norm(D*x,2)^2
   err    - error signal norm(K*x-y,2)^2
   reg    - regularisation signal norm(D*x,2)^2
Note: for best numerical performance, scale K to have approxima-
      tely unit 2-norm, and y to have approximately unit 1-norm.
Note: see tikhoind.m for the indeterminate solver.
ilya.kuprov@weizmann.ac.il
a.acharya@soton.ac.uk

Notes

For best numerical performance, scale K to have approximately unit 2-norm, and y to have approximately unit 1-norm.

See also

Miscellaneous data processing

Numerical infrasctucture

tikhoind.m


Version 2.9, authors: Anupama Acharya, Ilya Kuprov