batplot 1.8.30__tar.gz → 1.8.31__tar.gz

batplot-1.8.31/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md LICENSE USER_MANUAL.md
+recursive-include batplot/data *.md

{batplot-1.8.30/batplot.egg-info → batplot-1.8.31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: batplot
-Version: 1.8.30
+Version: 1.8.31
 Summary: Interactive plotting tool for material science (1D plot) and electrochemistry (GC, CV, dQ/dV, CPC, operando) with batch processing
 Author-email: Tian Dai <tianda@uio.no>
 License: MIT License
@@ -57,9 +57,10 @@ Dynamic: license-file
 
 ## Features
 
-- **Electrochemistry Modes**: Galvanostatic cycling (GC), cyclic voltammetry (CV), differential capacity (dQdV), capacity per cycle (CPC) with multi-file support
-- **Normal xy plot**: Designed for XRD, PDF, XAS (XANES/EXAFS) but also support other types
-- **Operando Analysis**: Correlate in-situ characterizations (XRD/PDF/XAS) with electrochemical data
+With a single line of command to easily plot publication-ready plots with customized, intuitive interactive editing features such as:
+- **Electrochemistry Plot**: Galvanostatic cycling (GC), cyclic voltammetry (CV), differential capacity (dQdV), capacity per cycle (CPC) with multi-file support
+- **1D XY plot**: Designed for XRD, PDF, XAS (XANES/EXAFS) but also support other types
+- **Operando Contour plot**: Correlate in-situ characterizations (XRD/PDF/XAS) with electrochemical data
 - **Interactive plotting**: Real-time editing customized for each type of plottings
 - **Session Persistence**: Save and reload complete plot states with `.pkl` files
 - **Style Management**: Import/export plot styles as `.bps`/`.bpsg` files
@@ -249,6 +250,23 @@ batplot custom.mpt --gc --pw 0.01 3 --cd 0.2 --i
 
 ## Operando Mode
 
+Contour plots from a folder of diffraction data, optionally with an electrochemistry side panel.
+
+### Bruker operando (.brml)
+
+For Bruker operando XRD (multi-scan .brml files named cyc1, cyc2, cyc3, etc.):
+
+```bash
+# Place .brml files (e.g. RA_O5_cyc1.brml, RA_O5_cyc2.brml) in the folder
+# Use --wl for Q conversion (e.g. synchrotron λ=0.709 Å)
+batplot RA_O5 --operando --wl 0.709 --i
+
+# EC side panel: .mpt or Biologic DataLogger CSV (*--DataLogger.csv), sorted by cyc
+# Time vs potential is concatenated across files (continuous time axis)
+```
+
+### Standard XY files
+
 ```bash
 # Contour from folder of .xy/.xye/.qye/.dat
 batplot --operando --wl 1.54 --i
@@ -313,8 +331,9 @@ batplot --all --readcol 2 3 style.bps --xaxis 2theta
 
 | Type | Formats |
 |------|---------|
-| **Electrochemistry** | `.csv` (Neware), `.mpt` (Biologic), `.xlsx` (Landt/Lanhe CPC) |
+| **Electrochemistry** | `.csv` (Neware, Biologic DataLogger), `.mpt` (Biologic), `.xlsx` (Landt/Lanhe CPC) |
 | **XRD / PDF** | `.xye`, `.xy`, `.qye`, `.dat`, `.csv`, `.txt`; Bruker `.brml`, `.raw` |
+| **Operando** | `.xy`, `.xye`, `.qye`, `.dat`; Bruker `.brml` (cyc1/cyc2/cyc3); EC: `.mpt` or DataLogger `.csv` |
 | **XAS** | `.nor`, `.chik`, `.chir` |
 | **Generic** | Use `--readcol` and `--xaxis` for custom formats |
 
@@ -324,9 +343,11 @@ batplot --all --readcol 2 3 style.bps --xaxis 2theta
 
 With `--interactive`:
 - **Cycle/Scan Control**: Toggle visibility, change colors
+- **Multi-file palette (EC/CV/dQdV)**: Press `c`, then type `fall viridis` (all files), `f1-5 viridis` (files 1–5), or `f1 f3 f5 4` (each file gets one color)
+- **CPC file palette**: In `ly`/`ry` color submenu, apply palette to file range: `1-5 viridis`, `1 3 5 4`
 - **Styling**: Line widths, markers, fonts
 - **Axes**: Labels, limits, ticks, spine styles
-- **Export**: Sessions (`.pkl`), styles (`.bps`/`.bpsg`), high-res images
+- **Export**: Sessions (`.pkl`), styles (`.bps`/`.bpsg`), high-res images. Colors persist via `p` (print style), `i` (import), `s` (save session), `b` (undo)
 - **Live Preview**: All changes update in real-time
 
 ---

{batplot-1.8.30 → batplot-1.8.31}/README.md

@@ -6,9 +6,10 @@
 
 ## Features
 
-- **Electrochemistry Modes**: Galvanostatic cycling (GC), cyclic voltammetry (CV), differential capacity (dQdV), capacity per cycle (CPC) with multi-file support
-- **Normal xy plot**: Designed for XRD, PDF, XAS (XANES/EXAFS) but also support other types
-- **Operando Analysis**: Correlate in-situ characterizations (XRD/PDF/XAS) with electrochemical data
+With a single line of command to easily plot publication-ready plots with customized, intuitive interactive editing features such as:
+- **Electrochemistry Plot**: Galvanostatic cycling (GC), cyclic voltammetry (CV), differential capacity (dQdV), capacity per cycle (CPC) with multi-file support
+- **1D XY plot**: Designed for XRD, PDF, XAS (XANES/EXAFS) but also support other types
+- **Operando Contour plot**: Correlate in-situ characterizations (XRD/PDF/XAS) with electrochemical data
 - **Interactive plotting**: Real-time editing customized for each type of plottings
 - **Session Persistence**: Save and reload complete plot states with `.pkl` files
 - **Style Management**: Import/export plot styles as `.bps`/`.bpsg` files
@@ -198,6 +199,23 @@ batplot custom.mpt --gc --pw 0.01 3 --cd 0.2 --i
 
 ## Operando Mode
 
+Contour plots from a folder of diffraction data, optionally with an electrochemistry side panel.
+
+### Bruker operando (.brml)
+
+For Bruker operando XRD (multi-scan .brml files named cyc1, cyc2, cyc3, etc.):
+
+```bash
+# Place .brml files (e.g. RA_O5_cyc1.brml, RA_O5_cyc2.brml) in the folder
+# Use --wl for Q conversion (e.g. synchrotron λ=0.709 Å)
+batplot RA_O5 --operando --wl 0.709 --i
+
+# EC side panel: .mpt or Biologic DataLogger CSV (*--DataLogger.csv), sorted by cyc
+# Time vs potential is concatenated across files (continuous time axis)
+```
+
+### Standard XY files
+
 ```bash
 # Contour from folder of .xy/.xye/.qye/.dat
 batplot --operando --wl 1.54 --i
@@ -262,8 +280,9 @@ batplot --all --readcol 2 3 style.bps --xaxis 2theta
 
 | Type | Formats |
 |------|---------|
-| **Electrochemistry** | `.csv` (Neware), `.mpt` (Biologic), `.xlsx` (Landt/Lanhe CPC) |
+| **Electrochemistry** | `.csv` (Neware, Biologic DataLogger), `.mpt` (Biologic), `.xlsx` (Landt/Lanhe CPC) |
 | **XRD / PDF** | `.xye`, `.xy`, `.qye`, `.dat`, `.csv`, `.txt`; Bruker `.brml`, `.raw` |
+| **Operando** | `.xy`, `.xye`, `.qye`, `.dat`; Bruker `.brml` (cyc1/cyc2/cyc3); EC: `.mpt` or DataLogger `.csv` |
 | **XAS** | `.nor`, `.chik`, `.chir` |
 | **Generic** | Use `--readcol` and `--xaxis` for custom formats |
 
@@ -273,9 +292,11 @@ batplot --all --readcol 2 3 style.bps --xaxis 2theta
 
 With `--interactive`:
 - **Cycle/Scan Control**: Toggle visibility, change colors
+- **Multi-file palette (EC/CV/dQdV)**: Press `c`, then type `fall viridis` (all files), `f1-5 viridis` (files 1–5), or `f1 f3 f5 4` (each file gets one color)
+- **CPC file palette**: In `ly`/`ry` color submenu, apply palette to file range: `1-5 viridis`, `1 3 5 4`
 - **Styling**: Line widths, markers, fonts
 - **Axes**: Labels, limits, ticks, spine styles
-- **Export**: Sessions (`.pkl`), styles (`.bps`/`.bpsg`), high-res images
+- **Export**: Sessions (`.pkl`), styles (`.bps`/`.bpsg`), high-res images. Colors persist via `p` (print style), `i` (import), `s` (save session), `b` (undo)
 - **Live Preview**: All changes update in real-time
 
 ---

{batplot-1.8.30 → batplot-1.8.31}/batplot/__init__.py

@@ -1,5 +1,5 @@
 """batplot: Interactive plotting for battery data visualization."""
 
-__version__ = "1.8.30"
+__version__ = "1.8.31"
 
 __all__ = ["__version__"]

{batplot-1.8.30 → batplot-1.8.31}/batplot/args.py

@@ -135,7 +135,7 @@ def _print_general_help() -> None:
         "What it does:\n"
         "  • XY: XRD/PDF/XAS/User defined curves\n"
         "  • EC: Galvanostatic cycling(GC)/Capacity per cycle(CPC)/Diffrential capacity(dQdV)/Cyclic Voltammetry(CV) from Neware (.csv) or Biologic (.mpt)\n"
-        "  • Operando: contour maps from a folder of .xy/.xye/.dat/.txt and optional .mpt file as side panel\n"
+        "  • Operando: contour from .xy/.xye/.dat/.brml; Bruker .brml (cyc1/cyc2/cyc3) with optional .mpt or DataLogger CSV side panel\n"
         "  • Batch: export vector plots for all files in a directory\n"
         "  • Interactive mode: --i flag opens a menu for styling, ranges, export, and save\n\n"
         "How to run (basics):\n"
@@ -156,7 +156,8 @@ def _print_general_help() -> None:
         "    batplot --cv file.mpt --i                 # Cyclic voltammetry\n"
         "    batplot --cpc file.csv --mass 3.52 --i     # Capacity per cycle\n\n"
         "  [Operando]\n"
-        "    batplot --operando --i [FOLDER]  # Contour from folder\n\n"
+        "    batplot --operando --i [FOLDER]  # Contour from folder\n"
+        "    batplot Path/to/file --operando --wl 0.709 --i  # Bruker .brml, Q conversion\n\n"
         "Features:\n"
         "  • Interactive (--i): styling, ranges, fonts, export, sessions\n"
         "  • XRD wavelength: --wl 1.54 or file.xye:1.5406 for Q conversion\n"
@@ -313,8 +314,11 @@ def _print_ec_help() -> None:
         "  batplot file1.csv file2.csv ./Style/style.bps --dqdv                  # Style from relative path\n"
         "  batplot file1.csv file2.mpt style.bpsg --cpc --mass 6                 # CPC mode\n"
         "  batplot file1.csv file2.mpt ./Style/style.bpsg --cpc --mass 6         # Style+geom from relative path\n\n"
+        "Multi-file (EC/CV/dQdV): Press c, then type fall viridis (all files), f1-5 viridis (files 1–5), or f1 f3 f5 4.\n"
+        "CPC (ly/ry): Type 1-5 viridis or 1 3 5 4 for file range. Exported via p, restored via i/s/b.\n\n"
         "Interactive (--i): choose cycles, colors/palettes, line widths, axis scales (linear/log/symlog),\n"
         "rename axes, toggle ticks/titles/spines, print/export/import style (.bps/.bpsg), save session (.pkl).\n"
+        "Multi-file: In c (cycles/colors), type fall viridis (all files), f1-5 viridis (files 1–5), or f1 f3 f5 4 (files 1,3,5).\n"
         "Note: Batch mode (--all) exports SVG files automatically; --i is for single-file plotting only.\n\n"
         "Axis swapping:\n"
         "  --ro                      : swap x and y axes (exchange x and y values before plotting)\n"
@@ -333,7 +337,14 @@ def _print_op_help() -> None:
         "  batplot --operando --xaxis 2theta              # Using 2theta axis\n"
         "  batplot --operando --1d --i           # Plot derivatives as contour with interactive menu\n"
         "  batplot --operando --2d --i          # Plot derivatives (alias for --1d)\n\n"
-        "  • Folder should contain XY files (.xy/.xye/.qye/.dat).\n"
+        "Bruker operando (.brml):\n"
+        "  • Place .brml files (e.g. XX_cyc1.brml, XX_cyc2.brml) in the folder.\n"
+        "  • Each .brml is expanded into per-scan rows; files sorted by cyc1/cyc2/cyc3.\n"
+        "  • Use --wl for Q conversion: batplot RA_O5 --operando --wl 0.709 --i\n"
+        "  • EC side panel: .mpt or Biologic DataLogger CSV (*--DataLogger.csv), sorted by cyc.\n"
+        "  • Time vs potential is concatenated across files (continuous time axis).\n\n"
+        "Standard XY files:\n"
+        "  • Folder should contain .xy/.xye/.qye/.dat files.\n"
         "  • Intensity scale is auto-adjusted between min/max values.\n"
         "  • If no .qye present, provide --xaxis 2theta or set --wl for Q conversion.\n"
         "  • If a .mpt file is present, a side panel is added for dual-panel mode (time/potential/temp/etc.).\n"
@@ -425,6 +436,8 @@ def build_parser() -> argparse.ArgumentParser:
     parser.add_argument("--xaxis", type=str, help=argparse.SUPPRESS)
     parser.add_argument("--convert", nargs=2, metavar=("FROM", "TO"), 
                         help="Convert XRD data: wavelength-to-wavelength (e.g., 1.54 0.25), wavelength-to-Q (e.g., 1.54 q), or Q-to-wavelength (e.g., q 1.54). Exports to 'converted' subfolder.")
+    parser.add_argument("--extract-brml-scans", nargs="?", const="", metavar="OUT_DIR",
+                        help="Extract each XRD scan from .brml file to separate .xy files. Optional OUT_DIR (default: <brml_stem>_scans).")
     parser.add_argument("--wl", type=float, help=argparse.SUPPRESS)
     parser.add_argument("--fullprof", nargs="+", type=float, help=argparse.SUPPRESS)
     parser.add_argument("--norm", action="store_true", help=argparse.SUPPRESS)
@@ -530,9 +543,11 @@ def parse_args(argv=None):
     if argv is None:
         argv = sys.argv[1:]
     
-    # Normalize single-dash short forms to double-dash long forms (backward compatibility)
+    # Normalize short forms to long forms (both -x and --x for common flags)
     _SHORT_TO_LONG = {
-        '-h': '--help', '-v': '--version', '-V': '--version', '-m': '--manual',
+        '-h': '--help', '--h': '--help',
+        '-v': '--version', '-V': '--version', '--v': '--version',
+        '-m': '--manual', '--m': '--manual',
         '-i': '--i', '-d': '--delta', '-r': '--xrange', '-o': '--out', '-c': '--convert',
         '-b': '--b',
     }
@@ -674,13 +689,13 @@ def parse_args(argv=None):
     ns, _unknown = parser.parse_known_args(argv)
     if getattr(ns, "manual", False):
         try:
-            from .manual import show_manual  # Lazy import avoids matplotlib startup unless needed
-            pdf_path = show_manual(open_viewer=True)
+            from .manual import open_manual_url  # Lazy import avoids matplotlib startup unless needed
+            open_manual_url()
             if _HAS_RICH and _console:
-                _console.print(f"\n[green]Opened manual:[/green] {pdf_path}")
+                _console.print("\n[green]Opened manual in browser[/green]")
             else:
-                print(f"\nOpened manual: {pdf_path}")
-        except Exception as exc:  # pragma: no cover - rendering is best effort
+                print("\nOpened manual in browser")
+        except Exception as exc:  # pragma: no cover - best effort
             if _HAS_RICH and _console:
                 _console.print(f"\n[red]Failed to open manual:[/red] {exc}")
             else:

{batplot-1.8.30 → batplot-1.8.31}/batplot/batch.py

@@ -21,6 +21,9 @@ from .readers import (
     read_ec_csv_dqdv_file,
     compute_dqdv_numerical,
     is_cs_b_format,
+    is_biologic_datalogger_csv,
+    read_biologic_datalogger_csv,
+    read_biologic_datalogger_dqdv_file,
     _load_csv_header_and_rows,
     read_biologic_txt_file,
 )
@@ -1013,8 +1016,16 @@ def batch_process_ec(directory: str, args):
                     cap_x = specific_capacity
                     x_label = r'Specific Capacity (mAh g$^{-1}$)'
                 elif ext == '.csv':
-                    cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = \
-                        read_ec_csv_file(fpath, prefer_specific=True)
+                    if is_biologic_datalogger_csv(fpath):
+                        if mass_mg is None:
+                            print(f"  Skipped {fname}: GC mode (Biologic DataLogger CSV) requires --mass parameter")
+                            plt.close(fig_b)
+                            continue
+                        cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = \
+                            read_biologic_datalogger_csv(fpath, mass_mg=mass_mg)
+                    else:
+                        cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = \
+                            read_ec_csv_file(fpath, prefer_specific=True)
                     x_label = r'Specific Capacity (mAh g$^{-1}$)'
                 else:
                     raise ValueError(f"Unsupported file type for GC: {ext}")
@@ -1116,13 +1127,21 @@ def batch_process_ec(directory: str, args):
 
                 # Try to load pre-calculated dQ/dV columns; fall back to numerical computation
                 _b_dqdv_header = None
-                try:
-                    _b_dqdv_header, _, _ = _load_csv_header_and_rows(fpath)
-                except Exception:
-                    pass
-
                 _b_loaded = False
-                if not _b_loaded:
+                if is_biologic_datalogger_csv(fpath):
+                    if mass_mg is None or mass_mg <= 0:
+                        print(f"  Skipped {fname}: dQ/dV (Biologic DataLogger CSV) requires --mass parameter")
+                        plt.close(fig_b)
+                        continue
+                    voltage, dqdv, cycles, charge_mask, discharge_mask, y_label = \
+                        read_biologic_datalogger_dqdv_file(fpath, mass_mg=mass_mg, prefer_specific=True)
+                    _b_loaded = True
+                else:
+                    try:
+                        _b_dqdv_header, _, _ = _load_csv_header_and_rows(fpath)
+                    except Exception:
+                        pass
+
                     try:
                         voltage, dqdv, cycles, charge_mask, discharge_mask, y_label = \
                             read_ec_csv_dqdv_file(fpath, prefer_specific=True)

{batplot-1.8.30 → batplot-1.8.31}/batplot/batplot.py

@@ -40,6 +40,10 @@ from .readers import (
     read_mpt_time_voltage,
     read_cs_b_csv_file,
     is_cs_b_format,
+    is_biologic_datalogger_csv,
+    read_biologic_datalogger_csv,
+    read_biologic_datalogger_dqdv_file,
+    read_biologic_datalogger_time_voltage,
     _load_csv_header_and_rows,
     read_biologic_txt_file,
     read_batx_file,
@@ -549,7 +553,7 @@ def batplot_main() -> int:  # type: ignore
     # If no files AND no special flags, nothing to do
     if not args.files and not has_special_flag:
         print("No input provided, nothing to do.")
-        print("Use 'batplot --version' for version and release info, 'batplot --help' for CLI help, or 'batplot --manual' to open the txt manual.")
+        print("Use 'batplot --v' for version and release info, 'batplot --h' for CLI help, or 'batplot --m' to open the user manual.")
         return 0  # Exit successfully (not an error, just nothing to do)
 
     # ====================================================================
@@ -797,15 +801,23 @@ def batplot_main() -> int:  # type: ignore
                         specific_capacity, voltage, cycle_numbers, charge_mask, discharge_mask = read_mpt_file(ec_file, mode='gc', mass_mg=mass_mg)
                         cap_x = specific_capacity
                     elif ec_file.lower().endswith('.csv'):
-                        try:
-                            header, _, _ = _load_csv_header_and_rows(ec_file)
-                            if is_cs_b_format(header):
-                                cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = read_cs_b_csv_file(ec_file, mode='gc')
-                            else:
-                                cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = read_ec_csv_file(ec_file, prefer_specific=True)
-                        except Exception:
+                        if is_biologic_datalogger_csv(ec_file):
+                            if mass_mg is None:
+                                continue
+                            cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = read_biologic_datalogger_csv(
+                                ec_file, mass_mg=mass_mg
+                            )
                             header = None
-                            cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = read_ec_csv_file(ec_file, prefer_specific=True)
+                        else:
+                            try:
+                                header, _, _ = _load_csv_header_and_rows(ec_file)
+                                if is_cs_b_format(header):
+                                    cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = read_cs_b_csv_file(ec_file, mode='gc')
+                                else:
+                                    cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = read_ec_csv_file(ec_file, prefer_specific=True)
+                            except Exception:
+                                header = None
+                                cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = read_ec_csv_file(ec_file, prefer_specific=True)
                         # If we only have absolute capacity and the user supplied --mass,
                         # convert Capacity(mAh) → Specific Capacity (mAh g⁻¹).
                         if header is not None:
@@ -1004,19 +1016,27 @@ def batplot_main() -> int:  # type: ignore
                         x_label_gc = r'Specific Capacity (mAh g$^{-1}$)'
                         cap_x = specific_capacity
                 elif ec_file.lower().endswith('.csv'):
-                    # Check if this is CS-B format
                     header = None
-                    try:
-                        header, _, _ = _load_csv_header_and_rows(ec_file)
-                        if is_cs_b_format(header):
-                            # Use CS-B format reader
-                            cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = read_cs_b_csv_file(ec_file, mode='gc')
-                        else:
-                            # Use standard CSV reader
+                    if is_biologic_datalogger_csv(ec_file):
+                        if mass_mg is None:
+                            print("GC mode (Biologic DataLogger CSV): --mass parameter is required (active material mass in milligrams).")
+                            print("Example: batplot file.csv --gc --mass 7.0")
+                            if len(data_files) > 1:
+                                continue
+                            else:
+                                exit(1)
+                        cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = read_biologic_datalogger_csv(
+                            ec_file, mass_mg=mass_mg
+                        )
+                    else:
+                        try:
+                            header, _, _ = _load_csv_header_and_rows(ec_file)
+                            if is_cs_b_format(header):
+                                cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = read_cs_b_csv_file(ec_file, mode='gc')
+                            else:
+                                cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = read_ec_csv_file(ec_file, prefer_specific=True)
+                        except Exception:
                             cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = read_ec_csv_file(ec_file, prefer_specific=True)
-                    except Exception:
-                        # Fallback to standard reader
-                        cap_x, voltage, cycle_numbers, charge_mask, discharge_mask = read_ec_csv_file(ec_file, prefer_specific=True)
                     # Decide whether we should treat cap_x as absolute or specific capacity.
                     x_label_gc = r'Specific Capacity (mAh g$^{-1}$)'
                     # If the CSV only has absolute capacity and no specific capacity, rescale
@@ -1893,38 +1913,46 @@ def batplot_main() -> int:  # type: ignore
                         voltage, dqdv, cycles, charge_mask, discharge_mask, y_label = read_mpt_dqdv_file(ec_file, mass_mg=_mf_mass, prefer_specific=True)
                     else:
                         _mf_dqdv_header = None
-                        try:
-                            _mf_dqdv_header, _, _ = _load_csv_header_and_rows(ec_file)
-                        except Exception:
-                            pass
-
                         _mf_loaded = False
-                        if _mf_dqdv_header is not None and is_cs_b_format(_mf_dqdv_header):
-                            voltage, dqdv, cycles, charge_mask, discharge_mask, y_label = read_cs_b_csv_file(ec_file, mode='dqdv')
+                        if is_biologic_datalogger_csv(ec_file):
+                            if _mf_mass is None or _mf_mass <= 0:
+                                continue
+                            voltage, dqdv, cycles, charge_mask, discharge_mask, y_label = read_biologic_datalogger_dqdv_file(
+                                ec_file, mass_mg=_mf_mass, prefer_specific=True
+                            )
                             _mf_loaded = True
-
-                        if not _mf_loaded:
+                        else:
                             try:
-                                voltage, dqdv, cycles, charge_mask, discharge_mask, y_label = read_ec_csv_dqdv_file(ec_file, prefer_specific=True)
-                                _mf_loaded = True
-                            except ValueError:
+                                _mf_dqdv_header, _, _ = _load_csv_header_and_rows(ec_file)
+                            except Exception:
                                 pass
 
-                        if not _mf_loaded:
-                            _mf_gc_cap, _mf_gc_volt, _mf_gc_cyc, _mf_gc_chgm, _mf_gc_dchm = read_ec_csv_file(ec_file, prefer_specific=True)
-                            if _mf_dqdv_header is not None:
-                                _mf_hdrs = [h.strip().replace('\t', '') for h in _mf_dqdv_header]
-                                _mf_has_spec = any('Spec. Cap.(mAh/g)' in h for h in _mf_hdrs)
-                                _mf_has_abs = any(h == 'Capacity(mAh)' for h in _mf_hdrs)
-                                if _mf_has_abs and not _mf_has_spec:
-                                    if _mf_mass and _mf_mass > 0:
-                                        _mf_gc_cap = _mf_gc_cap * (1000.0 / float(_mf_mass))
-                                    else:
-                                        print(f"dQ/dV mode: {os.path.basename(ec_file)!r} contains only Capacity(mAh) — pass --mass <mg>.")
-                            voltage, dqdv, cycles, charge_mask, discharge_mask, y_label = compute_dqdv_numerical(
-                                _mf_gc_cap, _mf_gc_volt, _mf_gc_cyc, _mf_gc_chgm, _mf_gc_dchm
-                            )
-                            print(f"dQ/dV mode: computing numerically from GC data for {os.path.basename(ec_file)!r}.")
+                            if _mf_dqdv_header is not None and is_cs_b_format(_mf_dqdv_header):
+                                voltage, dqdv, cycles, charge_mask, discharge_mask, y_label = read_cs_b_csv_file(ec_file, mode='dqdv')
+                                _mf_loaded = True
+
+                            if not _mf_loaded:
+                                try:
+                                    voltage, dqdv, cycles, charge_mask, discharge_mask, y_label = read_ec_csv_dqdv_file(ec_file, prefer_specific=True)
+                                    _mf_loaded = True
+                                except ValueError:
+                                    pass
+
+                            if not _mf_loaded:
+                                _mf_gc_cap, _mf_gc_volt, _mf_gc_cyc, _mf_gc_chgm, _mf_gc_dchm = read_ec_csv_file(ec_file, prefer_specific=True)
+                                if _mf_dqdv_header is not None:
+                                    _mf_hdrs = [h.strip().replace('\t', '') for h in _mf_dqdv_header]
+                                    _mf_has_spec = any('Spec. Cap.(mAh/g)' in h for h in _mf_hdrs)
+                                    _mf_has_abs = any(h == 'Capacity(mAh)' for h in _mf_hdrs)
+                                    if _mf_has_abs and not _mf_has_spec:
+                                        if _mf_mass and _mf_mass > 0:
+                                            _mf_gc_cap = _mf_gc_cap * (1000.0 / float(_mf_mass))
+                                        else:
+                                            print(f"dQ/dV mode: {os.path.basename(ec_file)!r} contains only Capacity(mAh) — pass --mass <mg>.")
+                                voltage, dqdv, cycles, charge_mask, discharge_mask, y_label = compute_dqdv_numerical(
+                                    _mf_gc_cap, _mf_gc_volt, _mf_gc_cyc, _mf_gc_chgm, _mf_gc_dchm
+                                )
+                                print(f"dQ/dV mode: computing numerically from GC data for {os.path.basename(ec_file)!r}.")
                     if y_label_used is None:
                         y_label_used = y_label
                     segments = _mask_segments(charge_mask, 'charge') + _mask_segments(discharge_mask, 'discharge')
@@ -2058,15 +2086,25 @@ def batplot_main() -> int:  # type: ignore
                 else:
                     # Load header for format detection and mass-scaling check
                     _dqdv_header = None
-                    try:
-                        _dqdv_header, _, _ = _load_csv_header_and_rows(ec_file)
-                    except Exception:
-                        pass
-
                     _loaded_dqdv = False
-                    if _dqdv_header is not None and is_cs_b_format(_dqdv_header):
-                        voltage, dqdv, cycles, charge_mask, discharge_mask, y_label = read_cs_b_csv_file(ec_file, mode='dqdv')
+                    if is_biologic_datalogger_csv(ec_file):
+                        if _dqdv_mass is None or _dqdv_mass <= 0:
+                            print(f"dQ/dV mode (Biologic DataLogger CSV): --mass parameter is required.")
+                            print(f"Example: batplot {ec_file} --dqdv --mass 7.0")
+                            continue
+                        voltage, dqdv, cycles, charge_mask, discharge_mask, y_label = read_biologic_datalogger_dqdv_file(
+                            ec_file, mass_mg=_dqdv_mass, prefer_specific=True
+                        )
                         _loaded_dqdv = True
+                    else:
+                        try:
+                            _dqdv_header, _, _ = _load_csv_header_and_rows(ec_file)
+                        except Exception:
+                            pass
+
+                        if _dqdv_header is not None and is_cs_b_format(_dqdv_header):
+                            voltage, dqdv, cycles, charge_mask, discharge_mask, y_label = read_cs_b_csv_file(ec_file, mode='dqdv')
+                            _loaded_dqdv = True
 
                     if not _loaded_dqdv:
                         try:
@@ -2086,11 +2124,11 @@ def batplot_main() -> int:  # type: ignore
                                 if _dqdv_mass and _dqdv_mass > 0:
                                     _gc_cap = _gc_cap * (1000.0 / float(_dqdv_mass))
                                 else:
-                                    print(f"dQ/dV mode: {file_basename!r} contains only Capacity(mAh) — pass --mass <mg> for specific dQ/dV.")
+                                    print(f"dQ/dV mode: {os.path.basename(ec_file)!r} contains only Capacity(mAh) — pass --mass <mg> for specific dQ/dV.")
                         voltage, dqdv, cycles, charge_mask, discharge_mask, y_label = compute_dqdv_numerical(
                             _gc_cap, _gc_volt, _gc_cyc, _gc_chgm, _gc_dchm
                         )
-                        print(f"dQ/dV mode: no dQ/dV column found — computing numerically from GC data for {file_basename!r}.")
+                        print(f"dQ/dV mode: no dQ/dV column found — computing numerically from GC data for {os.path.basename(ec_file)!r}.")
 
                 # Create the plot
                 fig, ax = plt.subplots(figsize=(10, 6))
@@ -3689,7 +3727,10 @@ def batplot_main() -> int:  # type: ignore
             # Time mode: read time (h) vs potential (V) for electrochemistry files
             try:
                 if file_ext == '.csv':
-                    x, y = read_csv_time_voltage(fname)
+                    if is_biologic_datalogger_csv(fname):
+                        x, y = read_biologic_datalogger_time_voltage(fname)
+                    else:
+                        x, y = read_csv_time_voltage(fname)
                 elif file_ext == '.mpt':
                     x, y = read_mpt_time_voltage(fname)
                 e = None