Implement Battery Data Format (BDF) column system and BDX format

docs/Makefile

@@ -1,24 +1,20 @@
-# Minimal makefile for Sphinx documentation
-#
+# Minimal makefile for Sphinx documentation.
 
 # You can set these variables from the command line, and also
 # from the environment for the first two.
-SPHINXOPTS    ?=
-SPHINXBUILD   ?= sphinx-build
-SOURCEDIR     = source
-BUILDDIR      = build
-
-# New target for running the append_footbib.py script
-prebuild:
-	python source/_append_footbib.py source
+SPHINXOPTS ?=
+SPHINXBUILD ?= uv run sphinx-build
+PYTHON ?= uv run python
+SOURCEDIR = source
+BUILDDIR = build
 
 # Put it first so that "make" without argument is like "make help".
 help: prebuild
 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
-.PHONY: help Makefile prebuild
+.PHONY: help prebuild Makefile
 
-# Catch-all target: route all unknown targets to Sphinx using the new
-# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+# Catch-all target: route all unknown targets to Sphinx using make mode.
+# $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile prebuild
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/source/examples/analysing-GITT-data.ipynb

@@ -52,10 +52,9 @@
     "\n",
     "# Create a cell object\n",
     "cell = pyprobe.Cell(info=info_dictionary)\n",
-    "cell.import_from_cycler(\n",
+    "cell.add_procedure(\n",
     "    procedure_name=\"Sample\",\n",
-    "    cycler=\"neware\",\n",
-    "    input_data_path=data_directory + \"/sample_data_neware.xlsx\",\n",
+    "    source=data_directory + \"/sample_data_neware.xlsx\",\n",
     ")\n",
     "print(cell.procedure[\"Sample\"].experiment_names)"
    ]
@@ -75,20 +74,20 @@
    "source": [
     "fig, ax = plt.subplots()\n",
     "cell.procedure[\"Sample\"].experiment(\"Break-in Cycles\").plot(\n",
-    "    x=\"Time [hr]\",\n",
-    "    y=\"Voltage [V]\",\n",
+    "    x=\"Test Time / hr\",\n",
+    "    y=\"Voltage / V\",\n",
     "    ax=ax,\n",
     "    label=\"Break-in Cycles\",\n",
     "    color=\"blue\",\n",
     ")\n",
     "cell.procedure[\"Sample\"].experiment(\"Discharge Pulses\").plot(\n",
-    "    x=\"Time [hr]\",\n",
-    "    y=\"Voltage [V]\",\n",
+    "    x=\"Test Time / hr\",\n",
+    "    y=\"Voltage / V\",\n",
     "    ax=ax,\n",
     "    label=\"Discharge Pulses\",\n",
     "    color=\"red\",\n",
     ")\n",
-    "ax.set_ylabel(\"Voltage [V]\")"
+    "ax.set_ylabel(\"Voltage / V\")"
    ]
   },
   {
@@ -111,20 +110,20 @@
     "\n",
     "fig, ax = plt.subplots()\n",
     "cell.procedure[\"Sample\"].experiment(\"Break-in Cycles\").plot(\n",
-    "    x=\"Time [hr]\",\n",
-    "    y=\"SOC\",\n",
+    "    x=\"Test Time / hr\",\n",
+    "    y=\"SOC / %\",\n",
     "    ax=ax,\n",
     "    label=\"Break-in Cycles\",\n",
     "    color=\"blue\",\n",
     ")\n",
     "cell.procedure[\"Sample\"].experiment(\"Discharge Pulses\").plot(\n",
-    "    x=\"Time [hr]\",\n",
-    "    y=\"SOC\",\n",
+    "    x=\"Test Time / hr\",\n",
+    "    y=\"SOC / %\",\n",
     "    ax=ax,\n",
     "    label=\"Discharge Pulses\",\n",
     "    color=\"red\",\n",
     ")\n",
-    "ax.set_ylabel(\"SOC\")\n",
+    "ax.set_ylabel(\"SOC / %\")\n",
     "plt.legend(loc=\"lower left\")"
    ]
   },
@@ -145,13 +144,13 @@
     "\n",
     "fig, ax = plt.subplots()\n",
     "pulsing_experiment.plot(\n",
-    "    x=\"Experiment Time [hr]\",\n",
-    "    y=\"Voltage [V]\",\n",
+    "    x=\"Test Time / hr\",\n",
+    "    y=\"Voltage / V\",\n",
     "    ax=ax,\n",
     "    label=\"Discharge Pulses\",\n",
     "    color=\"red\",\n",
     ")\n",
-    "ax.set_ylabel(\"Voltage [V]\")\n",
+    "ax.set_ylabel(\"Voltage / V\")\n",
     "plt.legend(loc=\"lower left\")"
    ]
   },
@@ -188,20 +187,20 @@
    "source": [
     "fig, ax = plt.subplots()\n",
     "pulse_object.input_data.plot(\n",
-    "    x=\"Experiment Time [hr]\",\n",
-    "    y=\"Voltage [V]\",\n",
+    "    x=\"Test Time / hr\",\n",
+    "    y=\"Voltage / V\",\n",
     "    label=\"Full Experiment\",\n",
     "    color=\"blue\",\n",
     "    ax=ax,\n",
     ")\n",
     "pulse_object.pulse(4).plot(\n",
-    "    x=\"Experiment Time [hr]\",\n",
-    "    y=\"Voltage [V]\",\n",
+    "    x=\"Test Time / hr\",\n",
+    "    y=\"Voltage / V\",\n",
     "    label=\"Pulse 5\",\n",
     "    color=\"red\",\n",
     "    ax=ax,\n",
     ")\n",
-    "ax.set_ylabel(\"Voltage [V]\")"
+    "ax.set_ylabel(\"Voltage / V\")"
    ]
   },
   {
@@ -252,9 +251,9 @@
    "outputs": [],
    "source": [
     "fig, ax = plt.subplots()\n",
-    "pulse_resistances.plot(x=\"SOC\", y=\"R0 [Ohms]\", ax=ax, label=\"R0\", color=\"blue\")\n",
-    "pulse_resistances.plot(x=\"SOC\", y=\"R_10s [Ohms]\", ax=ax, label=\"R_10s\", color=\"red\")\n",
-    "ax.set_ylabel(\"Resistance [Ohms]\")"
+    "pulse_resistances.plot(x=\"SOC / %\", y=\"R0 / Ohm\", ax=ax, label=\"R0\", color=\"blue\")\n",
+    "pulse_resistances.plot(x=\"SOC / %\", y=\"R_10s / Ohm\", ax=ax, label=\"R_10s\", color=\"red\")\n",
+    "ax.set_ylabel(\"Resistance / Ohm\")"
    ]
   }
  ],