Function: norml2
Section: linear_algebra
C-Name: gnorml2
Prototype: G
Help: norml2(x): square of the L2-norm of x.
Doc: square of the $L^{2}$-norm of $x$. More precisely,
 if $x$ is a scalar, $\kbd{norml2}(x)$ is defined to be the square
 of the complex modulus of $x$ (real \typ{QUAD}s are not supported).
 If $x$ is a polynomial, a (row or column) vector or a matrix, \kbd{norml2($x$)} is
 defined recursively as $\sum_{i} \kbd{norml2}(x_{i})$, where $(x_{i})$
 run through
 the components of $x$. In particular, this yields the usual
 $\sum_{i} |x_{i}|^{2}$ (resp.~$\sum_{i,j} |x_{i,j}|^{2}$) if $x$ is a
 polynomial or vector (resp.~matrix) with complex components.

 \bprog
 ? norml2( [ 1, 2, 3 ] )      \\ vector
 %1 = 14
 ? norml2( [ 1, 2; 3, 4] )   \\ matrix
 %2 = 30
 ? norml2( 2*I + x )
 %3 = 5
 ? norml2( [ [1,2], [3,4], 5, 6 ] )   \\ recursively defined
 %4 = 91
 @eprog
