4 OpenBLAS is an optimized BLAS library based on GotoBLAS2 1.13 BSD version. OpenBLAS is an open source project supported by Lab of Parallel Software and Computational Science, ISCAS <http://www.rdcps.ac.cn>.
6 Please read the documents on OpenBLAS wiki pages<http://github.com/xianyi/OpenBLAS/wiki>.
9 Download from project homepage. http://xianyi.github.com/OpenBLAS/
11 check out codes from git://github.com/xianyi/OpenBLAS.git
13 * type "make" to detect the CPU automatically.
15 * type "make TARGET=xxx" to set target CPU, e.g. "make TARGET=NEHALEM". The full target list is in file TargetList.txt.
18 Please set CC and FC with the cross toolchains. Then, set HOSTCC with your host C compiler. At last, set TARGET explicitly.
22 On X86 box, compile this library for loongson3a CPU.
24 make BINARY=64 CC=mips64el-unknown-linux-gnu-gcc FC=mips64el-unknown-linux-gnu-gfortran HOSTCC=gcc TARGET=LOONGSON3A
30 ### Intall to the directory (Optional)
34 make install PREFIX=your_installation_directory
36 The default directory is /opt/OpenBLAS
39 Please read GotoBLAS_01Readme.txt
41 Additional support CPU:
43 Intel Xeon 56xx (Westmere) //Used GotoBLAS2 Nehalem codes.
47 ICT Loongson 3B (Experimental)
50 Link with libopenblas.a or -lopenblas for shared library.
52 ### Set the number of threads with environment variables.
55 export OPENBLAS_NUM_THREADS=4
59 export GOTO_NUM_THREADS=4
63 export OMP_NUM_THREADS=4
65 The priorities are OPENBLAS_NUM_THREADS > GOTO_NUM_THREADS > OMP_NUM_THREADS.
67 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.
69 ### Set the number of threads with calling functions.
72 void goto_set_num_threads(int num_threads);
73 void openblas_set_num_threads(int num_threads);
75 If you compile this lib with USE_OPENMP=1, you should use the above functions, too.
78 Please add a issue in https://github.com/xianyi/OpenBLAS/issues
81 OpenBLAS users mailing list: http://list.rdcps.ac.cn/mailman/listinfo/openblas
84 Please see Changelog.txt to obtain the differences between GotoBLAS2 1.13 BSD version.
87 * Please use gcc version 4.6 and above to compile Sandy Bridge AVX kernels on Linux/MingW/BSD.
88 * 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.
89 * The number of CPUs/Cores should less than or equal to 256.
90 * 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.
92 ## Specification of Git Branches
93 We used the git branching model in this article (http://nvie.com/posts/a-successful-git-branching-model/).
94 Now, there are 4 branches in github.com.
95 * The master branch. This a main branch to reflect a production-ready state.
96 * The develop branch. This a main branch to reflect a state with the latest delivered development changes for the next release.
97 * The loongson3a branch. This is a feature branch. We develop Loongson3A codes on this branch. We will merge this feature to develop branch in future.
98 * The gh-pages branch. This is for web pages