{
  "node": {
    "id": "block:nominal_energy_wh",
    "type": "Block",
    "label": "nominal_energy_wh",
    "properties": {
      "id": "nominal_energy_wh",
      "name": "nominal_energy_wh",
      "kind": "core",
      "summary": "Calculate nominal stored-energy rating from capacity and voltage.",
      "behavior": "Both inputs must be finite and positive. The result is a nominal rating; delivered energy requires a voltage trajectory and operating constraints.",
      "ports": [
        {
          "name": "return",
          "direction": "output",
          "unit": "Wh",
          "description": "Scalar float or NumPy array following broadcasting."
        }
      ],
      "parameters": [
        {
          "key": "nominal_capacity_ah",
          "label": "nominal capacity ah",
          "unit": "Ah",
          "description": "Positive nominal capacity."
        },
        {
          "key": "nominal_voltage_v",
          "label": "nominal voltage v",
          "unit": "V",
          "description": "Positive nominal voltage."
        }
      ],
      "equations": [
        "E_Wh = Q_Ah * V_nominal"
      ],
      "example": {
        "title": "Estimate nominal energy",
        "text": "A 5 Ah cell rated 3.6 V has 18 Wh nominal energy. Ten identical cells contain 180 Wh nominally.",
        "url": "https://lemonergy.com/learn/fundamentals/capacity-and-c-rate/#energy",
        "label": "Open the worked lesson"
      },
      "limits": [
        "This is a rating estimate, not integrated delivered terminal energy."
      ],
      "evidence": [
        "src/battery_core/capacity.py"
      ],
      "caseIds": [
        "nominal-energy"
      ],
      "type": "nominal_energy_wh",
      "implementationId": "nominal_energy_wh",
      "url": "https://lemonergy.com/learn/glossary/blocks/nominal_energy_wh/",
      "documentationUrl": "https://lemonergy.com/learn/glossary/blocks/nominal_energy_wh/",
      "sourceFile": "block-library.json",
      "sourceRepository": "battery-core",
      "sourceRevision": "main",
      "reviewed": "2026-10-27"
    }
  },
  "incoming": [
    {
      "id": "edge:usesBlock/nominal-energy/0",
      "type": "usesBlock",
      "source": "workflow:nominal-energy",
      "target": "block:nominal_energy_wh",
      "properties": {
        "sourceFile": "wiki-blocks.json",
        "position": 0,
        "name": "nominal_energy_wh",
        "type": "nominal_energy_wh",
        "role": "Core equation",
        "settings": [
          "Capacity (Ah)",
          "Nominal voltage (V)"
        ]
      }
    }
  ],
  "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"
        ]
      }
    }
  ]
}