{
  "node": {
    "id": "block:current-source",
    "type": "Block",
    "label": "Controlled current source",
    "properties": {
      "id": "current-source",
      "kind": "studio",
      "name": "Controlled current source",
      "summary": "Imposes a signed current from p to n; the network determines its terminal voltage.",
      "behavior": "Imposes a signed current from p to n; the network determines its terminal voltage.",
      "documentationSlug": "current-source",
      "referenceOnly": true,
      "ports": [
        {
          "name": "p",
          "direction": "conserving",
          "unit": "electrical",
          "description": "Positive voltage-reference terminal"
        },
        {
          "name": "n",
          "direction": "conserving",
          "unit": "electrical",
          "description": "Negative voltage-reference terminal"
        },
        {
          "name": "Current command",
          "direction": "input",
          "unit": "A",
          "description": "Current command is a directed current input to this component, expressed in A. Its binding supplies information; it is not a conserving connection."
        },
        {
          "name": "voltage",
          "direction": "output",
          "unit": "V",
          "description": "Directed output available to compatible consumers: voltage."
        },
        {
          "name": "current",
          "direction": "output",
          "unit": "A",
          "description": "Directed output available to compatible consumers: current."
        },
        {
          "name": "power",
          "direction": "output",
          "unit": "W",
          "description": "Directed output available to compatible consumers: power."
        }
      ],
      "parameters": [
        {
          "key": "currentA",
          "label": "currentA",
          "unit": "A",
          "default": 1,
          "description": "Declared authoring field: currentA.",
          "min": -1000000,
          "max": 1000000
        }
      ],
      "equations": [],
      "example": {
        "title": "Use this authoring component",
        "text": "Choose this component in the Studio library and configure its declared interface. This reference describes the authoring contract; it does not claim a standalone numerical validation or a measured result.",
        "url": "https://design.lemonergy.com/cosim",
        "label": "Open Studio"
      },
      "limits": [
        "The symbolic diagram describes the component and its declared interface. It is not a solved circuit or simulated output.",
        "Configured parameters and model connections determine the result. Check the complete model before interpreting its outputs."
      ],
      "evidence": [
        "docs/glossary/studio-help-catalog.json"
      ],
      "caseIds": [],
      "sourceRepository": "battery-design",
      "sourceRevision": "e248d21a9902225f1075624f23e7628b54cdb7cc",
      "reviewed": "2026-10-30",
      "type": "current-source",
      "implementationId": "current-source",
      "url": "https://lemonergy.com/learn/glossary/blocks/current-source/",
      "documentationUrl": "https://lemonergy.com/learn/glossary/blocks/current-source/",
      "sourceFile": "studio-help-catalog.json",
      "studioHelp": {
        "type": "current-source",
        "namespace": "physical",
        "slug": "current-source",
        "canonicalSlug": "current-source",
        "existing": false,
        "dynamic": false,
        "scene": {
          "kind": "component",
          "componentId": "reference",
          "type": "current-source",
          "name": "Controlled current source",
          "domain": "electrical",
          "family": "current-source",
          "operation": "Imposes a signed current from p to n; the network determines its terminal voltage.",
          "mechanism": [
            "Current command",
            "Imposed current",
            "Solved voltage"
          ],
          "ports": [
            {
              "id": "p",
              "domain": "electrical",
              "kind": "conserving",
              "label": "Positive voltage-reference terminal",
              "net": null,
              "peers": []
            },
            {
              "id": "n",
              "domain": "electrical",
              "kind": "conserving",
              "label": "Negative voltage-reference terminal",
              "net": null,
              "peers": []
            }
          ],
          "terms": [
            {
              "type": "electrical-reference",
              "label": "Electrical reference"
            },
            {
              "type": "voltage-source",
              "label": "Controlled voltage source"
            }
          ],
          "symbol": [
            {
              "tag": "circle",
              "attrs": {
                "cx": 100,
                "cy": 40,
                "r": 32
              }
            },
            {
              "tag": "path",
              "attrs": {
                "d": "M10 40H68M132 40H190M80 40H120L110 30M120 40L110 50"
              }
            }
          ],
          "selection": {},
          "commands": [
            {
              "id": "command",
              "label": "Current command",
              "quantity": "current",
              "unit": "A",
              "active": true,
              "summary": "Current command is a directed current input to this component, expressed in A. Its binding supplies information; it is not a conserving connection.",
              "source": null,
              "target": null
            }
          ],
          "outputs": [
            {
              "id": "voltage",
              "quantity": "voltage",
              "declared": true,
              "consumers": [],
              "label": "voltage",
              "unit": "V"
            },
            {
              "id": "current",
              "quantity": "current",
              "declared": true,
              "consumers": [],
              "label": "current",
              "unit": "A"
            },
            {
              "id": "power",
              "quantity": "power",
              "declared": true,
              "consumers": [],
              "label": "power",
              "unit": "W"
            }
          ],
          "parameters": [
            {
              "id": "currentA",
              "default": 1,
              "unit": "A",
              "min": -1000000,
              "max": 1000000,
              "value": 1
            }
          ]
        }
      }
    }
  },
  "incoming": [
    {
      "id": "edge:usesBlock/term:current/block:current-source",
      "type": "usesBlock",
      "source": "term:current",
      "target": "block:current-source",
      "properties": {
        "sourceFile": "studio-help-catalog.json",
        "scope": "Declared interface quantity or semantic operation; not a numerical validation claim"
      }
    },
    {
      "id": "edge:usesBlock/term:power/block:current-source",
      "type": "usesBlock",
      "source": "term:power",
      "target": "block:current-source",
      "properties": {
        "sourceFile": "studio-help-catalog.json",
        "scope": "Declared interface quantity or semantic operation; not a numerical validation claim"
      }
    },
    {
      "id": "edge:usesBlock/term:voltage/block:current-source",
      "type": "usesBlock",
      "source": "term:voltage",
      "target": "block:current-source",
      "properties": {
        "sourceFile": "studio-help-catalog.json",
        "scope": "Declared interface quantity or semantic operation; not a numerical validation claim"
      }
    }
  ],
  "outgoing": [],
  "neighbors": [
    {
      "id": "term:current",
      "type": "Term",
      "label": "Current",
      "properties": {
        "id": "current",
        "name": "Current",
        "section": "topic-units",
        "definition": "The rate at which charge flows through the cell and its circuit, in amperes. Outside the cell it is carried by electrons; inside, by lithium ions moving through the electrolyte.",
        "formula": "I = dQ/dt",
        "unit": "A",
        "related": [
          "ampere",
          "c-rate",
          "ionic-path"
        ],
        "lesson": "fundamentals/cell-anatomy/#discharge",
        "example": {
          "title": "Convert charge transfer to current",
          "text": "If 120 C passes a point in 60 s at a steady rate, the current is 2 A. When the rate varies, integrate the current trace to recover the total charge."
        },
        "url": "https://lemonergy.com/learn/glossary/current/",
        "mentions": [
          "electrolyte"
        ]
      }
    },
    {
      "id": "term:power",
      "type": "Term",
      "label": "Power",
      "properties": {
        "id": "power",
        "name": "Power",
        "section": "topic-units",
        "definition": "The rate at which a cell delivers or absorbs energy: voltage times current, in watts. Power is limited by internal resistance and temperature long before capacity runs out.",
        "formula": "P = V × I",
        "unit": "W",
        "related": [
          "watt",
          "specific-power",
          "state-of-power",
          "internal-resistance"
        ],
        "example": {
          "title": "Separate power from energy",
          "text": "A 100 W load running for 30 min uses 50 Wh. Power tells you how fast energy is transferred; the duration determines how much energy is transferred."
        },
        "url": "https://lemonergy.com/learn/glossary/power/",
        "mentions": []
      }
    },
    {
      "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"
        ]
      }
    }
  ]
}