arrayview 0.50.1__tar.gz → 0.51.0__tar.gz

{arrayview-0.50.1 → arrayview-0.51.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: arrayview
-Version: 0.50.1
+Version: 0.51.0
 Summary: Fast multi-dimensional array viewer
 Project-URL: Home, https://github.com/oscarvanderheide/arrayview
 Project-URL: Source, https://github.com/oscarvanderheide/arrayview

{arrayview-0.50.1 → arrayview-0.51.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "arrayview"
-version = "0.50.1"
+version = "0.51.0"
 description = "Fast multi-dimensional array viewer"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.12"

{arrayview-0.50.1 → arrayview-0.51.0}/src/arrayview/_io.py

@@ -1452,7 +1452,7 @@ def _collection_pattern_paths(pattern):
     return paths
 
 
-def _explicit_case_files(patterns):
+def _explicit_case_files(patterns, keep_order=False):
     """Plain file paths given as several patterns, or None.
 
     An unquoted ``--match dir/*/maps.nii`` reaches us already expanded by the
@@ -1467,7 +1467,7 @@ def _explicit_case_files(patterns):
     paths = [os.path.abspath(p) for p in patterns if _is_supported_collection_path(p)]
     if len(paths) != len(patterns) or len(set(paths)) != len(paths):
         return None
-    return sorted(paths)
+    return paths if keep_order else sorted(paths)
 
 
 def _distinguishing_path_parts(paths):
@@ -1720,6 +1720,7 @@ def load_dir_collection(
     stack="auto",
     scan_progress=None,
     exclude_cases=None,
+    keep_order=False,
 ):
     """Load recursive collection patterns as aligned lazy image/overlay stacks.
 
@@ -1730,7 +1731,8 @@ def load_dir_collection(
     *case_regex*, files are paired by the regex's named ``case`` group instead.
     *exclude_cases* removes known case ids before any image or overlay data is
     opened. It is used by the interactive CLI after the user accepts a partial
-    overlay match.
+    overlay match. *keep_order* stacks an explicit file list in the order
+    given instead of sorted.
     """
     if not base_patterns:
         raise ValueError("--match requires at least one positional image pattern.")
@@ -1753,7 +1755,7 @@ def load_dir_collection(
             raise ValueError("; ".join(missing))
         base_matrix = [[by_case[case] for by_case in base_maps] for case in case_ids]
     else:
-        explicit_cases = _explicit_case_files(base_patterns)
+        explicit_cases = _explicit_case_files(base_patterns, keep_order=keep_order)
         base_lists = (
             [explicit_cases]
             if explicit_cases is not None

{arrayview-0.50.1 → arrayview-0.51.0}/src/arrayview/_launcher.py

@@ -6052,6 +6052,27 @@ def arrayview():
             "stacking: a directory of arrays is stacked either way. It selects "
             "which files form the collection."
         )
+    if (
+        args.files
+        and len(args.files) > 4
+        and not args.stack_mode
+        and not (
+            args.compare
+            or args.overlay
+            or args.vectorfield
+            or args.watch
+            or args.rgb
+            or args.relay
+        )
+    ):
+        # Too many for a side-by-side compare: stack them along a new last
+        # axis, one case per file, as --match does for explicit file lists.
+        args.stack_mode = True
+        args.keep_file_order = True
+        print(
+            f"[ArrayView] {len(args.files)} files: opened as one stack; "
+            "step through the last dimension to switch files."
+        )
     if args.dry_run and not args.stack_mode:
         parser.error("--dry-run requires --match.")
     excluded_cases = set()
@@ -6098,9 +6119,10 @@ def arrayview():
             dims_override = (0, 1)
     if not args.serve and not args.kill and not args.files:
         _configure_tutorial_args(args)
-    if args.files and len(args.files) > 6 and not args.stack_mode:
+    if args.files and len(args.files) > 4 and not args.stack_mode:
         parser.error(
-            "At most six FILE arguments are supported; concat arrays first for larger compare sets."
+            "More than four FILE arguments open as one stack, which does not "
+            "support --compare, --overlay, --vectorfield, --watch, --rgb, or --relay."
         )
     if args.compare and len(args.files) > 1 and not args.stack_mode:
         parser.error("Use either positional compare files or --compare, not both.")
@@ -6310,6 +6332,7 @@ def arrayview():
                         stack=args.stack_policy or "auto",
                         scan_progress=scan_progress.update,
                         exclude_cases=excluded_cases,
+                        keep_order=getattr(args, "keep_file_order", False),
                     )
                 finally:
                     scan_progress.finish()