viz: clarify which CLI options apply to which output modes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: sbryngelson

toolchain/mfc/cli/commands.py

@@ -927,15 +927,15 @@
         Argument(
             name="output",
             short="o",
-            help="Directory for saved PNG images or MP4 video.",
+            help="Output directory for --png and --mp4.",
             type=str,
             default=None,
             metavar="DIR",
             completion=Completion(type=CompletionType.DIRECTORIES),
         ),
         Argument(
             name="cmap",
-            help="Matplotlib colormap name.",
+            help="Matplotlib colormap name (--interactive, --png, --mp4).",
             type=str,
             default='viridis',
             metavar="CMAP",
@@ -967,28 +967,28 @@
         ),
         Argument(
             name="vmin",
-            help="Minimum value for color scale.",
+            help="Minimum value for color scale (--interactive, --png, --mp4).",
             type=float,
             default=None,
             metavar="VMIN",
         ),
         Argument(
             name="vmax",
-            help="Maximum value for color scale.",
+            help="Maximum value for color scale (--interactive, --png, --mp4).",
             type=float,
             default=None,
             metavar="VMAX",
         ),
         Argument(
             name="dpi",
-            help="Image resolution in DPI.",
+            help="Image resolution in DPI (--png, --mp4).",
             type=int,
             default=150,
             metavar="DPI",
         ),
         Argument(
             name="slice-axis",
-            help="Axis for 3D slice.",
+            help="Axis for 3D slice (--interactive, --png, --mp4).",
             type=str,
             default='z',
             choices=["x", "y", "z"],
@@ -997,15 +997,15 @@
         ),
         Argument(
             name="slice-value",
-            help="Coordinate value at which to take the 3D slice.",
+            help="Coordinate value at which to take the 3D slice (--interactive, --png, --mp4).",
             type=float,
             default=None,
             dest="slice_value",
             metavar="VAL",
         ),
         Argument(
             name="slice-index",
-            help="Array index at which to take the 3D slice.",
+            help="Array index at which to take the 3D slice (--interactive, --png, --mp4).",
             type=int,
             default=None,
             dest="slice_index",
@@ -1019,7 +1019,7 @@
         ),
         Argument(
             name="fps",
-            help="Frames per second for MP4 output.",
+            help="Frames per second for --mp4 output.",
             type=int,
             default=10,
             metavar="FPS",
@@ -1040,7 +1040,7 @@
         ),
         Argument(
             name="log-scale",
-            help="Use a logarithmic color/y scale (skips non-positive values).",
+            help="Logarithmic color/y scale (--interactive, --png, --mp4).",
             action=ArgAction.STORE_TRUE,
             default=False,
             dest="log_scale",
@@ -1058,14 +1058,14 @@
         ),
         Argument(
             name="port",
-            help="Port for the interactive web server.",
+            help="Port for --interactive web server.",
             type=int,
             default=8050,
             metavar="PORT",
         ),
         Argument(
             name="host",
-            help="Host/bind address for the interactive web server.",
+            help="Bind address for --interactive web server.",
             default="127.0.0.1",
             metavar="HOST",
         ),
@@ -1090,26 +1090,32 @@
         Example("./mfc.sh viz case_dir/ --var pres --step 500 --slice-axis x --png", "3D: x-plane slice of pressure"),
     ],
     key_options=[
-        ("-- Discovery --", ""),
+        ("-- Discovery (all modes) --", ""),
         ("--list-steps", "Print available timesteps and exit"),
         ("--list-vars", "Print available variable names and exit"),
-        ("-- Variable / step selection --", ""),
+        ("-- Data selection (all modes) --", ""),
         ("--var NAME", "Variable to plot (omit for tiled all-vars layout)"),
         ("--step STEP", "last (default), int, start:stop:stride, list, or 'all'"),
-        ("-- Output modes --", ""),
-        ("(default)", "Terminal UI — works over SSH, no browser needed (1D/2D)"),
-        ("--interactive / -i", "Dash web UI in browser (supports 1D/2D/3D)"),
-        ("--png", "Save PNG image(s) to case_dir/viz/; use -o DIR to change"),
+        ("-f, --format", "Force binary or silo (auto-detected if omitted)"),
+        ("-- Output mode --", ""),
+        ("(default)", "Terminal UI (1D/2D, works over SSH, no browser needed)"),
+        ("--interactive / -i", "Dash web UI (1D/2D/3D, needs browser or SSH tunnel)"),
+        ("--png", "Save PNG image(s) to case_dir/viz/"),
         ("--mp4", "Encode frames into an MP4 video"),
-        ("-- Appearance --", ""),
+        ("-- Appearance (--interactive, --png, --mp4) --", ""),
         ("--cmap NAME", "Matplotlib colormap (default: viridis)"),
         ("--vmin / --vmax", "Fix color-scale limits"),
         ("--log-scale", "Logarithmic color/y axis"),
-        ("--dpi N", "Image resolution (default: 150)"),
-        ("-- 3D options --", ""),
+        ("--dpi N", "Image resolution for --png/--mp4 (default: 150)"),
+        ("-- 3D slicing (--interactive, --png, --mp4) --", ""),
         ("--slice-axis x|y|z", "Plane to slice (default: z midplane)"),
         ("--slice-value VAL", "Slice at coordinate value"),
         ("--slice-index IDX", "Slice at array index"),
+        ("-- Mode-specific --", ""),
+        ("-o, --output DIR", "Output directory for --png/--mp4 (default: case_dir/viz/)"),
+        ("--fps N", "Frames per second for --mp4 (default: 10)"),
+        ("--port PORT", "Web server port for --interactive (default: 8050)"),
+        ("--host HOST", "Bind address for --interactive (default: 127.0.0.1)"),
     ],
 )