/usr/share/pyshared/nibabel/nicom/dwiparams.py is in python-nibabel 1.2.2-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 | ''' Process diffusion imaging parameters
* ``q`` is a vector in Q space
* ``b`` is a b value
* ``g`` is the unit vector along the direction of q (the gradient
direction)
Thus:
b = norm(q)
g = q / norm(q)
(``norm(q)`` is the Euclidean norm of ``q``)
The B matrix ``B`` is a symmetric positive semi-definite matrix. If
``q_est`` is the closest q vector equivalent to the B matrix, then:
B ~ (q_est . q_est.T) / norm(q_est)
'''
import numpy as np
import numpy.linalg as npl
def B2q(B, tol=None):
''' Estimate q vector from input B matrix `B`
We assume the input `B` is symmetric positive definite.
Because the solution is a square root, the sign of the returned
vector is arbitrary. We set the vector to have a positive x
component by convention.
Parameters
----------
B : (3,3) array-like
B matrix - symmetric. We do not check the symmetry.
tol : None or float
absolute tolerance below which to consider eigenvalues of the B
matrix to be small enough not to worry about them being negative,
in check for positive semi-definite-ness. None (default) results
in a fairly tight numerical threshold proportional the maximum
eigenvalue
Returns
-------
q : (3,) vector
Estimated q vector from B matrix `B`
'''
B = np.asarray(B)
w, v = npl.eig(B)
if tol is None:
tol = np.abs(w.max() * np.finfo(w.dtype).eps)
non_trivial = np.abs(w) > tol
if np.any(w[non_trivial] < 0):
raise ValueError('B not positive semi-definite')
inds = np.argsort(w)[::-1]
max_ind = inds[0]
vector = v[:,max_ind]
# because the factor is a sqrt, the sign of the vector is arbitrary.
# We arbitrarily set it to have a positive x value.
if vector[0] < 0:
vector *= -1
return vector * w[max_ind]
def nearest_pos_semi_def(B):
''' Least squares positive semi-definite tensor estimation
Reference: Niethammer M, San Jose Estepar R, Bouix S, Shenton M,
Westin CF. On diffusion tensor estimation. Conf Proc IEEE Eng Med
Biol Soc. 2006;1:2622-5. PubMed PMID: 17946125; PubMed Central
PMCID: PMC2791793.
Parameters
----------
B : (3,3) array-like
B matrix - symmetric. We do not check the symmetry.
Returns
-------
npds : (3,3) array
Estimated nearest positive semi-definite array to matrix `B`.
Examples
--------
>>> B = np.diag([1, 1, -1])
>>> nearest_pos_semi_def(B)
array([[ 0.75, 0. , 0. ],
[ 0. , 0.75, 0. ],
[ 0. , 0. , 0. ]])
'''
B = np.asarray(B)
vals, vecs = npl.eigh(B)
# indices of eigenvalues in descending order
inds = np.argsort(vals)[::-1]
vals = vals[inds]
cardneg = np.sum(vals < 0)
if cardneg == 0:
return B
if cardneg == 3:
return np.zeros((3,3))
lam1a, lam2a, lam3a = vals
scalers = np.zeros((3,))
if cardneg == 2:
b112 = np.max([0,lam1a+(lam2a+lam3a)/3.])
scalers[0] = b112
elif cardneg == 1:
lam1b=lam1a+0.25*lam3a
lam2b=lam2a+0.25*lam3a
if lam1b >= 0 and lam2b >= 0:
scalers[:2] = lam1b, lam2b
else: # one of the lam1b, lam2b is < 0
if lam2b < 0:
b111=np.max([0,lam1a+(lam2a+lam3a)/3.])
scalers[0] = b111
if lam1b < 0:
b221=np.max([0,lam2a+(lam1a+lam3a)/3.])
scalers[1] = b221
# resort the scalers to match the original vecs
scalers = scalers[np.argsort(inds)]
return np.dot(vecs, np.dot(np.diag(scalers), vecs.T))
|