Skip to content

Conversation

@sunt05
Copy link

@sunt05 sunt05 commented Nov 26, 2025

Summary

  • Add automated Web of Science publications tracker for SUEWS-related papers
  • New Global Applications documentation page showing worldwide SUEWS usage
  • Reproducible script for future updates

New Files

Scripts

  • scripts/wos-papers/fetch_suews_papers.py - WoS API fetcher with analysis
  • scripts/wos-papers/README.md - Methodology documentation

Documentation

  • docs/source/global_applications.rst - New page in Community section
  • docs/source/assets/wos-papers/ - Output data (JSON, BibTeX, Markdown)

Key Findings

Metric Value
Total papers 68
Year range 2011-2026
Unique locations 24+ cities
Top regions Europe (31), Asia (14), North America (6)

Top Cities

  • London (9), Helsinki (8), Beijing (6), Dublin (5), Shanghai (3), Vancouver (3)

Application Areas

  • Model Development (45), Surface Energy Balance (35), Water Balance (35), Urban Vegetation (34)

Reproducibility

To update the data in future:

cd scripts/wos-papers
export WOS_API_KEY="your-key"
python fetch_suews_papers.py --output-dir ../../docs/source/assets/wos-papers/

Test plan

  • Verify docs build without errors
  • Check RST rendering of global_applications.rst
  • Confirm download links work for data files

🤖 Generated with Claude Code

@github-actions
Copy link

🤖 I've automatically formatted the code in this PR using:

  • Python: ruff v0.8.6
  • Fortran: fprettify v0.3.7

Please pull the latest changes before making further edits.

@sunt05 sunt05 force-pushed the feature/wos-papers-analysis branch from bed9148 to 192f6ec Compare December 14, 2025 22:37
sunt05 and others added 2 commits January 2, 2026 20:43
Add automated Web of Science publications tracker for SUEWS-related papers:

- New `scripts/wos-papers/fetch_suews_papers.py` for reproducible paper retrieval
- Comprehensive methodology documentation in `scripts/wos-papers/README.md`
- New `docs/source/global_applications.rst` showing:
  - 68 papers from Web of Science
  - Geographic distribution across 24+ cities/regions
  - Application areas (energy balance, CO2 flux, vegetation, etc.)
  - Publication trends (2011-2026)
- Output data files in JSON, BibTeX, and Markdown formats

The script uses the WoS Expanded API (requires institutional subscription) and
can be re-run to update the data for future documentation releases.
Co-authored-by: sunt05 <1802656+sunt05@users.noreply.github.com>
@sunt05 sunt05 force-pushed the feature/wos-papers-analysis branch from 192f6ec to 60cdf5b Compare January 2, 2026 20:43
@github-actions
Copy link

github-actions bot commented Jan 2, 2026

Preview Deployed

Content Preview URL
Site https://suews.io/preview/pr-921/
Docs https://suews.io/preview/pr-921/docs/

Note

This preview is ephemeral. It will be lost when:

  • Another PR with site/ or docs/ changes is pushed
  • Changes are merged to master
  • A manual workflow dispatch runs

To restore, push any commit to this PR.

- Remove BibTeX and Markdown outputs, keep JSON as single source of truth
- Remove timestamps from filenames (suews_wos_papers.json)
- Update script to default to JSON-only output
- Simplify RST page: remove Publication Trends section, update date
- Update README with new output format

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Create refs-wos.bib with 68 WoS papers (unique citation keys)
- Add inline citations to each city entry in global_applications.rst
- Add References section with bibliography directive
- Fix duplicate citation keys in fetch script (AuthorYear -> AuthorYeara/b)
- Update conf.py to include refs-wos.bib

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add CSV format option to fetch_suews_papers.py
- Implement city detection from paper titles/abstracts
- Display publications as filterable table in documentation
- Include downloadable CSV alongside JSON data

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants