{
  "node": {
    "id": "block:road-load",
    "type": "Block",
    "label": "Road load",
    "properties": {
      "id": "road-load",
      "kind": "studio",
      "name": "Road load",
      "summary": "Designer vehicle rule: Crr·max(0, N)·sign(v) above a creep threshold + ½ρ·CdA·v·|v| + m·g·sinθ, in newtons.",
      "behavior": "Designer vehicle rule: Crr·max(0, N)·sign(v) above a creep threshold + ½ρ·CdA·v·|v| + m·g·sinθ, in newtons.",
      "documentationSlug": "signal-block-road-load",
      "referenceOnly": true,
      "ports": [
        {
          "name": "Speed",
          "direction": "input",
          "unit": "m/s",
          "description": "Speed; Scalar; real. Received from a connected producer."
        },
        {
          "name": "Normal force",
          "direction": "input",
          "unit": "N",
          "description": "Force; Scalar; real. Received from a connected producer."
        },
        {
          "name": "Mass",
          "direction": "input",
          "unit": "kg",
          "description": "Mass; Scalar; real. Received from a connected producer."
        },
        {
          "name": "Grade sine",
          "direction": "input",
          "unit": "—",
          "description": "Number; Scalar; real. Received from a connected producer."
        },
        {
          "name": "Output",
          "direction": "output",
          "unit": "N",
          "description": "Force; Scalar; real. Produced for connected consumers."
        }
      ],
      "parameters": [
        {
          "key": "crr",
          "label": "Rolling-resistance coefficient",
          "unit": "",
          "default": "0.01",
          "description": "Declared authoring field: Rolling-resistance coefficient."
        },
        {
          "key": "cdA",
          "label": "Drag area CdA",
          "unit": "m²",
          "default": "0.638",
          "description": "Declared authoring field: Drag area CdA."
        },
        {
          "key": "airDensity",
          "label": "Air density",
          "unit": "kg/m³",
          "default": "1.225",
          "description": "Declared authoring field: Air density."
        },
        {
          "key": "rollingThreshold",
          "label": "Rolling-resistance speed threshold",
          "unit": "m/s",
          "default": "0.1",
          "description": "Declared authoring field: Rolling-resistance speed threshold."
        },
        {
          "key": "gravity",
          "label": "Gravity",
          "unit": "m/s²",
          "default": "9.80665",
          "description": "Declared authoring field: Gravity."
        }
      ],
      "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": "road-load",
      "implementationId": "road-load",
      "url": "https://lemonergy.com/learn/glossary/blocks/signal-block-road-load/",
      "documentationUrl": "https://lemonergy.com/learn/glossary/blocks/signal-block-road-load/",
      "sourceFile": "studio-help-catalog.json",
      "studioHelp": {
        "type": "road-load",
        "namespace": "signal",
        "slug": "signal-block-road-load",
        "canonicalSlug": "signal-block-road-load",
        "existing": false,
        "dynamic": false,
        "scene": {
          "title": "Road load",
          "label": "Road load",
          "summary": "Designer vehicle rule: Crr·max(0, N)·sign(v) above a creep threshold + ½ρ·CdA·v·|v| + m·g·sinθ, in newtons.",
          "details": [
            "Block type: road-load.",
            "4 declared inputs and 1 declared output in this model.",
            "Arrows show the direction of signal data. They are not conserving electrical, thermal or mechanical connections."
          ],
          "operation": {
            "kind": "physical-model",
            "symbol": "inputs → equation → response",
            "label": "Reduced vehicle equation",
            "caption": "Designer vehicle rule: Crr·max(0, N)·sign(v) above a creep threshold + ½ρ·CdA·v·|v| + m·g·sinθ, in newtons."
          },
          "inputs": [
            {
              "id": "in0",
              "label": "Speed",
              "quantity": "linear-speed",
              "unit": "m/s",
              "unitDeclared": true,
              "fields": [],
              "quantityLabel": "Speed",
              "shapeLabel": "Scalar",
              "elementLabel": "real"
            },
            {
              "id": "in1",
              "label": "Normal force",
              "quantity": "force",
              "unit": "N",
              "unitDeclared": true,
              "fields": [],
              "quantityLabel": "Force",
              "shapeLabel": "Scalar",
              "elementLabel": "real"
            },
            {
              "id": "in2",
              "label": "Mass",
              "quantity": "mass",
              "unit": "kg",
              "unitDeclared": true,
              "fields": [],
              "quantityLabel": "Mass",
              "shapeLabel": "Scalar",
              "elementLabel": "real"
            },
            {
              "id": "in3",
              "label": "Grade sine",
              "quantity": "dimensionless",
              "unit": "—",
              "unitDeclared": true,
              "fields": [],
              "quantityLabel": "Number",
              "shapeLabel": "Scalar",
              "elementLabel": "real"
            }
          ],
          "outputs": [
            {
              "id": "out0",
              "label": "Output",
              "quantity": "force",
              "unit": "N",
              "unitDeclared": true,
              "fields": [],
              "quantityLabel": "Force",
              "shapeLabel": "Scalar",
              "elementLabel": "real"
            }
          ],
          "parameters": [
            {
              "id": "crr",
              "label": "Rolling-resistance coefficient",
              "unit": "",
              "value": "0.01"
            },
            {
              "id": "cdA",
              "label": "Drag area CdA",
              "unit": "m²",
              "value": "0.638"
            },
            {
              "id": "airDensity",
              "label": "Air density",
              "unit": "kg/m³",
              "value": "1.225"
            },
            {
              "id": "rollingThreshold",
              "label": "Rolling-resistance speed threshold",
              "unit": "m/s",
              "value": "0.1"
            },
            {
              "id": "gravity",
              "label": "Gravity",
              "unit": "m/s²",
              "value": "9.80665"
            }
          ],
          "url": "https://lemonergy.com/learn/glossary/blocks/signal-block-road-load/",
          "related": [
            {
              "label": "Tyre grip",
              "url": "https://lemonergy.com/learn/glossary/blocks/signal-block-tyre-grip/"
            },
            {
              "label": "Ground contact",
              "url": "https://lemonergy.com/learn/glossary/blocks/signal-block-ground-contact/"
            }
          ],
          "selected": null,
          "connections": []
        }
      }
    }
  },
  "incoming": [],
  "outgoing": [],
  "neighbors": []
}