{
  "node": {
    "id": "block:spring-damper",
    "type": "Block",
    "label": "Axial suspension spring and damper",
    "properties": {
      "id": "spring-damper",
      "kind": "studio",
      "name": "Axial suspension spring and damper",
      "summary": "Acts along the line between frames, combining elastic force from extension and viscous force from extension rate.",
      "behavior": "Acts along the line between frames, combining elastic force from extension and viscous force from extension rate.",
      "documentationSlug": "spring-damper",
      "referenceOnly": true,
      "ports": [
        {
          "name": "a",
          "direction": "conserving",
          "unit": "frame",
          "description": "Reference frame A"
        },
        {
          "name": "b",
          "direction": "conserving",
          "unit": "frame",
          "description": "Attached frame B"
        },
        {
          "name": "length",
          "direction": "output",
          "unit": "m",
          "description": "Directed output available to compatible consumers: length."
        },
        {
          "name": "force",
          "direction": "output",
          "unit": "N",
          "description": "Directed output available to compatible consumers: force."
        },
        {
          "name": "heat",
          "direction": "output",
          "unit": "W",
          "description": "Directed output available to compatible consumers: heat."
        }
      ],
      "parameters": [
        {
          "key": "restLengthM",
          "label": "restLengthM",
          "unit": "m",
          "default": 1,
          "description": "Declared authoring field: restLengthM.",
          "min": 1e-09,
          "max": 1000000
        },
        {
          "key": "stiffnessNM",
          "label": "stiffnessNM",
          "unit": "N/m",
          "default": 10000,
          "description": "Declared authoring field: stiffnessNM.",
          "min": 0,
          "max": 1000000000000
        },
        {
          "key": "dampingNSM",
          "label": "dampingNSM",
          "unit": "N s/m",
          "default": 100,
          "description": "Declared authoring field: dampingNSM.",
          "min": 0,
          "max": 1000000000000
        }
      ],
      "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": "spring-damper",
      "implementationId": "spring-damper",
      "url": "https://lemonergy.com/learn/glossary/blocks/spring-damper/",
      "documentationUrl": "https://lemonergy.com/learn/glossary/blocks/spring-damper/",
      "sourceFile": "studio-help-catalog.json",
      "studioHelp": {
        "type": "spring-damper",
        "namespace": "physical",
        "slug": "spring-damper",
        "canonicalSlug": "spring-damper",
        "existing": false,
        "dynamic": false,
        "scene": {
          "kind": "component",
          "componentId": "reference",
          "type": "spring-damper",
          "name": "Axial suspension spring and damper",
          "domain": "mechanical",
          "family": "spring",
          "operation": "Acts along the line between frames, combining elastic force from extension and viscous force from extension rate.",
          "mechanism": [
            "Relative extension",
            "Spring and damper",
            "Opposing forces"
          ],
          "ports": [
            {
              "id": "a",
              "domain": "frame",
              "kind": "conserving",
              "label": "Reference frame A",
              "net": null,
              "peers": []
            },
            {
              "id": "b",
              "domain": "frame",
              "kind": "conserving",
              "label": "Attached frame B",
              "net": null,
              "peers": []
            }
          ],
          "terms": [
            {
              "type": "body-inertia",
              "label": "Rigid body and inertia"
            },
            {
              "type": "linear-spring",
              "label": "Translational spring"
            }
          ],
          "symbol": [
            {
              "tag": "path",
              "attrs": {
                "d": "M10 40H40L50 15L65 65L80 15L95 65L110 15L125 65L140 15L150 40H190"
              }
            }
          ],
          "selection": {},
          "commands": [],
          "outputs": [
            {
              "id": "length",
              "quantity": "length",
              "declared": true,
              "consumers": [],
              "label": "length",
              "unit": "m"
            },
            {
              "id": "force",
              "quantity": "force",
              "declared": true,
              "consumers": [],
              "label": "force",
              "unit": "N"
            },
            {
              "id": "heat",
              "quantity": "power",
              "declared": true,
              "consumers": [],
              "label": "heat",
              "unit": "W"
            }
          ],
          "parameters": [
            {
              "id": "restLengthM",
              "default": 1,
              "unit": "m",
              "min": 1e-09,
              "max": 1000000,
              "value": 1
            },
            {
              "id": "stiffnessNM",
              "default": 10000,
              "unit": "N/m",
              "min": 0,
              "max": 1000000000000,
              "value": 10000
            },
            {
              "id": "dampingNSM",
              "default": 100,
              "unit": "N s/m",
              "min": 0,
              "max": 1000000000000,
              "value": 100
            }
          ]
        }
      }
    }
  },
  "incoming": [
    {
      "id": "edge:usesBlock/term:power/block:spring-damper",
      "type": "usesBlock",
      "source": "term:power",
      "target": "block:spring-damper",
      "properties": {
        "sourceFile": "studio-help-catalog.json",
        "scope": "Declared interface quantity or semantic operation; not a numerical validation claim"
      }
    }
  ],
  "outgoing": [],
  "neighbors": [
    {
      "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": []
      }
    }
  ]
}