{
  "tool": "murb-planning--property.household_projection",
  "name": "Population projection and dwelling demand (CDU-ENG-URB-900)",
  "answers": "How many people and households will the area hold in t years, and how many more dwellings does that need?",
  "degree": {
    "id": "competency:murb-planning--property",
    "code": "CDU-ENG-URB-900",
    "name": "MUrb Planning & Property",
    "version": "1.0.0"
  },
  "reference": "Geometric (compound) population projection; the persons-per-household method of converting population to households",
  "endpoint": "/faculty/murb-planning--property/household_projection",
  "feeSt": 1,
  "inputSchema": {
    "type": "object",
    "required": [
      "pan",
      "basePopulation",
      "annualGrowthRate",
      "years",
      "personsPerHousehold",
      "existingDwellings"
    ],
    "properties": {
      "pan": {
        "type": "string",
        "description": "The student PAN — the degree must be held in one of its five slots",
        "pattern": "^[0-9 ]{16,19}$"
      },
      "basePopulation": {
        "type": "number",
        "description": "Population now",
        "minimum": 0
      },
      "annualGrowthRate": {
        "type": "number",
        "description": "Annual growth rate (negative for decline)",
        "minimum": -0.2,
        "maximum": 0.2
      },
      "years": {
        "type": "number",
        "description": "Projection horizon",
        "minimum": 0,
        "maximum": 100
      },
      "personsPerHousehold": {
        "type": "number",
        "description": "Average household size",
        "minimum": 1,
        "maximum": 20
      },
      "existingDwellings": {
        "type": "number",
        "description": "Dwellings now",
        "minimum": 0
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "required": [
      "projectedPopulation",
      "projectedHouseholds",
      "additionalDwellings"
    ],
    "properties": {
      "projectedPopulation": {
        "type": "number",
        "description": "P0 × (1 + r)^t"
      },
      "projectedHouseholds": {
        "type": "number",
        "description": "Population ÷ household size"
      },
      "additionalDwellings": {
        "type": "number",
        "description": "Households − existing dwellings (negative: surplus)"
      }
    },
    "additionalProperties": false
  },
  "example": {
    "basePopulation": 250000,
    "annualGrowthRate": 0.021,
    "years": 10,
    "personsPerHousehold": 3.4,
    "existingDwellings": 68000
  }
}