Examples (#218)

* Added immediate possibility to load problem completely

* replaced with proper example needed for tutorial.

* Updated files

* removed unneccesary comments

Author: PaulJonasJost

MANIFEST.in

@@ -1,5 +1,7 @@
-include  example/*.csv
-include  example/*.tsv
-include  example/*.xml
+include  example/*/*.csv
+include  example/*/*.tsv
+include  example/*/*.xml
+include  example/*/*.yaml
+include  example/*/*.yml
 exclude .git_archival.txt
 exclude .gitattributes

example/data_matrix.csv

@@ -0,0 +1,11 @@
+time	obs_A	obs_B
+0	10.1	0.1
+2	8.0	 2.1
+4	6.8	 3.4
+6	5.6	 4.6
+8	4.4	 5.4
+10	3.8	 6.4
+12	3.1	 7.2
+15	2.3	 7.9
+18	1.6	 8.2
+20	1.3	 8.5

example/simple_conversion_measurements.tsv

@@ -56,6 +56,7 @@ include-package-data = true
 
 [tool.setuptools.package-data]
 "petab_gui.assets" = ["PEtab.png"]
+"petab_gui.example" = ["*/*.yaml", "*/*.yml", "*/*.tsv", "*/*.csv", "*/*.xml", "*/*.sbml"]
 
 [tool.setuptools_scm]
 

pyproject.toml

@@ -308,6 +308,23 @@ def setup_actions(self):
         actions["add"].triggered.connect(
             partial(self.open_file, mode="append")
         )
+        # Load Examples
+        actions["load_example_boehm"] = QAction(
+            qta.icon("mdi6.book-open-page-variant"),
+            "Load Example: Boehm",
+            self.view,
+        )
+        actions["load_example_boehm"].triggered.connect(
+            partial(self.load_example, "Boehm")
+        )
+        actions["load_example_simple"] = QAction(
+            qta.icon("mdi6.book-open-page-variant"),
+            "Load Example: Simple Conversion",
+            self.view,
+        )
+        actions["load_example_simple"].triggered.connect(
+            partial(self.load_example, "Simple_Conversion")
+        )
         # Save
         actions["save"] = QAction(
             qta.icon("mdi6.content-save-all"), "&Save As...", self.view
@@ -1085,6 +1102,64 @@ def new_file(self):
         self.view.plot_dock.plot_it()
         self.unsaved_changes_change(False)
 
+    def load_example(self, example_name):
+        """Load an internal example PEtab problem.
+
+        Parameters
+        ----------
+        example_name : str
+            Name of the example subdirectory (e.g., "Boehm", "Simple_Conversion").
+
+        Finds and loads the example dataset from the package directory.
+        No internet connection required - the example is bundled with the package.
+        """
+        try:
+            # Use importlib.resources to access packaged example files
+            from importlib.resources import as_file, files
+
+            example_files = files("petab_gui.example")
+
+            # Check if the example package exists
+            if not example_files.is_dir():
+                error_msg = (
+                    "Could not find the example dataset. "
+                    "The example folder may not be properly installed."
+                )
+                self.logger.log_message(error_msg, color="red")
+                QMessageBox.warning(self.view, "Example Not Found", error_msg)
+                return
+
+            # Get the problem.yaml file path for the specified example
+            yaml_file = example_files.joinpath(example_name, "problem.yaml")
+
+            with as_file(yaml_file) as yaml_path:
+                if not yaml_path.exists():
+                    error_msg = f"Example '{example_name}' not found or problem.yaml file is missing."
+                    self.logger.log_message(error_msg, color="red")
+                    QMessageBox.warning(
+                        self.view, "Example Invalid", error_msg
+                    )
+                    return
+
+                # Load the example
+                self.logger.log_message(
+                    f"Loading '{example_name}' example dataset...",
+                    color="blue",
+                )
+                self.open_yaml_and_load_files(str(yaml_path))
+
+        except ModuleNotFoundError as e:
+            error_msg = (
+                "Example dataset not found. It may not be installed properly. "
+                f"Error: {str(e)}"
+            )
+            self.logger.log_message(error_msg, color="red")
+            QMessageBox.warning(self.view, "Example Not Found", error_msg)
+        except Exception as e:
+            error_msg = f"Failed to load example: {str(e)}"
+            self.logger.log_message(error_msg, color="red")
+            QMessageBox.critical(self.view, "Error Loading Example", error_msg)
+
     def check_model(self):
         """Check the consistency of the model. And log the results."""
         capture_handler = CaptureLogHandler()