Add device, sycl_queue and usm_type keywords to dpnp.ndarray.copy method (#1976)

* Add device, sycl_queue and usm_type keywords to dpnp.ndarray.copy

* Align description of sycl_queue keyword

* Applied black formatting

* Updated third party tests

* Added tests for SYCL queue and USM device

* update fftfreq and rfftfreq docstring

---------

Co-authored-by: Vahid Tavanashad <[email protected]>
Co-authored-by: vtavana <[email protected]> 6ae16ce

Author: github-actions[bot]

.buildinfo

@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 879cd041dfa92b638256b09f2d30e714
+config: 89cd5926c07abd7e2f0aa4b2bc17b4bf
 tags: 645f666f9bcd5a90fca523b33c5a78b7

_modules/dpnp/dpnp_array.html

@@ -12,7 +12,7 @@
     </script>
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dpnp.dpnp_array &mdash; Data Parallel Extension for NumPy 0.16.0dev0+112.ge4acd3eff4 documentation</title>
+  <title>dpnp.dpnp_array &mdash; Data Parallel Extension for NumPy 0.16.0dev0+113.g6ae16ce5bf documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=fa44fd50" />
       <link rel="stylesheet" type="text/css" href="../../_static/css/theme.css?v=19f00094" />
 
@@ -23,7 +23,7 @@
 
         <script src="../../_static/jquery.js?v=5d32c60e"></script>
         <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-        <script src="../../_static/documentation_options.js?v=edd98bb5"></script>
+        <script src="../../_static/documentation_options.js?v=714a5aca"></script>
         <script src="../../_static/doctools.js?v=9a2dae69"></script>
         <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/js/theme.js"></script>
@@ -43,7 +43,7 @@
             Data Parallel Extension for NumPy
           </a>
               <div class="version">
-                0.16.0dev0+112.ge4acd3eff4
+                0.16.0dev0+113.g6ae16ce5bf
               </div>
 <div role="search">
   <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
@@ -856,10 +856,35 @@ <h1>Source code for dpnp.dpnp_array</h1><div class="highlight"><pre>
 
 <div class="viewcode-block" id="dpnp_array.copy">
 <a class="viewcode-back" href="../../reference/generated/dpnp.dpnp_array.dpnp_array.html#dpnp.dpnp_array.dpnp_array.copy">[docs]</a>
-    <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">order</span><span class="o">=</span><span class="s2">&quot;C&quot;</span><span class="p">):</span>
+    <span class="k">def</span> <span class="nf">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">order</span><span class="o">=</span><span class="s2">&quot;C&quot;</span><span class="p">,</span> <span class="n">device</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">usm_type</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">sycl_queue</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
 <span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
 <span class="sd">        Return a copy of the array.</span>
 
+<span class="sd">        Refer to :obj:`dpnp.copy` for full documentation.</span>
+
+<span class="sd">        Parameters</span>
+<span class="sd">        ----------</span>
+<span class="sd">        order : {&quot;C&quot;, &quot;F&quot;, &quot;A&quot;, &quot;K&quot;}, optional</span>
+<span class="sd">            Memory layout of the newly output array.</span>
+<span class="sd">            Default: ``&quot;C&quot;``.</span>
+<span class="sd">        device : {None, string, SyclDevice, SyclQueue}, optional</span>
+<span class="sd">            An array API concept of device where the output array is created.</span>
+<span class="sd">            The `device` can be ``None`` (the default), an OneAPI filter</span>
+<span class="sd">            selector string, an instance of :class:`dpctl.SyclDevice`</span>
+<span class="sd">            corresponding to a non-partitioned SYCL device, an instance of</span>
+<span class="sd">            :class:`dpctl.SyclQueue`, or a `Device` object returned by</span>
+<span class="sd">            :obj:`dpnp.dpnp_array.dpnp_array.device` property.</span>
+<span class="sd">            Default: ``None``.</span>
+<span class="sd">        usm_type : {None, &quot;device&quot;, &quot;shared&quot;, &quot;host&quot;}, optional</span>
+<span class="sd">            The type of SYCL USM allocation for the output array.</span>
+<span class="sd">            Default: ``None``.</span>
+<span class="sd">        sycl_queue : {None, SyclQueue}, optional</span>
+<span class="sd">            A SYCL queue to use for output array allocation and copying. The</span>
+<span class="sd">            `sycl_queue` can be passed as ``None`` (the default), which means</span>
+<span class="sd">            to get the SYCL queue from `device` keyword if present or to use</span>
+<span class="sd">            a default queue.</span>
+<span class="sd">            Default: ``None``.</span>
+
 <span class="sd">        Returns</span>
 <span class="sd">        -------</span>
 <span class="sd">        out : dpnp.ndarray</span>
@@ -872,8 +897,9 @@ <h1>Source code for dpnp.dpnp_array</h1><div class="highlight"><pre>
 
 <span class="sd">        Notes</span>
 <span class="sd">        -----</span>
-<span class="sd">        This function is the preferred method for creating an array copy. The</span>
-<span class="sd">        function :func:`dpnp.copy` is similar, but it defaults to using order &#39;K&#39;.</span>
+<span class="sd">        This function is the preferred method for creating an array copy.</span>
+<span class="sd">        The function :func:`dpnp.copy` is similar, but it defaults to using</span>
+<span class="sd">        order ``&quot;K&quot;``.</span>
 
 <span class="sd">        Examples</span>
 <span class="sd">        --------</span>
@@ -895,7 +921,13 @@ <h1>Source code for dpnp.dpnp_array</h1><div class="highlight"><pre>
 
 <span class="sd">        &quot;&quot;&quot;</span>
 
-        <span class="k">return</span> <span class="n">dpnp</span><span class="o">.</span><span class="n">copy</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">order</span><span class="o">=</span><span class="n">order</span><span class="p">)</span></div>
+        <span class="k">return</span> <span class="n">dpnp</span><span class="o">.</span><span class="n">copy</span><span class="p">(</span>
+            <span class="bp">self</span><span class="p">,</span>
+            <span class="n">order</span><span class="o">=</span><span class="n">order</span><span class="p">,</span>
+            <span class="n">device</span><span class="o">=</span><span class="n">device</span><span class="p">,</span>
+            <span class="n">usm_type</span><span class="o">=</span><span class="n">usm_type</span><span class="p">,</span>
+            <span class="n">sycl_queue</span><span class="o">=</span><span class="n">sycl_queue</span><span class="p">,</span>
+        <span class="p">)</span></div>
 
 
     <span class="c1"># &#39;ctypes&#39;,</span>

_modules/dpnp/dpnp_flatiter.html

@@ -12,7 +12,7 @@
     </script>
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dpnp.dpnp_flatiter &mdash; Data Parallel Extension for NumPy 0.16.0dev0+112.ge4acd3eff4 documentation</title>
+  <title>dpnp.dpnp_flatiter &mdash; Data Parallel Extension for NumPy 0.16.0dev0+113.g6ae16ce5bf documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=fa44fd50" />
       <link rel="stylesheet" type="text/css" href="../../_static/css/theme.css?v=19f00094" />
 
@@ -23,7 +23,7 @@
 
         <script src="../../_static/jquery.js?v=5d32c60e"></script>
         <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-        <script src="../../_static/documentation_options.js?v=edd98bb5"></script>
+        <script src="../../_static/documentation_options.js?v=714a5aca"></script>
         <script src="../../_static/doctools.js?v=9a2dae69"></script>
         <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/js/theme.js"></script>
@@ -43,7 +43,7 @@
             Data Parallel Extension for NumPy
           </a>
               <div class="version">
-                0.16.0dev0+112.ge4acd3eff4
+                0.16.0dev0+113.g6ae16ce5bf
               </div>
 <div role="search">
   <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">

_modules/dpnp/dpnp_iface.html

@@ -12,7 +12,7 @@
     </script>
 
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>dpnp.dpnp_iface &mdash; Data Parallel Extension for NumPy 0.16.0dev0+112.ge4acd3eff4 documentation</title>
+  <title>dpnp.dpnp_iface &mdash; Data Parallel Extension for NumPy 0.16.0dev0+113.g6ae16ce5bf documentation</title>
       <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=fa44fd50" />
       <link rel="stylesheet" type="text/css" href="../../_static/css/theme.css?v=19f00094" />
 
@@ -23,7 +23,7 @@
 
         <script src="../../_static/jquery.js?v=5d32c60e"></script>
         <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-        <script src="../../_static/documentation_options.js?v=edd98bb5"></script>
+        <script src="../../_static/documentation_options.js?v=714a5aca"></script>
         <script src="../../_static/doctools.js?v=9a2dae69"></script>
         <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/js/theme.js"></script>
@@ -43,7 +43,7 @@
             Data Parallel Extension for NumPy
           </a>
               <div class="version">
-                0.16.0dev0+112.ge4acd3eff4
+                0.16.0dev0+113.g6ae16ce5bf
               </div>
 <div role="search">
   <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">