Library for Numerical Methods. It binds to LAPACK and is unashamedly inspired by Numpy
HEAD Latest release released
43 7 2
Martin Verzilli


Build status

Crystalla is a Numerical Methods library for the Crystal programming language. It binds to LAPACK and looks to Numpy for API and design ideas.

Works on OSX and Ubuntu, using the Accelerate framework and liblapack+libblas respectively.


Add this to your application's shard.yml:

    github: mverzilli/crystalla

On Ubuntu, you may need to install the following packages:

liblapack-dev liblapack-doc-man liblapack-doc liblapack-pic liblapack3 liblapack-test liblapack3gf liblapacke liblapacke-dev libblas-dev libblas-doc liblapacke-dev liblapack-doc


require "crystalla"

# Matrixes are created from column arrays
m = Crystalla::Matrix.columns [[1.0, 2.0], [3.0, 4.0]]

puts "This is how M looks now: "
puts m

puts "This is M's inverse (note it's inverted in place): "
puts m


This is how M looks now:
Matrix[[ 1, 3 ],
       [ 2, 4 ]]

This is M's inverse (note it's inverted in place):
Matrix[[ -2,  1.5 ],
       [  1, -0.5 ]]

Features implemented so far

  • Load matrices from space separated plain text files.
  • Create constant matrices.
  • Add rows at an arbitrary position (non-destructive).
  • Compare two matrices value-by-value: exact match or closeness (given absolute and relative epsilon values).
  • Invert matrices (destructive).
  • Solve linear equations systems.
  • Singular Value Decomposition.


Development on OSX works out of the box. To try the library on Ubuntu from OSX, you can use the associated docker image, and run it mounting crystalla. First, build the image:

docker build -t mverzilli/crystalla .

And fire up a new container by running:

docker run --rm -it -v `pwd`:/opt/crystalla mverzilli/crystalla

You can run crystal spec to check everything is working fine.


  1. Fork it ( )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request


  • @mverzilli( Martin Verzilli - creator, maintainer
  github: mverzilli/crystalla
License MIT
Crystal none


Dependencies 0

Development Dependencies 0

Dependents 0

Last synced .
search fire star recently