{"_readme":"Machine-readable codebook for the Campus Alert Archive dataset. 'columns' documents every field the case exports can emit (CSV/XLSX/JSON row grains at /dataset/ and the on-site export menu); 'grains' on each column lists which detail levels include it. optIn marks the Claude Message-Anatomy columns that can be absent from a file, and optInGrains lists the grains where each is opt-in: the consensus columns are always present in the full grain and opt-in only in the alerts grain, while the per-pass reads columns are opt-in in every grain. 'elementDefinitions' documents the six warning-message elements used by the Message Anatomy coding. Canonical nested case records live at /data/cases.json and /data/case/<slug>.json; the human-readable schema reference is on /methodology/.","datasetVersion":"2026.07","license":"Compilation, metadata, summaries, and annotations © Campus Alert Archive, licensed under Creative Commons Attribution 4.0 International (CC BY 4.0). Verbatim alert and policy texts remain the work of their issuing institutions, reproduced from publicly available sources, and are not covered by the CC BY license.","licenseUrl":"https://creativecommons.org/licenses/by/4.0/","dataset":"https://campusalertarchive.com/dataset/","grains":{"summary":"One row per case. No alert text; counts and case metadata only.","alerts":"One row per alert message (the default for research): every sequenced verbatim message with its own citation, channel, timestamp, and confidence.","full":"The alerts grain plus the full case narrative, casualties, tags, key findings, and every source."},"columns":[{"key":"caseId","label":"Case ID","description":"A short, stable ID for the case — handy for linking rows back together.","group":"Case & institution","grains":["summary","alerts","full"]},{"key":"date","label":"Incident Date","description":"The date the incident happened (YYYY-MM-DD).","group":"Case & institution","grains":["summary","alerts","full"]},{"key":"institution","label":"Institution","description":"The college or university involved.","group":"Case & institution","grains":["summary","alerts","full"]},{"key":"shortName","label":"Short Name","description":"A common short name or abbreviation for the institution.","group":"Case & institution","grains":["summary","alerts","full"]},{"key":"state","label":"State","description":"The U.S. state or territory, as a two-letter code.","group":"Case & institution","grains":["summary","alerts","full"]},{"key":"institutionType","label":"Institution Type","description":"What kind of school it is (public, private, community college, and so on).","group":"Case & institution","grains":["summary","alerts","full"]},{"key":"incidentType","label":"Incident Type","description":"The category of emergency (active shooter, severe weather, etc.).","group":"Case & institution","grains":["summary","alerts","full"]},{"key":"cleryCategory","label":"Clery Category","description":"The federal Clery Act category this incident falls under.","group":"Case & institution","grains":["summary","alerts","full"]},{"key":"resolution","label":"Resolution","description":"How the situation ended (e.g. all-clear, suspect in custody).","group":"Case & institution","grains":["summary","alerts","full"]},{"key":"headline","label":"Headline","description":"A one-line plain-language summary of the case.","group":"Case & institution","grains":["summary","alerts","full"]},{"key":"alertSequence","label":"Alert #","description":"The order of this message within the case (1, 2, 3 …).","group":"Alert message","grains":["alerts","full"]},{"key":"alertType","label":"Alert Type","description":"What kind of message it was (initial alert, update, all-clear).","group":"Alert message","grains":["alerts","full"]},{"key":"channel","label":"Channel","description":"How it was sent (text, email, siren, social media, etc.).","group":"Alert message","grains":["alerts","full"]},{"key":"timestamp","label":"Timestamp (ISO)","description":"The exact send time in ISO format, when known.","group":"Alert message","grains":["alerts","full"]},{"key":"timestampApprox","label":"Timestamp (approx)","description":"A human-readable or approximate send time.","group":"Alert message","grains":["alerts","full"]},{"key":"verbatimText","label":"Verbatim Alert Text","description":"The exact wording of the alert message — the heart of the archive.","group":"Alert message","grains":["alerts","full"]},{"key":"isVerbatimConfirmed","label":"Verbatim Confirmed","description":"TRUE if we confirmed this is the exact original wording.","group":"Alert message","grains":["alerts","full"]},{"key":"characterCount","label":"Character Count","description":"How many characters the message contained.","group":"Alert message","grains":["alerts","full"]},{"key":"alertSourceDescription","label":"Alert Source","description":"Where this specific message came from.","group":"Alert message","grains":["alerts","full"]},{"key":"alertSourceUrl","label":"Alert Source URL","description":"A link to the source for this message.","group":"Alert message","grains":["alerts","full"]},{"key":"caseConfidence","label":"Case Confidence","description":"Our confidence in the overall case (repeated on each alert row).","group":"Case & institution","grains":["alerts","full"]},{"key":"caseUrl","label":"Case URL","description":"A link to this case's page on the archive.","group":"Case & institution","grains":["summary","alerts","full"]},{"key":"alertAnnotations","label":"Alert Annotations","description":"Editor's notes about this particular message.","group":"Alert message","grains":["full"]},{"key":"incidentSummary","label":"Incident Summary","description":"A fuller written summary of what happened.","group":"Case context & sources","grains":["full"]},{"key":"incidentOutcome","label":"Outcome","description":"The final outcome of the incident.","group":"Case context & sources","grains":["full"]},{"key":"responseTimeMinutes","label":"Response Time (min)","description":"Minutes from the incident to the first alert, when known.","group":"Counts & casualties","grains":["summary","full"]},{"key":"context","label":"Context","description":"Background and surrounding context for the case.","group":"Case context & sources","grains":["full"]},{"key":"keyFindings","label":"Key Findings","description":"The most important takeaways we noted.","group":"Case context & sources","grains":["full"]},{"key":"tags","label":"Tags","description":"Topic tags applied to this case.","group":"Case context & sources","grains":["full"]},{"key":"alertSystemName","label":"Alert System","description":"The name of the school's alert system (e.g. RAVE, Everbridge).","group":"Case & institution","grains":["full"]},{"key":"alertPlatform","label":"Alert Platform","description":"The platform or vendor behind the alert system.","group":"Case & institution","grains":["full"]},{"key":"enrollment","label":"Enrollment","description":"The institution's student enrollment, when known.","group":"Case & institution","grains":["full"]},{"key":"allSources","label":"All Sources","description":"Every source we used, with links, for the case.","group":"Case context & sources","grains":["full"]},{"key":"dateAdded","label":"Date Added","description":"When this case was first added to the archive.","group":"Case context & sources","grains":["full"]},{"key":"lastUpdated","label":"Last Updated","description":"When this case was last updated.","group":"Case context & sources","grains":["full"]},{"key":"aiElementsCoded","label":"AI Elements Coded","description":"TRUE if Claude analyzed this case's first alert for message elements.","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts"]},{"key":"aiSource","label":"AI Source (present)","description":"Did the alert name who is sending it? (Claude's read.)","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts"]},{"key":"aiHazard","label":"AI Hazard (present)","description":"Did the alert say what the threat is? (Claude's read.)","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts"]},{"key":"aiLocation","label":"AI Location (present)","description":"Did the alert say where the threat is? (Claude's read.)","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts"]},{"key":"aiGuidance","label":"AI Guidance (present)","description":"Did the alert tell people what to do? (Claude's read.)","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts"]},{"key":"aiTime","label":"AI Time (present)","description":"Did the alert convey timing or urgency? (Claude's read.)","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts"]},{"key":"aiImpact","label":"AI Impact (present)","description":"Did the alert convey the hazard's potential consequences or severity? (Claude's read.)","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts"]},{"key":"aiElementCount","label":"AI Element Count (0-6)","description":"How many of the six message elements were present (0–6).","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts"]},{"key":"aiAgreement","label":"AI Element Agreement","description":"How the AI passes voted on each element (e.g. S 23/25).","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts"]},{"key":"aiArbitratorAssessment","label":"AI Arbitrator Assessment","description":"A summarizing AI's synthesis of the element analysis.","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts"]},{"key":"aiCodingNote","label":"AI Coding Note","description":"A note on how the AI analysis was produced (not human-reviewed).","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts"]},{"key":"alertCount","label":"Total Alerts","description":"How many alert messages the school sent for this case.","group":"Counts & casualties","grains":["summary"]},{"key":"verbatimAlertCount","label":"Verbatim Alerts","description":"How many of those messages we have confirmed word-for-word.","group":"Counts & casualties","grains":["summary"]},{"key":"killed","label":"Killed","description":"Number of people killed, where reported.","group":"Counts & casualties","grains":["summary"]},{"key":"injured","label":"Injured","description":"Number of people injured, where reported.","group":"Counts & casualties","grains":["summary"]},{"key":"confidence","label":"Confidence","description":"Our confidence in this case's accuracy (high, medium, or low).","group":"Case & institution","grains":["summary"]},{"key":"aiSourceReads","label":"AI Source 25 Reads","description":"All 25 individual AI verdicts and reasons for the 'source' element.","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts","full"]},{"key":"aiHazardReads","label":"AI Hazard 25 Reads","description":"All 25 individual AI verdicts and reasons for the 'hazard' element.","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts","full"]},{"key":"aiLocationReads","label":"AI Location 25 Reads","description":"All 25 individual AI verdicts and reasons for the 'location' element.","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts","full"]},{"key":"aiGuidanceReads","label":"AI Guidance 25 Reads","description":"All 25 individual AI verdicts and reasons for the 'guidance' element.","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts","full"]},{"key":"aiTimeReads","label":"AI Time 25 Reads","description":"All 25 individual AI verdicts and reasons for the 'time' element.","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts","full"]},{"key":"aiImpactReads","label":"AI Impact 25 Reads","description":"All 25 individual AI verdicts and reasons for the 'impact' element.","group":"Claude AI analysis","grains":["alerts","full"],"optIn":true,"optInGrains":["alerts","full"]}],"caseSchemaNotes":["The flat export rows are projections; the canonical records are the nested per-case JSON files (byte-exact copies of the repository's data/cases/*.json).","Alert texts are preserved verbatim, typos and all. isVerbatimConfirmed=TRUE means the exact original wording was confirmed against the cited source; FALSE means an honest reconstruction from coverage.","Confidence semantics: high = verbatim from an official source; medium = reliable secondary sourcing; low = substantially reconstructed.","CSV artifacts only: cells beginning with =, +, @, or a tab are prefixed with a single quote (') to prevent spreadsheet formula injection. JSON is never altered."],"elementDefinitions":[{"key":"source","label":"Source","description":"Who is sending the message","rationale":"Who is sending the alert and who is responding. People act faster on a message from a clearly identifiable, credible sender, such as a named department, the police, or a branded alert system, than on an anonymous notice. A branded signature counts."},{"key":"hazard","label":"Hazard","description":"What the threat is","rationale":"What the threat actually is. A complete warning names the specific danger, such as a shooter, a fire, a tornado, or a gas leak, rather than a vague emergency, because people decide what to do based on what they are facing."},{"key":"location","label":"Location","description":"Where the threat is","rationale":"Where the threat is. Saying whether danger is in a specific building, a part of campus, or area-wide lets people judge their own proximity and choose a safe direction. Without a where, a warning is hard to act on precisely."},{"key":"guidance","label":"Guidance","description":"The protective action to take","rationale":"The protective action to take. A clear, specific instruction, such as shelter in place, evacuate, avoid the area, or run-hide-fight, drives faster and more correct protective behavior than describing the threat alone."},{"key":"time","label":"Time","description":"Timing or recency","rationale":"When the message applies. A timestamp, the word now or immediately, or a phrase like until further notice tells the reader whether the danger is current and how quickly to act."},{"key":"impact","label":"Impact","description":"What the hazard could do, its potential impact","rationale":"What the hazard could do to the people in its path. Beyond naming the threat, a complete warning conveys its potential consequences or severity, such as that a tornado can level buildings or that a leak could be explosive, so recipients grasp how much danger they are in. Research on warning message content finds that a concrete impact statement helps people personalize their risk and act sooner."}]}