Skip to content

Latest commit

 

History

24 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CCPID — China Climate Policy Instrument Database

中国气候政策工具数据库 — a bilingual (Chinese/English) database of national-level climate mitigation policy instruments of China, structured in alignment with the OECD IFCMA Climate Policy Database.

Overview

  • Unit of observation: the policy instrument (or sub-scheme), not the broader policy package.

  • Coverage: 281 instruments (313 rows including sub-schemes), as of September 2026, across five categories:

    Category Description
    Economic instruments Taxes, subsidies, emissions trading, etc.
    Regulatory instruments Standards, bans, mandates, etc.
    Government I&C Government investment & consumption
    Information instruments Disclosure, labelling, reporting
    Voluntary approaches Agreements, voluntary markets
  • Evidence-backed: every field is supported by a source URL, source title, evidence quote, and confidence score, recorded in outputs/evidence_log.csv. Where evidence is insufficient, values are marked not found / N/A and flagged for human review — nothing is invented.

  • Languages: Chinese-first drafting with a generated, human-reviewed English version.

Classification hierarchy

Category → Group → Approach → Instrument → Sub-scheme (optional)

Group/approach mappings are controlled by rules/schema.yaml.

Instrument ID format

{ISO3 country}{group code}{approach code}I{2-digit instrument seq}S{3-digit subscheme seq}

Example: CHNTRAETSI01S000 — CHN · Trading scheme · Emissions trading system · instrument 01 · parent row (S000). Sub-schemes use S001, S002, …

Repository structure

Path Contents
inputs/ Source templates, classification/approach definitions, field & attribute definitions, methodology docs, IFCMA paper
rules/schema.yaml Authoritative schema: templates, columns, allowed values, validation rules, controlled lists, ID code maps
scripts/ Python CLI pipeline (standard library only, except openpyxl for Excel export)
outputs/ CSV working files, Excel deliverables (CCPID_cn.xlsx, CCPID_en.xlsx), evidence log
review/ Inclusion/exclusion decisions, issues for human review, workflow docs
docs/ Static overview and download pages (CN/EN), published via GitHub Pages
logs/ Validation reports (generated, not committed)

Getting the data

  • Excel deliverables: outputs/CCPID_cn.xlsx (Chinese) and outputs/CCPID_en.xlsx (English), one sheet per instrument category plus Ended / 已终止 sheets for expired instruments.
  • CSV working files: outputs/CCPID_{cn,en}_{category}.csv.
  • Web: see docs/ for overview and download pages generated by scripts/generate_webpage.py, published at https://mgfpku.github.io/CCPID/.

Development

Requirements: Python 3.8+, openpyxl. All scripts are run from the repo root.

Core workflow (per instrument)

  1. Make an inclusion decision → record in review/inclusion_exclusion_decisions.md
  2. Fill the Chinese draft: python scripts/fill_instrument.py add ...
  3. Chinese draft passes human review and validation
  4. Generate the English version: python scripts/generate_english_from_chinese.py
  5. Validate: python scripts/validate_dataset.pylogs/validation_report.md
  6. Export deliverables: python scripts/export_workbooks.py --lang all

Key commands

# List available templates
python scripts\fill_instrument.py templates

# Generate an instrument ID from the schema code map
python scripts\fill_instrument.py id --country CHN --group "Trading scheme" --approach "Emissions trading system" --instrument-sequence 1

# Add / update an instrument row
python scripts\fill_instrument.py add `
  --template "Economic instruments" `
  --id CHNTRAETSI01S000 `
  --set "Instrument / subscheme=Instrument" `
  --set "Group=Trading scheme" `
  --set "Approach=Emissions trading system" `
  --set "Domestic name=..." `
  --set "Country=CHN" `
  --source-url "https://..." --source-title "..." --evidence-quote "..." --confidence-score 0.8

# Full export + validate pipeline (preferred after any CSV edit)
python scripts\run_pipeline.py

# Pipeline with URL health check
python scripts\run_pipeline.py --check-urls

# Normalize ISIC codes before export/validation
python scripts\normalize_isic_economic_sector.py

Scripts that write outputs/evidence_log.csv must run sequentially, never in parallel. Always regenerate both Excel workbooks after any CSV edit.

中文简介

CCPID(中国气候政策工具数据库)是一个中英双语的国家层面气候减缓政策工具数据库,分类体系与 OECD IFCMA 气候政策数据库保持一致。以政策工具(或子方案)为观测单位,涵盖经济工具、规制工具、政府投资与消费、信息工具、自愿措施五大类,截至 2026 年 9 月共收录 281 个工具(含子方案共 313 行)。每个字段均有来源 URL、来源标题、证据引文和置信度评分支撑(见 outputs/evidence_log.csv),证据不足时标注 未找到/N/A 并转人工复核,不编造数据。中文版先行填写,经人工审核后生成英文版。详细使用说明见上文英文部分及 CLAUDE.md

License

  • Code (scripts/ and tooling): MIT License
  • Data (CSV/Excel datasets in outputs/ and templates in inputs/): CC BY 4.0 — attribute the CCPID team, MGFPKU, Peking University.

Contact

Maintained by MGFPKU — Peking University.

About

China Climate Policy Instrument Database (CCPID) — bilingual (CN/EN) national-level climate mitigation policy instrument database aligned with the OECD IFCMA Climate Policy Database

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages