Deploying to gh-pages from @ 6082f71 🚀

Perfexionists · Jul 31, 2024 · b66ab5b · b66ab5b
1 parent cb83187
commit b66ab5b
Show file tree

Hide file tree

Showing 29 changed files with 473 additions and 447 deletions.
diff --git a/.buildinfo b/.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: 8cb69f36bde6a9b0b4f53db67f466b16
+config: 7ea6eeb38a7d7ea63d196e633d6a0dab
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/_modules/index.html b/_modules/index.html
@@ -4,10 +4,10 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Overview: module code &#8212; Perun 0.23.2 documentation</title>
+    <title>Overview: module code &#8212; Perun 0.23.3 documentation</title>
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=fa44fd50" />
     <link rel="stylesheet" type="text/css" href="../_static/perun.css?v=25c05b3f" />
-    <script src="../_static/documentation_options.js?v=b4d3b1f5"></script>
+    <script src="../_static/documentation_options.js?v=10ab35ec"></script>
     <script src="../_static/doctools.js?v=9a2dae69"></script>
     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <link rel="index" title="Index" href="../genindex.html" />
@@ -71,8 +71,8 @@ <h3 id="searchlabel">Quick search</h3>
       &#169;2017, Tomas Fiedor, Jiri Pavela, Simon Stupinsky, et al..
 
       |
-      Powered by <a href="https://www.sphinx-doc.org/">Sphinx 7.4.7</a>
-      &amp; <a href="https://alabaster.readthedocs.io">Alabaster 0.7.16</a>
+      Powered by <a href="https://www.sphinx-doc.org/">Sphinx 8.0.2</a>
+      &amp; <a href="https://alabaster.readthedocs.io">Alabaster 1.0.0</a>
 
     </div>
 

diff --git a/_modules/perun/profile/convert.html b/_modules/perun/profile/convert.html
@@ -4,10 +4,10 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>perun.profile.convert &#8212; Perun 0.23.2 documentation</title>
+    <title>perun.profile.convert &#8212; Perun 0.23.3 documentation</title>
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=fa44fd50" />
     <link rel="stylesheet" type="text/css" href="../../../_static/perun.css?v=25c05b3f" />
-    <script src="../../../_static/documentation_options.js?v=b4d3b1f5"></script>
+    <script src="../../../_static/documentation_options.js?v=10ab35ec"></script>
     <script src="../../../_static/doctools.js?v=9a2dae69"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <link rel="index" title="Index" href="../../../genindex.html" />
@@ -59,6 +59,7 @@ <h1>Source code for perun.profile.convert</h1><div class="highlight"><pre>
 <span class="c1"># Perun Imports</span>
 <span class="kn">from</span> <span class="nn">perun.postprocess.regression_analysis</span> <span class="kn">import</span> <span class="n">transform</span>
 <span class="kn">from</span> <span class="nn">perun.profile</span> <span class="kn">import</span> <span class="n">query</span>
+<span class="kn">from</span> <span class="nn">perun.utils</span> <span class="kn">import</span> <span class="n">log</span>
 <span class="kn">from</span> <span class="nn">perun.utils.common</span> <span class="kn">import</span> <span class="n">common_kit</span>
 
 <span class="k">if</span> <span class="n">TYPE_CHECKING</span><span class="p">:</span>
@@ -106,7 +107,9 @@ <h1>Source code for perun.profile.convert</h1><div class="highlight"><pre>
     <span class="n">values</span><span class="p">[</span><span class="s2">&quot;snapshots&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">array</span><span class="o">.</span><span class="n">array</span><span class="p">(</span><span class="s2">&quot;I&quot;</span><span class="p">)</span>
 
     <span class="c1"># All resources at this point should be flat</span>
-    <span class="k">for</span> <span class="n">snapshot</span><span class="p">,</span> <span class="n">resource</span> <span class="ow">in</span> <span class="n">profile</span><span class="o">.</span><span class="n">all_resources</span><span class="p">(</span><span class="n">flatten_values</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
+    <span class="k">for</span> <span class="n">snapshot</span><span class="p">,</span> <span class="n">resource</span> <span class="ow">in</span> <span class="n">log</span><span class="o">.</span><span class="n">progress</span><span class="p">(</span>
+        <span class="n">profile</span><span class="o">.</span><span class="n">all_resources</span><span class="p">(</span><span class="n">flatten_values</span><span class="o">=</span><span class="kc">True</span><span class="p">),</span> <span class="s2">&quot;Converting To Pandas&quot;</span>
+    <span class="p">):</span>
         <span class="n">values</span><span class="p">[</span><span class="s2">&quot;snapshots&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">snapshot</span><span class="p">)</span>
         <span class="k">for</span> <span class="n">resource_key</span> <span class="ow">in</span> <span class="n">resource_keys</span><span class="p">:</span>
             <span class="n">values</span><span class="p">[</span><span class="n">resource_key</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">resource</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">resource_key</span><span class="p">,</span> <span class="n">numpy</span><span class="o">.</span><span class="n">nan</span><span class="p">))</span>
@@ -130,7 +133,7 @@ <h1>Source code for perun.profile.convert</h1><div class="highlight"><pre>
     <span class="n">model_keys</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">query</span><span class="o">.</span><span class="n">all_model_fields_of</span><span class="p">(</span><span class="n">profile</span><span class="p">))</span>
     <span class="n">values</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="n">Any</span><span class="p">]]</span> <span class="o">=</span> <span class="p">{</span><span class="n">key</span><span class="p">:</span> <span class="p">[]</span> <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">model_keys</span><span class="p">}</span>
 
-    <span class="k">for</span> <span class="n">_</span><span class="p">,</span> <span class="n">model</span> <span class="ow">in</span> <span class="n">profile</span><span class="o">.</span><span class="n">all_models</span><span class="p">():</span>
+    <span class="k">for</span> <span class="n">_</span><span class="p">,</span> <span class="n">model</span> <span class="ow">in</span> <span class="n">log</span><span class="o">.</span><span class="n">progress</span><span class="p">(</span><span class="n">profile</span><span class="o">.</span><span class="n">all_models</span><span class="p">(),</span> <span class="n">description</span><span class="o">=</span><span class="s2">&quot;Converting To Pandas&quot;</span><span class="p">):</span>
         <span class="n">flattened_resources</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="nb">list</span><span class="p">(</span><span class="n">query</span><span class="o">.</span><span class="n">all_items_of</span><span class="p">(</span><span class="n">model</span><span class="p">)))</span>
         <span class="k">for</span> <span class="n">model_key</span> <span class="ow">in</span> <span class="n">model_keys</span><span class="p">:</span>
             <span class="n">values</span><span class="p">[</span><span class="n">model_key</span><span class="p">]</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">flattened_resources</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">model_key</span><span class="p">,</span> <span class="n">numpy</span><span class="o">.</span><span class="n">nan</span><span class="p">))</span>
@@ -303,8 +306,8 @@ <h3 id="searchlabel">Quick search</h3>
       &#169;2017, Tomas Fiedor, Jiri Pavela, Simon Stupinsky, et al..
 
       |
-      Powered by <a href="https://www.sphinx-doc.org/">Sphinx 7.4.7</a>
-      &amp; <a href="https://alabaster.readthedocs.io">Alabaster 0.7.16</a>
+      Powered by <a href="https://www.sphinx-doc.org/">Sphinx 8.0.2</a>
+      &amp; <a href="https://alabaster.readthedocs.io">Alabaster 1.0.0</a>
 
     </div>
 

diff --git a/_modules/perun/profile/factory.html b/_modules/perun/profile/factory.html
@@ -4,10 +4,10 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>perun.profile.factory &#8212; Perun 0.23.2 documentation</title>
+    <title>perun.profile.factory &#8212; Perun 0.23.3 documentation</title>
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=fa44fd50" />
     <link rel="stylesheet" type="text/css" href="../../../_static/perun.css?v=25c05b3f" />
-    <script src="../../../_static/documentation_options.js?v=b4d3b1f5"></script>
+    <script src="../../../_static/documentation_options.js?v=10ab35ec"></script>
     <script src="../../../_static/doctools.js?v=9a2dae69"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <link rel="index" title="Index" href="../../../genindex.html" />
@@ -42,7 +42,7 @@ <h1>Source code for perun.profile.factory</h1><div class="highlight"><pre>
 
 <span class="c1"># Standard Imports</span>
 <span class="kn">from</span> <span class="nn">collections.abc</span> <span class="kn">import</span> <span class="n">MutableMapping</span>
-<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span><span class="p">,</span> <span class="n">Iterator</span><span class="p">,</span> <span class="n">Iterable</span><span class="p">,</span> <span class="n">TYPE_CHECKING</span>
+<span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Any</span><span class="p">,</span> <span class="n">Iterator</span><span class="p">,</span> <span class="n">Iterable</span><span class="p">,</span> <span class="n">TYPE_CHECKING</span><span class="p">,</span> <span class="n">Literal</span>
 <span class="kn">import</span> <span class="nn">collections</span>
 <span class="kn">import</span> <span class="nn">itertools</span>
 <span class="kn">import</span> <span class="nn">operator</span>
@@ -55,6 +55,7 @@ <h1>Source code for perun.profile.factory</h1><div class="highlight"><pre>
 <span class="kn">from</span> <span class="nn">perun.postprocess.regression_analysis</span> <span class="kn">import</span> <span class="n">regression_models</span>
 <span class="kn">from</span> <span class="nn">perun.profile</span> <span class="kn">import</span> <span class="n">convert</span><span class="p">,</span> <span class="n">query</span>
 <span class="kn">from</span> <span class="nn">perun.utils</span> <span class="kn">import</span> <span class="n">log</span>
+<span class="kn">from</span> <span class="nn">perun.utils.common</span> <span class="kn">import</span> <span class="n">common_kit</span>
 <span class="kn">import</span> <span class="nn">perun.check.detection_kit</span> <span class="k">as</span> <span class="nn">detection</span>
 <span class="kn">import</span> <span class="nn">perun.postprocess.regressogram.methods</span> <span class="k">as</span> <span class="nn">nparam_methods</span>
 
@@ -126,6 +127,15 @@ <h1>Source code for perun.profile.factory</h1><div class="highlight"><pre>
                 <span class="bp">self</span><span class="o">.</span><span class="n">_storage</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value</span>
         <span class="n">config</span><span class="o">.</span><span class="n">runtime</span><span class="p">()</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s2">&quot;context.profiles&quot;</span><span class="p">,</span> <span class="bp">self</span><span class="p">)</span>
 
+    <span class="k">def</span> <span class="nf">apply</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">agg</span><span class="p">:</span> <span class="n">Literal</span><span class="p">[</span><span class="s2">&quot;sum&quot;</span><span class="p">,</span> <span class="s2">&quot;min&quot;</span><span class="p">,</span> <span class="s2">&quot;max&quot;</span><span class="p">,</span> <span class="s2">&quot;avg&quot;</span><span class="p">,</span> <span class="s2">&quot;mean&quot;</span><span class="p">,</span> <span class="s2">&quot;med&quot;</span><span class="p">,</span> <span class="s2">&quot;median&quot;</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Applies aggregation function to each counted resource</span>
+
+<span class="sd">        :param agg: name of the aggreagation function</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">for</span> <span class="n">res</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_storage</span><span class="p">[</span><span class="s2">&quot;resources&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">values</span><span class="p">():</span>
+            <span class="k">for</span> <span class="n">item</span><span class="p">,</span> <span class="n">val</span> <span class="ow">in</span> <span class="n">res</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+                <span class="n">res</span><span class="p">[</span><span class="n">item</span><span class="p">]</span> <span class="o">=</span> <span class="p">[</span><span class="n">common_kit</span><span class="o">.</span><span class="n">aggregate_list</span><span class="p">(</span><span class="n">val</span><span class="p">,</span> <span class="n">agg</span><span class="p">)]</span>
+
     <span class="k">def</span> <span class="nf">update_resources</span><span class="p">(</span>
         <span class="bp">self</span><span class="p">,</span>
         <span class="n">resource_list</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
@@ -482,7 +492,7 @@ <h1>Source code for perun.profile.factory</h1><div class="highlight"><pre>
         <span class="n">snapshot_map</span> <span class="o">=</span> <span class="n">collections</span><span class="o">.</span><span class="n">defaultdict</span><span class="p">(</span><span class="nb">list</span><span class="p">)</span>
         <span class="k">for</span> <span class="n">number_of</span><span class="p">,</span> <span class="n">res</span> <span class="ow">in</span> <span class="n">itertools</span><span class="o">.</span><span class="n">groupby</span><span class="p">(</span><span class="n">all_resources</span><span class="p">,</span> <span class="n">operator</span><span class="o">.</span><span class="n">itemgetter</span><span class="p">(</span><span class="mi">0</span><span class="p">)):</span>
             <span class="n">snapshot_map</span><span class="p">[</span><span class="n">number_of</span><span class="p">]</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="nb">map</span><span class="p">(</span><span class="n">operator</span><span class="o">.</span><span class="n">itemgetter</span><span class="p">(</span><span class="mi">1</span><span class="p">),</span> <span class="n">res</span><span class="p">))</span>
-        <span class="n">maximal_snapshot</span> <span class="o">=</span> <span class="nb">max</span><span class="p">(</span><span class="n">snapshot_map</span><span class="o">.</span><span class="n">keys</span><span class="p">())</span>
+        <span class="n">maximal_snapshot</span> <span class="o">=</span> <span class="nb">max</span><span class="p">(</span><span class="n">snapshot_map</span><span class="o">.</span><span class="n">keys</span><span class="p">()</span> <span class="ow">or</span> <span class="p">[</span><span class="mi">0</span><span class="p">])</span>
         <span class="k">for</span> <span class="n">i</span> <span class="ow">in</span> <span class="nb">range</span><span class="p">(</span><span class="mi">0</span><span class="p">,</span> <span class="n">maximal_snapshot</span> <span class="o">+</span> <span class="mi">1</span><span class="p">):</span>
             <span class="k">yield</span> <span class="n">i</span><span class="p">,</span> <span class="n">snapshot_map</span><span class="p">[</span><span class="n">i</span><span class="p">]</span></div>
 
@@ -537,8 +547,8 @@ <h3 id="searchlabel">Quick search</h3>
       &#169;2017, Tomas Fiedor, Jiri Pavela, Simon Stupinsky, et al..
 
       |
-      Powered by <a href="https://www.sphinx-doc.org/">Sphinx 7.4.7</a>
-      &amp; <a href="https://alabaster.readthedocs.io">Alabaster 0.7.16</a>
+      Powered by <a href="https://www.sphinx-doc.org/">Sphinx 8.0.2</a>
+      &amp; <a href="https://alabaster.readthedocs.io">Alabaster 1.0.0</a>
 
     </div>
 

diff --git a/_modules/perun/profile/query.html b/_modules/perun/profile/query.html
@@ -4,10 +4,10 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>perun.profile.query &#8212; Perun 0.23.2 documentation</title>
+    <title>perun.profile.query &#8212; Perun 0.23.3 documentation</title>
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=fa44fd50" />
     <link rel="stylesheet" type="text/css" href="../../../_static/perun.css?v=25c05b3f" />
-    <script src="../../../_static/documentation_options.js?v=b4d3b1f5"></script>
+    <script src="../../../_static/documentation_options.js?v=10ab35ec"></script>
     <script src="../../../_static/doctools.js?v=9a2dae69"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <link rel="index" title="Index" href="../../../genindex.html" />
@@ -392,8 +392,8 @@ <h3 id="searchlabel">Quick search</h3>
       &#169;2017, Tomas Fiedor, Jiri Pavela, Simon Stupinsky, et al..
 
       |
-      Powered by <a href="https://www.sphinx-doc.org/">Sphinx 7.4.7</a>
-      &amp; <a href="https://alabaster.readthedocs.io">Alabaster 0.7.16</a>
+      Powered by <a href="https://www.sphinx-doc.org/">Sphinx 8.0.2</a>
+      &amp; <a href="https://alabaster.readthedocs.io">Alabaster 1.0.0</a>
 
     </div>
 

diff --git a/_modules/perun/utils/structs.html b/_modules/perun/utils/structs.html
@@ -4,10 +4,10 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>perun.utils.structs &#8212; Perun 0.23.2 documentation</title>
+    <title>perun.utils.structs &#8212; Perun 0.23.3 documentation</title>
     <link rel="stylesheet" type="text/css" href="../../../_static/pygments.css?v=fa44fd50" />
     <link rel="stylesheet" type="text/css" href="../../../_static/perun.css?v=25c05b3f" />
-    <script src="../../../_static/documentation_options.js?v=b4d3b1f5"></script>
+    <script src="../../../_static/documentation_options.js?v=10ab35ec"></script>
     <script src="../../../_static/doctools.js?v=9a2dae69"></script>
     <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <link rel="index" title="Index" href="../../../genindex.html" />
@@ -769,8 +769,8 @@ <h3 id="searchlabel">Quick search</h3>
       &#169;2017, Tomas Fiedor, Jiri Pavela, Simon Stupinsky, et al..
 
       |
-      Powered by <a href="https://www.sphinx-doc.org/">Sphinx 7.4.7</a>
-      &amp; <a href="https://alabaster.readthedocs.io">Alabaster 0.7.16</a>
+      Powered by <a href="https://www.sphinx-doc.org/">Sphinx 8.0.2</a>
+      &amp; <a href="https://alabaster.readthedocs.io">Alabaster 1.0.0</a>
 
     </div>