1+ <!DOCTYPE html>
2+ < html class ="writer-html5 " lang ="en " data-content_root ="../../ ">
3+ < head >
4+ < meta charset ="utf-8 " />
5+ <!-- Google tag (gtag.js) -->
6+ < script async src ="https://www.googletagmanager.com/gtag/js?id=G-554F8VNE28 "> </ script >
7+ < script >
8+ window . dataLayer = window . dataLayer || [ ] ;
9+ function gtag ( ) { dataLayer . push ( arguments ) ; }
10+ gtag ( 'js' , new Date ( ) ) ;
11+ gtag ( 'config' , 'G-554F8VNE28' ) ;
12+ </ script >
13+
14+ < meta name ="viewport " content ="width=device-width, initial-scale=1.0 " />
15+ < title > dpnp.dpnp_iface_counting — Data Parallel Extension for NumPy 0.17.0dev0+59.g4c9706dac0c documentation</ title >
16+ < link rel ="stylesheet " type ="text/css " href ="../../_static/pygments.css?v=fa44fd50 " />
17+ < link rel ="stylesheet " type ="text/css " href ="../../_static/css/theme.css?v=19f00094 " />
18+
19+
20+ <!--[if lt IE 9]>
21+ <script src="../../_static/js/html5shiv.min.js"></script>
22+ <![endif]-->
23+
24+ < script src ="../../_static/jquery.js?v=5d32c60e "> </ script >
25+ < script src ="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c "> </ script >
26+ < script src ="../../_static/documentation_options.js?v=2a06c88c "> </ script >
27+ < script src ="../../_static/doctools.js?v=9a2dae69 "> </ script >
28+ < script src ="../../_static/sphinx_highlight.js?v=dc90522c "> </ script >
29+ < script src ="../../_static/js/theme.js "> </ script >
30+ < link rel ="index " title ="Index " href ="../../genindex.html " />
31+ < link rel ="search " title ="Search " href ="../../search.html " />
32+ </ head >
33+
34+ < body class ="wy-body-for-nav ">
35+ < div class ="wy-grid-for-nav ">
36+ < nav data-toggle ="wy-nav-shift " class ="wy-nav-side ">
37+ < div class ="wy-side-scroll ">
38+ < div class ="wy-side-nav-search " >
39+
40+
41+
42+ < a href ="../../index.html " class ="icon icon-home ">
43+ Data Parallel Extension for NumPy
44+ </ a >
45+ < div class ="version ">
46+ 0.17.0dev0+59.g4c9706dac0c
47+ </ div >
48+ < div role ="search ">
49+ < form id ="rtd-search-form " class ="wy-form " action ="../../search.html " method ="get ">
50+ < input type ="text " name ="q " placeholder ="Search docs " aria-label ="Search docs " />
51+ < input type ="hidden " name ="check_keywords " value ="yes " />
52+ < input type ="hidden " name ="area " value ="default " />
53+ </ form >
54+ </ div >
55+ </ div > < div class ="wy-menu wy-menu-vertical " data-spy ="affix " role ="navigation " aria-label ="Navigation menu ">
56+ < ul >
57+ < li class ="toctree-l1 "> < a class ="reference internal " href ="../../overview.html "> Overview</ a > </ li >
58+ < li class ="toctree-l1 "> < a class ="reference internal " href ="../../quick_start_guide.html "> Quick Start Guide</ a > </ li >
59+ < li class ="toctree-l1 "> < a class ="reference internal " href ="../../reference/index.html "> API Reference</ a > </ li >
60+ </ ul >
61+ < p class ="caption " role ="heading "> < span class ="caption-text "> Development information</ span > </ p >
62+ < ul >
63+ < li class ="toctree-l1 "> < a class ="reference internal " href ="../../dpnp_backend_api.html "> C++ backend API Reference</ a > </ li >
64+ </ ul >
65+
66+ </ div >
67+ </ div >
68+ </ nav >
69+
70+ < section data-toggle ="wy-nav-shift " class ="wy-nav-content-wrap "> < nav class ="wy-nav-top " aria-label ="Mobile navigation menu " >
71+ < i data-toggle ="wy-nav-top " class ="fa fa-bars "> </ i >
72+ < a href ="../../index.html "> Data Parallel Extension for NumPy</ a >
73+ </ nav >
74+
75+ < div class ="wy-nav-content ">
76+ < div class ="rst-content ">
77+ < div role ="navigation " aria-label ="Page navigation ">
78+ < ul class ="wy-breadcrumbs ">
79+ < li > < a href ="../../index.html " class ="icon icon-home " aria-label ="Home "> </ a > </ li >
80+ < li class ="breadcrumb-item "> < a href ="../index.html "> Module code</ a > </ li >
81+ < li class ="breadcrumb-item active "> dpnp.dpnp_iface_counting</ li >
82+ < li class ="wy-breadcrumbs-aside ">
83+ </ li >
84+ </ ul >
85+ < hr />
86+ </ div >
87+ < div role ="main " class ="document " itemscope ="itemscope " itemtype ="http://schema.org/Article ">
88+ < div itemprop ="articleBody ">
89+
90+ < h1 > Source code for dpnp.dpnp_iface_counting</ h1 > < div class ="highlight "> < pre >
91+ < span > </ span > < span class ="c1 "> # -*- coding: utf-8 -*-</ span >
92+ < span class ="c1 "> # *****************************************************************************</ span >
93+ < span class ="c1 "> # Copyright (c) 2016-2024, Intel Corporation</ span >
94+ < span class ="c1 "> # All rights reserved.</ span >
95+ < span class ="c1 "> #</ span >
96+ < span class ="c1 "> # Redistribution and use in source and binary forms, with or without</ span >
97+ < span class ="c1 "> # modification, are permitted provided that the following conditions are met:</ span >
98+ < span class ="c1 "> # - Redistributions of source code must retain the above copyright notice,</ span >
99+ < span class ="c1 "> # this list of conditions and the following disclaimer.</ span >
100+ < span class ="c1 "> # - Redistributions in binary form must reproduce the above copyright notice,</ span >
101+ < span class ="c1 "> # this list of conditions and the following disclaimer in the documentation</ span >
102+ < span class ="c1 "> # and/or other materials provided with the distribution.</ span >
103+ < span class ="c1 "> #</ span >
104+ < span class ="c1 "> # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"</ span >
105+ < span class ="c1 "> # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE</ span >
106+ < span class ="c1 "> # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE</ span >
107+ < span class ="c1 "> # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE</ span >
108+ < span class ="c1 "> # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR</ span >
109+ < span class ="c1 "> # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF</ span >
110+ < span class ="c1 "> # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS</ span >
111+ < span class ="c1 "> # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN</ span >
112+ < span class ="c1 "> # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)</ span >
113+ < span class ="c1 "> # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF</ span >
114+ < span class ="c1 "> # THE POSSIBILITY OF SUCH DAMAGE.</ span >
115+ < span class ="c1 "> # *****************************************************************************</ span >
116+
117+ < span class ="sd "> """</ span >
118+ < span class ="sd "> Interface of the counting function of the dpnp</ span >
119+
120+ < span class ="sd "> Notes</ span >
121+ < span class ="sd "> -----</ span >
122+ < span class ="sd "> This module is a face or public interface file for the library</ span >
123+ < span class ="sd "> it contains:</ span >
124+ < span class ="sd "> - Interface functions</ span >
125+ < span class ="sd "> - documentation for the functions</ span >
126+ < span class ="sd "> - The functions parameters check</ span >
127+
128+ < span class ="sd "> """</ span >
129+
130+ < span class ="kn "> import</ span > < span class ="nn "> dpctl.tensor</ span > < span class ="k "> as</ span > < span class ="nn "> dpt</ span >
131+
132+ < span class ="kn "> import</ span > < span class ="nn "> dpnp</ span >
133+
134+ < span class ="n "> __all__</ span > < span class ="o "> =</ span > < span class ="p "> [</ span > < span class ="s2 "> "count_nonzero"</ span > < span class ="p "> ]</ span >
135+
136+
137+ < div class ="viewcode-block " id ="count_nonzero ">
138+ < a class ="viewcode-back " href ="../../reference/generated/dpnp.count_nonzero.html#dpnp.count_nonzero "> [docs]</ a >
139+ < span class ="k "> def</ span > < span class ="nf "> count_nonzero</ span > < span class ="p "> (</ span > < span class ="n "> a</ span > < span class ="p "> ,</ span > < span class ="n "> axis</ span > < span class ="o "> =</ span > < span class ="kc "> None</ span > < span class ="p "> ,</ span > < span class ="o "> *</ span > < span class ="p "> ,</ span > < span class ="n "> keepdims</ span > < span class ="o "> =</ span > < span class ="kc "> False</ span > < span class ="p "> ,</ span > < span class ="n "> out</ span > < span class ="o "> =</ span > < span class ="kc "> None</ span > < span class ="p "> ):</ span >
140+ < span class ="w "> </ span > < span class ="sd "> """</ span >
141+ < span class ="sd "> Counts the number of non-zero values in the array `a`.</ span >
142+
143+ < span class ="sd "> For full documentation refer to :obj:`numpy.count_nonzero`.</ span >
144+
145+ < span class ="sd "> Parameters</ span >
146+ < span class ="sd "> ----------</ span >
147+ < span class ="sd "> a : {dpnp.ndarray, usm_ndarray}</ span >
148+ < span class ="sd "> The array for which to count non-zeros.</ span >
149+ < span class ="sd "> axis : {None, int, tuple}, optional</ span >
150+ < span class ="sd "> Axis or tuple of axes along which to count non-zeros.</ span >
151+ < span class ="sd "> Default value means that non-zeros will be counted along a flattened</ span >
152+ < span class ="sd "> version of `a`.</ span >
153+ < span class ="sd "> Default: ``None``.</ span >
154+ < span class ="sd "> keepdims : bool, optional</ span >
155+ < span class ="sd "> If this is set to ``True``, the axes that are counted are left in the</ span >
156+ < span class ="sd "> result as dimensions with size one. With this option, the result will</ span >
157+ < span class ="sd "> broadcast correctly against the input array.</ span >
158+ < span class ="sd "> Default: ``False``.</ span >
159+ < span class ="sd "> out : {None, dpnp.ndarray, usm_ndarray}, optional</ span >
160+ < span class ="sd "> The array into which the result is written. The data type of `out` must</ span >
161+ < span class ="sd "> match the expected shape and the expected data type of the result.</ span >
162+ < span class ="sd "> If ``None`` then a new array is returned.</ span >
163+ < span class ="sd "> Default: ``None``.</ span >
164+
165+ < span class ="sd "> Returns</ span >
166+ < span class ="sd "> -------</ span >
167+ < span class ="sd "> out : dpnp.ndarray</ span >
168+ < span class ="sd "> Number of non-zero values in the array along a given axis.</ span >
169+ < span class ="sd "> Otherwise, a zero-dimensional array with the total number of non-zero</ span >
170+ < span class ="sd "> values in the array is returned.</ span >
171+
172+ < span class ="sd "> See Also</ span >
173+ < span class ="sd "> --------</ span >
174+ < span class ="sd "> :obj:`dpnp.nonzero` : Return the coordinates of all the non-zero values.</ span >
175+
176+ < span class ="sd "> Examples</ span >
177+ < span class ="sd "> --------</ span >
178+ < span class ="sd "> >>> import dpnp as np</ span >
179+ < span class ="sd "> >>> np.count_nonzero(np.eye(4))</ span >
180+ < span class ="sd "> array(4)</ span >
181+ < span class ="sd "> >>> a = np.array([[0, 1, 7, 0],</ span >
182+ < span class ="sd "> [3, 0, 2, 19]])</ span >
183+ < span class ="sd "> >>> np.count_nonzero(a)</ span >
184+ < span class ="sd "> array(5)</ span >
185+ < span class ="sd "> >>> np.count_nonzero(a, axis=0)</ span >
186+ < span class ="sd "> array([1, 1, 2, 1])</ span >
187+ < span class ="sd "> >>> np.count_nonzero(a, axis=1)</ span >
188+ < span class ="sd "> array([2, 3])</ span >
189+ < span class ="sd "> >>> np.count_nonzero(a, axis=1, keepdims=True)</ span >
190+ < span class ="sd "> array([[2],</ span >
191+ < span class ="sd "> [3]])</ span >
192+
193+ < span class ="sd "> """</ span >
194+
195+ < span class ="n "> usm_a</ span > < span class ="o "> =</ span > < span class ="n "> dpnp</ span > < span class ="o "> .</ span > < span class ="n "> get_usm_ndarray</ span > < span class ="p "> (</ span > < span class ="n "> a</ span > < span class ="p "> )</ span >
196+ < span class ="n "> usm_out</ span > < span class ="o "> =</ span > < span class ="kc "> None</ span > < span class ="k "> if</ span > < span class ="n "> out</ span > < span class ="ow "> is</ span > < span class ="kc "> None</ span > < span class ="k "> else</ span > < span class ="n "> dpnp</ span > < span class ="o "> .</ span > < span class ="n "> get_usm_ndarray</ span > < span class ="p "> (</ span > < span class ="n "> out</ span > < span class ="p "> )</ span >
197+
198+ < span class ="n "> usm_res</ span > < span class ="o "> =</ span > < span class ="n "> dpt</ span > < span class ="o "> .</ span > < span class ="n "> count_nonzero</ span > < span class ="p "> (</ span >
199+ < span class ="n "> usm_a</ span > < span class ="p "> ,</ span > < span class ="n "> axis</ span > < span class ="o "> =</ span > < span class ="n "> axis</ span > < span class ="p "> ,</ span > < span class ="n "> keepdims</ span > < span class ="o "> =</ span > < span class ="n "> keepdims</ span > < span class ="p "> ,</ span > < span class ="n "> out</ span > < span class ="o "> =</ span > < span class ="n "> usm_out</ span >
200+ < span class ="p "> )</ span >
201+ < span class ="k "> return</ span > < span class ="n "> dpnp</ span > < span class ="o "> .</ span > < span class ="n "> get_result_array</ span > < span class ="p "> (</ span > < span class ="n "> usm_res</ span > < span class ="p "> ,</ span > < span class ="n "> out</ span > < span class ="p "> )</ span > </ div >
202+
203+ </ pre > </ div >
204+
205+ </ div >
206+ </ div >
207+ < footer >
208+
209+ < hr />
210+
211+ < div role ="contentinfo ">
212+ < p > © Copyright 2020-2024, Intel Corporation.</ p >
213+ </ div >
214+
215+ Built with < a href ="https://www.sphinx-doc.org/ "> Sphinx</ a > using a
216+ < a href ="https://github.com/readthedocs/sphinx_rtd_theme "> theme</ a >
217+ provided by < a href ="https://readthedocs.org "> Read the Docs</ a > .
218+
219+
220+ </ footer >
221+ </ div >
222+ </ div >
223+ </ section >
224+ </ div >
225+ < script >
226+ jQuery ( function ( ) {
227+ SphinxRtdTheme . Navigation . enable ( true ) ;
228+ } ) ;
229+ </ script >
230+
231+ </ body >
232+ </ html >
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4&size=40){kind=avatar}
0 commit comments