Skip to content

Conversation

anettkva
Copy link
Member

Summary

Adds the catalog data for the app: all elements and vaults from the Code of Points, with one drawing for each. It also adds the script that made the data and docs that explain it.

What is in this PR

  • The data (data/): 749 elements, 87 vaults, 22 element groups and 208 variant groups as JSON files, and 836 images.
  • The script (scripts/extract-cop/): a Python script that reads the Code of Points PDF and makes the files in data/.
  • Docs:
    • docs/EXTRACTION.md explains in plain words how the data was made and what we checked by hand
    • READMEs in data/ and scripts/extract-cop/
    • docs/DATA_MODEL.md and the root README are updated

About the number of files

This PR has around 850 changed files. Almost all of them are the images, one small drawing per element and vault.

They are fine to push. Each image is about 7 kB, and all of them together are about 6 MB, so they take up very little storage.

How to review

You do not need to open every file. Look at these:

  1. docs/EXTRACTION.md, to understand what was done
  2. scripts/extract-cop/extract.py, the script
  3. A few entries in data/elements.json and some images in data/images/

Good to know

  • The PDF is not in the repo. It is in .gitignore and must never be committed, because the rights belong to FIG.
  • Do not edit the files in data/ by hand. They are replaced when the script runs. Corrections go in the lists at the top of extract.py.
  • We checked everything the script was unsure about. The rest was only spot-checked, so there may still be small errors.

Closes #16

Anettkva and others added 8 commits October 2, 2026 13:43
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Reads the Table of Elements in the PDF and writes the JSON files and
one image per element and vault to data/, following docs/DATA_MODEL.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
751 elements, 87 vaults, 22 element groups and 208 variant groups,
with one image per element and vault.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Adds READMEs for scripts/extract-cop/ and data/, and a project
structure section to the root README.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@anettkva anettkva requested a review from a team as a code owner October 12, 2026 09:56
@anettkva anettkva self-assigned this Oct 12, 2026
Copy link
Member

@xeniag xeniag left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me! Great job at implementing the script:D

@xeniag xeniag merged commit 930460f into dev Oct 13, 2026
Sign in to join this conversation on GitHub.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants