SPB Git

spb/wp44_uqo

Public
2.4 KB

# Brief — Appendices A (taxonomy), E (data dictionary), H (reproducibility) — files manuscript/appendices/appA_taxonomy.tex, appE_data_dictionary.tex, appH_reproducibility.tex

Follow agents/briefs/WRITER_COMMON.md. These appendices are reference material: precise, tabular, no padding.

  • Appendix A — The ontology: read taxonomy/ONTOLOGY.md and taxonomy/ontology.yaml (do not paste the YAML). Give: the 8 areas and 40 leaves with definitions (one table, longtable), the parent/child edges, the signal types and the assignment rule with the threshold, per-category counts of mapped OpenAlex topics / DBLP streams / keyword patterns (from the ontology; compute with a short Python snippet), the list of unmapped CS topics with reasons, and the known ambiguities (ONTOLOGY.md §2). Mention that the validation sample results are reported in Part IX (do not invent them).
  • Appendix E — Data dictionary: read ingestion/build_corpus.py (schemas S), ingestion/openalex_snapshot.py (slim schema), systematic_review/define_corpus.py (corpus_works added columns: in_dblp, in_acl, arxiv_id_linked, arxiv_created, arxiv_primary, e1–e7 flags, xpac_kept_dblp, cs_core, cs_penumbra, eligible, period, first_date, first_month, date_precision, duplicate_of, preprint_work_id, version_relationship), the linkage tables, bibliometrics/03 (work_citation_windows), knowledge_graph/01 (edge tables), taxonomy/classify.py outputs (work_categories, work_primary), embeddings/embed_corpus.py outputs. One longtable per table family: column, type, definition, source field (OpenAlex path or derivation). Be exact; derive from the code.
  • Appendix H — Reproducibility: read reproducibility/RUNBOOK.md, reproducibility/environment_M3U96b.txt, data/raw/README.md, reports/INCIDENTS.md, protocol/amendments.csv. Give the step table (commands, inputs, outputs, measured times), the environment (versions of the key packages from the lock file), the provenance mechanisms (manifests, SHA-256 ledgers, MD5 of DBLP, OAI raw pages, API ledger), the incident log and what it implies for reproduction, the licence of each source, and what is and is not redistributed. Keep numbers to those present in those files (file counts, sizes, times) — they are provenance facts, not corpus results. Target: A ≈ 10–14 pages, E ≈ 10–14 pages, H ≈ 6–8 pages. No new bib entries needed except possibly software citations (verify).
Files · ba2b7cb2d796858e41df4e8a2376a6db42e5a5df
Menu

Theme