{
  "node": {
    "id": "term:diffusion",
    "type": "Term",
    "label": "Diffusion",
    "properties": {
      "id": "diffusion",
      "name": "Diffusion",
      "section": "topic-transport",
      "definition": "The net movement of a species from where it is concentrated to where it is scarce, driven by random thermal motion. In a cell lithium diffuses through the electrolyte in the pores and, far more slowly, through the solid particles themselves.",
      "related": [
        "ficks-first-law",
        "diffusion-coefficient",
        "solid-state-diffusion",
        "concentration-gradient",
        "migration"
      ],
      "lesson": "transport/ficks-first-law/#in-a-cell",
      "url": "https://lemonergy.com/learn/glossary/diffusion/",
      "mentions": [
        "electrolyte"
      ]
    }
  },
  "edges": [
    {
      "id": "edge:25",
      "source": "term:diffusion",
      "target": "workflow:fick-flux",
      "type": "usedIn",
      "properties": {
        "sourceFile": "wiki-blocks.json"
      }
    },
    {
      "id": "edge:2029",
      "source": "term:diffusion",
      "target": "topic:topic-transport",
      "type": "belongsTo",
      "properties": {
        "sourceFile": "terms.json"
      }
    },
    {
      "id": "edge:2030",
      "source": "term:diffusion",
      "target": "term:ficks-first-law",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:2031",
      "source": "term:diffusion",
      "target": "term:diffusion-coefficient",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:2032",
      "source": "term:diffusion",
      "target": "term:solid-state-diffusion",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:2033",
      "source": "term:diffusion",
      "target": "term:concentration-gradient",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:2034",
      "source": "term:diffusion",
      "target": "term:migration",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:mentions/diffusion/electrolyte",
      "source": "term:diffusion",
      "target": "term:electrolyte",
      "type": "mentions",
      "properties": {
        "sourceFile": "terms.json",
        "method": "build_glossary.mention_index + mentions",
        "field": "definition",
        "meaning": "Text mention; not a causal claim"
      }
    },
    {
      "id": "edge:2036",
      "source": "term:diffusion",
      "target": "lesson:transport/ficks-first-law/",
      "type": "explainedIn",
      "properties": {
        "sourceFile": "terms.json",
        "url": "https://lemonergy.com/learn/transport/ficks-first-law/#in-a-cell"
      }
    },
    {
      "id": "edge:2037",
      "source": "term:diffusion",
      "target": "visual:diffusion",
      "type": "illustratedBy",
      "properties": {
        "sourceFile": "visual-pages.json"
      }
    },
    {
      "id": "edge:2038",
      "source": "term:diffusion",
      "target": "reference:iupac-green",
      "type": "cites",
      "properties": {
        "sourceFile": "wiki-references.json",
        "scope": "direct technical reference"
      }
    }
  ],
  "neighbors": [
    {
      "id": "workflow:fick-flux",
      "type": "Workflow",
      "label": "Calculate diffusion flux",
      "properties": {
        "id": "fick-flux",
        "title": "Calculate diffusion flux",
        "kind": "core",
        "summary": "Lemonergy Core evaluates this relation.",
        "steps": [
          "Open the lesson and inspect the equation.",
          "Change one input while holding the others fixed."
        ],
        "example": "For D = 1 × 10⁻¹⁰ m²/s and dc/dx = 2 × 10⁶ mol/m⁴, J = −2 × 10⁻⁴ mol/(m²·s).",
        "observe": "Compare the result with the equation and units.",
        "limits": "This does not solve second-law time evolution or specify boundary conditions.",
        "url": "https://lemonergy.com/learn/transport/ficks-first-law/",
        "label": "Open the worked lesson",
        "evidence": [
          "src/battery_core/diffusion.py"
        ]
      }
    },
    {
      "id": "topic:topic-transport",
      "type": "Topic",
      "label": "Transport and modelling",
      "properties": {
        "id": "topic-transport",
        "name": "Transport and modelling",
        "lede": "How ions move, and the equations and models that describe a cell.",
        "context": "Specify phase, direction and boundaries.",
        "example": "The same concentration difference across 10 μm gives ten times the gradient across 100 μm; at equal D, first-law flux magnitude is ten times greater.",
        "lesson_url": "https://lemonergy.com/learn/transport/ficks-first-law/",
        "lesson_label": "Open diffusion"
      }
    },
    {
      "id": "term:ficks-first-law",
      "type": "Term",
      "label": "Fick’s first law",
      "properties": {
        "id": "ficks-first-law",
        "name": "Fick’s first law",
        "section": "topic-transport",
        "definition": "J = −D dc/dx: diffusive flux is proportional to the concentration gradient and points down it. It is a constitutive law, valid at one instant; Fick’s second law follows from it when mass is conserved.",
        "formula": "J = −D · dc/dx",
        "unit": "mol/(m²·s)",
        "related": [
          "diffusion-coefficient",
          "concentration-gradient",
          "ficks-second-law",
          "diffusion"
        ],
        "lesson": "transport/ficks-first-law/",
        "example": {
          "title": "Read the direction of a flux",
          "text": "With D = 1×10⁻¹⁰ m²/s and dc/dx = 1×10⁶ mol/m⁴, J = −1×10⁻⁴ mol/(m²·s). The negative sign means diffusion points toward decreasing concentration."
        },
        "url": "https://lemonergy.com/learn/glossary/ficks-first-law/",
        "mentions": []
      }
    },
    {
      "id": "term:diffusion-coefficient",
      "type": "Term",
      "label": "Diffusion coefficient",
      "properties": {
        "id": "diffusion-coefficient",
        "name": "Diffusion coefficient",
        "abbr": "D",
        "aka": [
          "diffusivity"
        ],
        "section": "topic-transport",
        "definition": "The proportionality constant D in Fick’s first law, in m²/s. It sets how fast a species spreads for a given concentration gradient.",
        "unit": "m²/s",
        "related": [
          "ficks-first-law",
          "solid-state-diffusion",
          "gitt",
          "diffusion"
        ],
        "lesson": "transport/ficks-first-law/#law",
        "url": "https://lemonergy.com/learn/glossary/diffusion-coefficient/",
        "mentions": [
          "concentration-gradient"
        ]
      }
    },
    {
      "id": "term:solid-state-diffusion",
      "type": "Term",
      "label": "Solid-state diffusion",
      "properties": {
        "id": "solid-state-diffusion",
        "name": "Solid-state diffusion",
        "section": "topic-transport",
        "definition": "Lithium moving through the crystal lattice of an active-material particle, with diffusion coefficients of about 10⁻¹⁶ to 10⁻¹³ m²/s — three or more orders of magnitude slower than the 10⁻¹⁰ m²/s of the liquid. It is usually the rate-limiting step for thick electrodes and large particles.",
        "unit": "m²/s",
        "related": [
          "diffusion-coefficient",
          "diffusion",
          "particle-size",
          "rate-capability",
          "gitt"
        ],
        "lesson": "transport/ficks-first-law/#in-a-cell",
        "url": "https://lemonergy.com/learn/glossary/solid-state-diffusion/",
        "mentions": []
      }
    },
    {
      "id": "term:concentration-gradient",
      "type": "Term",
      "label": "Concentration gradient",
      "properties": {
        "id": "concentration-gradient",
        "name": "Concentration gradient",
        "section": "topic-transport",
        "definition": "The rate at which concentration changes with distance, dc/dx, in mol/m⁴. It is the driving force in Fick’s law; current creates one across the electrolyte and inside each particle, and it relaxes away when current stops.",
        "unit": "mol/m⁴",
        "related": [
          "ficks-first-law",
          "concentration-polarization",
          "relaxation",
          "diffusion"
        ],
        "lesson": "transport/ficks-first-law/#sign",
        "url": "https://lemonergy.com/learn/glossary/concentration-gradient/",
        "mentions": [
          "electrolyte"
        ]
      }
    },
    {
      "id": "term:migration",
      "type": "Term",
      "label": "Migration",
      "properties": {
        "id": "migration",
        "name": "Migration",
        "section": "topic-transport",
        "definition": "Movement of ions driven by an electric field rather than a concentration difference. In the electrolyte both migration and diffusion carry lithium; the transference number says how much of the current the lithium ions carry by migration.",
        "related": [
          "diffusion",
          "transference-number",
          "ionic-conductivity"
        ],
        "url": "https://lemonergy.com/learn/glossary/migration/",
        "mentions": [
          "electrolyte"
        ]
      }
    },
    {
      "id": "term:electrolyte",
      "type": "Term",
      "label": "Electrolyte",
      "properties": {
        "id": "electrolyte",
        "name": "Electrolyte",
        "section": "topic-electrolytes",
        "definition": "The ion-conducting medium between the electrodes. In a liquid-electrolyte cell it fills the pores of both electrodes and the separator, so it is not a separate structural layer.",
        "related": [
          "lithium-salt",
          "carbonate-solvent",
          "electrolyte-additive",
          "ionic-conductivity",
          "solid-electrolyte",
          "ionic-liquid-electrolyte"
        ],
        "lesson": "fundamentals/cell-architecture/#electrolyte",
        "example": {
          "title": "Ions and electrons",
          "text": "Electrolyte carries ions between electrodes; the external circuit carries electrons. The two paths serve different roles."
        },
        "url": "https://lemonergy.com/learn/glossary/electrolyte/",
        "mentions": [
          "separator"
        ]
      }
    },
    {
      "id": "lesson:transport/ficks-first-law/",
      "type": "Lesson",
      "label": "Fick’s first law",
      "properties": {
        "url": "https://lemonergy.com/learn/transport/ficks-first-law/"
      }
    },
    {
      "id": "visual:diffusion",
      "type": "Visual",
      "label": "Flux follows the concentration slope",
      "properties": {
        "title": "Flux follows the concentration slope",
        "summary": "The minus sign in Fick’s law sends material down its concentration gradient.",
        "readout": "Flux J = 500 μmol/(m²·s), toward increasing position.",
        "formula": "J = −D dc/dx",
        "note": "The profile is imposed and static. Time evolution requires Fick’s second law and boundary conditions.",
        "software": {
          "status": "implemented",
          "label": "Implemented in battery-core",
          "body": "ficks_first_law_flux evaluates J = −D dc/dx. It does not solve a diffusion PDE, estimate the gradient or apply boundary conditions.",
          "href": "../transport/ficks-first-law/"
        },
        "html": "<figure class=\"visual-figure\"><figcaption>Imposed concentration profile</figcaption><svg class=\"visual-chart\" viewBox=\"0 0 360 330\" role=\"img\" aria-labelledby=\"static-diffusion-0-title static-diffusion-0-desc\"><title id=\"static-diffusion-0-title\">Imposed concentration profile</title><desc id=\"static-diffusion-0-desc\">Position (μm) versus Concentration (mol/m³). Concentration. Interpretation follows the graphs.</desc><path d=\"M74,238h268\" stroke=\"currentColor\" opacity=\".13\"/><text x=\"64\" y=\"242\" text-anchor=\"end\" font-size=\"13\" fill=\"currentColor\">0</text><text x=\"74\" y=\"265\" text-anchor=\"middle\" font-size=\"13\" fill=\"currentColor\">0</text><path d=\"M74,188.5h268\" stroke=\"currentColor\" opacity=\".13\"/><text x=\"64\" y=\"192.5\" text-anchor=\"end\" font-size=\"13\" fill=\"currentColor\">500</text><text x=\"141\" y=\"265\" text-anchor=\"middle\" font-size=\"13\" fill=\"currentColor\">25</text><path d=\"M74,139h268\" stroke=\"currentColor\" opacity=\".13\"/><text x=\"64\" y=\"143\" text-anchor=\"end\" font-size=\"13\" fill=\"currentColor\">1,000</text><text x=\"208\" y=\"265\" text-anchor=\"middle\" font-size=\"13\" fill=\"currentColor\">50</text><path d=\"M74,89.5h268\" stroke=\"currentColor\" opacity=\".13\"/><text x=\"64\" y=\"93.5\" text-anchor=\"end\" font-size=\"13\" fill=\"currentColor\">1,500</text><text x=\"275\" y=\"265\" text-anchor=\"middle\" font-size=\"13\" fill=\"currentColor\">75</text><path d=\"M74,40h268\" stroke=\"currentColor\" opacity=\".13\"/><text x=\"64\" y=\"44\" text-anchor=\"end\" font-size=\"13\" fill=\"currentColor\">2,000</text><text x=\"342\" y=\"265\" text-anchor=\"middle\" font-size=\"13\" fill=\"currentColor\">100</text><path d=\"M74,40v198h268\" fill=\"none\" stroke=\"currentColor\" opacity=\".3\"/><polyline fill=\"none\" stroke=\"#2459a8\" stroke-width=\"2.8\" points=\"74.00,114.25 76.68,114.74 79.36,115.24 82.04,115.73 84.72,116.23 87.40,116.72 90.08,117.22 92.76,117.71 95.44,118.21 98.12,118.70 100.80,119.20 103.48,119.69 106.16,120.19 108.84,120.68 111.52,121.18 114.20,121.67 116.88,122.17 119.56,122.66 122.24,123.16 124.92,123.66 127.60,124.15 130.28,124.64 132.96,125.14 135.64,125.64 138.32,126.13 141.00,126.63 143.68,127.12 146.36,127.61 149.04,128.11 151.72,128.61 154.40,129.10 157.08,129.59 159.76,130.09 162.44,130.59 165.12,131.08 167.80,131.57 170.48,132.07 173.16,132.56 175.84,133.06 178.52,133.56 181.20,134.05 183.88,134.55 186.56,135.04 189.24,135.54 191.92,136.03 194.60,136.53 197.28,137.02 199.96,137.52 202.64,138.01 205.32,138.50 208.00,139.00 210.68,139.50 213.36,139.99 216.04,140.49 218.72,140.98 221.40,141.48 224.08,141.97 226.76,142.47 229.44,142.96 232.12,143.45 234.80,143.95 237.48,144.44 240.16,144.94 242.84,145.44 245.52,145.93 248.20,146.43 250.88,146.92 253.56,147.41 256.24,147.91 258.92,148.41 261.60,148.90 264.28,149.39 266.96,149.89 269.64,150.38 272.32,150.88 275.00,151.38 277.68,151.87 280.36,152.37 283.04,152.86 285.72,153.36 288.40,153.85 291.08,154.34 293.76,154.84 296.44,155.34 299.12,155.83 301.80,156.32 304.48,156.82 307.16,157.31 309.84,157.81 312.52,158.31 315.20,158.80 317.88,159.30 320.56,159.79 323.24,160.28 325.92,160.78 328.60,161.27 331.28,161.77 333.96,162.26 336.64,162.76 339.32,163.25 342.00,163.75\"/><text transform=\"translate(208 303)\" text-anchor=\"middle\" font-size=\"14\" fill=\"currentColor\"><tspan x=\"0\" dy=\"0\">Position (μm)</tspan></text><text transform=\"translate(20 139) rotate(-90)\" text-anchor=\"middle\" font-size=\"14\" fill=\"currentColor\"><tspan x=\"0\" dy=\"0\">Concentration (mol/m³)</tspan></text></svg><div class=\"visual-legend\"><span><i style=\"background:#2459a8\"></i>Concentration</span></div></figure>"
      }
    },
    {
      "id": "reference:iupac-green",
      "type": "Reference",
      "label": "Quantities, Units and Symbols in Physical Chemistry, 3rd edition, 2nd printing",
      "properties": {
        "title": "Quantities, Units and Symbols in Physical Chemistry, 3rd edition, 2nd printing",
        "publisher": "IUPAC",
        "url": "https://media.iupac.org/publications/books/gbook/IUPAC-GB3-2ndPrinting-Online-22apr2011.pdf",
        "type": "Technical reference",
        "scope": "Physical-chemistry notation, thermodynamics, electrochemistry and transport quantities.",
        "year": 2011,
        "accessed": "2026-10-27"
      }
    }
  ]
}
