{
  "tool": "murb-planning--property.bulk_yield",
  "name": "Development yield under zoning controls (CDU-ENG-URB-900)",
  "answers": "How much floor area, how many storeys and how many units can this site carry under its floor-area ratio and coverage?",
  "degree": {
    "id": "competency:murb-planning--property",
    "code": "CDU-ENG-URB-900",
    "name": "MUrb Planning & Property",
    "version": "1.0.0"
  },
  "reference": "Land use scheme controls under SPLUMA 16 of 2013: floor-area ratio (bulk) and coverage; storeys = GFA ÷ footprint (rounded up); net lettable = GFA × efficiency",
  "endpoint": "/faculty/murb-planning--property/bulk_yield",
  "feeSt": 1,
  "inputSchema": {
    "type": "object",
    "required": [
      "pan",
      "siteArea",
      "floorAreaRatio",
      "coverage",
      "averageUnitSize"
    ],
    "properties": {
      "pan": {
        "type": "string",
        "description": "The student PAN — the degree must be held in one of its five slots",
        "pattern": "^[0-9 ]{16,19}$"
      },
      "siteArea": {
        "type": "number",
        "description": "Site area, m²",
        "minimum": 1
      },
      "floorAreaRatio": {
        "type": "number",
        "description": "Permitted floor-area ratio (bulk factor)",
        "minimum": 0.01,
        "maximum": 50
      },
      "coverage": {
        "type": "number",
        "description": "Permitted coverage, 0–1",
        "minimum": 0.01,
        "maximum": 1
      },
      "efficiency": {
        "type": "number",
        "description": "Net-to-gross efficiency, 0–1",
        "minimum": 0.1,
        "maximum": 1,
        "default": 0.85
      },
      "averageUnitSize": {
        "type": "number",
        "description": "Average net unit size, m²",
        "minimum": 1
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "required": [
      "grossFloorArea",
      "maxFootprint",
      "storeys",
      "netArea",
      "units"
    ],
    "properties": {
      "grossFloorArea": {
        "type": "number",
        "description": "m²"
      },
      "maxFootprint": {
        "type": "number",
        "description": "m²"
      },
      "storeys": {
        "type": "number",
        "description": "Storeys needed to use the bulk"
      },
      "netArea": {
        "type": "number",
        "description": "m²"
      },
      "units": {
        "type": "number",
        "description": "Whole units that fit"
      }
    },
    "additionalProperties": false
  },
  "example": {
    "siteArea": 4000,
    "floorAreaRatio": 2.5,
    "coverage": 0.6,
    "efficiency": 0.85,
    "averageUnitSize": 65
  }
}