nerdCopter
diff --git a/‎OVERVIEW.md‎
Lines changed: 17 additions & 12 deletions b/‎OVERVIEW.md‎
Lines changed: 17 additions & 12 deletions
diff --git a/‎README.md‎
Lines changed: 27 additions & 21 deletions b/‎README.md‎
Lines changed: 27 additions & 21 deletions
@@ -23,7 +23,7 @@ All analysis parameters, thresholds, plot dimensions, and algorithmic constants
 ### Core Functionality
 
 1.  **Argument Parsing (`src/main.rs`):**
-    * Parses command-line arguments: input CSV file(s), an optional `--dps` parameter (requires a numeric threshold value for detailed step response plots with low/high split), an optional `--output-dir` for specifying the output directory, and an optional `--step` flag to generate only step response plots.
+    * Parses command-line arguments: input CSV file(s), an optional `--dps` parameter (requires a numeric threshold value for detailed step response plots with low/high split), an optional `--output-dir` for specifying the output directory, and plot-selection flags (`--core` [default], `--extended`, `--step`, `--bode`).
     * Additional options include `--help` and `--version` for user assistance.
     * The `--output-dir` parameter now requires a directory path when specified. If omitted, plots are saved in the source folder (input file's directory).
     * Handles multiple input files and determines if a directory prefix should be added to output filenames to avoid collisions when processing files from different directories.
@@ -91,17 +91,22 @@ All analysis parameters, thresholds, plot dimensions, and algorithmic constants
                     * Clear disclaimers that recommendations are starting points, not absolute values
                     * Works for all aircraft sizes including 10"+ where D > P (P:D < 1.0)
                 * Recommendations appear in both console output and step response plot legends
-            * **Other plots generated (`src/plot_functions/`):** When the `--step` flag is not used, the following additional plots are generated. These per-plot gates are controlled by the `PlotConfig` struct (defaults to all enabled; `PlotConfig::step_only()` when `--step` is specified):
-                * `plot_pidsum_error_setpoint`: PIDsum (P+I+D), PID Error (Setpoint - GyroADC), and Setpoint time-domain traces for each axis.
-                * `plot_setpoint_vs_gyro`: Setpoint and filtered gyro time-domain comparison for each axis.
-                * `plot_gyro_vs_unfilt`: Filtered vs. unfiltered gyro time-domain comparison for each axis. Includes enhanced cross-correlation filtering delay calculation.
-                * `plot_gyro_spectrums`: Frequency-domain amplitude spectrums of filtered and unfiltered gyro data with intelligent peak detection and labeling using scale-aware thresholds (`FILTERED_GYRO_MIN_THRESHOLD` for filtered gyro data). Includes enhanced cross-correlation filtering delay calculation and flight firmware filter response curve overlays.
-                * `plot_psd`: Power Spectral Density plots in dB scale with peak labeling. Includes enhanced cross-correlation filtering delay calculation.
-                * `plot_d_term_spectrums`: Frequency-domain amplitude spectrums of D-term data with intelligent peak detection using scale-aware thresholds (`FILTERED_D_TERM_MIN_THRESHOLD` for filtered D-term data). Includes enhanced cross-correlation filtering delay calculation with intelligent D-term activity detection (skips axes where D gain = 0).
-                * `plot_d_term_psd`: Power Spectral Density plots of D-term data in dB scale with intelligent threshold filtering (`PSD_PEAK_LABEL_MIN_VALUE_DB` for filtered data) and enhanced formatting. Includes enhanced cross-correlation filtering delay calculation with intelligent D-term activity detection (skips axes where D gain = 0).
-                * `plot_d_term_heatmap`: D-term throttle-frequency heatmaps showing PSD vs. throttle (Y-axis) and frequency (X-axis) to analyze D-term energy distribution across different throttle levels.
-                * `plot_psd_db_heatmap`: Spectrograms showing PSD vs. time as heatmaps using Short-Time Fourier Transform (STFT) with configurable window duration and overlap.
-                * `plot_throttle_freq_heatmap`: Heatmaps showing PSD vs. throttle (Y-axis) and frequency (X-axis) to analyze noise characteristics across different throttle levels.
+            * **Other plots generated (`src/plot_functions/`):** Which plots are generated is controlled by the `PlotConfig` struct. The default (no flag) enables the core set; `--extended` enables all plots except Bode. Plots are gated per-field in `PlotConfig`:
+                * **Core plots (default — no flag required):**
+                    * `plot_setpoint_vs_gyro`: Setpoint and filtered gyro time-domain comparison for each axis.
+                    * `plot_gyro_vs_unfilt`: Filtered vs. unfiltered gyro time-domain comparison for each axis. Includes enhanced cross-correlation filtering delay calculation.
+                    * `plot_gyro_spectrums`: Frequency-domain amplitude spectrums of filtered and unfiltered gyro data with intelligent peak detection and labeling using scale-aware thresholds (`FILTERED_GYRO_MIN_THRESHOLD` for filtered gyro data). Includes enhanced cross-correlation filtering delay calculation and flight firmware filter response curve overlays.
+                    * `plot_d_term_spectrums`: Frequency-domain amplitude spectrums of D-term data with intelligent peak detection using scale-aware thresholds (`FILTERED_D_TERM_MIN_THRESHOLD` for filtered D-term data). Includes enhanced cross-correlation filtering delay calculation with intelligent D-term activity detection (skips axes where D gain = 0).
+                    * `plot_motor_spectrums`: Motor output frequency analysis.
+                * **Extended plots (`--extended` adds these to the core set):**
+                    * `plot_pidsum_error_setpoint`: PIDsum (P+I+D), PID Error (Setpoint - GyroADC), and Setpoint time-domain traces for each axis.
+                    * `plot_pid_activity`: P, I, D term activity over time.
+                    * `plot_setpoint_derivative`: Setpoint rate-of-change (feed-forward proxy) for each axis.
+                    * `plot_psd`: Power Spectral Density plots in dB scale with peak labeling. Includes enhanced cross-correlation filtering delay calculation.
+                    * `plot_d_term_psd`: Power Spectral Density plots of D-term data in dB scale with intelligent threshold filtering (`PSD_PEAK_LABEL_MIN_VALUE_DB` for filtered data) and enhanced formatting. Includes enhanced cross-correlation filtering delay calculation with intelligent D-term activity detection (skips axes where D gain = 0).
+                    * `plot_d_term_heatmap`: D-term throttle-frequency heatmaps showing PSD vs. throttle (Y-axis) and frequency (X-axis) to analyze D-term energy distribution across different throttle levels.
+                    * `plot_psd_db_heatmap`: Spectrograms showing PSD vs. time as heatmaps using Short-Time Fourier Transform (STFT) with configurable window duration and overlap.
+                    * `plot_throttle_freq_heatmap`: Heatmaps showing PSD vs. throttle (Y-axis) and frequency (X-axis) to analyze noise characteristics across different throttle levels.
 
 ### Filtering Delay Calculation
 
 
@@ -25,6 +25,9 @@ cargo build --release
 ```
 
 ### Usage
+
+> **Notice:** Default output is **core plots only**. Use `--extended` for all plots.
+
 ```shell
 Usage: ./BlackBox_CSV_Render <input1> [<input2> ...] [OPTIONS]
 
@@ -36,28 +39,29 @@ Usage: ./BlackBox_CSV_Render <input1> [<input2> ...] [OPTIONS]
 
 === PLOT TYPE SELECTION ===
 
-  Note: Plot flags are combinable. Without flags, all plots generated.
-
-  --step: Generate only step response plots.
-  --motor: Generate only motor spectrum plots.
-  --setpoint: Generate only setpoint-related plots.
-  --pid: Generate only P, I, D activity plot.
-  --bode: Bode plot analysis (requires chirp/sweep system-id test flight, not normal logs).
+  --core           [default] Step Response, Gyro Spectrums, D-term Spectrums,
+                   Setpoint vs Gyro, Gyro vs Unfiltered, Motor Spectrums.
+  --extended       All plots except Bode — adds PIDsum/Error, PID Activity,
+                   Setpoint Derivative, Gyro PSD, D-term PSD, and heatmaps.
+  --step           Step response only.
+  --bode           Bode only (requires chirp/sweep system-id test flight).
 
 === ANALYSIS OPTIONS ===
 
-  --butterworth: Show Butterworth PT1 cutoffs on gyro/D-term spectrum plots.
-  --dps <value>: Deg/s threshold for detailed step response plots (positive number).
-  --estimate-optimal-p: Enable optimal P estimation from throttle-punch dynamics. Requires .headers.csv; skips P estimation if absent.
+  --butterworth    Show Butterworth PT1 cutoffs on gyro/D-term spectrum plots.
+  --dps <value>    Deg/s threshold for detailed step response plots (positive number).
+  --estimate-optimal-p  [EXPERIMENTAL] Optimal P estimation from throttle-punch
+                        dynamics. Requires .headers.csv; skips if absent.
 
 === GENERAL ===
 
-  --debug: Show detailed metadata during processing.
-  -h, --help: Show this help message and exit.
-  -V, --version: Show version information.
+  --debug          Show detailed metadata during processing.
+  -h, --help       Show this help message and exit.
+  -V, --version    Show version information.
 ```
 
 Arguments can be in any order. Wildcards (e.g., *.csv) are shell-expanded and work with mixed file/directory patterns.
+
 ### Example execution commands
 ```shell
 ./target/release/BlackBox_CSV_Render path/to/BTFL_Log.csv
@@ -72,10 +76,7 @@ Arguments can be in any order. Wildcards (e.g., *.csv) are shell-expanded and wo
 ./target/release/BlackBox_CSV_Render path/to/ -R --step --output-dir ./step-only
 ```
 ```shell
-./target/release/BlackBox_CSV_Render path/to/ --setpoint --output-dir ./setpoint-only
-```
-```shell
-./target/release/BlackBox_CSV_Render path/to/ --step --setpoint --motor --output-dir ./all-selective
+./target/release/BlackBox_CSV_Render path/to/ --extended --output-dir ./all-plots
 ```
 ```shell
 ./target/release/BlackBox_CSV_Render path/to/BTFL_Log.csv --step --estimate-optimal-p
@@ -84,19 +85,24 @@ Arguments can be in any order. Wildcards (e.g., *.csv) are shell-expanded and wo
 ### Output
 
 #### PNG Files Generated
+
+**Core (default):**
 - `*_Step_Response_stacked_plot_*.png` — Step response analysis with P:D recommendations
-- `*_PIDsum_PIDerror_Setpoint_stacked.png` — PIDsum, PID error, and setpoint traces
 - `*_SetpointVsGyro_stacked.png` — Setpoint vs. filtered gyro comparison
 - `*_GyroVsUnfilt_stacked.png` — Filtered vs. unfiltered gyro comparison with delay estimates
 - `*_Gyro_Spectrums_comparative.png` — Frequency-domain gyro amplitude spectrums
-- `*_Gyro_PSD_comparative.png` — Gyro power spectral density (dB scale)
 - `*_D_Term_Spectrums_comparative.png` — Frequency-domain D-term amplitude spectrums
+- `*_Motor_Spectrums_stacked.png` — Motor output frequency analysis (supports any motor count; colors wrap every 8 motors)
+
+**Extended (`--extended` adds these to the core set):**
+- `*_PIDsum_PIDerror_Setpoint_stacked.png` — PIDsum, PID error, and setpoint traces
+- `*_PID_Activity_stacked.png` — P, I, D term activity over time
+- `*_SetpointDerivative_stacked.png` — Setpoint rate-of-change / feed-forward proxy
+- `*_Gyro_PSD_comparative.png` — Gyro power spectral density (dB scale)
 - `*_D_Term_PSD_comparative.png` — D-term power spectral density (dB scale)
 - `*_D_Term_Heatmap_comparative.png` — D-term throttle/frequency heatmap
 - `*_Gyro_PSD_Spectrogram_comparative.png` — Gyro spectrogram (PSD vs. time)
 - `*_Throttle_Freq_Heatmap_comparative.png` — Throttle/frequency heatmap analysis
-- `*_Motor_Spectrums_stacked.png` — Motor output frequency analysis (supports any motor count; colors wrap every 8 motors)
-- `*_PID_Activity_stacked.png` — P, I, D term activity over time (stacked plot showing all three PID components)
 
 #### Console Output:
 - Current P:D ratio and peak analysis with response assessment