Пакет: Іерархія гарадоў і закон Цыпфа

Правяральны пакет даследавання «Іерархія гарадоў і закон Цыпфа, 1897–2026». Адна крыніца (222 гарады, перапісы 1897–2019 + ацэнкі), увесь разлік — стандартная бібліятэка Python, узнаўленне ~10 секунд.

Версіі

v1.0.0 · 2026-07-11 · git-тэг artifact-zipf-v1.0.0

Першы рэліз: 12 зрэзаў 1897–2026, нахілы Габэ–Ібрагімава па топ-20/30/50, прымацыя, 8 кантрольных метрык з допускам ±0,001.

Склад

by-maps-zipf-v1.0.0/
├── README.md                    вопрос, вывод, как воспроизвести
├── manifest.json                машиночитаемое описание (файлы, sha256, допуски)
├── AGENT.md                     задачи для LLM-агента и формат отчёта
├── LIMITATIONS.md               7 известных ограничений
├── PROVENANCE.md                цепочка источник → преобразование → результат
├── CITATION.cff · LICENSE.md
├── sources/registry.csv         реестр источников (URL, лицензия, дата, sha256)
├── sources/raw/ps_cities.html   завендоренный сырой источник
├── code/run.sh                  единственная точка входа
├── code/build.py                весь расчёт (стандартная библиотека)
├── code/fetch.py · verify.py · requirements.lock
├── params/assumptions.yaml      6 допущений с обоснованиями
├── data/final/                  ранжировки, наклоны, примация, контрольные метрики
└── checks/                      инварианты, ожидаемые результаты, контрольные суммы

Хуткая праверка

unzip by-maps-zipf-v1.0.0.zip && cd by-maps-zipf-v1.0.0
bash code/run.sh
# == 1/3 Расчёт от sources/raw до data/final ==
# == 2/3 Инварианты данных ==
# == 3/3 Сверка с заявленными результатами ==
# Все 8 контрольных метрик воспроизведены в допусках.

Валідацыя ў CI: кожны пуш перазбірае пакет і зверае з апублікаваным байт-у-байт; поўны прагон run.sh — частка пайплайна.