LLA works with matrices, that is arrays of rank 2, with all numerical values. Categorical variables could be integer coded if you need to.
lla requires a BLAS and LAPACK shared library. These may be available via
your operating systems package manager, or you can download OpenBLAS, which includes precompiled binaries for MS Windows.
NoteLLA relies on CFFI to locate the BLAS & LAPPACK shared library. In most cases, this means CFFI will use the system default search paths. If you encounter errors in loading the library, consult the CFFI documentation. For MS Windows, the certain way to successfully load the DLL is to ensure that the library is on the
You can also configure the path by setting the
cl-user::*lla-configuration* variable like so:
(defvar *lla-configuration* '(:libraries ("s:/src/lla/lib/libopenblas.dll")))
Use the location specific to your system.
(asdf:load-system :lla) (use-package 'lla) ;access to the symbols
To make working with matrices easier, we’re going to use the matrix-shorthand library. Load it like so:
(asdf:load-system :num-utils) (use-package :num-utils.matrix-shorthand)
mm is the matrix multiplication function. It is generic and can operate on both regular arrays and ‘wrapped’ array types, e.g. hermitian or triangular. In this example we’ll multiple an array by a vector.
mx is the short-hand way of defining a matrix, and
vec a vector.
(let ((a (mx 'lla-double (1 2) (3 4) (5 6))) (b2 (vec 'lla-double 1 2))) (mm a b2)) ; #(5.0d0 11.0d0 17.0d0)
norm returns a matrix or vector norm. This function is able to return one of eight different matrix norms, or one of an infinite number of vector norms (described below), depending on the value of the
ord may be one of:
ord must be >= 0.
Note that norm is not, by default, part of the LS-USER package.
The following norms can be calculated:
|ord||norm for matrices||norm for vector|
||max(sum(abs(a), axis=1))||(max (abs a))|
||min(sum(abs(a), axis=1))||(min (abs a))|
||max(sum(abs(a), axis=0))||as below|
The Frobenius norm is given by
The nuclear norm is the sum of the singular values.
Both the Frobenius and nuclear norm orders are only defined for matrices.
(defparameter a #(-4 -3 -2 -1 0 1 2 3 4)) (defparameter b (reshape a '(3 3)))
LS-USER> (nu:norm a) 7.745967 LS-USER> (nu:norm b) 7.745967 LS-USER> (nu:norm b :frob) 7.745967 LS-USER> (nu:norm a :inf) 4 LS-USER> (nu:norm b :inf) 9 LS-USER> (nu:norm a :-inf) 0 LS-USER> (nu:norm b :-inf) 2
LS-USER> (nu:norm a 1) 20 LS-USER> (nu:norm b 1) 7 LS-USER> (nu:norm a 2) 7.745967 LS-USER> (nu:norm b 2) 7.745967 LS-USER> (nu:norm b 3) 5.8480353
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.