OpenBLAS is an optimized BLAS library based on GotoBLAS2 1.13 BSD version.
FORTRAN Assembly C C++ Makefile CMake Other
Latest commit ab2033f Jan 17, 2017 @xianyi committed on GitHub Merge pull request #1068 from sva-img/develop
Added MSA optimised rot functions.
Permalink
Failed to load latest commit information.
benchmark anti GC and reflow Jan 7, 2017
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 Merge pull request #1061 from ashwinyes/develop_aarch64_vulcan_thunde… Jan 16, 2017
exports removed blas_thread_shutdown from gensymbol Jan 8, 2017
interface updated some level1 funcions, that are not thread save Jan 10, 2017
kernel Added rot functions. Jan 17, 2017
lapack-netlib Split LAPACKE 3.7.0 obj list (take 2) Jan 10, 2017
lapack prepared lapack/lauum for UNROLL values, that are not a power of two Jan 11, 2017
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 make utest/Makefile respect LDFLAGS Oct 12, 2016
.gitignore Update gitignore Oct 26, 2016
.travis.yml Modify travis script. Mar 3, 2016
BACKERS.md Added backers. Sep 5, 2013
CMakeLists.txt Add files via upload Nov 6, 2016
CONTRIBUTORS.md Merge branch 'z13' into develop Jan 9, 2017
Changelog.txt Update doc for 0.2.19. Sep 1, 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 Never use "make" in makefiles. Only $(MAKE). Dec 14, 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 ARM64: Add Cavium THUNDERX2T99 Target Jan 11, 2017
Makefile.generic Respect user's LDFLAGS Jul 25, 2013
Makefile.ia64 Remove all trailing whitespace except lapack-netlib Jun 27, 2014
Makefile.install Merge pull request #1067 from martin-frbg/msysinst Jan 16, 2017
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 Update develop for 0.2.20.dev. Sep 1, 2016
Makefile.sparc Remove all trailing whitespace except lapack-netlib Jun 27, 2014
Makefile.system Apply COMMON_OPT to default FFLAGS to avoid building non-optimized LA… Jan 8, 2017
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
Makefile.zarch dtrmm and dgemm for z13 Jan 4, 2017
README.md Merge branch 'z13' into develop Jan 9, 2017
TargetList.txt ARM64: Add Cavium THUNDERX2T99 Target Jan 11, 2017
USAGE.md collected usage notes Feb 27, 2016
appveyor.yml Bump to 0.2.19.dev. Apr 12, 2016
c_check Merge branch 'z13' into develop Jan 9, 2017
cblas.h Add ATLAS-style ?geadd function Feb 16, 2015
common.h Merge branch 'z13' into develop Jan 9, 2017
common_alpha.h add fallback blas_lock implementation Aug 16, 2015
common_arm.h common_arm.h, common_mips.h: get rid of .func directives Sep 9, 2016
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 Init IBM z system (s390x) porting. Apr 15, 2016
common_macro.h ARM64: Add the VULCAN Target Jan 10, 2017
common_mips.h common_arm.h, common_mips.h: get rid of .func directives Sep 9, 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
common_zarch.h dtrmm and dgemm for z13 Jan 4, 2017
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 Fix for issue #1024: arm-linux-androideabi-g++ Compiler Error in /cpu… Dec 2, 2016
cpuid_arm64.c ARM64: Add Cavium THUNDERX2T99 Target Jan 11, 2017
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 Add files via upload Nov 6, 2016
cpuid_zarch.c dtrmm and dgemm for z13 Jan 4, 2017
ctest.c Merge branch 'z13' into develop Jan 9, 2017
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 Convert --exclude-libs argument to linker flag Nov 22, 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 ARM64: Add Cavium THUNDERX2T99 Target Jan 11, 2017
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
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 ARM64: Add Cavium THUNDERX2T99 Target Jan 11, 2017
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

IBM zEnterprise System:

  • Z13: blas3 for double

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.