refactor(config.xlsx): expt_input_voltage -> expt_excitation_voltage

- CLI: read new column name; fallback to legacy if absent
- ThrustPostProcess __main__: support new column with legacy fallback
- Wire through call sites to use expt_excitation_voltage

Author: yunseo-kim

examples/config.xlsx

@@ -54,16 +54,35 @@ def _load_config(execution_root: Path, expt_name: str | None) -> dict[str, Any]:
         "totalmass [g]",
         "Nozzlediameter [mm]",
         "segment",
-        "expt_input_voltage [V]",
+        # Accept both legacy and new column names for excitation voltage
+        # either "expt_excitation_voltage [V]" or legacy "expt_input_voltage [V]"
+        "expt_excitation_voltage [V]",
         "expt_resistance [Ohm]",
     ]
     missing = [col for col in required_columns if col not in config.columns]
+    # Backward-compat: if the only missing item is the new excitation voltage column,
+    # but the legacy column exists, treat as satisfied.
+    if (
+        "expt_excitation_voltage [V]" in missing
+        and "expt_input_voltage [V]" in config.columns
+    ):
+        missing = [col for col in missing if col != "expt_excitation_voltage [V]"]
     if missing:
         raise ValueError(f"Missing columns in configuration: {missing}")
 
+    # Backward-compatible read for excitation voltage
+    if "expt_excitation_voltage [V]" in config.columns:
+        expt_excitation_voltage = config["expt_excitation_voltage [V]"][idx]
+    elif "expt_input_voltage [V]" in config.columns:
+        expt_excitation_voltage = config["expt_input_voltage [V]"][idx]
+    else:
+        raise ValueError(
+            "Missing excitation voltage column in configuration: expected 'expt_excitation_voltage [V]' or legacy 'expt_input_voltage [V]'"
+        )
+
     return {
         "expt_file_name": config["expt_file_name"][idx],
-        "expt_input_voltage": config["expt_input_voltage [V]"][idx],
+        "expt_excitation_voltage": expt_excitation_voltage,
         "expt_resistance": config["expt_resistance [Ohm]"][idx],
         "grain": {
             "OD": float(config["Outerdiameter [mm]"][idx]),
@@ -130,7 +149,7 @@ def cmd_thrust(args: argparse.Namespace) -> None:
     proc = ThrustPostProcess(
         data_raw=thrust_raw,
         file_name=cfg["expt_file_name"],
-        input_voltage=cfg["expt_input_voltage"],
+        excitation_voltage=cfg["expt_excitation_voltage"],
         resistance=cfg["expt_resistance"],
         execution_root=str(exec_root),
     )
@@ -209,7 +228,7 @@ def cmd_process(args: argparse.Namespace) -> None:
     thrust_proc = ThrustPostProcess(
         data_raw=thrust_raw,
         file_name=cfg["expt_file_name"],
-        input_voltage=cfg["expt_input_voltage"],
+        excitation_voltage=cfg["expt_excitation_voltage"],
         resistance=cfg["expt_resistance"],
         execution_root=str(exec_root),
     )

src/static_fire_toolkit/cli.py

@@ -56,7 +56,7 @@ def __init__(
         self,
         data_raw: pd.DataFrame,
         file_name: str,
-        input_voltage: float,
+        excitation_voltage: float,
         resistance: float,
         execution_root: str | None = None,
     ) -> None:
@@ -65,7 +65,7 @@ def __init__(
         Args:
             data_raw (pd.DataFrame): Raw data containing time and thrust measurements.
             file_name (str): File name identifier.
-            input_voltage (float): Input voltage used during measurement.
+            excitation_voltage (float): Excitation voltage used during measurement.
             resistance (float): Resistance value used during measurement.
             execution_root (str | None): Base directory for logs/ and results/*.
                 If None, defaults to current working directory.
@@ -157,7 +157,7 @@ def __init__(
         ].copy()
         self._data_raw.columns = ["time", "thrust"]
         self._file_name: str = file_name
-        self._input_voltage: float = input_voltage
+        self._excitation_voltage: float = excitation_voltage
         self._resistance: float = resistance
 
         self._logger.info("0. Initialization complete.")
@@ -227,7 +227,7 @@ def _convert_voltage_to_thrust(self, data: pd.DataFrame) -> pd.DataFrame:
             data["thrust"] = (
                 data["thrust"]
                 * 1000
-                / (self._sensitivity_mv_per_v * self._input_voltage)
+                / (self._sensitivity_mv_per_v * self._excitation_voltage)
                 * self._rated_capacity_kgf
                 * self._g
                 / (
@@ -662,10 +662,12 @@ def _thrust_plot(self) -> None:
             )
 
             ax.annotate(
-                "Impulse            " + str(round(self._impulse, 2)) + " Ns\n"
-                "Input Voltage   " + str(round(self._input_voltage, 2)) + " V\n"
-                "Resistance       " + str(round(self._resistance, 2)) + r" $\Omega$",
-                xy=(0.72, 0.85),
+                "Impulse                 " + str(round(self._impulse, 2)) + " Ns\n"
+                "Excitation Voltage " + str(round(self._excitation_voltage, 2)) + " V\n"
+                "Resistance            "
+                + str(round(self._resistance, 2))
+                + r" $\Omega$",
+                xy=(0.67, 0.85),
                 xycoords="axes fraction",
                 size=20,
                 font="Arial",
@@ -733,7 +735,15 @@ def run(self) -> pd.DataFrame:
     config = pd.read_excel(config_path, sheet_name=0, header=0, index_col=0)
     idx = len(config) - 1
     expt_file_name = config["expt_file_name"][idx]
-    expt_input_voltage = config["expt_input_voltage [V]"][idx]
+    # Backward-compatible: read excitation voltage from new or legacy column
+    if "expt_excitation_voltage [V]" in config.columns:
+        expt_excitation_voltage = config["expt_excitation_voltage [V]"][idx]
+    elif "expt_input_voltage [V]" in config.columns:
+        expt_excitation_voltage = config["expt_input_voltage [V]"][idx]
+    else:
+        raise ValueError(
+            "Missing excitation voltage column: expected 'expt_excitation_voltage [V]' or legacy 'expt_input_voltage [V]'"
+        )
     expt_resistance = config["expt_resistance [Ohm]"][idx]
 
     print(f"Loaded configuration for experiment: {expt_file_name}")
@@ -764,6 +774,6 @@ def run(self) -> pd.DataFrame:
     print("Successfully loaded input data file.")
 
     process = ThrustPostProcess(
-        thrust_data, expt_file_name, expt_input_voltage, expt_resistance
+        thrust_data, expt_file_name, expt_excitation_voltage, expt_resistance
     )
     _ = process.run()