{
  "tool": "med-assessment--curriculum.item_analysis",
  "name": "Item difficulty and discrimination (CDU-EDU-ASC-900)",
  "answers": "How hard is this item, and does it separate stronger from weaker candidates?",
  "degree": {
    "id": "competency:med-assessment--curriculum",
    "code": "CDU-EDU-ASC-900",
    "name": "MEd Assessment & Curriculum",
    "version": "1.0.0"
  },
  "reference": "Kelley (1939) upper and lower groups; Ebel & Frisbie (1991) discrimination-index guidelines; AERA/APA/NCME Standards (2014) ch. 4 (item development and review)",
  "endpoint": "/faculty/med-assessment--curriculum/item_analysis",
  "feeSt": 1,
  "inputSchema": {
    "type": "object",
    "required": [
      "pan",
      "upperCorrect",
      "lowerCorrect",
      "groupSize"
    ],
    "properties": {
      "pan": {
        "type": "string",
        "description": "The student PAN — the degree must be held in one of its five slots",
        "pattern": "^[0-9 ]{16,19}$"
      },
      "upperCorrect": {
        "type": "number",
        "description": "Correct answers in the upper group",
        "minimum": 0
      },
      "lowerCorrect": {
        "type": "number",
        "description": "Correct answers in the lower group",
        "minimum": 0
      },
      "groupSize": {
        "type": "number",
        "description": "Candidates in each group (often the top and bottom 27%)",
        "minimum": 1
      }
    },
    "additionalProperties": false
  },
  "outputSchema": {
    "type": "object",
    "required": [
      "difficulty",
      "discrimination",
      "quality"
    ],
    "properties": {
      "difficulty": {
        "type": "number",
        "description": "p = (U + L) ÷ 2n"
      },
      "discrimination": {
        "type": "number",
        "description": "D = (U − L) ÷ n"
      },
      "quality": {
        "type": "string",
        "description": "very good, reasonably good, marginal or poor"
      }
    },
    "additionalProperties": false
  },
  "example": {
    "upperCorrect": 24,
    "lowerCorrect": 10,
    "groupSize": 30
  }
}