Crop Row Connector

Connect fragmented crop rows into continuous lines.

crop-row-connector is a Python package that solves a critical problem in precision agriculture:

When large orthomosaic images are processed tile-by-tile, crop rows that span multiple tiles get detected as separate fragments.

This tool reconnects these fragments creating complete crop row geometries for field analysis.

_images/Field_detected.png

Detected crop rows in an orthomosaic field.

Use crop-row-connector if you:

  • Use Crop Row Detector for row detection

  • Process agricultural imagery in tiles

  • Need to reconstruct complete crop row geometry

  • Want to analyze vegetation health along continuous rows

Quick Start

To install crop-row-connector:

pip install crop-row-connector

Running crop-row-connector:

crop-row-connector \
    path/to/row_information_global.csv \
    path/to/points_in_rows.csv \
    --distance_tolerance 0.12 \
    --angle_tolerance 7 \
    --output_path_connected_crop_rows path/to/connected_crop_rows.csv \
    --output_path_vegetation_points path/to/line_points.csv \
    --output_path_unhealthy_vegetation_segments path/to/unhealthy.shp \
    --output_path_healthy_vegetation_segments path/to/healthy.shp

See the Tutorial with Test Data for a walkthrough including the expected output.

Documentation Overview

This documentation is organized into four sections to help you learn and use crop-row-connector effectively:

Tutorials — Learn by doing

Step-by-step guides that walk through practical examples. Start here if you’re new to the tool.

How-To Guides — Solve specific problems

Practical recipes for common tasks when building interfaces or analyzing your own data.

Explanation — Understand the concepts

Conceptual guides that explain how and why crop row connection works.

Reference — Look up details

Technical API documentation for developers integrating the tool into applications.

Installation

crop-row-connector is a python package and can be installed with pip:

pip install crop-row-connector

See Installation for more advanced methods of installation.

Acknowledgement

the crop-row-connector tool was developed by SDU UAS Center as part of the project Præcisionsfrøavl, that was supported by the Green Development and Demonstration Programme (GUDP) and Frøafgiftsfonden both from Denmark.

Index