{
  "node": {
    "id": "block:initial-voltage-constraint",
    "type": "Block",
    "label": "Open branch with initial voltage target",
    "properties": {
      "id": "initial-voltage-constraint",
      "name": "Open branch with initial voltage target",
      "kind": "studio",
      "summary": "Zero current at all times; initializes a directly attached capacitor when its initial voltage is unspecified, otherwise verifies the consistent initial solution",
      "behavior": "Conserving component solved simultaneously with the connected network. Zero current at all times; initializes a directly attached capacitor when its initial voltage is unspecified, otherwise verifies the consistent initial solution",
      "ports": [
        {
          "name": "p",
          "direction": "terminal",
          "unit": "V; A",
          "description": "electrical conserving connection; voltage across and current through the connected branch."
        },
        {
          "name": "n",
          "direction": "terminal",
          "unit": "V; A",
          "description": "electrical conserving connection; voltage across and current through the connected branch."
        },
        {
          "name": "current",
          "direction": "output",
          "unit": "A",
          "description": "Recorded current measurement from the conserving simulation."
        },
        {
          "name": "voltage",
          "direction": "output",
          "unit": "V",
          "description": "Recorded voltage measurement from the conserving simulation."
        },
        {
          "name": "power",
          "direction": "output",
          "unit": "W",
          "description": "Recorded power measurement from the conserving simulation."
        }
      ],
      "parameters": [
        {
          "key": "initialVoltageV",
          "label": "Initial voltage",
          "unit": "V",
          "default": 0,
          "description": "Requested initial electrical voltage for the declared storage or target.",
          "min": -1000000,
          "max": 1000000
        }
      ],
      "equations": [
        "I = 0",
        "V(0) = requested initial voltage, subject to consistent storage initialization"
      ],
      "example": {
        "title": "Open branch with initial voltage target worked example",
        "text": "Editable first-party network. capacitor: capacitanceF=1; load: resistanceOhm=1; target: initialVoltageV=4. Checks below were verified in the native execution engine.",
        "url": "https://design.lemonergy.com/cosim.html?example=physical-initial-voltage-constraint",
        "label": "Open Studio example",
        "inputs": [
          {
            "port": "initialVoltageV",
            "label": "Initial voltage",
            "value": 4,
            "unit": "V"
          }
        ],
        "checks": [
          {
            "port": "target/current",
            "label": "current",
            "atS": 1,
            "value": 0,
            "unit": "A",
            "tolerance": 1e-10
          },
          {
            "port": "target/voltage",
            "label": "voltage",
            "atS": 1,
            "value": 1.47518891,
            "unit": "V",
            "tolerance": 1.4751889140492002e-06
          },
          {
            "port": "target/power",
            "label": "power",
            "atS": 1,
            "value": 0,
            "unit": "W",
            "tolerance": 1e-10
          }
        ]
      },
      "limits": [
        "Zero current at all times; initializes a directly attached capacitor when its initial voltage is unspecified, otherwise verifies the consistent initial solution",
        "Demonstration parameters are not calibrated hardware data. Singular or incompatible ideal constraints and unsupported state ranges stop the run."
      ],
      "references": [
        "physical-capacitor",
        "physical-circuit"
      ],
      "availability": {
        "status": "released",
        "label": "Available in Lemonergy Studio",
        "detail": "The bundled example is available in the production release verified on 28 October 2026. The parameters and examples here are synthetic teaching fixtures, not a characterized cell or a validated operating limit."
      },
      "evidence": [
        "docs/glossary/native-block-verification.json"
      ],
      "sourceRepository": "Lemonergy Studio public contract",
      "sourceRevision": "verification-2026-10-27",
      "caseIds": [
        "native-initial-voltage-constraint"
      ],
      "type": "initial-voltage-constraint",
      "implementationId": "initial-voltage-constraint",
      "url": "https://lemonergy.com/learn/glossary/blocks/initial-voltage-constraint/",
      "documentationUrl": "https://lemonergy.com/learn/glossary/blocks/initial-voltage-constraint/",
      "sourceFile": "block-library.json",
      "reviewed": "2026-10-27",
      "releaseEvidence": {
        "environment": "production",
        "status": "verified",
        "revision": "e76cadfc203e15eb41f3478d8b1044a5b851953d",
        "verifiedOn": "2026-10-28",
        "exampleUrls": [
          "https://design.lemonergy.com/cosim.html?example=physical-initial-voltage-constraint"
        ]
      }
    }
  },
  "incoming": [
    {
      "id": "edge:usesBlock/native-initial-voltage-constraint/0",
      "type": "usesBlock",
      "source": "workflow:native-initial-voltage-constraint",
      "target": "block:initial-voltage-constraint",
      "properties": {
        "sourceFile": "wiki-blocks.json",
        "position": 0,
        "name": "Open branch with initial voltage target",
        "type": "initial-voltage-constraint",
        "role": "Conserving component solved simultaneously with the connected network. Zero current at all times; initializes a directly attached capacitor when its initial voltage is unspecified, otherwise verifies the consistent initial solution",
        "settings": [
          "Use the block reference for settings and connections.",
          "Bundled example verified on the production release of 28 October 2026."
        ]
      }
    }
  ],
  "outgoing": [
    {
      "id": "edge:cites/block:initial-voltage-constraint/reference:physical-capacitor",
      "type": "cites",
      "source": "block:initial-voltage-constraint",
      "target": "reference:physical-capacitor",
      "properties": {
        "sourceFile": "block-library.json",
        "scope": "Scientific or mathematical background; implementation scope is stated by the block contract"
      }
    },
    {
      "id": "edge:cites/block:initial-voltage-constraint/reference:physical-circuit",
      "type": "cites",
      "source": "block:initial-voltage-constraint",
      "target": "reference:physical-circuit",
      "properties": {
        "sourceFile": "block-library.json",
        "scope": "Scientific or mathematical background; implementation scope is stated by the block contract"
      }
    }
  ],
  "neighbors": [
    {
      "id": "workflow:native-initial-voltage-constraint",
      "type": "Workflow",
      "label": "Open branch with initial voltage target worked example",
      "properties": {
        "id": "native-initial-voltage-constraint",
        "title": "Open branch with initial voltage target worked example",
        "kind": "studio",
        "summary": "Zero current at all times; initializes a directly attached capacitor when its initial voltage is unspecified, otherwise verifies the consistent initial solution",
        "steps": [
          "Review the interface, units and model limits.",
          "Open the Studio example and run its bundled model.",
          "Compare outputs with the numerical checks; change one input and run again."
        ],
        "example": "Editable first-party network. capacitor: capacitanceF=1; load: resistanceOhm=1; target: initialVoltageV=4. Checks below were verified in the native execution engine.",
        "observe": "Inspect the output channels and checks on the block reference page.",
        "limits": "Zero current at all times; initializes a directly attached capacitor when its initial voltage is unspecified, otherwise verifies the consistent initial solution Demonstration parameters are not calibrated hardware data. Singular or incompatible ideal constraints and unsupported state ranges stop the run.",
        "url": "https://design.lemonergy.com/cosim.html?example=physical-initial-voltage-constraint",
        "label": "Open Studio example",
        "evidence": [
          "docs/glossary/native-block-verification.json"
        ]
      }
    },
    {
      "id": "reference:physical-capacitor",
      "type": "Reference",
      "label": "Energy Stored in a Capacitor",
      "properties": {
        "title": "Energy Stored in a Capacitor",
        "publisher": "OpenStax, Rice University",
        "url": "https://openstax.org/books/university-physics-volume-2/pages/8-3-energy-stored-in-a-capacitor",
        "type": "Primary educational or metrology reference",
        "scope": "Underlying physical law or reduced-model basis; Lemonergy implementation choices and limits are documented separately.",
        "accessed": "2026-10-27"
      }
    },
    {
      "id": "reference:physical-circuit",
      "type": "Reference",
      "label": "Kirchhoff's Rules",
      "properties": {
        "title": "Kirchhoff's Rules",
        "publisher": "OpenStax, Rice University",
        "url": "https://openstax.org/books/university-physics-volume-2/pages/10-3-kirchhoffs-rules",
        "type": "Primary educational or metrology reference",
        "scope": "Underlying physical law or reduced-model basis; Lemonergy implementation choices and limits are documented separately.",
        "accessed": "2026-10-27"
      }
    }
  ]
}
