Digifarm CropHist
Home Map API MCP Demo
Free Technical Sample

Iowa Crop History Starter Pack

Live sample exported on 2026-04-06. Downloads and notebooks are ready.

This is the first production technical sample for CropHist: 100,000 Iowa fields with 2008-2025 crop history, downloadable in wide and long formats, plus two notebook paths: a buyer-facing evaluation and an API quickstart.

The goal is simple: let an analyst answer a useful question in under 5 minutes instead of asking them to trust a marketing page.

100,000
Iowa fields in the published sample
2008-2025
history window in the published sample
18 years
annual crop-history columns per field
2 paths
buyer evaluation notebook plus API quickstart notebook

What Goes In The Pack

  • 100,000 Iowa field IDs sampled from the production field layer
  • wide Parquet and wide CSV for fast analyst onboarding
  • long Parquet and long CSV for tidy analysis workflows
  • a buyer-facing notebook for underwriting and monoculture screening
  • a separate API quickstart notebook for engineering evaluation
  • a manifest describing source, sample size, and file inventory

Why Iowa

  • recognizable Corn Belt geography
  • easy to explain to US agtech and insurance teams
  • high density of corn / soy rotation patterns
  • good fit for underwriting, diligence, and crop-mix analytics demos

Two Notebook Paths

  1. open the evaluation notebook to screen the full Iowa sample without an API key
  2. run the underwriting / diligence screen for concentrated corn/soy fields with limited recent diversity
  3. run the monoculture screen for long same-crop streaks and inspect representative timelines
  4. review the simple 2026 baseline forecast for the screened population
  5. open the API quickstart notebook when you want to test POST /v1/fields directly
  6. set CROPHIST_API_KEY and inspect the raw API response plus a flattened dataframe
Recommended launch copy: "Open the Iowa evaluation notebook for underwriting and monoculture screening, then switch to the API quickstart when you want to test integration." The current export omits county metadata on purpose. The first version optimizes for a clean, fast technical evaluation and keeps the buyer workflow separate from the engineering workflow.

Live Artifacts

Artifact Link Purpose
Wide Parquet (4.4 MB) /iowa-sample/downloads/iowa-fields-sample-wide.parquet Best starting point for analysts who want one row per field.
Long CSV (134.0 MB) /iowa-sample/downloads/iowa-fields-sample-long.csv Tidy long-form export for SQL, pandas, and notebook workflows.
Wide CSV (38.1 MB) /iowa-sample/downloads/iowa-fields-sample-wide.csv Spreadsheet-friendly version of the wide field sample.
Field IDs (1.0 MB) /iowa-sample/downloads/iowa-fields-sample-field-ids.txt Published ID list used by the notebook and API examples.
Manifest /iowa-sample/downloads/iowa-fields-sample-manifest.json Source, sample size, and generation metadata.
Evaluation Notebook /iowa-sample/iowa-free-sample-notebook.ipynb Buyer-facing notebook for underwriting / diligence and monoculture screening, using lon/lat labels instead of visible field IDs.
API Quickstart Notebook /iowa-sample/iowa-api-quickstart-notebook.ipynb Engineering notebook for testing POST /v1/fields with a real API key.
Evaluation Colab colab.research.google.com/github/crophist/us/blob/50f111f641a6609417eedf0fa38869c9dc8fd709/iowa-free-sample-notebook.ipynb Launch the buyer-facing evaluation notebook in Colab.
API Quickstart Colab colab.research.google.com/github/crophist/us/blob/50f111f641a6609417eedf0fa38869c9dc8fd709/iowa-api-quickstart-notebook.ipynb Launch the engineering quickstart notebook in Colab.
Export generated from the live production history store on 2026-04-06 UTC using s3://us-crop-hist/web/tiles/fields_us_2024_centroid.pmtiles and the US Census 2024 state polygons.