{
  "node": {
    "id": "block:plane-contact",
    "type": "Block",
    "label": "Compliant unilateral plane contact",
    "properties": {
      "id": "plane-contact",
      "kind": "studio",
      "name": "Compliant unilateral plane contact",
      "summary": "Applies compliant normal contact and friction when the body penetrates the modeled plane. Separation removes contact force.",
      "behavior": "Applies compliant normal contact and friction when the body penetrates the modeled plane. Separation removes contact force.",
      "documentationSlug": "plane-contact",
      "referenceOnly": true,
      "ports": [
        {
          "name": "a",
          "direction": "conserving",
          "unit": "frame",
          "description": "Reference frame A"
        },
        {
          "name": "b",
          "direction": "conserving",
          "unit": "frame",
          "description": "Attached frame B"
        },
        {
          "name": "gap",
          "direction": "output",
          "unit": "m",
          "description": "Directed output available to compatible consumers: gap."
        },
        {
          "name": "normal Force",
          "direction": "output",
          "unit": "N",
          "description": "Directed output available to compatible consumers: normal Force."
        }
      ],
      "parameters": [
        {
          "key": "radiusM",
          "label": "radiusM",
          "unit": "m",
          "default": 0,
          "description": "Declared authoring field: radiusM.",
          "min": 0,
          "max": 1000000
        },
        {
          "key": "stiffnessNM",
          "label": "stiffnessNM",
          "unit": "N/m",
          "default": 10000,
          "description": "Declared authoring field: stiffnessNM.",
          "min": 1e-09,
          "max": 1000000000000
        },
        {
          "key": "dampingNSM",
          "label": "dampingNSM",
          "unit": "N s/m",
          "default": 100,
          "description": "Declared authoring field: dampingNSM.",
          "min": 0,
          "max": 1000000000000
        },
        {
          "key": "friction",
          "label": "friction",
          "unit": "1",
          "default": 0,
          "description": "Declared authoring field: friction.",
          "min": 0,
          "max": 10
        },
        {
          "key": "slipScaleMS",
          "label": "slipScaleMS",
          "unit": "m/s",
          "default": 0.01,
          "description": "Declared authoring field: slipScaleMS.",
          "min": 1e-09,
          "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": "plane-contact",
      "implementationId": "plane-contact",
      "url": "https://lemonergy.com/learn/glossary/blocks/plane-contact/",
      "documentationUrl": "https://lemonergy.com/learn/glossary/blocks/plane-contact/",
      "sourceFile": "studio-help-catalog.json",
      "studioHelp": {
        "type": "plane-contact",
        "namespace": "physical",
        "slug": "plane-contact",
        "canonicalSlug": "plane-contact",
        "existing": false,
        "dynamic": false,
        "scene": {
          "kind": "component",
          "componentId": "reference",
          "type": "plane-contact",
          "name": "Compliant unilateral plane contact",
          "domain": "mechanical",
          "family": "contact",
          "operation": "Applies compliant normal contact and friction when the body penetrates the modeled plane. Separation removes contact force.",
          "mechanism": [
            "Contact gap",
            "Compression and slip",
            "Normal and friction 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": "tyre-contact",
              "label": "Combined-slip tyre and compliant road contact"
            }
          ],
          "symbol": [
            {
              "tag": "path",
              "attrs": {
                "d": "M25 65H180M45 70L35 78M80 70L70 78M115 70L105 78M150 70L140 78"
              }
            },
            {
              "tag": "circle",
              "attrs": {
                "cx": 100,
                "cy": 35,
                "r": 29
              }
            }
          ],
          "selection": {},
          "commands": [],
          "outputs": [
            {
              "id": "gap",
              "quantity": "length",
              "declared": true,
              "consumers": [],
              "label": "gap",
              "unit": "m"
            },
            {
              "id": "normalForce",
              "quantity": "force",
              "declared": true,
              "consumers": [],
              "label": "normal Force",
              "unit": "N"
            }
          ],
          "parameters": [
            {
              "id": "radiusM",
              "default": 0,
              "unit": "m",
              "min": 0,
              "max": 1000000,
              "value": 0
            },
            {
              "id": "stiffnessNM",
              "default": 10000,
              "unit": "N/m",
              "min": 1e-09,
              "max": 1000000000000,
              "value": 10000
            },
            {
              "id": "dampingNSM",
              "default": 100,
              "unit": "N s/m",
              "min": 0,
              "max": 1000000000000,
              "value": 100
            },
            {
              "id": "friction",
              "default": 0,
              "unit": "1",
              "min": 0,
              "max": 10,
              "value": 0
            },
            {
              "id": "slipScaleMS",
              "default": 0.01,
              "unit": "m/s",
              "min": 1e-09,
              "max": 1000000,
              "value": 0.01
            }
          ]
        }
      }
    }
  },
  "incoming": [],
  "outgoing": [],
  "neighbors": []
}
