Add reverse flag to fit_sequential for reverse-order processing

Author: AndrewSazonov

.github/workflows/cleanup.yml

@@ -73,7 +73,6 @@ jobs:
     permissions:
       actions: write
 
-
     steps:
       - name: Delete workflow runs
         uses: Mattraks/delete-workflow-runs@v2

pixi.lock

@@ -372,8 +372,8 @@ convention = 'numpy'
 [tool.ruff.lint.pylint]
 # Ruff counts `self`/`cls` in max-args; traditional pylint does not.
 # Setting 6 here matches pylint's default of 5 (excluding self).
-max-args = 6
-max-positional-args = 6
+max-args = 7
+max-positional-args = 7
 
 #############################
 # Configuration for pydoclint

pyproject.toml

@@ -905,6 +905,7 @@ def fit_sequential(
         file_pattern: str = '*',
         extract_diffrn: object = None,
         verbosity: str | None = None,
+        reverse: bool = False,
     ) -> None:
         """
         Run sequential fitting over all data files in a directory.
@@ -936,6 +937,10 @@ def fit_sequential(
         verbosity : str | None, default=None
             ``'full'``, ``'short'``, or ``'silent'``. Default: project
             verbosity.
+        reverse : bool, default=False
+            When ``True``, process data files in reverse order.  Useful
+            when starting values are better matched to the last file
+            (e.g. highest-temperature dataset in a cooling scan).
         """
         from easydiffraction.analysis.sequential import fit_sequential as _fit_seq  # noqa: PLC0415
 
@@ -955,6 +960,7 @@ def fit_sequential(
                 chunk_size=chunk_size,
                 file_pattern=file_pattern,
                 extract_diffrn=extract_diffrn,
+                reverse=reverse,
             )
         finally:
             if original_verbosity is not None:

src/easydiffraction/analysis/analysis.py

@@ -811,6 +811,7 @@ def fit_sequential(
     chunk_size: int | None = None,
     file_pattern: str = '*',
     extract_diffrn: Callable | None = None,
+    reverse: bool = False,
 ) -> None:
     """
     Run sequential fitting over all data files in a directory.
@@ -831,6 +832,10 @@ def fit_sequential(
         Glob pattern to filter files in *data_dir*.
     extract_diffrn : Callable | None, default=None
         User callback: ``f(file_path) → {diffrn_field: value}``.
+    reverse : bool, default=False
+        When ``True``, process data files in reverse order.  Useful when
+        starting values are better matched to the last file (e.g.
+        highest-temperature dataset in a cooling scan).
     """
     if mp.parent_process() is not None:
         return
@@ -850,6 +855,8 @@ def fit_sequential(
     )
 
     remaining = [p for p in data_paths if p not in already_fitted]
+    if reverse:
+        remaining.reverse()
     if not remaining:
         if verb is not VerbosityEnum.SILENT:
             print('✅ All files already fitted. Nothing to do.')