Skip to content
OpenBLAS is an optimized BLAS library based on GotoBLAS2 1.13 BSD version.
FORTRAN Assembly C C++ Makefile CMake Other
Latest commit e3b7781 @xianyi Update readme.
Failed to load latest commit information.
benchmark Add benchmark/smallscaling.c
cmake Added mising lapacke files for CMake.
ctest Fix output descriptors of c_{s,d,c,z}blat3
driver Add gemm3m building for CMake.
exports Refs #707. Bugfix for previous commit.
interface Fix zgemv.c compilation when stack allocation is disabled
kernel Add gemm3m building for CMake.
lapack-netlib Restored LAPACK_COMPLEX_STRUCTURE for Android prior to 21. Refs #682.
lapack Fix lapack complex implementation of lauu2 and potf2 for Android (use…
reference Remove all trailing whitespace except lapack-netlib
test Detect cmake test result.
utest Enable utest for appveyor.
.gitignore Delete vi swap file.
.travis.yml Use ctest.h for unit test. Enable unit test on travis CI.
BACKERS.md Added backers.
CMakeLists.txt Enable utest for appveyor.
CONTRIBUTORS.md update CONTRIBUTORS.md
Changelog.txt Update doc for OpenBLAS 0.2.15 version. [CI skipped]
GotoBLAS_00License.txt rename documents in GotoBLAS.
GotoBLAS_01Readme.txt Remove all trailing whitespace except lapack-netlib
GotoBLAS_02QuickInstall.txt Remove all trailing whitespace except lapack-netlib
GotoBLAS_03FAQ.txt Remove all trailing whitespace except lapack-netlib
GotoBLAS_04FAQ.txt rename documents in GotoBLAS.
GotoBLAS_05LargePage.txt Correct typo /proc/ instead of /pros/
GotoBLAS_06WeirdPerformance.txt Remove all trailing whitespace except lapack-netlib
LICENSE Update organization info.
Makefile Run utest when building.
Makefile.alpha Remove all trailing whitespace except lapack-netlib
Makefile.arm Fixed linking error when compiling ARMv7 for Android (disabled -lpthr…
Makefile.arm64 Adding arm64 target CORTEXA57
Makefile.generic Respect user's LDFLAGS
Makefile.ia64 Remove all trailing whitespace except lapack-netlib
Makefile.install Merge pull request #749 from lotheac/illumos_fixes
Makefile.mips64 Import GotoBLAS2 1.13 BSD version codes.
Makefile.power Remove all trailing whitespace except lapack-netlib
Makefile.prebuild get rid of the generated cblas_noconst.h file
Makefile.rule Run utest when building.
Makefile.sparc Remove all trailing whitespace except lapack-netlib
Makefile.system Fixed linking error when compiling ARMv7 for Android (disabled -lpthr…
Makefile.tail Remove all trailing whitespace except lapack-netlib
Makefile.x86 Remove all trailing whitespace except lapack-netlib
Makefile.x86_64 Remove all trailing whitespace except lapack-netlib
README.md Update readme.
TargetList.txt Adding arm64 target CORTEXA57
appveyor.yml Enable utest for appveyor.
c_check Fix detection of POWER architecture in c_check.
cblas.h Add ATLAS-style ?geadd function
common.h Fixed #773 blas_quickdivide bug on CMake and Visual Studio x86 32-bit.
common_alpha.h add fallback blas_lock implementation
common_arm.h use real armv5 support
common_arm64.h Fix blas_lock for arm64
common_c.h Improved Ximatcopy when lda==ldb.
common_d.h Improved Ximatcopy when lda==ldb.
common_ia64.h add fallback blas_lock implementation
common_interface.h Add ATLAS-style ?geadd function
common_lapack.h Import GotoBLAS2 1.13 BSD version codes.
common_level1.h Changed _Complex types in common_level1.h to use the typedef.
common_level2.h Remove all trailing whitespace except lapack-netlib
common_level3.h Improved Ximatcopy when lda==ldb.
common_linux.h Remove all trailing whitespace except lapack-netlib
common_macro.h Improved Ximatcopy when lda==ldb.
common_mips64.h add fallback blas_lock implementation
common_param.h Fix DYNAMIC_ARCH=1 bug.
common_power.h add fallback blas_lock implementation
common_q.h Import GotoBLAS2 1.13 BSD version codes.
common_reference.h Update organization info.
common_s.h Improved Ximatcopy when lda==ldb.
common_sparc.h add fallback blas_lock implementation
common_stackalloc.h Refs #727. Align stack buffer address on 32-bytes.
common_thread.h Remove all trailing whitespace except lapack-netlib
common_x.h Import GotoBLAS2 1.13 BSD version codes.
common_x86.h Fixed #773 blas_quickdivide bug on CMake and Visual Studio x86 32-bit.
common_x86_64.h Merge branch 'develop' into cmake
common_z.h Improved Ximatcopy when lda==ldb.
cpuid.S Remove all trailing whitespace except lapack-netlib
cpuid.h Merge branch 'cmake' of https://github.com/hpanderson/OpenBLAS into h…
cpuid_alpha.c Remove all trailing whitespace except lapack-netlib
cpuid_arm.c Detect ARMV8 on 32-bit mode by using ARMV7 kernels.
cpuid_arm64.c Adding arm64 target CORTEXA57
cpuid_ia64.c Remove all trailing whitespace except lapack-netlib
cpuid_mips.c Update organization info.
cpuid_power.c Add POWER7/POWER8 as targets
cpuid_sparc.c refs #55. Added DTB_ENTRIES into dynamic arch setting parameters. Now…
cpuid_x86.c Update dynamic.c and cpuid_x86.c for Intel Avoton.
ctest.c Support Android NDK armeabi-v7a-hard ABI. (-mfloat-abi=hard)
ctest1.c Import GotoBLAS2 1.13 BSD version codes.
ctest2.c Import GotoBLAS2 1.13 BSD version codes.
f_check don't pass -Y at all to the linker on illumos
ftest.f Remove all trailing whitespace except lapack-netlib
ftest2.f Import GotoBLAS2 1.13 BSD version codes.
ftest3.f Remove all trailing whitespace except lapack-netlib
getarch.c Merge pull request #749 from lotheac/illumos_fixes
getarch_2nd.c Remove all trailing whitespace except lapack-netlib
l1param.h Added BULLDOZER target. So far it uses barcelona kernels.
l2param.h Support AMD Piledriver by bulldozer kernels.
lapack-devel.log Remove all trailing whitespace except lapack-netlib
make.inc added optimized dsymv kernels for haswell
openblas_config_template.h Refs #708. Modified config template for MSVC.
param.h added updates for syrk and syr2k
quickbuild.32bit Import GotoBLAS2 1.13 BSD version codes.
quickbuild.64bit Import GotoBLAS2 1.13 BSD version codes.
quickbuild.win32 Added the tip for Windows.
quickbuild.win64 Refs #63. delete prefix for mingw64 toolchain.
segfaults.patch Remove all trailing whitespace except lapack-netlib
symcopy.h Changed a number of inline calls to use __inline.
version.h Update organization info.

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

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.

Something went wrong with that request. Please try again.