Spec-Zone.ru › NumPy 1.20

numpy.linalg.cholesky

linalg.cholesky(a) [source]

Разложение Холецкого.

Возвращает разложение Холецкого, L * L.H, квадратной матрицы a, где L является нижнетреугольной, а .H — оператор сопряжённого транспонирования (который является обычным транспонированием, если a вещественнозначная). a должна быть эрмитовой (симметричной, если вещественнозначная) и положительно определённой. Проверка на то, является ли a эрмитовой, не производится. Кроме того, используются только нижнетреугольные и диагональные элементы a. На самом деле возвращается только L.

Параметры
a(…, M, M) array_like

Эрмитова (симметричная, если все элементы вещественные), положительно определённая входная матрица.

Возвращает
L(…, M, M) array_like

Верхне- или нижнетреугольный фактор Холецкого матрицы a. Возвращает матричный объект, если a — матричный объект.

Возбуждает
LinAlgError

Если разложение не удаётся, например, если a не является положительно определённой.

См. также

scipy.linalg.cholesky

Аналогичная функция в SciPy.

scipy.linalg.cholesky_banded

Разложение Холецкого для полосовой эрмитовой положительно определённой матрицы.

scipy.linalg.cho_factor

Разложение Холецкого матрицы, которое используется в scipy.linalg.cho_solve.

Примечания

Введено в версии 1.8.0.

Применяются правила вещания, см. numpy.linalg документацию для получения подробностей.

Разложение Холецкого часто используется как быстрый способ решения

A \mathbf{x} = \mathbf{b}

(когда A является одновременно эрмитовой/симметричной и положительно определённой).

Сначала мы решаем относительно \mathbf{y} в

L \mathbf{y} = \mathbf{b},

а затем относительно \mathbf{x} в

L.H \mathbf{x} = \mathbf{y}.

Примеры

>>> A = np.array([[1,-2j],[2j,5]])
>>> A
array([[ 1.+0.j, -0.-2.j],
       [ 0.+2.j,  5.+0.j]])
>>> L = np.linalg.cholesky(A)
>>> L
array([[1.+0.j, 0.+0.j],
       [0.+2.j, 1.+0.j]])
>>> np.dot(L, L.T.conj()) # verify that L * L.H = A
array([[1.+0.j, 0.-2.j],
       [0.+2.j, 5.+0.j]])
>>> A = [[1,-2j],[2j,5]] # what happens if A is only array_like?
>>> np.linalg.cholesky(A) # an ndarray object is returned
array([[1.+0.j, 0.+0.j],
       [0.+2.j, 1.+0.j]])
>>> # But a matrix object is returned if A is a matrix object
>>> np.linalg.cholesky(np.matrix(A))
matrix([[ 1.+0.j,  0.+0.j],
        [ 0.+2.j,  1.+0.j]])

© 2005–2021 NumPy Developers
Licensed under the 3-clause BSD License.
https://numpy.org/doc/1.20/reference/generated/numpy.linalg.cholesky.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API