Add updatez and updatez_compressed to update arrays in a single file …

…in numpy's npz format

CHANGELOG.rst

@@ -1,7 +1,9 @@
 Changelog
 ---------
 
-v1.28 (??? 2023)
+v1.28 (Jan 2023)
+    * Add `updatez` and `updatez_compressed` to update arrays in a single file
+      in numpy's npz format.
     * Do not set color for missing data; only existed for sron palettes.
     * Add --dpi as a standard option in `mcPlot`.
     * Use mpl.colormaps[name] instead of mpl.colormaps.get_cmap(name)

README.rst

@@ -224,6 +224,10 @@ Functions and modules (alphabetical)
      - Prints arguments on screen and in file, like Unix/Linux tee utility
    * - text2plot
      - Write text on a plot
+   * - updatez
+     - Update arrays in uncompressed numpy .npz format
+   * - updatez_compressed
+     - Update arrays in compressed numpy .npz format
    * - us2date
      - Convert dates to standard date format DD.MM.YYYY hh:mm:ss
    * - us2en
@@ -484,6 +488,10 @@ Functions and modules per category
          - Same as `readnetcdf`
        * - readnetcdf
          - Read variables from netCDF file
+       * - updatez
+         - Update arrays in uncompressed numpy .npz format
+       * - updatez_compressed
+         - Update arrays in compressed numpy .npz format
        * - xlsread
          - Same as `xread`
        * - xlsxread

docs/html/.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: 42cf350847c210e748062d339f610018
+config: e43cbb6c18b9130395cb78864a62a8fc
 tags: 645f666f9bcd5a90fca523b33c5a78b7

docs/html/_modules/index.html

@@ -56,6 +56,7 @@ <h1>All modules for which code is available</h1>
 <li><a href="pyjams/means.html">pyjams.means</a></li>
 <li><a href="pyjams/morris_method.html">pyjams.morris_method</a></li>
 <li><a href="pyjams/ncio/netcdfio.html">pyjams.ncio.netcdfio</a></li>
+<li><a href="pyjams/npyio.html">pyjams.npyio</a></li>
 <li><a href="pyjams/position.html">pyjams.position</a></li>
 <li><a href="pyjams/readnetcdf.html">pyjams.readnetcdf</a></li>
 <li><a href="pyjams/romanliterals.html">pyjams.romanliterals</a></li>
@@ -127,7 +128,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/alpha_equ_h2o.html

@@ -242,7 +242,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/alpha_kin_h2o.html

@@ -229,7 +229,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/argsort.html

@@ -495,7 +495,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/class_datetime.html

@@ -2250,7 +2250,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/closest.html

@@ -187,7 +187,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/color/color.html

@@ -64,6 +64,12 @@ <h1>Source code for pyjams.color.color</h1><div class="highlight"><pre>
 <span class="sd">    * &#39;cname&#39; can be list of names in &#39;get_color&#39;, Apr 2022, Matthias Cuntz</span>
 <span class="sd">    * Register ufz colors only once, Apr 2022, Matthias Cuntz</span>
 <span class="sd">    * Added print_colors, Apr 2022, Matthias Cuntz</span>
+<span class="sd">    * Use matplotlib.colormaps.get_cmap instead of deprecated</span>
+<span class="sd">      matplotlib.cm.get_cmap, Dec 2022, Matthias Cuntz</span>
+<span class="sd">    * Use matplotlib.colormaps[name] instead of</span>
+<span class="sd">      matplotlib.colormaps.get_cmap(name) to work with matplotlib &lt; v3.6,</span>
+<span class="sd">      Jan 2023, Matthias Cuntz</span>
+<span class="sd">    * Do not set_bad() for sron palettes, Jan 2023, Matthias Cuntz</span>
 
 <span class="sd">&quot;&quot;&quot;</span>
 
@@ -321,7 +327,7 @@ <h1>Source code for pyjams.color.color</h1><div class="highlight"><pre>
 
     <span class="n">found_palette</span> <span class="o">=</span> <span class="kc">False</span>
     <span class="n">nosubsample</span> <span class="o">=</span> <span class="kc">False</span>
-    <span class="n">miss</span> <span class="o">=</span> <span class="kc">None</span>
+    <span class="c1"># miss = None</span>
 
     <span class="k">if</span> <span class="ow">not</span> <span class="n">found_palette</span><span class="p">:</span>
         <span class="k">for</span> <span class="n">bb</span> <span class="ow">in</span> <span class="n">pyjams_collections</span><span class="p">:</span>
@@ -341,7 +347,7 @@ <h1>Source code for pyjams.color.color</h1><div class="highlight"><pre>
                 <span class="k">elif</span> <span class="n">bb</span> <span class="o">==</span> <span class="s1">&#39;sron_colormaps&#39;</span><span class="p">:</span>
                     <span class="n">colors</span> <span class="o">=</span> <span class="p">[</span> <span class="n">mpl</span><span class="o">.</span><span class="n">colors</span><span class="o">.</span><span class="n">colorConverter</span><span class="o">.</span><span class="n">to_rgb</span><span class="p">(</span><span class="n">i</span><span class="p">)</span>
                                <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">dd</span><span class="p">[</span><span class="n">palette</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span> <span class="p">]</span>
-                    <span class="n">miss</span> <span class="o">=</span> <span class="n">mpl</span><span class="o">.</span><span class="n">colors</span><span class="o">.</span><span class="n">colorConverter</span><span class="o">.</span><span class="n">to_rgb</span><span class="p">(</span><span class="n">dd</span><span class="p">[</span><span class="n">palette</span><span class="p">][</span><span class="mi">1</span><span class="p">])</span>
+                    <span class="c1"># miss = mpl.colors.colorConverter.to_rgb(dd[palette][1])</span>
                 <span class="k">elif</span> <span class="n">bb</span> <span class="o">==</span> <span class="s1">&#39;sron_functions&#39;</span><span class="p">:</span>
                     <span class="n">nosubsample</span> <span class="o">=</span> <span class="kc">True</span>
                     <span class="k">if</span> <span class="n">ncol</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
@@ -351,7 +357,7 @@ <h1>Source code for pyjams.color.color</h1><div class="highlight"><pre>
                     <span class="n">cols</span> <span class="o">=</span> <span class="n">dd</span><span class="p">[</span><span class="n">palette</span><span class="p">](</span><span class="n">ncol1</span><span class="p">)</span>
                     <span class="n">colors</span> <span class="o">=</span> <span class="p">[</span> <span class="n">mpl</span><span class="o">.</span><span class="n">colors</span><span class="o">.</span><span class="n">colorConverter</span><span class="o">.</span><span class="n">to_rgb</span><span class="p">(</span><span class="n">i</span><span class="p">)</span>
                                <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">cols</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="p">]</span>
-                    <span class="n">miss</span> <span class="o">=</span> <span class="n">mpl</span><span class="o">.</span><span class="n">colors</span><span class="o">.</span><span class="n">colorConverter</span><span class="o">.</span><span class="n">to_rgb</span><span class="p">(</span><span class="n">cols</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span>
+                    <span class="c1"># miss = mpl.colors.colorConverter.to_rgb(cols[1])</span>
 
     <span class="k">if</span> <span class="ow">not</span> <span class="n">found_palette</span><span class="p">:</span>
         <span class="k">for</span> <span class="n">bb</span> <span class="ow">in</span> <span class="n">sron2012_collections</span><span class="p">:</span>
@@ -403,7 +409,9 @@ <h1>Source code for pyjams.color.color</h1><div class="highlight"><pre>
         <span class="n">mplmaps</span> <span class="o">=</span> <span class="p">[</span> <span class="n">i</span> <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="n">amplmaps</span> <span class="k">if</span> <span class="ow">not</span> <span class="n">i</span><span class="o">.</span><span class="n">endswith</span><span class="p">(</span><span class="s1">&#39;_r&#39;</span><span class="p">)</span> <span class="p">]</span>
         <span class="k">if</span> <span class="n">palette</span> <span class="ow">in</span> <span class="n">mplmaps</span><span class="p">:</span>
             <span class="n">found_palette</span> <span class="o">=</span> <span class="kc">True</span>
-            <span class="n">cmap</span> <span class="o">=</span> <span class="n">mpl</span><span class="o">.</span><span class="n">colormaps</span><span class="o">.</span><span class="n">get_cmap</span><span class="p">(</span><span class="n">palette</span><span class="p">)</span>
+            <span class="c1"># cmap = mpl.cm.get_cmap(palette)</span>
+            <span class="c1"># cmap = mpl.colormaps.get_cmap(palette)</span>
+            <span class="n">cmap</span> <span class="o">=</span> <span class="n">mpl</span><span class="o">.</span><span class="n">colormaps</span><span class="p">[</span><span class="n">palette</span><span class="p">]</span>
             <span class="k">try</span><span class="p">:</span>
                 <span class="c1"># mpl.colors.ListedColormap</span>
                 <span class="n">colors</span> <span class="o">=</span> <span class="n">cmap</span><span class="o">.</span><span class="n">colors</span>
@@ -415,7 +423,9 @@ <h1>Source code for pyjams.color.color</h1><div class="highlight"><pre>
             <span class="k">if</span> <span class="n">palette</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="ow">in</span> <span class="n">lmplmaps</span><span class="p">:</span>
                 <span class="n">found_palette</span> <span class="o">=</span> <span class="kc">True</span>
                 <span class="n">ipalette</span> <span class="o">=</span> <span class="n">lmplmaps</span><span class="o">.</span><span class="n">index</span><span class="p">(</span><span class="n">palette</span><span class="o">.</span><span class="n">lower</span><span class="p">())</span>
-                <span class="n">cmap</span> <span class="o">=</span> <span class="n">mpl</span><span class="o">.</span><span class="n">colormaps</span><span class="o">.</span><span class="n">get_cmap</span><span class="p">(</span><span class="n">mplmaps</span><span class="p">[</span><span class="n">ipalette</span><span class="p">])</span>
+                <span class="c1"># cmap = mpl.cm.get_cmap(mplmaps[ipalette])</span>
+                <span class="c1"># cmap = mpl.colormaps.get_cmap(mplmaps[ipalette])</span>
+                <span class="n">cmap</span> <span class="o">=</span> <span class="n">mpl</span><span class="o">.</span><span class="n">colormaps</span><span class="p">[</span><span class="n">mplmaps</span><span class="p">[</span><span class="n">ipalette</span><span class="p">]]</span>
                 <span class="k">try</span><span class="p">:</span>
                     <span class="c1"># mpl.colors.ListedColormap</span>
                     <span class="n">colors</span> <span class="o">=</span> <span class="n">cmap</span><span class="o">.</span><span class="n">colors</span>
@@ -461,9 +471,9 @@ <h1>Source code for pyjams.color.color</h1><div class="highlight"><pre>
 
     <span class="k">if</span> <span class="n">as_cmap</span><span class="p">:</span>
         <span class="n">colors</span> <span class="o">=</span> <span class="n">mpl</span><span class="o">.</span><span class="n">colors</span><span class="o">.</span><span class="n">ListedColormap</span><span class="p">(</span><span class="n">colors</span><span class="p">)</span>
-        <span class="k">if</span> <span class="n">mpl</span><span class="o">.</span><span class="n">__version__</span> <span class="o">&gt;</span> <span class="s1">&#39;3.4.0&#39;</span><span class="p">:</span>
-            <span class="k">if</span> <span class="n">miss</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-                <span class="n">colors</span><span class="o">.</span><span class="n">set_bad</span><span class="p">(</span><span class="n">miss</span><span class="p">)</span>
+        <span class="c1"># if mpl.__version__ &gt; &#39;3.4.0&#39;:</span>
+        <span class="c1">#     if miss is not None:</span>
+        <span class="c1">#         colors.set_bad(miss)</span>
 
     <span class="k">return</span> <span class="n">colors</span></div>
 
@@ -879,7 +889,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/date2date.html

@@ -838,7 +838,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/division.html

@@ -242,7 +242,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/esat.html

@@ -511,7 +511,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/fgui.html

@@ -325,7 +325,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/fsread.html

@@ -2063,7 +2063,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/functions/fit_functions.html

@@ -1727,7 +1727,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/functions/general_functions.html

@@ -192,7 +192,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/functions/logistic_function.html

@@ -641,7 +641,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/functions/opti_test_functions.html

@@ -349,7 +349,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/functions/sa_test_functions.html

@@ -922,7 +922,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/gridcellarea.html

@@ -239,7 +239,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/kernel_regression.html

@@ -457,7 +457,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>

docs/html/_modules/pyjams/mad.html

@@ -444,7 +444,7 @@ <h3 id="searchlabel">Quick search</h3>
       <div class="clearer"></div>
     </div>
     <div class="footer">
-      &copy;2012-2022, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
+      &copy;2012-2023, Matthias Cuntz, Juliane Mai, Stephan Thober, Arndt Piayda.
 
       |
       Powered by <a href="http://sphinx-doc.org/">Sphinx 5.0.2</a>