summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorCharles Harris <charlesr.harris@gmail.com>2013-04-17 08:50:16 -0700
committerCharles Harris <charlesr.harris@gmail.com>2013-04-17 08:50:16 -0700
commit1975606394d577421c4b4e21abb8fdadbdc572c0 (patch)
tree46b622f02d189d69a4df5418566bd8419b50b03e /doc
parent1a9aa5ac15df13028e52d0a1d01fbcec9bbb687e (diff)
parent8eebee82b88f26f40c75422f5f655dea9f86f4b6 (diff)
downloadnumpy-1975606394d577421c4b4e21abb8fdadbdc572c0.tar.gz
Merge pull request #3220 from pv/linalg-gu
Add generalized ufunc linalg functions and make numpy.linalg use them
Diffstat (limited to 'doc')
-rw-r--r--doc/source/reference/routines.linalg.rst18
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/source/reference/routines.linalg.rst b/doc/source/reference/routines.linalg.rst
index 173a6ad53..00620347a 100644
--- a/doc/source/reference/routines.linalg.rst
+++ b/doc/source/reference/routines.linalg.rst
@@ -67,3 +67,21 @@ Exceptions
:toctree: generated/
linalg.LinAlgError
+
+Linear algebra on several matrices at once
+------------------------------------------
+
+Several of the linear algebra routines listed above are able to
+compute results for several matrices at once, if they are stacked into
+the same array.
+
+This is indicated in the documentation via input parameter
+specifications such as ``a : (..., M, M) array_like``. This means that
+if for instance given an input array ``a.shape == (N, M, M)``, it is
+interpreted as a "stack" of N matrices, each of size M-by-M. Similar
+specification applies to return values, for instance the determinant
+has ``det : (...)`` and will in this case return an array of shape
+``det(a).shape == (N,)``. This generalizes to linear algebra
+operations on higher-dimensional arrays: the last 1 or 2 dimensions of
+a multidimensional array are interpreted as vectors or matrices, as
+appropriate for each operation.