{
  "tool": "msc-agribusiness--water.irrigation_requirement",
  "name": "Net and gross irrigation requirement (CDU-AGR-AGW-900)",
  "answers": "Over this period, how much water does the crop need from irrigation, at the field and at the source?",
  "degree": {
    "id": "competency:msc-agribusiness--water",
    "code": "CDU-AGR-AGW-900",
    "name": "MSc Agribusiness & Water",
    "version": "1.0.0"
  },
  "reference": "FAO-56 ch. 6 (single crop coefficient: ETc = Kc·ET0); FAO-24 (application efficiency); 1 mm over 1 ha = 10 m³",
  "endpoint": "/faculty/msc-agribusiness--water/irrigation_requirement",
  "feeSt": 1,
  "inputSchema": {
    "type": "object",
    "required": [
      "pan",
      "et0",
      "cropCoefficient",
      "days",
      "effectiveRainfall",
      "applicationEfficiency"
    ],
    "properties": {
      "pan": {
        "type": "string",
        "description": "The student PAN — the degree must be held in one of its five slots",
        "pattern": "^[0-9 ]{16,19}$"
      },
      "et0": {
        "type": "number",
        "description": "Mean reference ET over the period, mm/day",
        "minimum": 0,
        "maximum": 20
      },
      "cropCoefficient": {
        "type": "number",
        "description": "Kc for the growth stage",
        "minimum": 0.05,
        "maximum": 2
      },
      "days": {
        "type": "number",
        "description": "Days in the period",
        "minimum": 1,
        "maximum": 366
      },
      "effectiveRainfall": {
        "type": "number",
        "description": "Effective rainfall over the period, mm",
        "minimum": 0
      },
      "applicationEfficiency": {
        "type": "number",
        "description": "Irrigation application efficiency, 0–1",
        "minimum": 0.1,
        "maximum": 1
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "required": [
      "cropEt",
      "netRequirement",
      "grossRequirement",
      "volumePerHectare"
    ],
    "properties": {
      "cropEt": {
        "type": "number",
        "description": "ETc over the period, mm"
      },
      "netRequirement": {
        "type": "number",
        "description": "ETc − effective rain (not below 0), mm"
      },
      "grossRequirement": {
        "type": "number",
        "description": "Net ÷ efficiency, mm"
      },
      "volumePerHectare": {
        "type": "number",
        "description": "Gross × 10, m³/ha"
      }
    },
    "additionalProperties": false
  },
  "example": {
    "et0": 5.2,
    "cropCoefficient": 1.15,
    "days": 30,
    "effectiveRainfall": 40,
    "applicationEfficiency": 0.75
  }
}