Docs for pull request 1872

Author: github-actions[doc-deploy-bot]

pulls/1872/_modules/dpctl/tensor/_ctors.html

@@ -827,6 +827,7 @@ <h1>Source code for dpctl.tensor._ctors</h1><div class="highlight"><pre>
 <span class="c1">#  limitations under the License.</span>
 
 <span class="kn">import</span> <span class="nn">operator</span>
+<span class="kn">from</span> <span class="nn">numbers</span> <span class="kn">import</span> <span class="n">Number</span>
 
 <span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
 
@@ -1849,6 +1850,19 @@ <h1>Source code for dpctl.tensor._ctors</h1><div class="highlight"><pre>
         <span class="k">return</span> <span class="n">fill_val</span>
 
 
+<span class="k">def</span> <span class="nf">_validate_fill_value</span><span class="p">(</span><span class="n">fill_val</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Validates that `fill_val` is a numeric or boolean scalar.</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="c1"># TODO: verify if `np.True_` and `np.False_` should be instances of</span>
+    <span class="c1"># Number in NumPy, like other NumPy scalars and like Python bools</span>
+    <span class="c1"># check for `np.bool_` separately as NumPy&lt;2 has no `np.bool`</span>
+    <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">fill_val</span><span class="p">,</span> <span class="n">Number</span><span class="p">)</span> <span class="ow">and</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">fill_val</span><span class="p">,</span> <span class="n">np</span><span class="o">.</span><span class="n">bool_</span><span class="p">):</span>
+        <span class="k">raise</span> <span class="ne">TypeError</span><span class="p">(</span>
+            <span class="sa">f</span><span class="s2">&quot;array cannot be filled with scalar of type </span><span class="si">{</span><span class="nb">type</span><span class="p">(</span><span class="n">fill_val</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span>
+        <span class="p">)</span>
+
+
 <div class="viewcode-block" id="full"><a class="viewcode-back" href="../../../api_reference/dpctl/generated/dpctl.tensor.full.html#dpctl.tensor.full">[docs]</a><span class="k">def</span> <span class="nf">full</span><span class="p">(</span>
     <span class="n">shape</span><span class="p">,</span>
     <span class="n">fill_value</span><span class="p">,</span>
@@ -1922,6 +1936,8 @@ <h1>Source code for dpctl.tensor._ctors</h1><div class="highlight"><pre>
             <span class="n">sycl_queue</span><span class="o">=</span><span class="n">sycl_queue</span><span class="p">,</span>
         <span class="p">)</span>
         <span class="k">return</span> <span class="n">dpt</span><span class="o">.</span><span class="n">copy</span><span class="p">(</span><span class="n">dpt</span><span class="o">.</span><span class="n">broadcast_to</span><span class="p">(</span><span class="n">X</span><span class="p">,</span> <span class="n">shape</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="k">else</span><span class="p">:</span>
+        <span class="n">_validate_fill_value</span><span class="p">(</span><span class="n">fill_value</span><span class="p">)</span>
 
     <span class="n">sycl_queue</span> <span class="o">=</span> <span class="n">normalize_queue_device</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="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="k">if</span> <span class="n">usm_type</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="k">else</span> <span class="s2">&quot;device&quot;</span>
@@ -2292,6 +2308,8 @@ <h1>Source code for dpctl.tensor._ctors</h1><div class="highlight"><pre>
             <span class="p">)</span>
             <span class="n">_manager</span><span class="o">.</span><span class="n">add_event_pair</span><span class="p">(</span><span class="n">hev</span><span class="p">,</span> <span class="n">copy_ev</span><span class="p">)</span>
             <span class="k">return</span> <span class="n">res</span>
+        <span class="k">else</span><span class="p">:</span>
+            <span class="n">_validate_fill_value</span><span class="p">(</span><span class="n">fill_value</span><span class="p">)</span>
 
         <span class="n">dtype</span> <span class="o">=</span> <span class="n">_get_dtype</span><span class="p">(</span><span class="n">dtype</span><span class="p">,</span> <span class="n">sycl_queue</span><span class="p">,</span> <span class="n">ref_type</span><span class="o">=</span><span class="nb">type</span><span class="p">(</span><span class="n">fill_value</span><span class="p">))</span>
         <span class="n">res</span> <span class="o">=</span> <span class="n">_empty_like_orderK</span><span class="p">(</span><span class="n">x</span><span class="p">,</span> <span class="n">dtype</span><span class="p">,</span> <span class="n">usm_type</span><span class="p">,</span> <span class="n">sycl_queue</span><span class="p">)</span>

pulls/1872/_modules/dpctl/tensor/_type_utils.html

@@ -1579,6 +1579,9 @@ <h1>Source code for dpctl.tensor._type_utils</h1><div class="highlight"><pre>
                 <span class="n">target_dev</span> <span class="o">=</span> <span class="n">d</span>
                 <span class="n">inspected</span> <span class="o">=</span> <span class="kc">True</span>
 
+    <span class="k">if</span> <span class="ow">not</span> <span class="n">dtypes</span> <span class="ow">and</span> <span class="n">weak_dtypes</span><span class="p">:</span>
+        <span class="n">dtypes</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">weak_dtypes</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">get</span><span class="p">())</span>
+
     <span class="k">if</span> <span class="ow">not</span> <span class="p">(</span><span class="n">has_fp16</span> <span class="ow">and</span> <span class="n">has_fp64</span><span class="p">):</span>
         <span class="k">for</span> <span class="n">dt</span> <span class="ow">in</span> <span class="n">dtypes</span><span class="p">:</span>
             <span class="k">if</span> <span class="ow">not</span> <span class="n">_dtype_supported_by_device_impl</span><span class="p">(</span><span class="n">dt</span><span class="p">,</span> <span class="n">has_fp16</span><span class="p">,</span> <span class="n">has_fp64</span><span class="p">):</span>

pulls/1872/beginners_guides/installation.html

@@ -881,7 +881,7 @@ <h2>Installation using pip<a class="headerlink" href="#installation-using-pip" t
 <section id="installation-via-intel-r-distribution-for-python">
 <h2>Installation via Intel(R) Distribution for Python<a class="headerlink" href="#installation-via-intel-r-distribution-for-python" title="Permalink to this heading">¶</a></h2>
 <p><a class="reference external" href="https://www.intel.com/content/www/us/en/developer/tools/oneapi/distribution-for-python.html">Intel(R) Distribution for Python*</a> is distributed as a conda-based installer
-and includes <a class="reference internal" href="../api_reference/dpctl/index.html#module-dpctl" title="dpctl"><code class="xref py py-mod docutils literal notranslate"><span class="pre">dpctl</span></code></a> along with its dependencies and sister projects <a class="reference external" href="https://intelpython.github.io/dpnp/overview.html#module-dpnp" title="(in Data Parallel Extension for NumPy v0.17.0dev0+56.ga42a87f89f7)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">dpnp</span></code></a>
+and includes <a class="reference internal" href="../api_reference/dpctl/index.html#module-dpctl" title="dpctl"><code class="xref py py-mod docutils literal notranslate"><span class="pre">dpctl</span></code></a> along with its dependencies and sister projects <a class="reference external" href="https://intelpython.github.io/dpnp/overview.html#module-dpnp" title="(in Data Parallel Extension for NumPy v0.17.0dev1+2.g687b8eacc44)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">dpnp</span></code></a>
 and <a class="reference external" href="https://intelpython.github.io/numba-dpex/latest/index.html#module-numba_dpex" title="(in numba-dpex)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">numba_dpex</span></code></a>.</p>
 <p>Once the installed environment is activated, <code class="docutils literal notranslate"><span class="pre">dpctl</span></code> should be ready to use.</p>
 </section>