1414 </ script >
1515
1616 < meta name ="viewport " content ="width=device-width, initial-scale=1.0 " />
17- < title > dpnp.dpnp_iface_bitwise — Data Parallel Extension for NumPy 0.18.0dev0+23.gf9f647b65d1 documentation</ title >
17+ < title > dpnp.dpnp_iface_bitwise — Data Parallel Extension for NumPy 0.18.0dev0+26.g1fd1280c774 documentation</ title >
1818 < link rel ="stylesheet " type ="text/css " href ="../../_static/pygments.css?v=03e43079 " />
1919 < link rel ="stylesheet " type ="text/css " href ="../../_static/css/theme.css?v=e59714d7 " />
2020
2121
2222 < script src ="../../_static/jquery.js?v=5d32c60e "> </ script >
2323 < script src ="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c "> </ script >
24- < script src ="../../_static/documentation_options.js?v=ad9b0314 "> </ script >
24+ < script src ="../../_static/documentation_options.js?v=d0fa21e9 "> </ script >
2525 < script src ="../../_static/doctools.js?v=9bcbadda "> </ script >
2626 < script src ="../../_static/sphinx_highlight.js?v=dc90522c "> </ script >
2727 < script src ="../../_static/js/theme.js "> </ script >
@@ -110,7 +110,7 @@ <h1>Source code for dpnp.dpnp_iface_bitwise</h1><div class="highlight"><pre>
110110< span class ="c1 "> # *****************************************************************************</ span >
111111
112112< span class ="sd "> """</ span >
113- < span class ="sd "> Interface of the Binary operations of the DPNP</ span >
113+ < span class ="sd "> Interface of the Bitwise part of the DPNP</ span >
114114
115115< span class ="sd "> Notes</ span >
116116< span class ="sd "> -----</ span >
@@ -123,16 +123,18 @@ <h1>Source code for dpnp.dpnp_iface_bitwise</h1><div class="highlight"><pre>
123123< span class ="sd "> """</ span >
124124
125125< span class ="c1 "> # pylint: disable=protected-access</ span >
126-
126+ < span class =" c1 " > # pylint: disable=no-name-in-module </ span >
127127
128128< span class ="kn "> import</ span > < span class ="w "> </ span > < span class ="nn "> dpctl.tensor._tensor_elementwise_impl</ span > < span class ="w "> </ span > < span class ="k "> as</ span > < span class ="w "> </ span > < span class ="nn "> ti</ span >
129129< span class ="kn "> import</ span > < span class ="w "> </ span > < span class ="nn "> numpy</ span >
130130
131+ < span class ="kn "> import</ span > < span class ="w "> </ span > < span class ="nn "> dpnp.backend.extensions.ufunc._ufunc_impl</ span > < span class ="w "> </ span > < span class ="k "> as</ span > < span class ="w "> </ span > < span class ="nn "> ufi</ span >
131132< span class ="kn "> from</ span > < span class ="w "> </ span > < span class ="nn "> dpnp.dpnp_algo.dpnp_elementwise_common</ span > < span class ="w "> </ span > < span class ="kn "> import</ span > < span class ="n "> DPNPBinaryFunc</ span > < span class ="p "> ,</ span > < span class ="n "> DPNPUnaryFunc</ span >
132133
133134< span class ="n "> __all__</ span > < span class ="o "> =</ span > < span class ="p "> [</ span >
134135 < span class ="s2 "> "binary_repr"</ span > < span class ="p "> ,</ span >
135136 < span class ="s2 "> "bitwise_and"</ span > < span class ="p "> ,</ span >
137+ < span class ="s2 "> "bitwise_count"</ span > < span class ="p "> ,</ span >
136138 < span class ="s2 "> "bitwise_invert"</ span > < span class ="p "> ,</ span >
137139 < span class ="s2 "> "bitwise_left_shift"</ span > < span class ="p "> ,</ span >
138140 < span class ="s2 "> "bitwise_not"</ span > < span class ="p "> ,</ span >
@@ -171,6 +173,7 @@ <h1>Source code for dpnp.dpnp_iface_bitwise</h1><div class="highlight"><pre>
171173< span class ="sd "> at least a sufficient number of bits for `num` to be represented in the</ span >
172174< span class ="sd "> designated form. If the `width` value is insufficient, an error is</ span >
173175< span class ="sd "> raised.</ span >
176+
174177< span class ="sd "> Default: ``None``.</ span >
175178
176179< span class ="sd "> Returns</ span >
@@ -233,9 +236,11 @@ <h1>Source code for dpnp.dpnp_iface_bitwise</h1><div class="highlight"><pre>
233236< span class ="s2 "> out : {None, dpnp.ndarray, usm_ndarray}, optional</ span >
234237< span class ="s2 "> Output array to populate.</ span >
235238< span class ="s2 "> Array must have the correct shape and the expected data type.</ span >
239+
236240< span class ="s2 "> Default: ``None``.</ span >
237241< span class ="s2 "> order : {"C", "F", "A", "K"}, optional</ span >
238242< span class ="s2 "> Memory layout of the newly output array, if parameter `out` is ``None``.</ span >
243+
239244< span class ="s2 "> Default: ``"K"``.</ span >
240245
241246< span class ="s2 "> Returns</ span >
@@ -300,6 +305,59 @@ <h1>Source code for dpnp.dpnp_iface_bitwise</h1><div class="highlight"><pre>
300305< span class ="p "> )</ span >
301306
302307
308+ < span class ="n "> _BITWISE_COUNT_DOCSTRING</ span > < span class ="o "> =</ span > < span class ="s2 "> """</ span >
309+ < span class ="s2 "> Computes the number of 1-bits in the absolute value of `x`.</ span >
310+
311+ < span class ="s2 "> For full documentation refer to :obj:`numpy.bitwise_count`.</ span >
312+
313+ < span class ="s2 "> Parameters</ span >
314+ < span class ="s2 "> ----------</ span >
315+ < span class ="s2 "> x : {dpnp.ndarray, usm_ndarray}</ span >
316+ < span class ="s2 "> Input array, expected to have integer or boolean data type.</ span >
317+ < span class ="s2 "> out : {None, dpnp.ndarray, usm_ndarray}, optional</ span >
318+ < span class ="s2 "> Output array to populate.</ span >
319+ < span class ="s2 "> Array must have the correct shape and the expected data type.</ span >
320+
321+ < span class ="s2 "> Default: ``None``.</ span >
322+ < span class ="s2 "> order : {"C", "F", "A", "K"}, optional</ span >
323+ < span class ="s2 "> Memory layout of the newly output array, if parameter `out` is ``None``.</ span >
324+
325+ < span class ="s2 "> Default: ``"K"``.</ span >
326+
327+ < span class ="s2 "> Returns</ span >
328+ < span class ="s2 "> -------</ span >
329+ < span class ="s2 "> out : dpnp.ndarray</ span >
330+ < span class ="s2 "> The corresponding number of 1-bits in the input. Returns ``uint8`` for all</ span >
331+ < span class ="s2 "> integer types.</ span >
332+
333+ < span class ="s2 "> Limitations</ span >
334+ < span class ="s2 "> -----------</ span >
335+ < span class ="s2 "> Parameters `where` and `subok` are supported with their default values.</ span >
336+ < span class ="s2 "> Keyword argument `kwargs` is currently unsupported.</ span >
337+ < span class ="s2 "> Otherwise ``NotImplementedError`` exception will be raised.</ span >
338+
339+ < span class ="s2 "> Examples</ span >
340+ < span class ="s2 "> --------</ span >
341+ < span class ="s2 "> >>> import dpnp as np</ span >
342+ < span class ="s2 "> >>> a = np.array(1023)</ span >
343+ < span class ="s2 "> >>> np.bitwise_count(a)</ span >
344+ < span class ="s2 "> array(10, dtype=uint8)</ span >
345+
346+ < span class ="s2 "> >>> a = np.array([2**i - 1 for i in range(16)])</ span >
347+ < span class ="s2 "> >>> np.bitwise_count(a)</ span >
348+ < span class ="s2 "> array([ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],</ span >
349+ < span class ="s2 "> dtype=uint8)</ span >
350+
351+ < span class ="s2 "> """</ span >
352+
353+ < span class ="n "> bitwise_count</ span > < span class ="o "> =</ span > < span class ="n "> DPNPUnaryFunc</ span > < span class ="p "> (</ span >
354+ < span class ="s2 "> "bitwise_count"</ span > < span class ="p "> ,</ span >
355+ < span class ="n "> ufi</ span > < span class ="o "> .</ span > < span class ="n "> _bitwise_count_result_type</ span > < span class ="p "> ,</ span >
356+ < span class ="n "> ufi</ span > < span class ="o "> .</ span > < span class ="n "> _bitwise_count</ span > < span class ="p "> ,</ span >
357+ < span class ="n "> _BITWISE_COUNT_DOCSTRING</ span > < span class ="p "> ,</ span >
358+ < span class ="p "> )</ span >
359+
360+
303361< span class ="n "> _BITWISE_OR_DOCSTRING</ span > < span class ="o "> =</ span > < span class ="s2 "> """</ span >
304362< span class ="s2 "> Computes the bitwise OR of the underlying binary representation of each</ span >
305363< span class ="s2 "> element `x1_i` of the input array `x1` with the respective element `x2_i`</ span >
@@ -320,9 +378,11 @@ <h1>Source code for dpnp.dpnp_iface_bitwise</h1><div class="highlight"><pre>
320378< span class ="s2 "> out : {None, dpnp.ndarray, usm_ndarray}, optional</ span >
321379< span class ="s2 "> Output array to populate.</ span >
322380< span class ="s2 "> Array must have the correct shape and the expected data type.</ span >
381+
323382< span class ="s2 "> Default: ``None``.</ span >
324383< span class ="s2 "> order : {"C", "F", "A", "K"}, optional</ span >
325384< span class ="s2 "> Memory layout of the newly output array, if parameter `out` is ``None``.</ span >
385+
326386< span class ="s2 "> Default: ``"K"``.</ span >
327387
328388< span class ="s2 "> Returns</ span >
@@ -398,9 +458,11 @@ <h1>Source code for dpnp.dpnp_iface_bitwise</h1><div class="highlight"><pre>
398458< span class ="s2 "> out : {None, dpnp.ndarray, usm_ndarray}, optional</ span >
399459< span class ="s2 "> Output array to populate.</ span >
400460< span class ="s2 "> Array must have the correct shape and the expected data type.</ span >
461+
401462< span class ="s2 "> Default: ``None``.</ span >
402463< span class ="s2 "> order : {"C", "F", "A", "K"}, optional</ span >
403464< span class ="s2 "> Memory layout of the newly output array, if parameter `out` is ``None``.</ span >
465+
404466< span class ="s2 "> Default: ``"K"``.</ span >
405467
406468< span class ="s2 "> Returns</ span >
@@ -474,9 +536,11 @@ <h1>Source code for dpnp.dpnp_iface_bitwise</h1><div class="highlight"><pre>
474536< span class ="s2 "> out : {None, dpnp.ndarray, usm_ndarray}, optional</ span >
475537< span class ="s2 "> Output array to populate.</ span >
476538< span class ="s2 "> Array must have the correct shape and the expected data type.</ span >
539+
477540< span class ="s2 "> Default: ``None``.</ span >
478541< span class ="s2 "> order : {"C", "F", "A", "K"}, optional</ span >
479542< span class ="s2 "> Memory layout of the newly output array, if parameter `out` is ``None``.</ span >
543+
480544< span class ="s2 "> Default: ``"K"``.</ span >
481545
482546< span class ="s2 "> Returns</ span >
@@ -560,9 +624,11 @@ <h1>Source code for dpnp.dpnp_iface_bitwise</h1><div class="highlight"><pre>
560624< span class ="s2 "> out : {None, dpnp.ndarray, usm_ndarray}, optional</ span >
561625< span class ="s2 "> Output array to populate.</ span >
562626< span class ="s2 "> Array must have the correct shape and the expected data type.</ span >
627+
563628< span class ="s2 "> Default: ``None``.</ span >
564629< span class ="s2 "> order : {"C", "F", "A", "K"}, optional</ span >
565630< span class ="s2 "> Memory layout of the newly output array, if parameter `out` is ``None``.</ span >
631+
566632< span class ="s2 "> Default: ``"K"``.</ span >
567633< span class ="s2 "> Returns</ span >
568634< span class ="s2 "> -------</ span >
@@ -637,9 +703,11 @@ <h1>Source code for dpnp.dpnp_iface_bitwise</h1><div class="highlight"><pre>
637703< span class ="s2 "> out : {None, dpnp.ndarray, usm_ndarray}, optional</ span >
638704< span class ="s2 "> Output array to populate.</ span >
639705< span class ="s2 "> Array must have the correct shape and the expected data type.</ span >
706+
640707< span class ="s2 "> Default: ``None``.</ span >
641708< span class ="s2 "> order : {"C", "F", "A", "K"}, optional</ span >
642709< span class ="s2 "> Memory layout of the newly output array, if parameter `out` is ``None``.</ span >
710+
643711< span class ="s2 "> Default: ``"K"``.</ span >
644712
645713< span class ="s2 "> Returns</ span >
0 commit comments