Home

Welcome to the core.matrix wiki!

About

core.matrix is an API for multi-dimensional array computation in Clojure. This includes vector and matrix maths, and a lot more, using a consistent and idiomatic Clojure API.

Key objectives:

• Provide a clear, standard API / abstraction for matrix and vector maths in Clojure
• Enable pluggable support for different underlying matrix library implementations
• Provide a general purpose n-dimensional array implementation (NumPy style)
• Provide a foundation layer for other projects (e.g. Incanter)
• Enable best-in-class performance wherever possible

Tutorials / guides

• Getting Started Guide
• The Array Abstraction

Additional information and FAQs

• Vectors vs. Matrices - FAQ on the differences between 1D vectors and 2D matrices
• Broadcasting - how broadcasting works in core.matrix
• Views - what are views, and how to use them
• Matrix Implementations - what core.matrix implementations are currently available?
• Linear Algebra - Linear algebra functions in core.matrix
• vectorz-clj examples - external link to vectorz-clj

Information for core.matrix developers and implementers

Dmitry (si14) has contributed some nice visualizations of core.matrix protocol implementation coverage and performance:

• Implementation coverage
• Performance matrix

Wiki Links:

• core.matrix internals
• Implementation Guide - for people building a core.matrix implementation
• Contributing

Work in progress/ design discussion

These pages contain working ideas, notes and discussions for future development.

• Core design ideas
• Selectors and Indexing
• Sorting
• NDArray Implementation - design notes for Clojure NDArray implementation
• Linear algebra API proposal
• Dataset API proposal