|
| 1 | +# BLAS / LAPACK selection |
1 | 2 | option('blas', type: 'string', value: 'auto', |
2 | | - description: 'Option for BLAS library selection. By default, try to find any in the order given by `blas-order`') |
| 3 | + description: 'BLAS library to use (default: autodetect based on `blas-order`)') |
3 | 4 | option('lapack', type: 'string', value: 'auto', |
4 | | - description: 'Option for LAPACK library selection. By default, try to find any in the order given by `lapack-order`') |
| 5 | + description: 'LAPACK library to use (default: autodetect based on `lapack-order`)') |
5 | 6 | option('allow-noblas', type: 'boolean', value: true, |
6 | | - description: 'If set to true, allow building with (slow!) internal fallback routines') |
| 7 | + description: 'Allow building with (slow!) internal fallback routines if no BLAS library is found') |
7 | 8 | option('blas-order', type: 'array', value: ['auto'], |
8 | | - description: 'Order of BLAS libraries to search for. E.g.: mkl,openblas,blis,blas') |
| 9 | + description: 'Preferred search order for BLAS libraries (e.g., mkl, openblas, blis, blas)') |
9 | 10 | option('lapack-order', type: 'array', value: ['auto'], |
10 | | - description: 'Order of LAPACK libraries to search for. E.g.: mkl,openblas,lapack') |
| 11 | + description: 'Preferred search order for LAPACK libraries (e.g., mkl, openblas, lapack)') |
11 | 12 | option('use-ilp64', type: 'boolean', value: false, |
12 | | - description: 'Use ILP64 (64-bit integer) BLAS and LAPACK interfaces') |
| 13 | + description: 'Use ILP64 (64-bit integer) BLAS/LAPACK interfaces') |
13 | 14 | option('blas-symbol-suffix', type: 'string', value: 'auto', |
14 | | - description: 'BLAS and LAPACK symbol suffix to use, if any') |
15 | | -option('mkl-threading', type: 'string', value: 'auto', |
16 | | - description: 'MKL threading method, one of: `seq`, `iomp`, `gomp`, `tbb`') |
17 | | -option('disable-svml', type: 'boolean', value: false, |
18 | | - description: 'Disable building against SVML') |
19 | | -option('disable-highway', type: 'boolean', value: false, |
20 | | - description: 'Disables SIMD-optimized operations related to Google Highway') |
21 | | -option('disable-intel-sort', type: 'boolean', value: false, |
22 | | - description: 'Disables SIMD-optimized operations related to Intel x86-simd-sort') |
| 15 | + description: 'Symbol suffix for BLAS/LAPACK symbols (if any)') |
| 16 | +option('mkl-threading', type: 'combo', value: 'auto', |
| 17 | + choices: ['auto', 'seq', 'iomp', 'gomp', 'tbb'], |
| 18 | + description: 'Threading backend for MKL') |
| 19 | + |
| 20 | +# Threading & parallelism |
23 | 21 | option('disable-threading', type: 'boolean', value: false, |
24 | 22 | description: 'Disable threading support (see `NPY_ALLOW_THREADS` docs)') |
25 | 23 | option('enable-openmp', type: 'boolean', value: false, |
26 | | - description: 'Enable building NumPy with openmp support') |
| 24 | + description: 'Enable compilation with OpenMP support') |
| 25 | + |
| 26 | +# CPU optimization / SIMD |
27 | 27 | option('disable-optimization', type: 'boolean', value: false, |
28 | | - description: 'Disable CPU optimized code (dispatch,simd,unroll...)') |
| 28 | + description: 'Disable all CPU optimizations (dispatch, SIMD, loop unrolling)') |
| 29 | +option('disable-svml', type: 'boolean', value: false, |
| 30 | + description: 'Disable use of Intel SVML') |
| 31 | +option('disable-highway', type: 'boolean', value: false, |
| 32 | + description: 'Disable SIMD-optimized operations related to Google Highway') |
| 33 | +option('disable-intel-sort', type: 'boolean', value: false, |
| 34 | + description: 'Disable SIMD-optimized operations related to Intel x86-simd-sort') |
29 | 35 | option('cpu-baseline', type: 'string', value: 'min', |
30 | | - description: 'Minimal set of required CPU features') |
| 36 | + description: 'Minimal set of required CPU features') |
31 | 37 | option('cpu-baseline-detect', type: 'feature', value: 'auto', |
32 | | - description: 'Detect CPU baseline from the compiler flags') |
| 38 | + description: 'Detect CPU baseline from the compiler flags') |
33 | 39 | option('cpu-dispatch', type: 'string', value: 'max', |
34 | | - description: 'Dispatched set of additional CPU features') |
| 40 | + description: 'Additional CPU features to dispatch to (beyond baseline)') |
| 41 | + |
| 42 | +# SIMD test options |
35 | 43 | option('test-simd', type: 'array', |
36 | | - value: [ |
37 | | - 'BASELINE', 'X86_V2', 'X86_V3', 'X86_V4', |
38 | | - 'VSX', 'VSX2', 'VSX3', 'VSX4', |
39 | | - 'NEON', 'ASIMD', |
40 | | - 'VX', 'VXE', 'VXE2', |
41 | | - 'LSX', |
42 | | - ], |
43 | | - description: 'Specify a list of CPU features to be tested against NumPy SIMD interface') |
| 44 | + value: [ |
| 45 | + 'BASELINE', 'X86_V2', 'X86_V3', 'X86_V4', |
| 46 | + 'VSX', 'VSX2', 'VSX3', 'VSX4', |
| 47 | + 'NEON', 'ASIMD', |
| 48 | + 'VX', 'VXE', 'VXE2', |
| 49 | + 'LSX', |
| 50 | + ], |
| 51 | + description: 'CPU SIMD feature sets to be tested by the NumPy SIMD test module') |
44 | 52 | option('test-simd-args', type: 'string', value: '', |
45 | | - description: 'Extra args to be passed to the `_simd` module that is used for testing the NumPy SIMD interface') |
| 53 | + description: 'Extra arguments passed to the internal `_simd` test module') |
0 commit comments