Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/scalanlp/breeze
Breeze is/was a numerical processing library for Scala.
https://github.com/scalanlp/breeze
Last synced: 11 days ago
JSON representation
Breeze is/was a numerical processing library for Scala.
- Host: GitHub
- URL: https://github.com/scalanlp/breeze
- Owner: scalanlp
- License: apache-2.0
- Created: 2009-07-08T23:22:52.000Z (over 15 years ago)
- Default Branch: master
- Last Pushed: 2024-08-29T06:08:38.000Z (2 months ago)
- Last Synced: 2024-10-14T18:22:03.263Z (25 days ago)
- Language: Scala
- Homepage: https://www.scalanlp.org
- Size: 26.2 MB
- Stars: 3,448
- Watchers: 206
- Forks: 693
- Open Issues: 90
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-scala - **breeze** - activity/y/scalanlp/breeze) (Table of Contents / Science and Data Analysis)
README
## Breeze is mostly retired at this point.
I (@dlwh) will review bug fix PRs and sometimes answer questions, but that's about all I can offer. If someone wants to take of the reins I'd be happy to hand it off.
# Breeze [](https://travis-ci.org/scalanlp/breeze)
Breeze is a library for numerical processing. It aims to be generic, clean, and powerful without sacrificing (much) efficiency.
This is the 2.x branch. The 1.x branch is `1.x`.
The latest release is 2.1.0, which is cross-built against Scala 3.1, 2.12, and 2.13.
## Documentation
* https://github.com/scalanlp/breeze/wiki/Quickstart
* https://github.com/scalanlp/breeze/wiki/Linear-Algebra-Cheat-Sheet
* [Scaladoc](http://www.scalanlp.org/api/breeze/) (Scaladoc is typically horribly out of date, and not a good way to learn Breeze.)
* There is also the [scala-breeze google group](https://groups.google.com/forum/#!forum/scala-breeze) for general questions and discussion.
## Using Breeze
### Building it yourself
This project can be built with SBT 1.2+
### SBT
For SBT, add these lines to your SBT project definition:
```scala
libraryDependencies ++= Seq(
// Last stable release
"org.scalanlp" %% "breeze" % "2.1.0",
// The visualization library is distributed separately as well.
// It depends on LGPL code
"org.scalanlp" %% "breeze-viz" % "2.1.0"
)
```
Previous versions of Breeze included a "breeze-natives" artifact that bundled various native libraries. As of Breeze 1.3, we now use a faster, more friendly-licensed library from @luhenry called simply "[netlib](https://github.com/luhenry/netlib)". This library is now bundled by default.
### Maven
Maven looks like this:
```xml
org.scalanlp
breeze_2.13
2.1.0
```
### Other build tools
[http://mvnrepository.com/artifact/org.scalanlp/breeze_2.12/2.1.0] (as an example) is a great resource for finding other configuration examples for other build tools.
See documentation (linked above!) for more information on using Breeze.
## History
Breeze is the merger of the ScalaNLP and Scalala projects, because one of the original maintainers is unable to continue development. The Scalala parts are largely rewritten.
(c) David Hall, 2009 -
Portions (c) Daniel Ramage, 2009 - 2011
Contributions from:
* Jason Zaugg (@retronym)
* Alexander Lehmann (@afwlehmann)
* Jonathan Merritt (@lancelet)
* Keith Stevens (@fozziethebeat)
* Jason Baldridge (@jasonbaldridge)
* Timothy Hunter (@tjhunter)
* Dave DeCaprio (@DaveDeCaprio)
* Daniel Duckworth (@duckworthd)
* Eric Christiansen (@emchristiansen)
* Marc Millstone (@splittingfield)
* Mérő László (@laci37)
* Alexey Noskov (@alno)
* Devon Bryant (@devonbryant)
* Kentaroh Takagaki (@ktakagaki)
* Sam Halliday (@fommil)
* Chris Stucchio (@stucchio)
* Xiangrui Meng (@mengxr)
* Gabriel Schubiner (@gabeos)
* Debasish Das (@debasish83)
* Julien Dumazert (@DumazertJulien)
* Matthias Langer (@bashimao)
* Mohamed Kafsi (@mou7)
* Max Thomas (@maxthomas)
* @qilab
* Weichen Xu (@WeichenXu123)
* Sergei Lebedev (@superbobry)
* Zac Blanco (@ZacBlanco)
Corporate (Code) Contributors:
* [Semantic Machines](http://www.semanticmachines.com/) (@semanticmachines)
* [ContentSquare](http://www.contentsquare.com/en/)
* Big Data Analytics, Verizon Lab, Palo Alto
* [crealytics GmbH, Berlin/Passau, Germany](https://crealytics.com/)
And others (contact David Hall if you've contributed and aren't listed).
## Common Issues
### Segmentation Fault or Other Crashes on Linux
Netlib, the new low level BLAS library Breeze uses, in turn uses OpenBLAS by default on Linux, which has some quirky behavior w.r.t. threading. (Please see https://github.com/luhenry/netlib/issues/2).
As work arounds:
* Use MKL, if possible
* Increase the size of the stack of Java threads with `-Xss10M` (set the Java threads' stack size to 10 Mbytes)
* Make sure OpenBLAS doesn't use the parallel implementation by defining the environment variable `OPENBLAS_NUM_THREADS=1`
* Compile a custom version of OpenBLAS that unconditionally define `USE_ALLOC_HEAP` at https://github.com/xianyi/OpenBLAS/blob/develop/lapack/getrf/getrf_parallel.c#L49