Skip to content

Soy Area Assessment

View or edit on GitHub

This page is synchronized from trase/engagement/brazil/soy_risk_benchmark/soy_area_assessment/README.md. Last modified on 2026-04-14 15:19 CEST by Nicolas Martin. Please view or edit the original file there; changes should be reflected here after a midnight build (CET time), or manually triggering it with a GitHub action (link).

Soy Area Comparison Report

This folder contains a standalone HTML report that compares soy planted area estimates across three data sources (GLAD/Song et al. 2021, IBGE SIDRA PAM, and MapBiomas Collection 10).

The data it relies on can be found in this same folder, as well as in s3://trase-storage/brazil/soy/risk_benchmark/soy_area_assessment/

Contents

  • soy_area_comparison_report.html - main report (single-page app)
  • soy_area_MB_with_MMU_mb_risk_benchmark_strict_q1_2026.csv - MapBiomas-based soy area time series
  • soy_area_trase_glad_mb_orig_q4_2025.csv - GLAD/Song et al. (2021) soy area time series
  • soy_planted_area_2000_2025_tonnes_IBGE.csv - IBGE SIDRA PAM planted area time series
  • Biomas_Trase.zip - biome boundaries overlay (shapefile ZIP)

Quick start (local)

The HTML fetches local CSV/ZIP files, so you need a local web server and associated files (file:// will be blocked by CORS).

From this folder, run:

python -m http.server 8000

Then open locally [with associated files]:

http://localhost:8000/soy_area_comparison_report.html
Then open online:

https://trase-storage.s3.eu-west-1.amazonaws.com/brazil/soy/risk_benchmark/soy_br_risk_benchmark_v3/QA/soy_area_assessment/soy_area_comparison_report.html

What the report shows

  1. National time series (2002-2024) for MapBiomas, GLAD, and IBGE.
  2. Biome-level comparisons and differences vs IBGE.
  3. State-level differences vs IBGE (top differences).
  4. Municipality-level map of differences.
  5. Municipality-level scatter comparisons.

Data sources (soy area / deforestation calculation inputs)

  • Land use / land cover for soy area: MapBiomas Collection 10.
  • Source: https://brasil.mapbiomas.org/en/
  • GLAD soy planted area (Song et al. 2021) used by Trase:
  • Source: https://www.nature.com/articles/s41893-021-00729-z
  • IBGE SIDRA PAM annual planted area:
  • Source: https://sidra.ibge.gov.br/acervo#/S/Q

If you need to add official data download links for the CSVs in this folder, you can fill them in here.

External libraries (CDN)

The report loads these libraries via CDN:

  • Tailwind CSS
  • Chart.js + chartjs-plugin-datalabels
  • PapaParse
  • Plotly.js
  • shpjs (for ZIP shapefiles)
  • Google Fonts: DM Sans, Space Mono

Configuration points in the HTML

In soy_area_comparison_report.html:

  • CSV sources are defined in the sources object:
  • soy_area_MB_with_MMU_mb_risk_benchmark_strict_q1_2026.csv
  • soy_area_trase_glad_mb_orig_q4_2025.csv
  • soy_planted_area_2000_2025_tonnes_IBGE.csv
  • Map base GeoJSON: mapUrl (external GitHub source)
  • Biome overlay: Biomas_Trase.zip (optional; report still works without it)

Updating the data

  1. Replace the CSV files with updated versions (keep filenames).
  2. Refresh the page (hard reload).
  3. Check:
  4. Time series charts render with updated values.
  5. Biome/state differences look reasonable.
  6. Map and scatter plots update to the selected year.

Troubleshooting

  • Charts or map not loading: open browser dev tools and check for missing files (404s).
  • Local file blocked: serve the folder via python -m http.server.
  • Empty charts: verify CSV headers match the parsing logic in the HTML.