A browser-based tool for generating boustrophedon (back-and-forth) sampling paths across polygon boundaries loaded from ESRI shapefiles or drawn directly on the map. Built for agricultural field surveying and precision sampling workflows.
How to Use
- Click Open Shapefile (.zip) to load boundaries, or use Boundary Tools to draw polygons directly on the map. Click to place vertices, double-click to finish, Escape to cancel.
- Configure path parameters: speed, heading, swath width, sampling duration, and elevation (auto-populated from location).
- Select an operation type and fill in type-specific fields (e.g. crop type, moisture, yield for Harvest; tillage method for Tillage). Grain/legume crops auto-derive dry yield from wet (or vice versa) using standard drying moisture. Set optional Min and Max values for yield and moisture to control per-point spatial variation range.
- Click Generate Path, then click a start point and end point on the map. For headlands, check the Headlands option, set the number of laps, and click a single start point.
- The path renders with a green–yellow–red gradient (in-field, based on yield quality) and black (turning) segments.
Key Features
- Draw boundaries — Draw polygon boundaries and holes directly on the map with vertex editing and delete tools.
- Headlands — Generate perimeter passes around the field boundary or around holes. Configurable number of laps with physics-based smooth turns between laps. Click near a hole edge to generate headlands around the hole instead.
- Restrict to polygon — Path turns at every boundary edge including holes.
- Accumulate features — Preserve previous paths; new passes avoid prior swaths within the same operation type.
- Undo — Revert generations one at a time.
- Compass rose — Drag to set heading. Auto-initializes to magnetic north.
- Operation types — Harvest, As-Applied, Planting, Tillage with type-specific parameters and independent path layers. As-Applied supports a dynamic multi-product tank mix (up to 5 products) with product name, type, rate, rate units, and density; carriers auto-fill density from known values; includes auto-calculated application rate (with user-selectable units), target rate, and per-point rate variation using 30 m Simplex noise. Planting supports up to 3 variety cards — each with variety name (dynamic per-crop dropdown with real hybrids/varieties), seed population, row spacing, and planting depth — plus crop type, row count, auto-calculated total seed population, and per-point population variation using 30 m Simplex noise. Tillage includes a tillage method selector and row count. All dropdowns sorted alphabetically.
- Crop moisture derivation — Auto-calculates dry yield from wet (or vice versa) using crop-specific standard drying moisture.
- Yield/moisture/rate variation — Per-point spatial variation using Simplex noise with edge-proximity effects. Optional Min and Max inputs define the variation range around the entered average. Harvest uses 150 m noise for yield and moisture. As-Applied and Planting use 30 m noise for tighter application rate and population variation zones.
- Elevation — Per-point terrain elevation via a grid fetched from the Open-Meteo API. Field average shown in the input; user overrides shift all points while preserving terrain shape. Displays in selected unit system (ft/m).
- Soil quality influence (Experimental) — Optional opt-in feature that fetches soil properties (organic carbon, clay content, pH) from the ISRIC SoilGrids API as a 3×3 grid across the field. Computes a composite soil quality score per grid point and bilinearly interpolates per path point, shifting yield/rate/population up or down based on soil quality. Better soil produces higher values; worse soil produces lower. Works independently of Min/Max variation inputs — soil quality alone produces variation even when Min/Max are left blank. Falls back to uniform quality (1.0) if the API is unavailable.
- Unit toggle — Switch between US (mph, ft) and metric (km/h, m).
- Visualization modes — Three-button toggle (Points / Polygons / Raster) in the Options fieldset controls how the selected operation's data is displayed. Points shows individual path points; Polygons shows filled rectangular swath polygons (choropleth); Raster shows a smooth continuous-surface via Inverse Distance Weighting interpolation clipped to the field boundary. All modes use the same green–yellow–red gradient and rebuild automatically on generate, undo, boundary changes, and operation type switch.
- Map controls — Layer switcher with radio-button operation layers (one visible at a time), zoom, attribution, scale bar, and compass share a unified dark translucent theme.
- Data histogram — Canvas-based histogram above the scale bar shows the distribution of the primary varied value (yield, app rate, or population) for the selected operation type, colored with the same green–yellow–red gradient. Visible in all visualization modes; auto-hides for tillage or when no data is present.
- Git history — View the last 40 commits from the panel header. Commit log is embedded at build time.
- Test results — View a formatted test report from the panel header with pass/fail summary, coverage progress bars, and collapsible per-suite results. Data is embedded at build time; JUnit XML and Clover XML reports are generated for AWS CodeBuild.
- Date/time stamping — Each sample point carries an incrementing timestamp.
- Feature tooltip — Hover over path points to inspect all properties.
- Export templates — Predefined export templates for Climate FieldView, John Deere, SMS AgLeader, Farmobile, FarmTrx, and Raven Slingshot. Templates select platform-specific columns and rename them to match each platform's format. Additional DD/DH-compatible templates produce shapefiles that match DataDetective identification rules and DataHarvester extraction formats, with vendor-specific field names, automatic unit conversions (yield bu/ac↔lb/ac, seeds/ac→lbs/ac, app rate→gal/ac or lb/ac), and required columns.
- Discrepancy viewer — View field-by-field discrepancies between SFG export templates and DataDetective/DataHarvester expectations via a button in the export dialog.
- Export — Download path points as a Shapefile ZIP with configurable attributes and column names. Type-specific columns included per operation.
- CI/CD — Auto-deployed to shapegen.agos.us via CodeBuild on push to master. CloudFormation stack manages S3, CloudFront, ACM, and Route 53.