{
  "tool": "matric-nqf4.music_interval",
  "name": "Interval frequency ratio (CDU-GEN-NSC-400)",
  "answers": "The just-intonation frequency ratio of a named interval and the upper note from a base frequency.",
  "degree": {
    "id": "competency:matric-nqf4",
    "code": "CDU-GEN-NSC-400",
    "name": "Senior Certificate (Amended) — exam-readiness programme (NQF 4 matric)",
    "version": "1.0.0"
  },
  "reference": "Umalusi/NSC subject catalogue, worked reference (offline reconstruction); Music row of §4 — a frequency ratio for an interval",
  "endpoint": "/faculty/matric-nqf4/music_interval",
  "feeSt": 1,
  "inputSchema": {
    "type": "object",
    "required": [
      "pan",
      "interval",
      "baseFrequencyHz"
    ],
    "properties": {
      "pan": {
        "type": "string",
        "description": "The student PAN — the degree must be held in one of its five slots",
        "pattern": "^[0-9 ]{16,19}$"
      },
      "interval": {
        "type": "string",
        "description": "the interval",
        "enum": [
          "octave",
          "perfect fifth",
          "perfect fourth",
          "major third"
        ]
      },
      "baseFrequencyHz": {
        "type": "number",
        "description": "the lower note (Hz, > 0) (Hz)",
        "minimum": 0.001,
        "maximum": 100000
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "required": [
      "ratio",
      "upperFrequencyHz"
    ],
    "properties": {
      "ratio": {
        "type": "number",
        "description": "the frequency ratio (4 d.p.)"
      },
      "upperFrequencyHz": {
        "type": "number",
        "description": "the upper note (Hz, 2 d.p.)"
      }
    },
    "additionalProperties": false
  },
  "example": {
    "interval": "perfect fifth",
    "baseFrequencyHz": 440
  }
}