mwever: Merge pull request #192 from automl/190-working-directory-uni…

…ntuitive-selection-of-runs
automl · Nov 4, 2024 · 27037b2 · 27037b2
1 parent 44e91ad
commit 27037b2
Show file tree

Hide file tree

Showing 125 changed files with 580 additions and 26 deletions.
diff --git a/development/.buildinfo b/development/.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: 5f5cc67e9884aa53630cf60444ed0069
+config: 7025bbd0c56da8b033f6701c08ab0258
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/development/.doctrees/api/deepcave.evaluators.ablation.doctree b/development/.doctrees/api/deepcave.evaluators.ablation.doctree
diff --git a/development/.doctrees/api/deepcave.evaluators.doctree b/development/.doctrees/api/deepcave.evaluators.doctree
diff --git a/development/.doctrees/api/deepcave.evaluators.epm.doctree b/development/.doctrees/api/deepcave.evaluators.epm.doctree
diff --git a/development/.doctrees/api/deepcave.evaluators.epm.fanova_forest.doctree b/development/.doctrees/api/deepcave.evaluators.epm.fanova_forest.doctree
diff --git a/development/.doctrees/api/deepcave.evaluators.epm.random_forest.doctree b/development/.doctrees/api/deepcave.evaluators.epm.random_forest.doctree
diff --git a/development/.doctrees/api/deepcave.evaluators.epm.random_forest_surrogate.doctree b/development/.doctrees/api/deepcave.evaluators.epm.random_forest_surrogate.doctree
diff --git a/development/.doctrees/api/deepcave.evaluators.epm.utils.doctree b/development/.doctrees/api/deepcave.evaluators.epm.utils.doctree
diff --git a/development/.doctrees/api/deepcave.evaluators.fanova.doctree b/development/.doctrees/api/deepcave.evaluators.fanova.doctree
diff --git a/development/.doctrees/api/deepcave.evaluators.footprint.doctree b/development/.doctrees/api/deepcave.evaluators.footprint.doctree
diff --git a/development/.doctrees/api/deepcave.evaluators.lpi.doctree b/development/.doctrees/api/deepcave.evaluators.lpi.doctree
diff --git a/development/.doctrees/api/deepcave.evaluators.mo_ablation.doctree b/development/.doctrees/api/deepcave.evaluators.mo_ablation.doctree
diff --git a/development/.doctrees/api/deepcave.evaluators.mo_fanova.doctree b/development/.doctrees/api/deepcave.evaluators.mo_fanova.doctree
diff --git a/development/.doctrees/api/deepcave.evaluators.mo_lpi.doctree b/development/.doctrees/api/deepcave.evaluators.mo_lpi.doctree
diff --git a/development/.doctrees/api/deepcave.layouts.doctree b/development/.doctrees/api/deepcave.layouts.doctree
diff --git a/development/.doctrees/api/deepcave.layouts.header.doctree b/development/.doctrees/api/deepcave.layouts.header.doctree
diff --git a/development/.doctrees/api/deepcave.layouts.not_found.doctree b/development/.doctrees/api/deepcave.layouts.not_found.doctree
diff --git a/development/.doctrees/api/deepcave.layouts.sidebar.doctree b/development/.doctrees/api/deepcave.layouts.sidebar.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.budget.doctree b/development/.doctrees/api/deepcave.plugins.budget.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.doctree b/development/.doctrees/api/deepcave.plugins.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.dynamic.doctree b/development/.doctrees/api/deepcave.plugins.dynamic.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.hyperparameter.ablation_paths.doctree b/development/.doctrees/api/deepcave.plugins.hyperparameter.ablation_paths.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.hyperparameter.configuration_cube.doctree b/development/.doctrees/api/deepcave.plugins.hyperparameter.configuration_cube.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.hyperparameter.doctree b/development/.doctrees/api/deepcave.plugins.hyperparameter.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.hyperparameter.importances.doctree b/development/.doctrees/api/deepcave.plugins.hyperparameter.importances.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.hyperparameter.parallel_coordinates.doctree b/development/.doctrees/api/deepcave.plugins.hyperparameter.parallel_coordinates.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.hyperparameter.pdp.doctree b/development/.doctrees/api/deepcave.plugins.hyperparameter.pdp.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.hyperparameter.symbolic_explanations.doctree b/development/.doctrees/api/deepcave.plugins.hyperparameter.symbolic_explanations.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.objective.doctree b/development/.doctrees/api/deepcave.plugins.objective.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.static.doctree b/development/.doctrees/api/deepcave.plugins.static.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.summary.configurations.doctree b/development/.doctrees/api/deepcave.plugins.summary.configurations.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.summary.doctree b/development/.doctrees/api/deepcave.plugins.summary.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.summary.footprint.doctree b/development/.doctrees/api/deepcave.plugins.summary.footprint.doctree
diff --git a/development/.doctrees/api/deepcave.plugins.summary.overview.doctree b/development/.doctrees/api/deepcave.plugins.summary.overview.doctree
diff --git a/development/.doctrees/api/deepcave.runs.converters.amltk.doctree b/development/.doctrees/api/deepcave.runs.converters.amltk.doctree
diff --git a/development/.doctrees/api/deepcave.runs.converters.bohb.doctree b/development/.doctrees/api/deepcave.runs.converters.bohb.doctree
diff --git a/development/.doctrees/api/deepcave.runs.converters.dataframe.doctree b/development/.doctrees/api/deepcave.runs.converters.dataframe.doctree
diff --git a/development/.doctrees/api/deepcave.runs.converters.deepcave.doctree b/development/.doctrees/api/deepcave.runs.converters.deepcave.doctree
diff --git a/development/.doctrees/api/deepcave.runs.converters.doctree b/development/.doctrees/api/deepcave.runs.converters.doctree
diff --git a/development/.doctrees/api/deepcave.runs.converters.optuna.doctree b/development/.doctrees/api/deepcave.runs.converters.optuna.doctree
diff --git a/development/.doctrees/api/deepcave.runs.converters.smac3v1.doctree b/development/.doctrees/api/deepcave.runs.converters.smac3v1.doctree
diff --git a/development/.doctrees/api/deepcave.runs.converters.smac3v2.doctree b/development/.doctrees/api/deepcave.runs.converters.smac3v2.doctree
diff --git a/development/.doctrees/api/deepcave.runs.doctree b/development/.doctrees/api/deepcave.runs.doctree
diff --git a/development/.doctrees/api/deepcave.runs.exceptions.doctree b/development/.doctrees/api/deepcave.runs.exceptions.doctree
diff --git a/development/.doctrees/api/deepcave.runs.group.doctree b/development/.doctrees/api/deepcave.runs.group.doctree
diff --git a/development/.doctrees/api/deepcave.runs.handler.doctree b/development/.doctrees/api/deepcave.runs.handler.doctree
diff --git a/development/.doctrees/api/deepcave.runs.objective.doctree b/development/.doctrees/api/deepcave.runs.objective.doctree
diff --git a/development/.doctrees/api/deepcave.runs.recorder.doctree b/development/.doctrees/api/deepcave.runs.recorder.doctree
diff --git a/development/.doctrees/api/deepcave.runs.run.doctree b/development/.doctrees/api/deepcave.runs.run.doctree
diff --git a/development/.doctrees/api/deepcave.runs.status.doctree b/development/.doctrees/api/deepcave.runs.status.doctree
diff --git a/development/.doctrees/api/deepcave.runs.trial.doctree b/development/.doctrees/api/deepcave.runs.trial.doctree
diff --git a/development/.doctrees/api/deepcave.utils.cache.doctree b/development/.doctrees/api/deepcave.utils.cache.doctree
diff --git a/development/.doctrees/api/deepcave.utils.cast.doctree b/development/.doctrees/api/deepcave.utils.cast.doctree
diff --git a/development/.doctrees/api/deepcave.utils.compression.doctree b/development/.doctrees/api/deepcave.utils.compression.doctree
diff --git a/development/.doctrees/api/deepcave.utils.configs.doctree b/development/.doctrees/api/deepcave.utils.configs.doctree
diff --git a/development/.doctrees/api/deepcave.utils.configspace.doctree b/development/.doctrees/api/deepcave.utils.configspace.doctree
diff --git a/development/.doctrees/api/deepcave.utils.converters.doctree b/development/.doctrees/api/deepcave.utils.converters.doctree
diff --git a/development/.doctrees/api/deepcave.utils.dash.doctree b/development/.doctrees/api/deepcave.utils.dash.doctree
diff --git a/development/.doctrees/api/deepcave.utils.data_structures.doctree b/development/.doctrees/api/deepcave.utils.data_structures.doctree
diff --git a/development/.doctrees/api/deepcave.utils.docs.doctree b/development/.doctrees/api/deepcave.utils.docs.doctree
diff --git a/development/.doctrees/api/deepcave.utils.doctree b/development/.doctrees/api/deepcave.utils.doctree
diff --git a/development/.doctrees/api/deepcave.utils.files.doctree b/development/.doctrees/api/deepcave.utils.files.doctree
diff --git a/development/.doctrees/api/deepcave.utils.hash.doctree b/development/.doctrees/api/deepcave.utils.hash.doctree
diff --git a/development/.doctrees/api/deepcave.utils.layout.doctree b/development/.doctrees/api/deepcave.utils.layout.doctree
diff --git a/development/.doctrees/api/deepcave.utils.logs.doctree b/development/.doctrees/api/deepcave.utils.logs.doctree
diff --git a/development/.doctrees/api/deepcave.utils.multi_objective_importance.doctree b/development/.doctrees/api/deepcave.utils.multi_objective_importance.doctree
diff --git a/development/.doctrees/api/deepcave.utils.notification.doctree b/development/.doctrees/api/deepcave.utils.notification.doctree
diff --git a/development/.doctrees/api/deepcave.utils.run_caches.doctree b/development/.doctrees/api/deepcave.utils.run_caches.doctree
diff --git a/development/.doctrees/api/deepcave.utils.styled_plotty.doctree b/development/.doctrees/api/deepcave.utils.styled_plotty.doctree
diff --git a/development/.doctrees/api/deepcave.utils.symbolic_regression.doctree b/development/.doctrees/api/deepcave.utils.symbolic_regression.doctree
diff --git a/development/.doctrees/api/deepcave.utils.url.doctree b/development/.doctrees/api/deepcave.utils.url.doctree
diff --git a/development/.doctrees/api/deepcave.utils.util.doctree b/development/.doctrees/api/deepcave.utils.util.doctree
diff --git a/development/.doctrees/converters/bohb.doctree b/development/.doctrees/converters/bohb.doctree
diff --git a/development/.doctrees/converters/custom_converters.doctree b/development/.doctrees/converters/custom_converters.doctree
diff --git a/development/.doctrees/converters/deepcave.doctree b/development/.doctrees/converters/deepcave.doctree
diff --git a/development/.doctrees/converters/optuna.doctree b/development/.doctrees/converters/optuna.doctree
diff --git a/development/.doctrees/converters/smac.doctree b/development/.doctrees/converters/smac.doctree
diff --git a/development/.doctrees/environment.pickle b/development/.doctrees/environment.pickle
diff --git a/development/_downloads/21f8798a167ba643492208cc67bd1e22/minimal.zip b/development/_downloads/21f8798a167ba643492208cc67bd1e22/minimal.zip
diff --git a/development/_downloads/3ad6dd54379f5c5277b43384ae072aa5/ablation_paths.zip b/development/_downloads/3ad6dd54379f5c5277b43384ae072aa5/ablation_paths.zip
diff --git a/development/_downloads/40821b6c90aa18945a4ed76124057823/minimal.ipynb b/development/_downloads/40821b6c90aa18945a4ed76124057823/minimal.ipynb
@@ -35,7 +35,7 @@
       "name": "python",
       "nbconvert_exporter": "python",
       "pygments_lexer": "ipython3",
-      "version": "3.9.19"
+      "version": "3.9.20"
     }
   },
   "nbformat": 4,

diff --git a/development/_downloads/6c6c940b7cd82707fbcc01f7df5fd56f/digits_sklearn.zip b/development/_downloads/6c6c940b7cd82707fbcc01f7df5fd56f/digits_sklearn.zip
diff --git a/development/_downloads/7d7a7d51b729cfd5e3d34696ada6b064/importances.zip b/development/_downloads/7d7a7d51b729cfd5e3d34696ada6b064/importances.zip
diff --git a/development/_downloads/99282791bd8a0f766c85ce43b212a6b7/pdp.ipynb b/development/_downloads/99282791bd8a0f766c85ce43b212a6b7/pdp.ipynb
@@ -35,7 +35,7 @@
       "name": "python",
       "nbconvert_exporter": "python",
       "pygments_lexer": "ipython3",
-      "version": "3.9.19"
+      "version": "3.9.20"
     }
   },
   "nbformat": 4,

diff --git a/development/_downloads/99556dba95731a8f804741239f91ea47/mnist_pytorch.zip b/development/_downloads/99556dba95731a8f804741239f91ea47/mnist_pytorch.zip
diff --git a/development/_downloads/aabae18a223fa014a3ff3692699ee5e2/importances.ipynb b/development/_downloads/aabae18a223fa014a3ff3692699ee5e2/importances.ipynb
@@ -35,7 +35,7 @@
       "name": "python",
       "nbconvert_exporter": "python",
       "pygments_lexer": "ipython3",
-      "version": "3.9.19"
+      "version": "3.9.20"
     }
   },
   "nbformat": 4,

diff --git a/development/_downloads/ad79591140408f040bd9f6e2ef83c954/parallel_coordinates.zip b/development/_downloads/ad79591140408f040bd9f6e2ef83c954/parallel_coordinates.zip
diff --git a/development/_downloads/bc82bea3a5dd7bdba60b65220891d9e5/examples_python.zip b/development/_downloads/bc82bea3a5dd7bdba60b65220891d9e5/examples_python.zip
diff --git a/development/_downloads/bdc2709d62468d73e63248ef71ebc760/mnist_pytorch.ipynb b/development/_downloads/bdc2709d62468d73e63248ef71ebc760/mnist_pytorch.ipynb
@@ -35,7 +35,7 @@
       "name": "python",
       "nbconvert_exporter": "python",
       "pygments_lexer": "ipython3",
-      "version": "3.9.19"
+      "version": "3.9.20"
     }
   },
   "nbformat": 4,

diff --git a/development/_downloads/ca45e64eb26e32125a4561a719e13205/pdp.zip b/development/_downloads/ca45e64eb26e32125a4561a719e13205/pdp.zip
diff --git a/development/_downloads/d1732d869fba86e022de98932899c009/ablation_paths.ipynb b/development/_downloads/d1732d869fba86e022de98932899c009/ablation_paths.ipynb
@@ -35,7 +35,7 @@
       "name": "python",
       "nbconvert_exporter": "python",
       "pygments_lexer": "ipython3",
-      "version": "3.9.19"
+      "version": "3.9.20"
     }
   },
   "nbformat": 4,

diff --git a/development/_downloads/e9c545ae14a903164c9a627d1b3a375a/parallel_coordinates.ipynb b/development/_downloads/e9c545ae14a903164c9a627d1b3a375a/parallel_coordinates.ipynb
@@ -35,7 +35,7 @@
       "name": "python",
       "nbconvert_exporter": "python",
       "pygments_lexer": "ipython3",
-      "version": "3.9.19"
+      "version": "3.9.20"
     }
   },
   "nbformat": 4,

diff --git a/development/_downloads/f17079aa123e756d5eb37459dfeb46a2/digits_sklearn.ipynb b/development/_downloads/f17079aa123e756d5eb37459dfeb46a2/digits_sklearn.ipynb
@@ -35,7 +35,7 @@
       "name": "python",
       "nbconvert_exporter": "python",
       "pygments_lexer": "ipython3",
-      "version": "3.9.19"
+      "version": "3.9.20"
     }
   },
   "nbformat": 4,

diff --git a/development/_downloads/fb625db3c50d423b1b7881136ffdeec8/examples_jupyter.zip b/development/_downloads/fb625db3c50d423b1b7881136ffdeec8/examples_jupyter.zip
diff --git a/development/_modules/deepcave/runs/converters/amltk.html b/development/_modules/deepcave/runs/converters/amltk.html
@@ -824,6 +824,7 @@ <h1>Source code for deepcave.runs.converters.amltk</h1><div class="highlight"><p
 
 <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span><span class="p">,</span> <span class="n">Sequence</span><span class="p">,</span> <span class="n">Union</span>
 
+<span class="kn">import</span> <span class="nn">os</span>
 <span class="kn">import</span> <span class="nn">re</span>
 <span class="kn">from</span> <span class="nn">pathlib</span> <span class="kn">import</span> <span class="n">Path</span>
 
@@ -1019,6 +1020,31 @@ <h1>Source code for deepcave.runs.converters.amltk</h1><div class="highlight"><p
             <span class="p">)</span>
 
         <span class="k">return</span> <span class="n">run</span></div>
+
+
+<div class="viewcode-block" id="AMLTKRun.is_valid_run">
+<a class="viewcode-back" href="../../../../api/deepcave.runs.converters.amltk.html#deepcave.runs.converters.amltk.AMLTKRun.is_valid_run">[docs]</a>
+    <span class="nd">@classmethod</span>
+    <span class="k">def</span> <span class="nf">is_valid_run</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">path_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">        Check whether the path name belongs to a valid amltk run.</span>
+
+<span class="sd">        Parameters</span>
+<span class="sd">        ----------</span>
+<span class="sd">        path_name: str</span>
+<span class="sd">            The path to check.</span>
+
+<span class="sd">        Returns</span>
+<span class="sd">        -------</span>
+<span class="sd">        bool</span>
+<span class="sd">            True if path is valid run.</span>
+<span class="sd">            False otherwise.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isfile</span><span class="p">(</span><span class="n">path_name</span> <span class="o">+</span> <span class="s2">&quot;/history.parquet&quot;</span><span class="p">)</span> <span class="ow">and</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isfile</span><span class="p">(</span>
+            <span class="n">path_name</span> <span class="o">+</span> <span class="s2">&quot;/configspace.json&quot;</span>
+        <span class="p">):</span>
+            <span class="k">return</span> <span class="kc">True</span>
+        <span class="k">return</span> <span class="kc">False</span></div>
 </div>
 
 </pre></div>

diff --git a/development/_modules/deepcave/runs/converters/bohb.html b/development/_modules/deepcave/runs/converters/bohb.html
@@ -825,6 +825,7 @@ <h1>Source code for deepcave.runs.converters.bohb</h1><div class="highlight"><pr
 
 <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">Dict</span><span class="p">,</span> <span class="n">Union</span>
 
+<span class="kn">import</span> <span class="nn">os</span>
 <span class="kn">from</span> <span class="nn">pathlib</span> <span class="kn">import</span> <span class="n">Path</span>
 
 <span class="kn">from</span> <span class="nn">ConfigSpace.configuration_space</span> <span class="kn">import</span> <span class="n">ConfigurationSpace</span>
@@ -981,6 +982,29 @@ <h1>Source code for deepcave.runs.converters.bohb</h1><div class="highlight"><pr
             <span class="p">)</span>
 
         <span class="k">return</span> <span class="n">run</span></div>
+
+
+<div class="viewcode-block" id="BOHBRun.is_valid_run">
+<a class="viewcode-back" href="../../../../api/deepcave.runs.converters.bohb.html#deepcave.runs.converters.bohb.BOHBRun.is_valid_run">[docs]</a>
+    <span class="nd">@classmethod</span>
+    <span class="k">def</span> <span class="nf">is_valid_run</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">path_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">        Check whether the path name belongs to a valid bohb run.</span>
+
+<span class="sd">        Parameters</span>
+<span class="sd">        ----------</span>
+<span class="sd">        path_name: str</span>
+<span class="sd">            The path to check.</span>
+
+<span class="sd">        Returns</span>
+<span class="sd">        -------</span>
+<span class="sd">        bool</span>
+<span class="sd">            True if path is valid run.</span>
+<span class="sd">            False otherwise.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isfile</span><span class="p">(</span><span class="n">path_name</span> <span class="o">+</span> <span class="s2">&quot;/configspace.json&quot;</span><span class="p">):</span>
+            <span class="k">return</span> <span class="kc">True</span>
+        <span class="k">return</span> <span class="kc">False</span></div>
 </div>
 
 </pre></div>

diff --git a/development/_modules/deepcave/runs/converters/dataframe.html b/development/_modules/deepcave/runs/converters/dataframe.html
@@ -1198,7 +1198,32 @@ <h1>Source code for deepcave.runs.converters.dataframe</h1><div class="highlight
         <span class="n">meta</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;config_id&quot;</span><span class="p">,</span> <span class="s2">&quot;start_time&quot;</span><span class="p">,</span> <span class="s2">&quot;end_time&quot;</span><span class="p">,</span> <span class="s2">&quot;status&quot;</span><span class="p">]</span>
         <span class="n">additional</span> <span class="o">=</span> <span class="n">data</span><span class="o">.</span><span class="n">drop</span><span class="p">(</span><span class="n">hyperparameters</span> <span class="o">+</span> <span class="n">costs_metrics</span> <span class="o">+</span> <span class="n">budgets</span> <span class="o">+</span> <span class="n">seeds</span> <span class="o">+</span> <span class="n">meta</span><span class="p">)</span>
         <span class="n">additional</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">additional</span><span class="p">)</span>
-        <span class="k">return</span> <span class="p">{</span><span class="n">key</span><span class="p">:</span> <span class="n">value</span> <span class="k">if</span> <span class="n">pd</span><span class="o">.</span><span class="n">notna</span><span class="p">(</span><span class="n">value</span><span class="p">)</span> <span class="k">else</span> <span class="kc">None</span> <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">additional</span><span class="o">.</span><span class="n">items</span><span class="p">()}</span></div>
+        <span class="k">return</span> <span class="p">{</span><span class="n">key</span><span class="p">:</span> <span class="n">value</span> <span class="k">if</span> <span class="n">pd</span><span class="o">.</span><span class="n">notna</span><span class="p">(</span><span class="n">value</span><span class="p">)</span> <span class="k">else</span> <span class="kc">None</span> <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">additional</span><span class="o">.</span><span class="n">items</span><span class="p">()}</span>
+
+<div class="viewcode-block" id="DataFrameRun.is_valid_run">
+<a class="viewcode-back" href="../../../../api/deepcave.runs.converters.dataframe.html#deepcave.runs.converters.dataframe.DataFrameRun.is_valid_run">[docs]</a>
+    <span class="nd">@classmethod</span>
+    <span class="k">def</span> <span class="nf">is_valid_run</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">path_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">        Check whether the path name belongs to a valid dataframe run.</span>
+
+<span class="sd">        Parameters</span>
+<span class="sd">        ----------</span>
+<span class="sd">        path_name: str</span>
+<span class="sd">            The path to check.</span>
+
+<span class="sd">        Returns</span>
+<span class="sd">        -------</span>
+<span class="sd">        bool</span>
+<span class="sd">            True if path is valid run.</span>
+<span class="sd">            False otherwise.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isfile</span><span class="p">(</span><span class="n">path_name</span> <span class="o">+</span> <span class="s2">&quot;/trials.csv&quot;</span><span class="p">)</span> <span class="ow">and</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isfile</span><span class="p">(</span>
+            <span class="n">path_name</span> <span class="o">+</span> <span class="s2">&quot;/configspace.csv&quot;</span>
+        <span class="p">):</span>
+            <span class="k">return</span> <span class="kc">True</span>
+        <span class="k">return</span> <span class="kc">False</span></div>
+</div>
 
 </pre></div>
 

diff --git a/development/_modules/deepcave/runs/converters/deepcave.html b/development/_modules/deepcave/runs/converters/deepcave.html
@@ -824,6 +824,7 @@ <h1>Source code for deepcave.runs.converters.deepcave</h1><div class="highlight"
 
 <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Union</span>
 
+<span class="kn">import</span> <span class="nn">os</span>
 <span class="kn">from</span> <span class="nn">pathlib</span> <span class="kn">import</span> <span class="n">Path</span>
 
 <span class="kn">from</span> <span class="nn">deepcave.runs.run</span> <span class="kn">import</span> <span class="n">Run</span>
@@ -896,6 +897,29 @@ <h1>Source code for deepcave.runs.converters.deepcave</h1><div class="highlight"
 <span class="sd">        The DeepCAVE run.</span>
 <span class="sd">        &quot;&quot;&quot;</span>
         <span class="k">return</span> <span class="n">DeepCAVERun</span><span class="p">(</span><span class="n">path</span><span class="o">.</span><span class="n">stem</span><span class="p">,</span> <span class="n">path</span><span class="o">=</span><span class="n">Path</span><span class="p">(</span><span class="n">path</span><span class="p">))</span></div>
+
+
+<div class="viewcode-block" id="DeepCAVERun.is_valid_run">
+<a class="viewcode-back" href="../../../../api/deepcave.runs.converters.deepcave.html#deepcave.runs.converters.deepcave.DeepCAVERun.is_valid_run">[docs]</a>
+    <span class="nd">@classmethod</span>
+    <span class="k">def</span> <span class="nf">is_valid_run</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">path_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">        Check whether the path name belongs to a valid deepcave run.</span>
+
+<span class="sd">        Parameters</span>
+<span class="sd">        ----------</span>
+<span class="sd">        path_name: str</span>
+<span class="sd">            The path to check.</span>
+
+<span class="sd">        Returns</span>
+<span class="sd">        -------</span>
+<span class="sd">        bool</span>
+<span class="sd">            True if path is valid run.</span>
+<span class="sd">            False otherwise.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isfile</span><span class="p">(</span><span class="n">path_name</span> <span class="o">+</span> <span class="s2">&quot;history.jsonl&quot;</span><span class="p">):</span>
+            <span class="k">return</span> <span class="kc">True</span>
+        <span class="k">return</span> <span class="kc">False</span></div>
 </div>
 
 </pre></div>

diff --git a/development/_modules/deepcave/runs/converters/optuna.html b/development/_modules/deepcave/runs/converters/optuna.html
@@ -1089,6 +1089,31 @@ <h1>Source code for deepcave.runs.converters.optuna</h1><div class="highlight"><
             <span class="p">)</span>
 
         <span class="k">return</span> <span class="n">run</span></div>
+
+
+<div class="viewcode-block" id="OptunaRun.is_valid_run">
+<a class="viewcode-back" href="../../../../api/deepcave.runs.converters.optuna.html#deepcave.runs.converters.optuna.OptunaRun.is_valid_run">[docs]</a>
+    <span class="nd">@classmethod</span>
+    <span class="k">def</span> <span class="nf">is_valid_run</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">path_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">        Check whether the path name belongs to a valid optuna run.</span>
+
+<span class="sd">        Parameters</span>
+<span class="sd">        ----------</span>
+<span class="sd">        path_name: str</span>
+<span class="sd">            The path to check.</span>
+
+<span class="sd">        Returns</span>
+<span class="sd">        -------</span>
+<span class="sd">        bool</span>
+<span class="sd">            True if path is valid run.</span>
+<span class="sd">            False otherwise.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="n">path</span> <span class="o">=</span> <span class="n">Path</span><span class="p">(</span><span class="n">path_name</span><span class="p">)</span>
+        <span class="n">pickle_files</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="n">path</span><span class="o">.</span><span class="n">glob</span><span class="p">(</span><span class="s2">&quot;*.pkl&quot;</span><span class="p">))</span>
+        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">pickle_files</span><span class="p">)</span> <span class="o">!=</span> <span class="mi">1</span><span class="p">:</span>
+            <span class="k">return</span> <span class="kc">False</span>
+        <span class="k">return</span> <span class="kc">True</span></div>
 </div>
 
 </pre></div>

diff --git a/development/_modules/deepcave/runs/converters/smac3v1.html b/development/_modules/deepcave/runs/converters/smac3v1.html
@@ -827,6 +827,7 @@ <h1>Source code for deepcave.runs.converters.smac3v1</h1><div class="highlight">
 <span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">Optional</span><span class="p">,</span> <span class="n">Union</span>
 
 <span class="kn">import</span> <span class="nn">json</span>
+<span class="kn">import</span> <span class="nn">os</span>
 <span class="kn">from</span> <span class="nn">pathlib</span> <span class="kn">import</span> <span class="n">Path</span>
 
 <span class="kn">import</span> <span class="nn">numpy</span> <span class="k">as</span> <span class="nn">np</span>
@@ -1021,6 +1022,31 @@ <h1>Source code for deepcave.runs.converters.smac3v1</h1><div class="highlight">
             <span class="p">)</span>
 
         <span class="k">return</span> <span class="n">run</span></div>
+
+
+<div class="viewcode-block" id="SMAC3v1Run.is_valid_run">
+<a class="viewcode-back" href="../../../../api/deepcave.runs.converters.smac3v1.html#deepcave.runs.converters.smac3v1.SMAC3v1Run.is_valid_run">[docs]</a>
+    <span class="nd">@classmethod</span>
+    <span class="k">def</span> <span class="nf">is_valid_run</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">path_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">        Check whether the path name belongs to a valid smac3v1 run.</span>
+
+<span class="sd">        Parameters</span>
+<span class="sd">        ----------</span>
+<span class="sd">        path_name: str</span>
+<span class="sd">            The path to check.</span>
+
+<span class="sd">        Returns</span>
+<span class="sd">        -------</span>
+<span class="sd">        bool</span>
+<span class="sd">            True if path is valid run.</span>
+<span class="sd">            False otherwise.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="k">if</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isfile</span><span class="p">(</span><span class="n">path_name</span> <span class="o">+</span> <span class="s2">&quot;/runhistory.json&quot;</span><span class="p">)</span> <span class="ow">and</span> <span class="n">os</span><span class="o">.</span><span class="n">path</span><span class="o">.</span><span class="n">isfile</span><span class="p">(</span>
+            <span class="n">path_name</span> <span class="o">+</span> <span class="s2">&quot;/configspace.json&quot;</span>
+        <span class="p">):</span>
+            <span class="k">return</span> <span class="kc">True</span>
+        <span class="k">return</span> <span class="kc">False</span></div>
 </div>
 
 </pre></div>