deploy: 9419213

Author: copybara-service[bot]

python/api/tensorstore.Future.__new__.html

@@ -1065,7 +1065,7 @@
 <span class="gp">&gt;&gt;&gt; </span><span class="k">assert</span> <span class="n">x</span> <span class="ow">is</span> <span class="n">ts</span><span class="o">.</span><span class="n">Future</span><span class="p">(</span><span class="n">x</span><span class="p">)</span>
 </code></pre></div>
 </div>
-<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><code><span class="gp">&gt;&gt;&gt; </span><span class="k">async</span> <span class="k">def</span> <span class="nf">get_value</span><span class="p">():</span>
+<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><code><span class="gp">&gt;&gt;&gt; </span><span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">get_value</span><span class="p">():</span>
 <span class="gp">... </span>    <span class="k">return</span> <span class="mi">42</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">x</span> <span class="o">=</span> <span class="n">ts</span><span class="o">.</span><span class="n">Future</span><span class="p">(</span><span class="n">get_value</span><span class="p">())</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">x</span><span class="o">.</span><span class="n">done</span><span class="p">()</span>

python/api/tensorstore.virtual_chunked.html

@@ -1230,7 +1230,7 @@
 <dd><p>Creates a <a class="reference internal" href="tensorstore.TensorStore.html" title="tensorstore.TensorStore (Python class) — Asynchronous multi-dimensional array handle."><code class="xref py py-obj docutils literal notranslate"><span class="pre">TensorStore</span></code></a> where the content is read/written chunk-wise by an arbitrary function.</p>
 <p>Example (read-only):</p>
 <div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><code><span class="gp">&gt;&gt;&gt; </span><span class="n">a</span> <span class="o">=</span> <span class="n">ts</span><span class="o">.</span><span class="n">array</span><span class="p">([[</span><span class="mi">1</span><span class="p">,</span> <span class="mi">2</span><span class="p">,</span> <span class="mi">3</span><span class="p">],</span> <span class="p">[</span><span class="mi">4</span><span class="p">,</span> <span class="mi">5</span><span class="p">,</span> <span class="mi">6</span><span class="p">]],</span> <span class="n">dtype</span><span class="o">=</span><span class="n">ts</span><span class="o">.</span><span class="n">uint32</span><span class="p">)</span>
-<span class="gp">&gt;&gt;&gt; </span><span class="k">async</span> <span class="k">def</span> <span class="nf">do_read</span><span class="p">(</span><span class="n">domain</span><span class="p">:</span> <span class="n">ts</span><span class="o">.</span><span class="n">IndexDomain</span><span class="p">,</span> <span class="n">array</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">do_read</span><span class="p">(</span><span class="n">domain</span><span class="p">:</span> <span class="n">ts</span><span class="o">.</span><span class="n">IndexDomain</span><span class="p">,</span> <span class="n">array</span><span class="p">:</span> <span class="n">np</span><span class="o">.</span><span class="n">ndarray</span><span class="p">,</span>
 <span class="gp">... </span>                  <span class="n">read_params</span><span class="p">:</span> <span class="n">ts</span><span class="o">.</span><span class="n">VirtualChunkedReadParameters</span><span class="p">):</span>
 <span class="gp">... </span>    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;Computing content for: </span><span class="si">{</span><span class="n">domain</span><span class="si">}</span><span class="s1">&#39;</span><span class="p">)</span>
 <span class="gp">... </span>    <span class="n">array</span><span class="p">[</span><span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span><span class="k">await</span> <span class="n">a</span><span class="p">[</span><span class="n">domain</span><span class="p">]</span><span class="o">.</span><span class="n">read</span><span class="p">())</span> <span class="o">+</span> <span class="mi">100</span>
@@ -1244,9 +1244,9 @@
 <p>Example (read/write):</p>
 <div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><code><span class="gp">&gt;&gt;&gt; </span><span class="n">array</span> <span class="o">=</span> <span class="n">np</span><span class="o">.</span><span class="n">zeros</span><span class="p">(</span><span class="n">shape</span><span class="o">=</span><span class="p">[</span><span class="mi">4</span><span class="p">,</span> <span class="mi">5</span><span class="p">],</span> <span class="n">dtype</span><span class="o">=</span><span class="n">np</span><span class="o">.</span><span class="n">uint32</span><span class="p">)</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">array</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span> <span class="o">=</span> <span class="mi">50</span>
-<span class="gp">&gt;&gt;&gt; </span><span class="k">def</span> <span class="nf">do_read</span><span class="p">(</span><span class="n">domain</span><span class="p">,</span> <span class="n">chunk</span><span class="p">,</span> <span class="n">read_context</span><span class="p">):</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="k">def</span><span class="w"> </span><span class="nf">do_read</span><span class="p">(</span><span class="n">domain</span><span class="p">,</span> <span class="n">chunk</span><span class="p">,</span> <span class="n">read_context</span><span class="p">):</span>
 <span class="gp">... </span>    <span class="n">chunk</span><span class="p">[</span><span class="o">...</span><span class="p">]</span> <span class="o">=</span> <span class="n">array</span><span class="p">[</span><span class="n">domain</span><span class="o">.</span><span class="n">index_exp</span><span class="p">]</span>
-<span class="gp">&gt;&gt;&gt; </span><span class="k">def</span> <span class="nf">do_write</span><span class="p">(</span><span class="n">domain</span><span class="p">,</span> <span class="n">chunk</span><span class="p">,</span> <span class="n">write_context</span><span class="p">):</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="k">def</span><span class="w"> </span><span class="nf">do_write</span><span class="p">(</span><span class="n">domain</span><span class="p">,</span> <span class="n">chunk</span><span class="p">,</span> <span class="n">write_context</span><span class="p">):</span>
 <span class="gp">... </span>    <span class="n">array</span><span class="p">[</span><span class="n">domain</span><span class="o">.</span><span class="n">index_exp</span><span class="p">]</span> <span class="o">=</span> <span class="n">chunk</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">t</span> <span class="o">=</span> <span class="n">ts</span><span class="o">.</span><span class="n">virtual_chunked</span><span class="p">(</span>
 <span class="gp">... </span>    <span class="n">do_read</span><span class="p">,</span>

python/tutorial.html

@@ -645,8 +645,8 @@ <h1 id="tutorial">Tutorial<a class="headerlink" href="#tutorial" title="Link to
 <h2 id="reading-and-writing-a-local-n5-dataset">Reading and writing a local N5 dataset<a class="headerlink" href="#reading-and-writing-a-local-n5-dataset" title="Link to this heading">¶</a></h2>
 <p>Create a new <a class="reference internal" href="../driver/n5/index.html#n5-driver"><span class="std std-ref">N5</span></a> dataset on the local filesystem using the
 <a class="reference internal" href="../kvstore/file/index.html#file-kvstore-driver"><span class="std std-ref">file Key-Value Store driver</span></a>:</p>
-<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><code><span class="gp">&gt;&gt;&gt; </span><span class="kn">import</span> <span class="nn">tensorstore</span> <span class="k">as</span> <span class="nn">ts</span>
-<span class="gp">&gt;&gt;&gt; </span><span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><code><span class="gp">&gt;&gt;&gt; </span><span class="kn">import</span><span class="w"> </span><span class="nn">tensorstore</span><span class="w"> </span><span class="k">as</span><span class="w"> </span><span class="nn">ts</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="kn">import</span><span class="w"> </span><span class="nn">numpy</span><span class="w"> </span><span class="k">as</span><span class="w"> </span><span class="nn">np</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">dataset</span> <span class="o">=</span> <span class="n">ts</span><span class="o">.</span><span class="n">open</span><span class="p">({</span>
 <span class="gp">... </span>    <span class="s1">&#39;driver&#39;</span><span class="p">:</span> <span class="s1">&#39;n5&#39;</span><span class="p">,</span>
 <span class="gp">... </span>    <span class="s1">&#39;kvstore&#39;</span><span class="p">:</span> <span class="p">{</span>
@@ -698,8 +698,8 @@ <h2 id="reading-the-janelia-flyem-hemibrain-dataset">Reading the Janelia FlyEM H
 <p>While this dataset is public, the <a class="reference internal" href="../kvstore/gcs/index.html#gcs-kvstore-driver"><span class="std std-ref">gcs Key-Value Store driver</span></a> currently requires
 that you supply <a class="reference internal" href="../kvstore/gcs/index.html#gcs-authentication"><span class="std std-ref">Google Cloud credentials</span></a>.</p>
 <p>Open the dataset asynchronously to obtain a <a class="reference internal" href="api/tensorstore.Future.html" title="tensorstore.Future (Python class) — Handle for consuming the result of an asynchronous operation."><code class="xref py py-obj docutils literal notranslate"><span class="pre">tensorstore.Future</span></code></a>:</p>
-<div class="highlight-pycon notranslate"><div class="highlight"><pre><span></span><code><span class="gp">&gt;&gt;&gt; </span><span class="kn">import</span> <span class="nn">tensorstore</span> <span class="k">as</span> <span class="nn">ts</span>
-<span class="gp">&gt;&gt;&gt; </span><span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
+<div class="highlight-pycon notranslate"><div class="highlight"><pre><span></span><code><span class="gp">&gt;&gt;&gt; </span><span class="kn">import</span><span class="w"> </span><span class="nn">tensorstore</span><span class="w"> </span><span class="k">as</span><span class="w"> </span><span class="nn">ts</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="kn">import</span><span class="w"> </span><span class="nn">numpy</span><span class="w"> </span><span class="k">as</span><span class="w"> </span><span class="nn">np</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">dataset_future</span> <span class="o">=</span> <span class="n">ts</span><span class="o">.</span><span class="n">open</span><span class="p">({</span>
 <span class="gp">... </span>    <span class="s1">&#39;driver&#39;</span><span class="p">:</span>
 <span class="gp">... </span>        <span class="s1">&#39;neuroglancer_precomputed&#39;</span><span class="p">,</span>
@@ -855,7 +855,7 @@ <h2 id="reading-the-janelia-flyem-hemibrain-dataset">Reading the Janelia FlyEM H
 <span class="go">       [1132030694, 1132030694, 1132030694, ..., 5813054053, 5813054053,</span>
 <span class="go">        5813054053],</span>
 <span class="go">       [1132030694, 1132030694, 1132030694, ..., 5813054053, 5813054053,</span>
-<span class="go">        5813054053]], dtype=uint64)</span>
+<span class="go">        5813054053]], shape=(100, 100), dtype=uint64)</span>
 </code></pre></div>
 </div>
 <p>Conversion to an <a class="reference external" href="https://numpy.org/doc/stable/reference/generated/numpy.ndarray.html#numpy.ndarray" title="(in NumPy v1.24)"><code class="xref py py-obj docutils literal notranslate"><span class="pre">numpy.ndarray</span></code></a> also implicitly performs a synchronous
@@ -873,7 +873,7 @@ <h2 id="reading-the-janelia-flyem-hemibrain-dataset">Reading the Janelia FlyEM H
 <span class="go">       [1132030694, 1132030694, 1132030694, ..., 5813054053, 5813054053,</span>
 <span class="go">        5813054053],</span>
 <span class="go">       [1132030694, 1132030694, 1132030694, ..., 5813054053, 5813054053,</span>
-<span class="go">        5813054053]], dtype=uint64)</span>
+<span class="go">        5813054053]], shape=(100, 100), dtype=uint64)</span>
 </code></pre></div>
 </div>