OpenBLAS is an optimized BLAS library based on GotoBLAS2 1.13 BSD version.
FORTRAN Assembly C C++ Makefile CMake Other
Permalink
Failed to load latest commit information.
benchmark Add time prints in benchmark output Jul 14, 2016
cmake Replace CMAKE_SOURCE_DIR/CMAKE_BINARY_DIR with PROJECT_SOURCE_DIR/PRO… May 25, 2016
ctest Replace CMAKE_SOURCE_DIR/CMAKE_BINARY_DIR with PROJECT_SOURCE_DIR/PRO… May 25, 2016
driver Update dynamic.c Jul 14, 2016
exports Wrap CURDIR and DESTDIR in quotes May 3, 2016
interface Fix z/ctrmv stack allocation on AMD bulldozer and barcelona target Jun 7, 2016
kernel Refs #946. Use nrm2 reference implementation for Power8. Aug 19, 2016
lapack-netlib MIPS n32 ABI and build time mips simd support check Aug 10, 2016
lapack Replace CMAKE_SOURCE_DIR/CMAKE_BINARY_DIR with PROJECT_SOURCE_DIR/PRO… May 25, 2016
reference Remove all trailing whitespace except lapack-netlib Jun 27, 2014
test Replace CMAKE_SOURCE_DIR/CMAKE_BINARY_DIR with PROJECT_SOURCE_DIR/PRO… May 25, 2016
utest Replace CMAKE_SOURCE_DIR/CMAKE_BINARY_DIR with PROJECT_SOURCE_DIR/PRO… May 25, 2016
.gitignore Delete vi swap file. Nov 10, 2015
.travis.yml Modify travis script. Mar 3, 2016
BACKERS.md Added backers. Sep 5, 2013
CMakeLists.txt Replace CMAKE_SOURCE_DIR/CMAKE_BINARY_DIR with PROJECT_SOURCE_DIR/PRO… May 25, 2016
CONTRIBUTORS.md STRSM optimization for MIPS P5600 and I6400 using MSA May 20, 2016
Changelog.txt Update doc for 0.2.18 version. Apr 12, 2016
GotoBLAS_00License.txt rename documents in GotoBLAS. Jan 24, 2011
GotoBLAS_01Readme.txt Remove all trailing whitespace except lapack-netlib Jun 27, 2014
GotoBLAS_02QuickInstall.txt Remove all trailing whitespace except lapack-netlib Jun 27, 2014
GotoBLAS_03FAQ.txt Remove all trailing whitespace except lapack-netlib Jun 27, 2014
GotoBLAS_04FAQ.txt rename documents in GotoBLAS. Jan 24, 2011
GotoBLAS_05LargePage.txt Correct typo /proc/ instead of /pros/ Mar 20, 2015
GotoBLAS_06WeirdPerformance.txt Remove all trailing whitespace except lapack-netlib Jun 27, 2014
LICENSE Update organization info. Nov 25, 2014
Makefile MIPS n32 ABI and build time mips simd support check Aug 10, 2016
Makefile.alpha Remove all trailing whitespace except lapack-netlib Jun 27, 2014
Makefile.arm Fixed linking error when compiling ARMv7 for Android (disabled -lpthr… Feb 4, 2016
Makefile.arm64 Adding arm64 target CORTEXA57 Nov 9, 2015
Makefile.generic Respect user's LDFLAGS Jul 25, 2013
Makefile.ia64 Remove all trailing whitespace except lapack-netlib Jun 27, 2014
Makefile.install Wrap CURDIR and DESTDIR in quotes May 3, 2016
Makefile.mips MIPS P5600(32 bit) and I6400(64 bit) cores support added. Apr 22, 2016
Makefile.mips64 Import GotoBLAS2 1.13 BSD version codes. Jan 24, 2011
Makefile.power Added support of IBM's MASS library that optimizes performance on Pow… Aug 11, 2016
Makefile.prebuild MIPS n32 ABI support, MSA support detection and rename ARCH, ARCHFLAGS Aug 8, 2016
Makefile.rule added bugfixes for some make files and smallscaling.c Apr 21, 2016
Makefile.sparc Remove all trailing whitespace except lapack-netlib Jun 27, 2014
Makefile.system MIPS n32 ABI and build time mips simd support check Aug 10, 2016
Makefile.tail Remove all trailing whitespace except lapack-netlib Jun 27, 2014
Makefile.x86 Remove all trailing whitespace except lapack-netlib Jun 27, 2014
Makefile.x86_64 Remove all trailing whitespace except lapack-netlib Jun 27, 2014
README.md Added support of IBM's MASS library that optimizes performance on Pow… Aug 11, 2016
TargetList.txt Added MSA optimization for GEMV_N, GEMV_T, ASUM, DOT functions Jul 15, 2016
USAGE.md collected usage notes Feb 27, 2016
appveyor.yml Bump to 0.2.19.dev. Apr 12, 2016
c_check MIPS n32 ABI and build time mips simd support check Aug 10, 2016
cblas.h Add ATLAS-style ?geadd function Feb 16, 2015
common.h Change to allow compiling with USE_OPENMP on MSVC Jun 14, 2016
common_alpha.h add fallback blas_lock implementation Aug 16, 2015
common_arm.h use real armv5 support Aug 16, 2015
common_arm64.h Fix blas_lock for arm64 Nov 19, 2015
common_c.h Improved Ximatcopy when lda==ldb. Sep 7, 2015
common_d.h Improved Ximatcopy when lda==ldb. Sep 7, 2015
common_ia64.h add fallback blas_lock implementation Aug 16, 2015
common_interface.h Add ATLAS-style ?geadd function Feb 16, 2015
common_lapack.h Import GotoBLAS2 1.13 BSD version codes. Jan 24, 2011
common_level1.h Changed _Complex types in common_level1.h to use the typedef. Feb 11, 2015
common_level2.h Remove all trailing whitespace except lapack-netlib Jun 27, 2014
common_level3.h Improved Ximatcopy when lda==ldb. Sep 7, 2015
common_linux.h Remove all trailing whitespace except lapack-netlib Jun 27, 2014
common_macro.h Improved Ximatcopy when lda==ldb. Sep 7, 2015
common_mips.h MIPS P5600(32 bit) and I6400(64 bit) cores support added. Apr 22, 2016
common_mips64.h MIPS P5600(32 bit) and I6400(64 bit) cores support added. Apr 22, 2016
common_param.h Fix DYNAMIC_ARCH=1 bug. Oct 26, 2015
common_power.h optimized dgemm for 20 threads May 16, 2016
common_q.h Import GotoBLAS2 1.13 BSD version codes. Jan 24, 2011
common_reference.h Update organization info. Nov 25, 2014
common_s.h Improved Ximatcopy when lda==ldb. Sep 7, 2015
common_sparc.h add fallback blas_lock implementation Aug 16, 2015
common_stackalloc.h Refs #727. Align stack buffer address on 32-bytes. Feb 10, 2016
common_thread.h Remove all trailing whitespace except lapack-netlib Jun 27, 2014
common_x.h Import GotoBLAS2 1.13 BSD version codes. Jan 24, 2011
common_x86.h Fix a minor compiler error in VisualStudio with CMake Mar 20, 2016
common_x86_64.h Don't pass REALNAME to `.end` Mar 13, 2016
common_z.h Improved Ximatcopy when lda==ldb. Sep 7, 2015
cpuid.S Remove all trailing whitespace except lapack-netlib Jun 27, 2014
cpuid.h Merge branch 'cmake' of https://github.com/hpanderson/OpenBLAS into h… Jul 21, 2015
cpuid_alpha.c Remove all trailing whitespace except lapack-netlib Jun 27, 2014
cpuid_arm.c Detect ARMV8 on 32-bit mode by using ARMV7 kernels. Jan 28, 2016
cpuid_arm64.c Fix compiling bug on ARM Cortex-A57. Feb 13, 2016
cpuid_ia64.c Remove all trailing whitespace except lapack-netlib Jun 27, 2014
cpuid_mips.c MIPS P5600(32 bit) and I6400(64 bit) cores support added. Apr 22, 2016
cpuid_mips64.c Added MSA optimization for GEMV_N, GEMV_T, ASUM, DOT functions Jul 15, 2016
cpuid_power.c added dgemm-, dtrmm-, zgemm- and ztrmm-kernel for power8 Mar 1, 2016
cpuid_sparc.c refs #55. Added DTB_ENTRIES into dynamic arch setting parameters. Now… Sep 5, 2011
cpuid_x86.c Update cpuid_x86.c Jul 14, 2016
ctest.c MIPS P5600(32 bit) and I6400(64 bit) cores support added. Apr 22, 2016
ctest1.c Import GotoBLAS2 1.13 BSD version codes. Jan 24, 2011
ctest2.c Import GotoBLAS2 1.13 BSD version codes. Jan 24, 2011
f_check MIPS n32 ABI support, MSA support detection and rename ARCH, ARCHFLAGS Aug 8, 2016
ftest.f Remove all trailing whitespace except lapack-netlib Jun 27, 2014
ftest2.f Import GotoBLAS2 1.13 BSD version codes. Jan 24, 2011
ftest3.f Remove all trailing whitespace except lapack-netlib Jun 27, 2014
getarch.c Added MSA optimization for GEMV_N, GEMV_T, ASUM, DOT functions Jul 15, 2016
getarch_2nd.c Delete LOCAL_BUFFER_SIZE for other architectures. Apr 12, 2016
l1param.h Added BULLDOZER target. So far it uses barcelona kernels. Dec 6, 2012
l2param.h Support AMD Piledriver by bulldozer kernels. Jul 6, 2013
lapack-devel.log Remove all trailing whitespace except lapack-netlib Jun 27, 2014
make.inc MIPS n32 ABI and build time mips simd support check Aug 10, 2016
openblas_config_template.h Refs #708. Modified config template for MSVC. Dec 4, 2015
param.h MIPS n32 ABI and build time mips simd support check Aug 10, 2016
quickbuild.32bit Import GotoBLAS2 1.13 BSD version codes. Jan 24, 2011
quickbuild.64bit Import GotoBLAS2 1.13 BSD version codes. Jan 24, 2011
quickbuild.win32 Added the tip for Windows. Aug 9, 2012
quickbuild.win64 Refs #63. delete prefix for mingw64 toolchain. Apr 27, 2014
segfaults.patch Remove all trailing whitespace except lapack-netlib Jun 27, 2014
symcopy.h Changed a number of inline calls to use __inline. Feb 11, 2015
version.h Update organization info. Nov 25, 2014

README.md

OpenBLAS

Join the chat at https://gitter.im/xianyi/OpenBLAS

Travis CI: Build Status

AppVeyor: Build status

Introduction

OpenBLAS is an optimized BLAS library based on GotoBLAS2 1.13 BSD version.

Please read the documents on OpenBLAS wiki pages http://github.com/xianyi/OpenBLAS/wiki.

Binary Packages

We provide binary packages for the following platform.

  • Windows x86/x86_64

You can download them from file hosting on sourceforge.net.

Installation from Source

Download from project homepage. http://xianyi.github.com/OpenBLAS/

Or, check out codes from git://github.com/xianyi/OpenBLAS.git

Normal compile

  • type "make" to detect the CPU automatically. or
  • type "make TARGET=xxx" to set target CPU, e.g. "make TARGET=NEHALEM". The full target list is in file TargetList.txt.

Cross compile

Please set CC and FC with the cross toolchains. Then, set HOSTCC with your host C compiler. At last, set TARGET explicitly.

Examples:

On X86 box, compile this library for loongson3a CPU.

make BINARY=64 CC=mips64el-unknown-linux-gnu-gcc FC=mips64el-unknown-linux-gnu-gfortran HOSTCC=gcc TARGET=LOONGSON3A

On X86 box, compile this library for loongson3a CPU with loongcc (based on Open64) compiler.

make CC=loongcc FC=loongf95 HOSTCC=gcc TARGET=LOONGSON3A CROSS=1 CROSS_SUFFIX=mips64el-st-linux-gnu-   NO_LAPACKE=1 NO_SHARED=1 BINARY=32

Debug version

make DEBUG=1

Compile with MASS Support on Power CPU (Optional dependency)

IBM MASS library consists of a set of mathematical functions for C, C++, and Fortran-language applications that are tuned for optimum performance on POWER architectures. OpenBLAS with MASS requires 64-bit, little-endian OS on POWER. The library can be installed as below -

After installing MASS library, compile openblas with USE_MASS=1.

Example:

Compiling on Power8 with MASS support -

make USE_MASS=1 TARGET=POWER8

Install to the directory (optional)

Example:

make install PREFIX=your_installation_directory

The default directory is /opt/OpenBLAS

Support CPU & OS

Please read GotoBLAS_01Readme.txt

Additional support CPU:

x86/x86-64:

  • Intel Xeon 56xx (Westmere): Used GotoBLAS2 Nehalem codes.
  • Intel Sandy Bridge: Optimized Level-3 and Level-2 BLAS with AVX on x86-64.
  • Intel Haswell: Optimized Level-3 and Level-2 BLAS with AVX2 and FMA on x86-64.
  • AMD Bobcat: Used GotoBLAS2 Barcelona codes.
  • AMD Bulldozer: x86-64 ?GEMM FMA4 kernels. (Thank Werner Saar)
  • AMD PILEDRIVER: Uses Bulldozer codes with some optimizations.
  • AMD STEAMROLLER: Uses Bulldozer codes with some optimizations.

MIPS64:

  • ICT Loongson 3A: Optimized Level-3 BLAS and the part of Level-1,2.
  • ICT Loongson 3B: Experimental

ARM:

  • ARMV6: Optimized BLAS for vfpv2 and vfpv3-d16 ( e.g. BCM2835, Cortex M0+ )
  • ARMV7: Optimized BLAS for vfpv3-d32 ( e.g. Cortex A8, A9 and A15 )

ARM64:

  • ARMV8: Experimental
  • ARM Cortex-A57: Experimental

Support OS:

Usages

Link with libopenblas.a or -lopenblas for shared library.

Set the number of threads with environment variables.

Examples:

export OPENBLAS_NUM_THREADS=4

or

export GOTO_NUM_THREADS=4

or

export OMP_NUM_THREADS=4

The priorities are OPENBLAS_NUM_THREADS > GOTO_NUM_THREADS > OMP_NUM_THREADS.

If you compile this lib with USE_OPENMP=1, you should set OMP_NUM_THREADS environment variable. OpenBLAS ignores OPENBLAS_NUM_THREADS and GOTO_NUM_THREADS with USE_OPENMP=1.

Set the number of threads on runtime.

We provided the below functions to control the number of threads on runtime.

void goto_set_num_threads(int num_threads);

void openblas_set_num_threads(int num_threads);

If you compile this lib with USE_OPENMP=1, you should use the above functions, too.

Report Bugs

Please add a issue in https://github.com/xianyi/OpenBLAS/issues

Contact

ChangeLog

Please see Changelog.txt to obtain the differences between GotoBLAS2 1.13 BSD version.

Troubleshooting

  • Please read Faq at first.
  • Please use gcc version 4.6 and above to compile Sandy Bridge AVX kernels on Linux/MingW/BSD.
  • Please use Clang version 3.1 and above to compile the library on Sandy Bridge microarchitecture. The Clang 3.0 will generate the wrong AVX binary code.
  • The number of CPUs/Cores should less than or equal to 256. On Linux x86_64(amd64), there is experimental support for up to 1024 CPUs/Cores and 128 numa nodes if you build the library with BIGNUMA=1.
  • OpenBLAS does not set processor affinity by default. On Linux, you can enable processor affinity by commenting the line NO_AFFINITY=1 in Makefile.rule. But this may cause the conflict with R parallel.
  • On Loongson 3A. make test would be failed because of pthread_create error. The error code is EAGAIN. However, it will be OK when you run the same testcase on shell.

Contributing

  1. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
  2. Fork the OpenBLAS repository to start making your changes.
  3. Write a test which shows that the bug was fixed or that the feature works as expected.
  4. Send a pull request. Make sure to add yourself to CONTRIBUTORS.md.

Donation

Please read this wiki page.