{
  "node": {
    "id": "term:voltage",
    "type": "Term",
    "label": "Voltage",
    "properties": {
      "id": "voltage",
      "name": "Voltage",
      "aka": [
        "terminal voltage"
      ],
      "section": "topic-units",
      "definition": "The potential difference between a cell’s two terminals. It comes from the chemical difference between the electrodes, moves with state of charge, and sags under load because of internal resistance.",
      "unit": "V",
      "related": [
        "open-circuit-voltage",
        "nominal-voltage",
        "internal-resistance",
        "ir-drop"
      ],
      "lesson": "fundamentals/cell-anatomy/#voltage",
      "url": "https://lemonergy.com/learn/glossary/voltage/",
      "mentions": [
        "state-of-charge"
      ]
    }
  },
  "edges": [
    {
      "id": "edge:157",
      "source": "term:voltage",
      "target": "workflow:ohm-circuit",
      "type": "usedIn",
      "properties": {
        "sourceFile": "wiki-blocks.json"
      }
    },
    {
      "id": "edge:191",
      "source": "term:voltage",
      "target": "topic:topic-units",
      "type": "belongsTo",
      "properties": {
        "sourceFile": "terms.json"
      }
    },
    {
      "id": "edge:192",
      "source": "term:voltage",
      "target": "term:open-circuit-voltage",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:193",
      "source": "term:voltage",
      "target": "term:nominal-voltage",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:194",
      "source": "term:voltage",
      "target": "term:internal-resistance",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:195",
      "source": "term:voltage",
      "target": "term:ir-drop",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:mentions/voltage/state-of-charge",
      "source": "term:voltage",
      "target": "term:state-of-charge",
      "type": "mentions",
      "properties": {
        "sourceFile": "terms.json",
        "method": "build_glossary.mention_index + mentions",
        "field": "definition",
        "meaning": "Text mention; not a causal claim"
      }
    },
    {
      "id": "edge:197",
      "source": "term:voltage",
      "target": "lesson:fundamentals/cell-anatomy/",
      "type": "explainedIn",
      "properties": {
        "sourceFile": "terms.json",
        "url": "https://lemonergy.com/learn/fundamentals/cell-anatomy/#voltage"
      }
    },
    {
      "id": "edge:198",
      "source": "term:voltage",
      "target": "visual:voltage",
      "type": "illustratedBy",
      "properties": {
        "sourceFile": "visual-pages.json"
      }
    },
    {
      "id": "edge:199",
      "source": "term:voltage",
      "target": "reference:bipm-si",
      "type": "cites",
      "properties": {
        "sourceFile": "wiki-references.json",
        "scope": "direct technical reference"
      }
    }
  ],
  "neighbors": [
    {
      "id": "workflow:ohm-circuit",
      "type": "Workflow",
      "label": "Relate current and voltage",
      "properties": {
        "id": "ohm-circuit",
        "title": "Relate current and voltage",
        "kind": "studio",
        "summary": "Conserving components solve constitutive relations and node balance.",
        "steps": [
          "Inspect source and resistor in the RC example.",
          "Compare branch current with resistor voltage."
        ],
        "example": "A 1 V drop across 2 Ω implies 0.5 A.",
        "observe": "Topology sets individual element voltages.",
        "limits": "The RC example includes a capacitor: transient current varies and source voltage is not always resistor voltage.",
        "url": "https://design.lemonergy.com/cosim.html?example=physical-rc",
        "label": "Open the electrical circuit",
        "evidence": [
          "js/physical-network.js",
          "js/studio-examples.js"
        ]
      }
    },
    {
      "id": "topic:topic-units",
      "type": "Topic",
      "label": "Units and electrical basics",
      "properties": {
        "id": "topic-units",
        "name": "Units and electrical basics",
        "lede": "The quantities every datasheet is written in, and how they relate.",
        "context": "Use consistent units and cell/pack basis.",
        "example": "10 A for 30 min transfers 5 Ah. At constant 3.6 V this is 18 Wh; varying voltage requires integration.",
        "lesson_url": "https://lemonergy.com/learn/fundamentals/capacity-and-c-rate/",
        "lesson_label": "Open capacity and C-rate"
      }
    },
    {
      "id": "term:open-circuit-voltage",
      "type": "Term",
      "label": "Open-circuit voltage",
      "properties": {
        "id": "open-circuit-voltage",
        "name": "Open-circuit voltage",
        "abbr": "OCV",
        "section": "topic-state",
        "definition": "The voltage across a cell’s terminals when no current flows and the cell has rested long enough for the voltage to settle. It depends on state of charge and temperature, and a cell whose open-circuit voltage falls unusually fast in storage may have an internal short.",
        "unit": "V",
        "related": [
          "ocv-soc-curve",
          "relaxation",
          "voltage-hysteresis",
          "k-value",
          "internal-short-circuit"
        ],
        "lesson": "fundamentals/cell-production/#finishing",
        "url": "https://lemonergy.com/learn/glossary/open-circuit-voltage/",
        "mentions": [
          "state-of-charge"
        ]
      }
    },
    {
      "id": "term:nominal-voltage",
      "type": "Term",
      "label": "Nominal voltage",
      "properties": {
        "id": "nominal-voltage",
        "name": "Nominal voltage",
        "section": "topic-ratings",
        "definition": "A representative average voltage of a cell over a full discharge, such as 3.6–3.7 V for an oxide/graphite cell or about 3.2 V for LFP/graphite. Multiplied by capacity, it gives nominal energy.",
        "unit": "V",
        "related": [
          "nominal-energy",
          "open-circuit-voltage",
          "voltage-window",
          "lfp"
        ],
        "lesson": "fundamentals/capacity-and-c-rate/#energy",
        "url": "https://lemonergy.com/learn/glossary/nominal-voltage/",
        "mentions": [
          "graphite"
        ]
      }
    },
    {
      "id": "term:internal-resistance",
      "type": "Term",
      "label": "Internal resistance",
      "properties": {
        "id": "internal-resistance",
        "name": "Internal resistance",
        "abbr": "IR",
        "aka": [
          "DC resistance",
          "DCIR"
        ],
        "section": "topic-units",
        "definition": "The resistance a cell presents to current, from its foils, electrolyte, interfaces and the reactions themselves. It converts part of the delivered energy into heat, sets the voltage drop under load, and rises as the cell ages; a large automotive cell has about a milliohm, a small cylindrical cell tens.",
        "unit": "mΩ",
        "related": [
          "ohms-law",
          "ir-drop",
          "impedance-rise",
          "dcir",
          "area-specific-resistance",
          "resistance-capacity-product"
        ],
        "lesson": "fundamentals/battery-basics/#datasheet",
        "url": "https://lemonergy.com/learn/glossary/internal-resistance/",
        "mentions": [
          "electrolyte",
          "cylindrical-cell"
        ]
      }
    },
    {
      "id": "term:ir-drop",
      "type": "Term",
      "label": "IR drop",
      "properties": {
        "id": "ir-drop",
        "name": "IR drop",
        "aka": [
          "ohmic drop",
          "voltage sag"
        ],
        "section": "topic-charging",
        "definition": "The instant step in terminal voltage when current starts or stops, equal to current times internal resistance. It is lost as heat and is the reason a cell’s voltage under load sits below its open-circuit voltage.",
        "formula": "ΔV = I × R",
        "unit": "V",
        "related": [
          "internal-resistance",
          "ohms-law",
          "polarization",
          "open-circuit-voltage"
        ],
        "example": {
          "title": "Distinguish a current step from SOC change",
          "text": "When discharge current jumps from 0 A to 10 A through an illustrative 20 mΩ resistance, terminal voltage immediately drops by 0.2 V. Slower polarization and SOC change are separate effects."
        },
        "url": "https://lemonergy.com/learn/glossary/ir-drop/",
        "mentions": [
          "voltage",
          "closed-circuit-voltage"
        ]
      }
    },
    {
      "id": "term:state-of-charge",
      "type": "Term",
      "label": "State of charge",
      "properties": {
        "id": "state-of-charge",
        "name": "State of charge",
        "abbr": "SOC",
        "section": "topic-state",
        "definition": "How full a cell is, as a fraction of its available capacity. State of charge, like temperature, affects how fast a stored cell ages.",
        "unit": "%",
        "related": [
          "depth-of-discharge",
          "ocv-soc-curve",
          "coulomb-counting",
          "state-of-health",
          "bms"
        ],
        "lesson": "fundamentals/battery-aging/#storage-soc",
        "example": {
          "title": "Interpret a charge inventory",
          "text": "If available capacity is 5 Ah and 3 Ah remains by the chosen estimator, SOC is 60%. A different estimate of available capacity changes this percentage, so compare SOC values only with the capacity convention recorded."
        },
        "url": "https://lemonergy.com/learn/glossary/state-of-charge/",
        "mentions": [
          "usable-capacity"
        ]
      }
    },
    {
      "id": "lesson:fundamentals/cell-anatomy/",
      "type": "Lesson",
      "label": "Lesson 1 · Cell anatomy",
      "properties": {
        "url": "https://lemonergy.com/learn/fundamentals/cell-anatomy/"
      }
    },
    {
      "id": "visual:voltage",
      "type": "Visual",
      "label": "Voltage under load",
      "properties": {
        "title": "Voltage under load",
        "summary": "Discharge current creates an ohmic drop below open-circuit voltage.",
        "readout": "5 A through 20 mΩ gives 0.1 V ohmic drop.",
        "formula": "V_terminal = OCV − I_discharge R",
        "note": "Chosen OCV curve; no chemistry calibration, hysteresis or voltage cutoff.",
        "software": {
          "status": "studio",
          "label": "Voltage relationship in Studio",
          "body": "The native battery calculates terminal voltage from OCV and resistance. The curve here is an illustrative OCV relationship, not a fitted cell dataset.",
          "href": "https://design.lemonergy.com/cosim.html?example=charging-home"
        },
        "html": "<figure class=\"visual-figure\"><figcaption>Illustrative OCV and loaded voltage</figcaption><svg class=\"visual-chart\" viewBox=\"0 0 360 330\" role=\"img\" aria-labelledby=\"static-voltage-0-title static-voltage-0-desc\"><title id=\"static-voltage-0-title\">Illustrative OCV and loaded voltage</title><desc id=\"static-voltage-0-desc\">SOC (%) versus Voltage (V). Open circuit; Under load. 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\">1.8</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\">2.42</text><text x=\"141\" y=\"265\" text-anchor=\"middle\" font-size=\"13\" fill=\"currentColor\">25</text><path d=\"M74,139.00000000000003h268\" stroke=\"currentColor\" opacity=\".13\"/><text x=\"64\" y=\"143.00000000000003\" text-anchor=\"end\" font-size=\"13\" fill=\"currentColor\">3.05</text><text x=\"208\" y=\"265\" text-anchor=\"middle\" font-size=\"13\" fill=\"currentColor\">50</text><path d=\"M74,89.50000000000003h268\" stroke=\"currentColor\" opacity=\".13\"/><text x=\"64\" y=\"93.50000000000003\" text-anchor=\"end\" font-size=\"13\" fill=\"currentColor\">3.67</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\">4.3</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=\"#6953a8\" stroke-width=\"2.8\" points=\"74.00,142.96 76.68,142.29 79.36,141.61 82.04,140.94 84.72,140.27 87.40,139.59 90.08,138.92 92.76,138.25 95.44,137.57 98.12,136.90 100.80,136.23 103.48,135.55 106.16,134.88 108.84,134.21 111.52,133.54 114.20,132.86 116.88,132.19 119.56,131.52 122.24,130.84 124.92,130.17 127.60,129.50 130.28,128.82 132.96,128.15 135.64,127.48 138.32,126.80 141.00,126.13 143.68,125.46 146.36,124.78 149.04,124.11 151.72,123.44 154.40,122.76 157.08,122.09 159.76,121.41 162.44,120.74 165.12,120.07 167.80,119.39 170.48,118.72 173.16,118.04 175.84,117.37 178.52,116.69 181.20,116.02 183.88,115.34 186.56,114.66 189.24,113.98 191.92,113.31 194.60,112.63 197.28,111.95 199.96,111.26 202.64,110.58 205.32,109.89 208.00,109.21 210.68,108.52 213.36,107.83 216.04,107.13 218.72,106.44 221.40,105.74 224.08,105.03 226.76,104.32 229.44,103.61 232.12,102.89 234.80,102.17 237.48,101.44 240.16,100.70 242.84,99.96 245.52,99.21 248.20,98.44 250.88,97.67 253.56,96.89 256.24,96.10 258.92,95.29 261.60,94.47 264.28,93.63 266.96,92.77 269.64,91.90 272.32,91.01 275.00,90.09 277.68,89.15 280.36,88.19 283.04,87.20 285.72,86.17 288.40,85.12 291.08,84.03 293.76,82.90 296.44,81.73 299.12,80.52 301.80,79.26 304.48,77.96 307.16,76.59 309.84,75.17 312.52,73.69 315.20,72.14 317.88,70.53 320.56,68.83 323.24,67.06 325.92,65.20 328.60,63.24 331.28,61.19 333.96,59.04 336.64,56.77 339.32,54.39 342.00,51.88\"/><polyline fill=\"none\" stroke=\"#2459a8\" stroke-width=\"2.8\" stroke-dasharray=\"7 4\" points=\"74.00,150.88 76.68,150.21 79.36,149.53 82.04,148.86 84.72,148.19 87.40,147.51 90.08,146.84 92.76,146.17 95.44,145.49 98.12,144.82 100.80,144.15 103.48,143.47 106.16,142.80 108.84,142.13 111.52,141.46 114.20,140.78 116.88,140.11 119.56,139.44 122.24,138.76 124.92,138.09 127.60,137.42 130.28,136.74 132.96,136.07 135.64,135.40 138.32,134.72 141.00,134.05 143.68,133.38 146.36,132.70 149.04,132.03 151.72,131.36 154.40,130.68 157.08,130.01 159.76,129.33 162.44,128.66 165.12,127.99 167.80,127.31 170.48,126.64 173.16,125.96 175.84,125.29 178.52,124.61 181.20,123.94 183.88,123.26 186.56,122.58 189.24,121.90 191.92,121.23 194.60,120.55 197.28,119.87 199.96,119.18 202.64,118.50 205.32,117.81 208.00,117.13 210.68,116.44 213.36,115.75 216.04,115.05 218.72,114.36 221.40,113.66 224.08,112.95 226.76,112.24 229.44,111.53 232.12,110.81 234.80,110.09 237.48,109.36 240.16,108.62 242.84,107.88 245.52,107.13 248.20,106.36 250.88,105.59 253.56,104.81 256.24,104.02 258.92,103.21 261.60,102.39 264.28,101.55 266.96,100.69 269.64,99.82 272.32,98.93 275.00,98.01 277.68,97.07 280.36,96.11 283.04,95.12 285.72,94.09 288.40,93.04 291.08,91.95 293.76,90.82 296.44,89.65 299.12,88.44 301.80,87.18 304.48,85.88 307.16,84.51 309.84,83.09 312.52,81.61 315.20,80.06 317.88,78.45 320.56,76.75 323.24,74.98 325.92,73.12 328.60,71.16 331.28,69.11 333.96,66.96 336.64,64.69 339.32,62.31 342.00,59.80\"/><text transform=\"translate(208 303)\" text-anchor=\"middle\" font-size=\"14\" fill=\"currentColor\"><tspan x=\"0\" dy=\"0\">SOC (%)</tspan></text><text transform=\"translate(20 139) rotate(-90)\" text-anchor=\"middle\" font-size=\"14\" fill=\"currentColor\"><tspan x=\"0\" dy=\"0\">Voltage (V)</tspan></text></svg><div class=\"visual-legend\"><span><i style=\"background:#6953a8\"></i>Open circuit</span><span><i style=\"background:#2459a8\"></i>Under load (dashed)</span></div></figure>"
      }
    },
    {
      "id": "reference:bipm-si",
      "type": "Reference",
      "label": "The International System of Units (SI), 9th edition",
      "properties": {
        "title": "The International System of Units (SI), 9th edition",
        "publisher": "Bureau International des Poids et Mesures",
        "url": "https://doi.org/10.59161/AUEZ1291",
        "type": "Metrology reference",
        "scope": "Definitions of SI units and coherent derived units; 2026 revision.",
        "year": 2026,
        "accessed": "2026-10-27"
      }
    }
  ]
}
