dpnp
pypi i dpnp

dpnp

NumPy drop-in replacement for Intel(R) XPUs

by IntelPython

0.9.0 (see all)License:BSD
pypi i dpnp
Readme

Build Status codecov Build Sphinx

DPNP: NumPy Drop-In Replacement for Intel(R) XPU

API coverage summary

Full documentation

DPNP C++ backend documentation

The project contains:

  • Python interface with NumPy-like API
  • C++ library with SYCL based kernels

How to run

By default main CPU SYCL queue is used. To use Intel GPU please use:

DPNP_QUEUE_GPU=1 python examples/example1.py

Build from source:

git clone https://github.com/IntelPython/dpnp
cd dpnp
./0.build.sh

Install Wheel Package from Pypi

Install DPNP

python -m pip install --index-url https://pypi.anaconda.org/intel/simple -extra-index-url https://pypi.org/simple dpnp

Note: DPNP wheel package is placed on Pypi, but some of its dependencies (like Intel numpy) are in Anaconda Cloud. That is why install command requires additional intel Pypi channel from Anaconda Cloud.

Set path to Performance Libraries in case of using venv or system Python:

export LD_LIBRARY_PATH=<path_to_your_env>/lib

It is also required to set following environment variables:

export OCL_ICD_FILENAMES_RESET=1
export OCL_ICD_FILENAMES=libintelocl.so

Run test

. ./0.env.sh
pytest
# or
pytest tests/test_matmul.py -s -v
# or
python -m unittest tests/test_mixins.py

Run numpy external test

. ./0.env.sh
python -m tests.third_party.numpy_ext
# or
python -m tests.third_party.numpy_ext core/tests/test_umath.py
# or
python -m tests.third_party.numpy_ext core/tests/test_umath.py::TestHypot::test_simple

Building documentation:

Prerequisites:
$ conda install sphinx sphinx_rtd_theme
Building:
1. Install dpnp into your python environment
2. $ cd doc && make html
3. The documentation will be in doc/_build/html

Packaging:

. ./0.env.sh
conda-build conda-recipe/

Run benchmark:

cd benchmarks/

asv run --python=python --bench <filename without .py>
# example:
asv run --python=python --bench bench_elementwise

# or

asv run --python=python --bench <class>.<bench>
# example:
asv run --python=python --bench Elementwise.time_square

# add --quick option to run every case once but looks like first execution has additional overheads and takes a lot of time (need to be investigated)

Tests matrix:

#NameOSdistributiveinterpreterpython used fromSYCL queue managerbuild commands setforced environment
1Ubuntu 20.04 Python37LinuxUbuntu 20.04Python 3.7IntelOneAPIlocalexport DPNP_DEBUG=1 python setup.py clean python setup.py build_clib python setup.py build_ext --inplace pytestcmake-3.19.2, valgrind, pytest-valgrind, conda-build, pytest, hypothesis
2Ubuntu 20.04 Python38LinuxUbuntu 20.04Python 3.8IntelOneAPIlocalexport DPNP_DEBUG=1 python setup.py clean python setup.py build_clib python setup.py build_ext --inplace pytestcmake-3.19.2, valgrind, pytest-valgrind, conda-build, pytest, hypothesis
3Ubuntu 20.04 Python39LinuxUbuntu 20.04Python 3.9IntelOneAPIlocalexport DPNP_DEBUG=1 python setup.py clean python setup.py build_clib python setup.py build_ext --inplace pytestcmake-3.19.2, valgrind, pytest-valgrind, conda-build, pytest, hypothesis
4Ubuntu 20.04 External Tests Python37LinuxUbuntu 20.04Python 3.7IntelOneAPIlocalexport DPNP_DEBUG=1 python setup.py clean python setup.py build_clib python setup.py build_ext --inplace python -m tests_external.numpy.runtestscmake-3.19.2, valgrind, pytest-valgrind, conda-build, pytest, hypothesis
5Ubuntu 20.04 External Tests Python38LinuxUbuntu 20.04Python 3.8IntelOneAPIlocalexport DPNP_DEBUG=1 python setup.py clean python setup.py build_clib python setup.py build_ext --inplace python -m tests_external.numpy.runtestscmake-3.19.2, valgrind, pytest-valgrind, conda-build, pytest, hypothesis
6Ubuntu 20.04 External Tests Python39LinuxUbuntu 20.04Python 3.9IntelOneAPIlocalexport DPNP_DEBUG=1 python setup.py clean python setup.py build_clib python setup.py build_ext --inplace python -m tests_external.numpy.runtestscmake-3.19.2, valgrind, pytest-valgrind, conda-build, pytest, hypothesis
7Code styleLinuxUbuntu 20.04Python 3.8IntelOneAPIlocalpython ./setup.py stylecmake-3.19.2, valgrind, pytest-valgrind, conda-build, pytest, hypothesis, conda-verify, pycodestyle, autopep8, black
8ValgrindLinuxUbuntu 20.04IntelOneAPIlocalexport DPNP_DEBUG=1 python setup.py clean python setup.py build_clib python setup.py build_ext --inplacecmake-3.19.2, valgrind, pytest-valgrind, conda-build, pytest, hypothesis
9Code coverageLinuxUbuntu 20.04Python 3.8IntelOneAPIlocalexport DPNP_DEBUG=1 python setup.py clean python setup.py build_clib python setup.py build_ext --inplacecmake-3.19.2, valgrind, pytest-valgrind, conda-build, pytest, hypothesis, conda-verify, pycodestyle, autopep8, pytest-cov

GitHub Stars

31

LAST COMMIT

9mos ago

MAINTAINERS

1

CONTRIBUTORS

19

OPEN ISSUES

50

OPEN PRs

25
VersionTagPublished
0.9.0
9mos ago
0.6.2
1yr ago
0.5.1
1yr ago
No alternatives found
No tutorials found
Add a tutorial