{"success":true,"data":{"author":"Eedi","bucketAccessType":"public","bucketName":"Eedi/Eedi-Misconceptions-Graph","bucketPrefix":"","category":"Mathematics","cloudProvider":"huggingface","createdAt":"2026-11-21T22:16:38.712Z","description":"A map of mathematical misconceptions held by school students and of the curriculum skills (constructs) in which they appear, released by the education company Eedi. Students on the Eedi platform answer multiple-choice Diagnostic Questions in which each wrong answer (distractor) is tagged with the misconception it reveals, for example a systematic error when ordering fractions. Aggregating those taggings gives misconception-map.csv, a weighted bipartite edge list with 19,294 rows covering 8,117 misconceptions. The edge weight, PercentageMisconceptionExistsInThisConstruct, is the share of a misconception's taggings that fall in each construct. construct-map.csv catalogs 2,258 constructs in a subject, topic and sub-topic hierarchy (4 subjects, 50 topics, 236 sub-topics: Number, Geometry and Measure, Algebra, Data and Statistics). The question texts themselves are not included. Education researchers use it to study how errors spread across topics, to design diagnostic assessments, and to ground tutoring models. Load the CSVs with pandas; scripts/ converts them to graph JSONL for Neo4j. The data is CC BY 4.0 and the scripts are MIT. Attribute \"Eedi Misconceptions Graph v1.0\" by Eedi.","displayTitle":"Eedi Misconceptions Graph: 8,117 Student Math Misconceptions Mapped to 2,258 Curriculum Constructs (Eedi)","huggingFaceUrl":"https://huggingface.co/datasets/Eedi/Eedi-Misconceptions-Graph","id":"80e02349-c5a6-5159-930c-67b7258715b7","license":"CC-BY-4.0","licenseEvidenceUrl":"https://huggingface.co/datasets/Eedi/Eedi-Misconceptions-Graph","objectCountEstimate":12,"probeStatus":"ok","region":"us","schemaCard":{"accessHints":[{"language":"python-datasets","snippet":"from datasets import load_dataset\nds = load_dataset(\"Eedi/Eedi-Misconceptions-Graph\")"},{"language":"python-hub","snippet":"from huggingface_hub import snapshot_download\nsnapshot_download(repo_id=\"Eedi/Eedi-Misconceptions-Graph\", repo_type=\"dataset\")"}],"caveats":["HuggingFace metadata: author=Eedi, license:cc-by-4.0, size_categories:10K<n<100K, format:csv, downloads=1015"],"format":"mixed","generatedAt":"2026-11-21T22:31:56.510Z","layout":{"example":"data/construct-map.csv","pattern":"{repoId}/{filename}"},"mountPath":"/mnt/archive","sampleHeaders":[{"bytes":"SubjectName,SubjectSubjectId,TopicName,TopicSubjectId,SubTopicName,SubTopicSubjectId,ConstructName,ConstructId\nAlgebra,49,Algebraic Fractions,255,Adding and Subtracting Algebraic Fractions,1078,Add algebraic fractions where one denominator is a multiple of the other,1616\nAlgebra,49,Algebraic Fractions,255,Adding and Subtracting Algebraic Fractions,1078,Add algebraic fractions where the denominators are single terms and are not multiples of each other,1617\nAlgebra,49,Algebraic Fractions,255,Adding and Subtra","encoding":"utf8","key":"data/construct-map.csv","truncatedAt":512}],"sampleObjects":["data/construct-map.csv","data/misconception-map.csv","docs/data-dictionary.md","scripts/.env.example","scripts/.gitignore"],"sidecars":[{"bytes":"Eedi Misconceptions Graph v1.0\nCopyright (c) 2026 Eedi Ltd (company number 09592720, England and Wales)\n\nThis work is licensed under the Creative Commons Attribution 4.0 International\nLicence (CC BY 4.0).\n\nYou are free to share and adapt this material for any purpose, including\ncommercially, provided you give appropriate credit, provide a link to the\nlicence, and indicate if changes were made.\n\nLicence deed:  https://creativecommons.org/licenses/by/4.0/\nLegal code:    https://creativecommons.org/licenses/by/4.0/legalcode.en\nSPDX-License-Identifier: CC-BY-4.0\n\nThe licensor grants the rights in this material, including any sui generis\ndatabase rights, under the terms of the licence reproduced in full below.\n\n================================================================================\n\nAttribution 4.0 International\n\n=======================================================================\n\nCreative Commons Corporation (\"Creative Commons\") is not a law firm and\ndoes not provide legal services or legal advice. Distribution of\nCreative Commons public licenses does not create a lawyer-client or\nother relationship. Creative Commons makes its licenses and related\ninformation available on an \"as-is\" basis. Creative Commons gives no\nwarranties regarding its licenses, any material licensed under their\nterms and conditions, or any related information. Creative Commons\ndisclaims all liability for damages resulting from their use to the\nfullest extent possible.\n\nUsing Creative Commons Public Licenses\n\nCreative Commons public licenses provide a standard set of terms and\nconditions that creators and other rights holders may use to share\noriginal works of authorship and other material subject to copyright\nand certain other rights specified in the public license below. The\nfollowing considerations are for informational purposes only, are not\nexhaustive, and do not form part of our licenses.\n\n     Considerations for licensors: Our public licenses are\n     intended for use by those authorized to give the public\n     permission to use material in ways otherwise restricted by\n     copyright and certain other rights. Our licenses are\n     irrevocable. Licensors should read and understand the terms\n     and conditions of the license they choose before applying it.\n     Licensors should also secure all rights necessary before\n     applying our licenses so that the public can reuse the\n     material as expected. Licensors should clearly mark any\n     material not subject to the license. This includes other CC-\n     licensed material, or material used under an exception or\n     limitation to copyright. More considerations for licensors:\n    wiki.creativecommons.org/Considerations_for_licensors\n\n     Considerations for the public: By using one of our public\n     licenses, a licensor grants the public permission to use the\n     licensed material under specified terms and conditions. If\n     the licensor's permission is not necessary for any reason--for\n     example, because of any applicable exception or limitation to\n     copyright--then that use is not regulated by the license. Our\n     licenses grant only permissions under copyright and certain\n     other rights that a licensor has authority to grant. Use of\n     the licensed material may still be restricted for other\n     reasons, including because others have copyright or other\n     rights in the material. A licensor may make special requests,\n     such as asking that all changes be marked or described.\n     Although not required by our licenses, you are encouraged to\n     respect those requests where reasonable. More considerations\n     for the public:\n    wiki.creativecommons.org/Considerations_for_licensees\n\n=======================================================================\n\nCreative Commons Attribution 4.0 International Public License\n\nBy exercising the Licensed Rights (defined below), You accept and agree\nto be bound by the terms and conditions of this Creative Commons\nAttribution 4.0 International Public License (\"Public License\"). To the\nextent this Public License may be interprete","encoding":"utf8","key":"LICENSE","name":"LICENSE","size":19453,"truncated":true},{"bytes":"---\nlicense: cc-by-4.0\nlanguage:\n  - en\npretty_name: Eedi Misconceptions Graph\ntags:\n  - education\n  - mathematics\n  - misconceptions\n  - curriculum\n  - edtech\nsize_categories:\n  - 10K<n<100K\nconfigs:\n  - config_name: misconception-map\n    data_files: data/misconception-map.csv\n  - config_name: construct-map\n    data_files: data/construct-map.csv\n---\n\n# Eedi Misconceptions Graph v1.0\n\nA map of **mathematical misconceptions** and the **curriculum constructs** they appear in, released by [Eedi](https://www.eedi.com) under a CC BY 4.0 licence.\n\nEedi defines a *misconception* as a flawed conceptual structure, or a gap in conceptual understanding, that manifests as a systematic and predictable error pattern across problems involving the same mathematical concept. A *construct* is a small, specific element of mathematics — for example, \"Order fractions with the same denominators\".\n\nOn the Eedi platform, students answer multiple-choice Diagnostic Questions with one correct answer and three distractors. Each distractor is tagged with the misconception it reveals, and each question sits within a curriculum hierarchy. \n\n## Contents\n\n| File | Rows | Description |\n| --- | --- | --- |\n| `data/misconception-map.csv` | 19,294 | Misconception ↔ construct edges, weighted, with the full topic hierarchy on each row |\n| `data/construct-map.csv` | 2,258 | The construct catalogue and its subject → topic → sub-topic hierarchy |\n| `docs/data-dictionary.md` | — | Field definitions, per-field statistics and samples |\n| `scripts/` | — | Python scripts to convert the CSVs to graph JSONL and load them into Neo4j |\n\nCoverage: **8,117 misconceptions**, **2,258 constructs**, 236 sub-topics, 50 topics, 4 subjects (Number, Geometry and Measure, Algebra, Data and Statistics).\n\n`misconception-map.csv` is an edge list over a bipartite graph of misconceptions and constructs. `PercentageMisconceptionExistsInThisConstruct` is the edge weight: the share of a misconception's taggings that fall in that construct. Weights for any single `MisconceptionId` sum to 100. A misconception confined to one area of mathematics has few, heavy edges; one that spans areas has many light ones — which is what makes cross-topic misconceptions findable.\n\nJoin the two files on `ConstructId`. Every `ConstructId` in the misconception map resolves to a row in the construct map, and every construct has at least one misconception. Field-by-field definitions are in [`docs/data-dictionary.md`](docs/data-dictionary.md).\n\n### What is not included\n\nThe Diagnostic Questions themselves, their distractors, question images, and any student-level response data are **not** part of this release. No personal data is included.\n\n## Loading into a graph database\n\nTo explore the data as a graph, load it into [Neo4j](https://neo4j.com) with one command:\n\n```bash\npip install neo4j python-dotenv\npython scripts/load_eedi_graph.py --download\n```\n\nThis builds a Subject → Topic → SubTopic → Construct → Misconception graph. Each construct–misconception link keeps its percentage weight. `scripts/csv_to_jsonl.py` produces the same graph as database-agnostic JSONL, and needs only the Python standard library. See [`scripts/README.md`](scripts/README.md) for connection settings, options, the graph model and example queries.\n\n## Licence\n\nThis work is licensed under a [Creative Commons Attribution 4.0 International Licence](https://creativecommons.org/licenses/by/4.0/) (CC BY 4.0).\n\n[![CC BY 4.0](https://licensebuttons.net/l/by/4.0/88x31.png)](https://creativecommons.org/licenses/by/4.0/)\n\nYou are free to **share** (copy and redistribute in any medium or format) and **adapt** (remix, transform and build upon the material) for any purpose, including commercially — provided you meet the attribution condition below. The licence covers Eedi's copyright and its sui generis database rights in this material. It is irrevocable, and it does not grant any rights in Eedi's trade marks.\n\nThe material is offered as-is, without warranties of any kind.\n\nThe full licence text is in [`LICENSE`](LICENSE).\n\nThe","encoding":"utf8","key":"README.md","name":"README.md","size":4886,"truncated":true},{"bytes":"MIT License\n\nCopyright (c) 2026 Eedi\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n","encoding":"utf8","key":"scripts/LICENSE","name":"LICENSE","size":1061,"truncated":false},{"bytes":"# Scripts\n\nLoad the Eedi Misconceptions Graph into a graph database in one command.\n\n| Script | What it does | Needs |\n| --- | --- | --- |\n| `csv_to_jsonl.py` | Converts the two CSVs into property-graph JSONL (`nodes.jsonl`, `relationships.jsonl`) | Python 3.8+ only |\n| `load_eedi_graph.py` | Loads the JSONL into Neo4j (local or Aura); builds the JSONL first with `--download` | `pip install neo4j python-dotenv`, Neo4j 5+ |\n\n## Quick start\n\n```bash\npip install neo4j python-dotenv\npython scripts/load_eedi_graph.py --download\n```\n\nThe CSVs are read from `data/` if you've cloned this repo. Otherwise they're downloaded from the `v1.0` release (pick a revision with `--tag`). You can also download just the two scripts and run them on their own.\n\n## Connecting to Neo4j\n\nCopy `.env.example` to `.env` and fill in your details. Credentials are read from environment variables, or from the nearest `.env` file in the script's folder or any folder above it (failing that, the folder you run it from, or above):\n\n```bash\nNEO4J_URI=bolt://localhost:7687      # or neo4j+s://xxxx.databases.neo4j.io for Aura\nNEO4J_USERNAME=neo4j\nNEO4J_PASSWORD=...\nNEO4J_DATABASE_EEDI=eedi-v1          # optional; this is the default\n```\n\nTo keep several instances in one `.env`, add a suffix, e.g. `NEO4J_URI_LOCAL`, `NEO4J_PASSWORD_LOCAL`, and choose with `--target LOCAL`. When more than one is configured, the script refuses to guess.\n\nThe database is created if it doesn't exist. This needs Neo4j Enterprise, which Neo4j Desktop includes. Aura (including the free tier) and Community edition have a single database, so pass `--database neo4j` to load into it. The graph fits comfortably within Aura Free's limits.\n\n## Useful options\n\n| Option | Effect |\n| --- | --- |\n| `--download` | (Re)build the JSONL from the CSVs before loading |\n| `--target NAME` | Use the `NEO4J_*_NAME` variables |\n| `--database NAME` | Load into this database (default `eedi-v1`) |\n| `--wipe` | Delete everything in the database first |\n| `--allow-nonempty` | Merge into a database that already has data |\n| `--no-derived` | Skip the derived count properties |\n\nBy default the loader refuses to write to a database that already contains data.\n\n## Graph model\n\n```\n(:Subject)-[:SUBJECT_CONTAINS_TOPIC]->(:Topic)-[:TOPIC_CONTAINS_SUBTOPIC]->(:SubTopic)\n(:SubTopic)-[:SUBTOPIC_CONTAINS_CONSTRUCT]->(:Construct)\n(:Construct)-[:CONSTRUCT_HAS_MISCONCEPTION {percentage}]->(:Misconception)\n```\n\n| Label | Node id | Properties |\n| --- | --- | --- |\n| `Subject` | `eedi:subject:32` | `subjectSubjectId`, `name` |\n| `Topic` | `eedi:topic:144` | `topicSubjectId`, `name` |\n| `SubTopic` | `eedi:subtopic:202` | `subTopicSubjectId`, `name` |\n| `Construct` | `eedi:construct:27` | `constructId`, `name`, `misconceptionCount`\\* |\n| `Misconception` | `eedi:misconception:13708` | `misconceptionId`, `name`, `constructCount`\\*, `subTopicCount`\\*, `topicCount`\\*, `subjectCount`\\* |\n\n\\* Computed by the loader, not present in the CSVs.\n\n- **Field definitions:** properties are the CSV columns in camelCase (`ConstructId` → `constructId`, `ConstructName` → `name`). See [`docs/data-dictionary.md`](../docs/data-dictionary.md) for what each field means.\n- **Node ids include the type.** Construct ids overlap with Subject/Topic/SubTopic ids, so the type prefix keeps every id unique. In Neo4j the id is stored as `uri`, and every node also has the label `EediNode`.\n- **`percentage`** is `PercentageMisconceptionExistsInThisConstruct`: the share of a misconception's taggings that fall in that construct. It sums to 100 per misconception.\n- **Full-text search** on names: `CALL db.index.fulltext.queryNodes('eedi_text', 'place value')`.\n\nVersion 1.0 loads 10,665 nodes and 21,838 relationships, and the loader checks these counts when it finishes.\n\n## Example queries\n\nMisconceptions that appear in all four subjects:\n\n```cypher\nMATCH (m:Misconception) WHERE m.subjectCount = 4\nRETURN m.name, m.topicCount ORDER BY m.topicCount DESC\n```\n\nWhere a misconception shows up:\n\n```cypher\nMATCH (m:Misconception {misconceptionId: 13708})<-[r:CONSTRUCT_HAS_MIS","encoding":"utf8","key":"scripts/README.md","name":"README.md","size":4516,"truncated":true}],"sourceObjectKey":"data/construct-map.csv","starterCell":"import pandas as pd\ndf = pd.read_csv(\"hf://datasets/Eedi/Eedi-Misconceptions-Graph/data/construct-map.csv\")\ndf.head()","starterSamplePath":"data/construct-map.csv","totalObjects":12},"summary":"A map of mathematical misconceptions held by school students and of the curriculum skills (constructs) in which they appear, released by the education company Eedi.","title":"Eedi Misconceptions Graph: 8,117 Student Math Misconceptions Mapped to 2,258 Curriculum Constructs (Eedi)","updatedAt":"2026-11-22T00:58:49.926Z","visibility":"public","websiteUrl":"https://www.eedi.com"}}