{ "$id": "https://coursebank.dev/schema/measurements.schema.json", "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "What one administration measured. Written once and not rewritten, like a seal: it records a thing that happened on a day. Cohort aggregates only — no per-section or per-student breakdown, because a small cell crossed with anything else stops being an aggregate.", "properties": { "administration": { "additionalProperties": false, "properties": { "assessment": { "type": "string" }, "coursebank": { "type": "string" }, "date": { "description": "When it was given.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "forms": { "description": "The forms in play.", "items": { "type": "string" }, "type": "array" }, "generated": { "description": "When the analysis was run.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "id": { "type": "string" }, "model": { "type": "string" }, "n_examinees": { "description": "The number to read before any of the others: a point-biserial on twenty-seven students is a different kind of claim than one on three hundred.", "minimum": 0, "type": "integer" }, "term": { "type": "string" } }, "required": [ "id", "assessment", "n_examinees" ], "type": "object" }, "items": { "items": { "additionalProperties": false, "properties": { "discrimination_index": { "maximum": 1.0, "minimum": -1.0, "type": "number" }, "flags": { "items": { "enum": [ "negative_discrimination", "low_discrimination", "distractor_outperforms_key", "key_underperforms", "too_easy", "too_hard", "high_rapid_guess", "nonfunctioning_distractor", "dif_flagged", "ambiguous", "design_mismatch" ], "type": "string" }, "type": "array" }, "irt": { "additionalProperties": false, "properties": { "a": { "description": "Discrimination.", "type": "number" }, "b": { "description": "Difficulty.", "type": "number" }, "bayesian": { "description": "Whether priors were used. On a class-sized sample they should be.", "type": "boolean" }, "c": { "description": "Lower asymptote, 3PL only.", "maximum": 1.0, "minimum": 0.0, "type": "number" }, "model": { "enum": [ "rasch", "2pl", "3pl" ], "type": "string" }, "n": { "minimum": 0, "type": "integer" }, "se_a": { "minimum": 0.0, "type": "number" }, "se_b": { "minimum": 0.0, "type": "number" } }, "required": [ "a", "b" ], "type": "object" }, "item": { "type": "string" }, "n": { "minimum": 0, "type": "integer" }, "number": { "minimum": 1, "type": "integer" }, "option_stats": { "additionalProperties": { "additionalProperties": false, "properties": { "lower_group_rate": { "description": "Rate in the bottom 27%.", "maximum": 1.0, "minimum": 0.0, "type": "number" }, "point_biserial": { "maximum": 1.0, "minimum": -1.0, "type": "number" }, "selection_rate": { "description": "How often chosen.", "maximum": 1.0, "minimum": 0.0, "type": "number" }, "upper_group_rate": { "description": "Rate in the top 27%.", "maximum": 1.0, "minimum": 0.0, "type": "number" } }, "type": "object" }, "type": "object" }, "p_value": { "description": "Proportion correct on this administration.", "maximum": 1.0, "minimum": 0.0, "type": "number" }, "point_biserial": { "maximum": 1.0, "minimum": -1.0, "type": "number" }, "stem_digest": { "type": "string" }, "variant": { "type": "string" } }, "required": [ "item", "number", "n" ], "type": "object" }, "type": "array" }, "schema_version": { "type": [ "string", "number" ] } }, "required": [ "administration" ], "title": "coursebank administration record", "type": "object" }