{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# Build a temperature plot matrix from literature data\n",
    "\n",
    "Turn digitized friction, wear-rate and wear-life data into the review’s metric × environment plot matrix.\n",
    "\n",
    "Paper: Temperature-Dependent Friction, Wear, and Life of MoS₂ Dry Film Lubricants for Space Mechanisms: A Comprehensive Review\n",
    "\n",
    "Website tutorial: reproduce/mos2-temperature-review/ · Status: Example run locally · Runtime: < 5 s."
   ],
   "id": "cell-1"
  },
  {
   "cell_type": "code",
   "metadata": {},
   "execution_count": null,
   "outputs": [],
   "source": [
    "!pip install numpy matplotlib"
   ],
   "id": "cell-2"
  },
  {
   "cell_type": "code",
   "metadata": {},
   "execution_count": null,
   "outputs": [],
   "source": [
    "%%writefile plot_matrix.py\n",
    "\"\"\"Tutorial — Build a temperature \"plot matrix\" from published tribology data.\n",
    "\n",
    "Faiyad, Miliate et al., Tribol. Lett. 73, 114 (2025) compiled friction coefficient (CoF), specific\n",
    "wear rate (SWR) and wear life of MoS2 dry films from 21 references into one matrix of plots:\n",
    "rows = metric, columns = environment (vacuum/inert gas vs air). Seeing every study on shared axes\n",
    "revealed the transition near 220 K that no single study could show.\n",
    "\n",
    "This script makes that matrix from a tidy CSV, one row per data point:\n",
    "    reference, coating, environment, temperature_K, metric, value\n",
    "    metric is one of: CoF, SWR_mm3_per_Nm, wear_life_cycles\n",
    "\n",
    "How to get real data: digitize the figures of the original papers (for example with\n",
    "WebPlotDigitizer, https://automeris.io), and record the coating and environment for every point.\n",
    "The bundled example_points.csv is SYNTHETIC. It only shows the format and is not literature data.\n",
    "\n",
    "Run:   python plot_matrix.py example_points.csv\n",
    "Output: out/plot_matrix.png\n",
    "\"\"\"\n",
    "import csv\n",
    "import sys\n",
    "from collections import defaultdict\n",
    "from pathlib import Path\n",
    "\n",
    "OUT = Path(__file__).parent / \"out\"\n",
    "OUT.mkdir(exist_ok=True)\n",
    "METRICS = [(\"CoF\", \"CoF\", False), (\"SWR_mm3_per_Nm\", \"SWR (mm$^3$/Nm)\", True), (\"wear_life_cycles\", \"Wear life (cycles)\", True)]\n",
    "ENVS = [\"vacuum/inert\", \"air\"]\n",
    "\n",
    "\n",
    "def main(path):\n",
    "    data = defaultdict(list)\n",
    "    with open(path, newline=\"\") as f:\n",
    "        for r in csv.DictReader(f):\n",
    "            env = \"air\" if r[\"environment\"].strip().lower() == \"air\" else \"vacuum/inert\"\n",
    "            data[(r[\"metric\"], env, r[\"reference\"])].append((float(r[\"temperature_K\"]), float(r[\"value\"])))\n",
    "    refs = sorted({k[2] for k in data})\n",
    "    import matplotlib\n",
    "    matplotlib.use(\"Agg\")\n",
    "    import matplotlib.pyplot as plt\n",
    "    cmap = plt.get_cmap(\"tab20\")\n",
    "    fig, axes = plt.subplots(3, 2, figsize=(8, 8), sharex=True)\n",
    "    for i, (m, label, logy) in enumerate(METRICS):\n",
    "        for j, env in enumerate(ENVS):\n",
    "            ax = axes[i, j]\n",
    "            for k, ref in enumerate(refs):\n",
    "                pts = sorted(data.get((m, env, ref), []))\n",
    "                if pts:\n",
    "                    ax.plot(*zip(*pts), \"o-\", ms=4, lw=1, color=cmap(k % 20), label=ref)\n",
    "            ax.axvline(220, color=\"k\", ls=\":\", lw=0.8)\n",
    "            if logy:\n",
    "                ax.set_yscale(\"log\")\n",
    "            if j == 0:\n",
    "                ax.set_ylabel(label)\n",
    "            if i == 0:\n",
    "                ax.set_title(env)\n",
    "            if i == 2:\n",
    "                ax.set_xlabel(\"Temperature (K)\")\n",
    "    handles, labels = axes[0, 0].get_legend_handles_labels()\n",
    "    fig.legend(handles, labels, loc=\"center right\", fontsize=7, frameon=False)\n",
    "    fig.tight_layout(rect=(0, 0, 0.82, 1))\n",
    "    fig.savefig(OUT / \"plot_matrix.png\", dpi=160)\n",
    "    print(\"wrote\", OUT / \"plot_matrix.png\")\n",
    "\n",
    "\n",
    "if __name__ == \"__main__\":\n",
    "    main(sys.argv[1] if len(sys.argv) > 1 else Path(__file__).parent / \"example_points.csv\")\n"
   ],
   "id": "cell-3"
  },
  {
   "cell_type": "code",
   "metadata": {},
   "execution_count": null,
   "outputs": [],
   "source": [
    "%%writefile example_points.csv\n",
    "reference,coating,environment,temperature_K,metric,value\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,150,CoF,0.1667\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,150,SWR_mm3_per_Nm,4.435e-06\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,150,wear_life_cycles,3224\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,180,CoF,0.1649\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,180,SWR_mm3_per_Nm,2.327e-06\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,180,wear_life_cycles,3256\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,200,CoF,0.1341\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,200,SWR_mm3_per_Nm,8.625e-07\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,200,wear_life_cycles,1.129e+04\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,220,CoF,0.08056\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,220,SWR_mm3_per_Nm,6.077e-07\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,220,wear_life_cycles,4.883e+04\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,240,CoF,0.03788\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,240,SWR_mm3_per_Nm,1.227e-07\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,240,wear_life_cycles,1.711e+05\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,270,CoF,0.03053\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,270,SWR_mm3_per_Nm,1.405e-07\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,270,wear_life_cycles,1.814e+05\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,300,CoF,0.01881\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,300,SWR_mm3_per_Nm,8.7e-08\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,300,wear_life_cycles,2.541e+05\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,350,CoF,0.01731\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,350,SWR_mm3_per_Nm,9.754e-08\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,350,wear_life_cycles,3.45e+05\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,400,CoF,0.02593\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,400,SWR_mm3_per_Nm,9.993e-08\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,400,wear_life_cycles,2.075e+05\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,450,CoF,0.01643\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,450,SWR_mm3_per_Nm,6.14e-08\n",
    "Synthetic A,sputtered MoS2 (synthetic),vacuum,450,wear_life_cycles,3.781e+05\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,165,CoF,0.1663\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,165,SWR_mm3_per_Nm,1.995e-06\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,165,wear_life_cycles,3890\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,195,CoF,0.1501\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,195,SWR_mm3_per_Nm,1.94e-06\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,195,wear_life_cycles,8612\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,215,CoF,0.09884\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,215,SWR_mm3_per_Nm,4.68e-07\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,215,wear_life_cycles,2.524e+04\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,235,CoF,0.04302\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,235,SWR_mm3_per_Nm,2.5e-07\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,235,wear_life_cycles,1.437e+05\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,255,CoF,0.02233\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,255,SWR_mm3_per_Nm,1.042e-07\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,255,wear_life_cycles,2.039e+05\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,285,CoF,0.0181\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,285,SWR_mm3_per_Nm,1.002e-07\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,285,wear_life_cycles,2.868e+05\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,315,CoF,0.02827\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,315,SWR_mm3_per_Nm,9.398e-08\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,315,wear_life_cycles,2.798e+05\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,365,CoF,0.02183\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,365,SWR_mm3_per_Nm,9.188e-08\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,365,wear_life_cycles,2.539e+05\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,415,CoF,0.02005\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,415,SWR_mm3_per_Nm,7.386e-08\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,415,wear_life_cycles,3.779e+05\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,465,CoF,0.02549\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,465,SWR_mm3_per_Nm,1.04e-07\n",
    "Synthetic B,sputtered MoS2 (synthetic),nitrogen,465,wear_life_cycles,2.916e+05\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,270,CoF,0.08247\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,270,SWR_mm3_per_Nm,2.079e-06\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,270,wear_life_cycles,4.992e+04\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,300,CoF,0.08173\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,300,SWR_mm3_per_Nm,1.244e-06\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,300,wear_life_cycles,3.12e+04\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,350,CoF,0.08004\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,350,SWR_mm3_per_Nm,5.853e-07\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,350,wear_life_cycles,7.316e+04\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,400,CoF,0.0874\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,400,SWR_mm3_per_Nm,9.101e-07\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,400,wear_life_cycles,1.309e+05\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,450,CoF,0.09821\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,450,SWR_mm3_per_Nm,7.963e-07\n",
    "Synthetic C,sputtered MoS2 (synthetic),air,450,wear_life_cycles,1.137e+05\n",
    "Synthetic D,sputtered MoS2 (synthetic),air,280,CoF,0.08662\n",
    "Synthetic D,sputtered MoS2 (synthetic),air,280,SWR_mm3_per_Nm,8.421e-07\n",
    "Synthetic D,sputtered MoS2 (synthetic),air,280,wear_life_cycles,1.783e+04\n",
    "Synthetic D,sputtered MoS2 (synthetic),air,330,CoF,0.06911\n",
    "Synthetic D,sputtered MoS2 (synthetic),air,330,SWR_mm3_per_Nm,5.094e-07\n",
    "Synthetic D,sputtered MoS2 (synthetic),air,330,wear_life_cycles,8459\n",
    "Synthetic D,sputtered MoS2 (synthetic),air,380,CoF,0.09522\n",
    "Synthetic D,sputtered MoS2 (synthetic),air,380,SWR_mm3_per_Nm,5.344e-06\n",
    "Synthetic D,sputtered MoS2 (synthetic),air,380,wear_life_cycles,5.488e+04\n",
    "Synthetic D,sputtered MoS2 (synthetic),air,430,CoF,0.09568\n",
    "Synthetic D,sputtered MoS2 (synthetic),air,430,SWR_mm3_per_Nm,6.587e-07\n",
    "Synthetic D,sputtered MoS2 (synthetic),air,430,wear_life_cycles,6.349e+04\n"
   ],
   "id": "cell-4"
  },
  {
   "cell_type": "code",
   "metadata": {},
   "execution_count": null,
   "outputs": [],
   "source": [
    "!python plot_matrix.py example_points.csv"
   ],
   "id": "cell-5"
  },
  {
   "cell_type": "code",
   "metadata": {},
   "execution_count": null,
   "outputs": [],
   "source": [
    "from IPython.display import Image, display\n",
    "import glob\n",
    "for f in sorted(glob.glob('out/*.png') + glob.glob('*.png')):\n",
    "    print(f); display(Image(f))"
   ],
   "id": "cell-6"
  }
 ],
 "metadata": {
  "kernelspec": {
   "name": "python3",
   "display_name": "Python 3"
  },
  "language_info": {
   "name": "python"
  },
  "colab": {
   "provenance": []
  }
 },
 "nbformat": 4,
 "nbformat_minor": 5
}