{
  "node": {
    "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"
      ]
    }
  },
  "edges": [
    {
      "id": "edge:12",
      "source": "term:nominal-voltage",
      "target": "workflow:nominal-energy",
      "type": "usedIn",
      "properties": {
        "sourceFile": "wiki-blocks.json"
      }
    },
    {
      "id": "edge:908",
      "source": "term:nominal-voltage",
      "target": "topic:topic-ratings",
      "type": "belongsTo",
      "properties": {
        "sourceFile": "terms.json"
      }
    },
    {
      "id": "edge:909",
      "source": "term:nominal-voltage",
      "target": "term:nominal-energy",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:910",
      "source": "term:nominal-voltage",
      "target": "term:open-circuit-voltage",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:911",
      "source": "term:nominal-voltage",
      "target": "term:voltage-window",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:912",
      "source": "term:nominal-voltage",
      "target": "term:lfp",
      "type": "relatedTo",
      "properties": {
        "sourceFile": "terms.json",
        "meaning": "Related context; not a causal claim"
      }
    },
    {
      "id": "edge:mentions/nominal-voltage/graphite",
      "source": "term:nominal-voltage",
      "target": "term:graphite",
      "type": "mentions",
      "properties": {
        "sourceFile": "terms.json",
        "method": "build_glossary.mention_index + mentions",
        "field": "definition",
        "meaning": "Text mention; not a causal claim"
      }
    },
    {
      "id": "edge:914",
      "source": "term:nominal-voltage",
      "target": "lesson:fundamentals/capacity-and-c-rate/",
      "type": "explainedIn",
      "properties": {
        "sourceFile": "terms.json",
        "url": "https://lemonergy.com/learn/fundamentals/capacity-and-c-rate/#energy"
      }
    },
    {
      "id": "edge:915",
      "source": "term:nominal-voltage",
      "target": "visual:voltage",
      "type": "illustratedBy",
      "properties": {
        "sourceFile": "visual-pages.json"
      }
    }
  ],
  "neighbors": [
    {
      "id": "workflow:nominal-energy",
      "type": "Workflow",
      "label": "Estimate nominal energy",
      "properties": {
        "id": "nominal-energy",
        "title": "Estimate nominal energy",
        "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": "A 5 Ah cell rated 3.6 V has 18 Wh nominal energy. Ten identical cells contain 180 Wh nominally.",
        "observe": "Compare the result with the equation and units.",
        "limits": "This is a rating estimate, not integrated delivered terminal energy.",
        "url": "https://lemonergy.com/learn/fundamentals/capacity-and-c-rate/#energy",
        "label": "Open the worked lesson",
        "evidence": [
          "src/battery_core/capacity.py"
        ]
      }
    },
    {
      "id": "topic:topic-ratings",
      "type": "Topic",
      "label": "Capacity, energy, power and ratings",
      "properties": {
        "id": "topic-ratings",
        "name": "Capacity, energy, power and ratings",
        "lede": "The numbers that size a cell and let two cells be compared.",
        "context": "Separate nameplate ratings from test results.",
        "example": "5 Ah at 3.6 V gives 18 Wh nominally. Integrated measured terminal power may give a different result.",
        "lesson_url": "https://lemonergy.com/learn/fundamentals/capacity-and-c-rate/",
        "lesson_label": "Open capacity and C-rate"
      }
    },
    {
      "id": "term:nominal-energy",
      "type": "Term",
      "label": "Nominal energy",
      "properties": {
        "id": "nominal-energy",
        "name": "Nominal energy",
        "section": "topic-ratings",
        "definition": "Nominal capacity times nominal voltage, in watt-hours: the headline energy figure on a datasheet. The energy actually delivered depends on the load, the temperature and how the voltage curve is weighted.",
        "formula": "E = Q × V_nominal",
        "unit": "Wh",
        "related": [
          "nominal-capacity",
          "nominal-voltage",
          "watt-hour",
          "energy-density"
        ],
        "lesson": "fundamentals/capacity-and-c-rate/#energy",
        "example": {
          "title": "Turn capacity into a nominal energy",
          "text": "A 5 Ah cell with a nominal voltage of 3.6 V has 18 Wh of nominal energy. This estimate uses the nominal voltage; delivered energy is the integral of measured terminal voltage multiplied by current."
        },
        "url": "https://lemonergy.com/learn/glossary/nominal-energy/",
        "mentions": [
          "datasheet",
          "discharge-curve"
        ]
      }
    },
    {
      "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:voltage-window",
      "type": "Term",
      "label": "Voltage window",
      "properties": {
        "id": "voltage-window",
        "name": "Voltage window",
        "aka": [
          "operating voltage range"
        ],
        "section": "topic-ratings",
        "definition": "The range between a cell’s lower and upper cutoff voltages, such as 2.5–4.2 V for an NMC/graphite cell. Staying inside it is what keeps the electrodes and electrolyte from degrading quickly.",
        "unit": "V",
        "related": [
          "cutoff-voltage",
          "overcharge",
          "over-discharge",
          "electrochemical-stability-window"
        ],
        "url": "https://lemonergy.com/learn/glossary/voltage-window/",
        "mentions": [
          "graphite",
          "electrolyte"
        ]
      }
    },
    {
      "id": "term:lfp",
      "type": "Term",
      "label": "LFP",
      "properties": {
        "id": "lfp",
        "name": "LFP",
        "aka": [
          "lithium iron phosphate",
          "LiFePO₄"
        ],
        "section": "topic-chemistries",
        "definition": "A positive electrode material, LiFePO₄, giving cells a nominal voltage around 3.2 V, long cycle life and good thermal stability, but less energy per kilogram than nickel-rich oxides. Its flat voltage curve makes state of charge hard to read from voltage alone.",
        "related": [
          "cathode-active-material",
          "nmc",
          "lmfp",
          "ocv-soc-curve",
          "cycle-life"
        ],
        "lesson": "fundamentals/cell-anatomy/#voltage",
        "example": {
          "title": "Chemistry is not the whole datasheet",
          "text": "Two LFP products can differ in format, loading, capacity and current limits. Their cathode family alone does not make them interchangeable."
        },
        "url": "https://lemonergy.com/learn/glossary/lfp/",
        "mentions": [
          "electrode",
          "positive-electrode",
          "nominal-voltage",
          "discharge-curve",
          "state-of-charge"
        ]
      }
    },
    {
      "id": "term:graphite",
      "type": "Term",
      "label": "Graphite",
      "properties": {
        "id": "graphite",
        "name": "Graphite",
        "section": "topic-components",
        "definition": "Layered carbon, the negative active material of nearly all lithium-ion cells. Lithium intercalates between its layers up to LiC₆, a theoretical 372 mAh/g, at a potential about 0.1 V above lithium metal.",
        "related": [
          "anode-active-material",
          "intercalation",
          "natural-graphite",
          "synthetic-graphite",
          "lithium-plating"
        ],
        "lesson": "fundamentals/cell-anatomy/#components",
        "example": {
          "title": "Compare matching mass bases",
          "text": "A graphite value per gram of active material cannot be directly compared with a value including binder, additive and foil."
        },
        "url": "https://lemonergy.com/learn/glossary/graphite/",
        "mentions": [
          "milliampere-hour",
          "active-material"
        ]
      }
    },
    {
      "id": "lesson:fundamentals/capacity-and-c-rate/",
      "type": "Lesson",
      "label": "Lesson 2 · Capacity and C-rate",
      "properties": {
        "url": "https://lemonergy.com/learn/fundamentals/capacity-and-c-rate/"
      }
    },
    {
      "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>"
      }
    }
  ]
}
