feat(project-opener): create vehicle project from ArduPilot .bin log file

Add a "Create a vehicle project from a .bin log file" button to the
New Vehicle panel in the project-opener window.

Business logic additions in data_model_vehicle_project_creator.py:
- extract_param_files_from_bin_log(): calls extract_parameter_values()
  for both "defaults" and "values" snapshots; wraps results as ParDict
- template_dir_for_bin_import(): returns the empty_4.6.x template path
- vehicle_name_from_bin_log(): derives the new vehicle name from the
  .bin file stem
- next_import_filename(): finds the next available numbered slot for the
  imported parameter file

Orchestration in data_model_vehicle_project.py
(create_new_vehicle_from_bin_log):
- Scaffolds the project from empty_4.6.x with current FC params used for
  template substitution
- Replaces the template's 00_default.param with the .bin-extracted
  defaults snapshot (key deviation from normal template-based creation)
- Exports remaining current parameters into a numbered
  *_imported_bin_log_parameters.param file

GUI additions:
- BinLogSelectionWidgets reusable widget added to
  frontend_tkinter_directory_selection.py
- Widget wired into VehicleProjectOpenerWindow.create_option1_widgets()

Author: amilcarlucas

ardupilot_methodic_configurator/data_model_vehicle_project.py

@@ -16,6 +16,7 @@
 
 from ardupilot_methodic_configurator import _
 from ardupilot_methodic_configurator.backend_filesystem import LocalFilesystem
+from ardupilot_methodic_configurator.data_model_par_dict import is_within_tolerance
 from ardupilot_methodic_configurator.data_model_vehicle_project_creator import NewVehicleProjectSettings, VehicleProjectCreator
 from ardupilot_methodic_configurator.data_model_vehicle_project_opener import VehicleProjectOpener
 
@@ -156,6 +157,64 @@ def create_new_vehicle_from_template(
             self.open_vehicle_directory(new_path)
         return new_path
 
+    def create_new_vehicle_from_bin_log(self, bin_file: str, vehicle_type: str = "ArduCopter") -> str:
+        """
+        Create a new vehicle configuration directory from an ArduPilot .bin log file.
+
+        The project is based on the empty_4.6.x template, uses the extracted
+        current parameter values for template substitution, replaces the template's
+        00_default.param with the extracted defaults snapshot, and exports any
+        remaining parameters missing from the AMC files into a final import file.
+
+        Args:
+            bin_file: Path to the ArduPilot .bin log file
+            vehicle_type: Vehicle type whose empty template should be used
+
+        Returns:
+            The created vehicle directory path
+
+        Raises:
+            VehicleProjectCreationError: If creation or extraction fails
+
+        """
+        template_dir = self._creator.template_dir_for_bin_import(vehicle_type)
+        new_base_dir = str(LocalFilesystem.get_vehicles_default_dir())
+        new_vehicle_name = self._creator.vehicle_name_from_bin_log(bin_file)
+        default_params, current_params = self._creator.extract_param_files_from_bin_log(bin_file)
+        current_param_values = {name: param.value for name, param in current_params.items()}
+        settings = NewVehicleProjectSettings(
+            blank_change_reason=True,
+            infer_comp_specs_and_conn_from_fc_params=True,
+            use_fc_params=True,
+        )
+
+        new_path = self._creator.create_new_vehicle_from_template(
+            template_dir,
+            new_base_dir,
+            new_vehicle_name,
+            settings,
+            fc_connected=False,
+            fc_parameters=current_param_values,
+        )
+        self._settings = settings
+        self.configuration_template = self.get_directory_name_from_path(template_dir)
+        self.store_recently_used_template_dirs(template_dir, new_base_dir)
+        self.open_vehicle_directory(new_path)
+
+        self._local_filesystem.write_param_default_values_to_file(default_params)
+
+        compound_params, _first_filename = self._local_filesystem.compound_params(skip_default=True)
+        imported_params = current_params.get_missing_or_different(compound_params, is_within_tolerance)
+        if imported_params:
+            import_filename = self._creator.next_import_filename(new_path)
+            self._local_filesystem.export_to_param(imported_params, import_filename, annotate_doc=False)
+            self._local_filesystem.re_init(new_path, vehicle_type)
+
+        if self._flight_controller is not None:
+            self._flight_controller.fc_parameters = current_param_values
+
+        return new_path
+
     # Vehicle project opening operations
     def open_vehicle_directory(self, vehicle_dir: str) -> str:
         """

ardupilot_methodic_configurator/data_model_vehicle_project_creator.py

@@ -12,10 +12,13 @@
 """
 
 from dataclasses import MISSING, dataclass, fields
+from pathlib import Path
 from typing import ClassVar, NamedTuple, Optional
 
 from ardupilot_methodic_configurator import _
 from ardupilot_methodic_configurator.backend_filesystem import LocalFilesystem
+from ardupilot_methodic_configurator.data_model_par_dict import ParDict
+from ardupilot_methodic_configurator.extract_param_defaults import extract_parameter_values
 
 
 class VehicleProjectCreationError(Exception):
@@ -387,7 +390,7 @@ def adjust_for_fc_connection(
         return NewVehicleProjectSettings(**adjusted_settings)
 
 
-class VehicleProjectCreator:  # pylint: disable=too-few-public-methods
+class VehicleProjectCreator:
     """Manages vehicle project creation operations."""
 
     def __init__(self, local_filesystem: LocalFilesystem) -> None:
@@ -400,6 +403,44 @@ def __init__(self, local_filesystem: LocalFilesystem) -> None:
         """
         self.local_filesystem = local_filesystem
 
+    @staticmethod
+    def template_dir_for_bin_import(vehicle_type: str = "ArduCopter") -> str:
+        """Return the empty template directory used for .bin log imports."""
+        return str(Path(LocalFilesystem.get_templates_base_dir()) / vehicle_type / "empty_4.6.x")
+
+    @staticmethod
+    def vehicle_name_from_bin_log(bin_file: str) -> str:
+        """Return the default vehicle directory name derived from the .bin filename."""
+        return Path(bin_file).stem
+
+    @staticmethod
+    def next_import_filename(vehicle_dir: str) -> str:
+        """Return the next available numbered parameter filename for imported log parameters."""
+        highest_prefix = 0
+        for file_path in Path(vehicle_dir).iterdir():
+            if not file_path.is_file() or file_path.suffix != ".param":
+                continue
+            prefix = file_path.name[:2]
+            if prefix.isdigit():
+                highest_prefix = max(highest_prefix, int(prefix))
+
+        next_prefix = highest_prefix + 1
+        if next_prefix > 99:
+            msg = _("Could not create an import parameter file because no numbered slot is available in {vehicle_dir}")
+            raise VehicleProjectCreationError(_("Parameter import"), msg.format(vehicle_dir=vehicle_dir))
+        return f"{next_prefix:02d}_imported_bin_log_parameters.param"
+
+    @staticmethod
+    def extract_param_files_from_bin_log(bin_file: str) -> tuple[ParDict, ParDict]:
+        """Extract default and current parameter snapshots from an ArduPilot .bin log file."""
+        try:
+            default_params = ParDict.from_float_dict(extract_parameter_values(bin_file, "defaults"))
+            current_params = ParDict.from_float_dict(extract_parameter_values(bin_file, "values"))
+        except SystemExit as exc:
+            msg = str(exc) or _("Failed to extract parameters from the selected .bin log file")
+            raise VehicleProjectCreationError(_(".bin log import"), msg) from exc
+        return default_params, current_params
+
     def create_new_vehicle_from_template(  # pylint: disable=too-many-arguments, too-many-positional-arguments
         self,
         template_dir: str,

ardupilot_methodic_configurator/frontend_tkinter_directory_selection.py

@@ -14,6 +14,7 @@
 from typing import Callable, Optional
 
 from ardupilot_methodic_configurator import _
+from ardupilot_methodic_configurator.data_model_vehicle_project_creator import VehicleProjectCreationError
 from ardupilot_methodic_configurator.data_model_vehicle_project_opener import VehicleProjectOpenError
 from ardupilot_methodic_configurator.frontend_tkinter_base_window import BaseWindow
 from ardupilot_methodic_configurator.frontend_tkinter_show import show_tooltip
@@ -135,6 +136,54 @@ def get_selected_directory(self) -> str:
         return self.directory
 
 
+class BinLogSelectionWidgets:  # pylint: disable=too-few-public-methods
+    """A GUI widget for selecting a .bin log file and invoking a callback."""
+
+    def __init__(
+        self,
+        parent: BaseWindow,
+        parent_frame: ttk.Widget,
+        on_select_file_callback: Callable[[str], None],
+    ) -> None:
+        self.parent = parent
+        self.on_select_file_callback = on_select_file_callback
+
+        self.container_frame = ttk.Frame(parent_frame)
+        self.select_file_button = ttk.Button(
+            self.container_frame,
+            text=_("Create a vehicle project from a .bin log file"),
+            command=self.on_select_file,
+        )
+        self.select_file_button.pack(expand=False, fill=tk.X, padx=20, pady=5, anchor=tk.CENTER)
+        show_tooltip(
+            self.select_file_button,
+            _(
+                "Extract default and current parameters from an ArduPilot .bin log file, create a new vehicle project\n"
+                "from the empty_4.6.x template, replace the template's 00_default.param with the extracted one and\n"
+                "continue with the normal component editor flow"
+            ),
+        )
+
+    def on_select_file(self) -> bool:
+        selected_file = filedialog.askopenfilename(
+            parent=self.parent.root,
+            title=_("Select an ArduPilot .bin log file"),
+            filetypes=[(_("ArduPilot binary log files"), "*.bin"), (_("All files"), "*.*")],
+        )
+        if not selected_file:
+            return False
+
+        try:
+            self.on_select_file_callback(selected_file)
+            return True
+        except VehicleProjectCreationError as exc:
+            messagebox.showerror(exc.title, exc.message)
+            return False
+        except OSError as exc:
+            messagebox.showerror(_(".bin log import"), str(exc))
+            return False
+
+
 class VehicleDirectorySelectionWidgets(DirectorySelectionWidgets):
     """
     A subclass of DirectorySelectionWidgets specifically tailored for selecting vehicle directories.

ardupilot_methodic_configurator/frontend_tkinter_project_opener.py

@@ -28,6 +28,7 @@
 from ardupilot_methodic_configurator.data_model_vehicle_project_opener import VehicleProjectOpenError
 from ardupilot_methodic_configurator.frontend_tkinter_base_window import BaseWindow
 from ardupilot_methodic_configurator.frontend_tkinter_directory_selection import (
+    BinLogSelectionWidgets,
     VehicleDirectorySelectionWidgets,
 )
 from ardupilot_methodic_configurator.frontend_tkinter_project_creator import VehicleProjectCreatorWindow
@@ -64,7 +65,7 @@ def __init__(self, project_manager: VehicleProjectManager) -> None:
             self.main_frame,
             anchor=tk.CENTER,
             justify=tk.CENTER,
-            text=introduction_text + _("\nChoose one of the following three options:"),
+            text=introduction_text + _("\nChoose one of the following options:"),
         )
         introduction_label.pack(expand=False, fill=tk.X, padx=6, pady=6)
         _template_dir, _new_base_dir, vehicle_dir = self.project_manager.get_recently_used_dirs()
@@ -96,6 +97,17 @@ def create_option1_widgets(self) -> None:
             _("Create a new vehicle configuration directory, choose this option when using the software for the first time"),
         )
 
+        def on_bin_log_selected(bin_file: str) -> None:
+            self.project_manager.create_new_vehicle_from_bin_log(bin_file)
+            self.root.destroy()
+
+        self.bin_log_selection_widgets = BinLogSelectionWidgets(
+            self,
+            option1_label_frame,
+            on_select_file_callback=on_bin_log_selected,
+        )
+        self.bin_log_selection_widgets.container_frame.pack(expand=False, fill=tk.X, padx=3, pady=(0, 5), anchor=tk.NW)
+
     # pylint: enable=duplicate-code
 
     def create_option2_widgets(self, initial_dir: str) -> None: