Linear Algebra

Linear algebra for Common Lisp. A two-dimensional array-like structure, a matrix, for performing matrix algebra.
Explore the docs »

Report Bug · Request Feature · Reference Manual

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Resources
6. Contributing
7. License
8. Contact

About the Project

This project is a fork of Thomas M. Hermann's linear-algebra system. We chose it as the basis for Lisp-Stat's linear algebra because it uses high-quality algorithms, has extensive references and good test coverage.

Built With

• closer-mop
• alexandria
• array-operations
• array-operations
• numerical-utilities
• select
• let-plus

Getting Started

To get a local copy up and running follow these steps:

Prerequisites

An ANSI Common Lisp implementation. Developed and tested with SBCL.

Installation

Lisp-Stat is composed of several system that are designed to be independently useful. So you can, for example, use linear-algebra for any project needing to manipulate two dimensional data in a machine learning or statistical setting.

Getting the source

To make the system accessible to ASDF (a build facility, similar to make in the C world), clone the repository in a directory ASDF knows about. By default the common-lisp directory in your home directory is known. Create this if it doesn't already exist and then:

1. Clone the repositories

cd ~/common-lisp && \
git clone https://github.com/Lisp-Stat/linear-algebra.git

2. Reset the ASDF source-registry to find the new system (from the REPL)

   (asdf:clear-source-registry)

3. Load the system

   (asdf:load-system :linear-algebra)

If you have installed the slime ASDF extensions, you can invoke this with a comma (',') from the slime REPL in emacs.

Getting dependencies

To get the third party systems that Lisp-Stat depends on you can use a dependency manager, such as Quicklisp or CLPM Once installed, get the dependencies with either of:

(clpm-client:sync :sources "clpi") ;sources may vary

(ql:quickload :linear-algebra)

You need do this only once. After obtaining the dependencies, you can load the system with ASDF as described above without first syncing sources.

Roadmap

linear-algebra is in a usable state for pure lisp operations. Future plans include:

• Merging functionality from numerical-utilities where there is duplication
• Add a backend for CUDA for GPU based linear algebra operations
• Improve documentation

See the open issues for a list of proposed features (and known issues).

Resources

This system is part of the Lisp-Stat project; that should be your first stop for information. Also see the resources and community page for more information.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated. Please see CONTRIBUTING.md for details on the code of conduct, and the process for submitting pull requests.

License

Distributed under the MS-PL License. See LICENSE for more information.

Contact

Project Link: https://github.com/lisp-stat/linear-algebra