Keyline Engine
Generates parametric plowing lines or swale networks by offsetting guide curves along a terrain mesh.
Overview
Generates parametric plowing lines or swale networks by offsetting guide curves along a terrain mesh.
Inputs (5)
- Terrain (Mesh): The base topography mesh
- Guide Curves (Curve): The reference contours or keylines
- Spacing (Number): Horizontal distance between plowing lines
- Count (Integer): Number of parallel lines to generate per side
- Run (Boolean): Optional. False = skip the analysis and keep showing the last results (cached). Share one toggle with the Analysis Dashboard to switch everything on/off together.
Outputs (3)
- Keylines (Curve): Generated 3D swale/plow curves projected on terrain
- Info (Text): Component information and methodology
- Dashboard Data (Text): Unified JSON payload containing legend and key analysis metrics for the Analysis Dashboard
Method, assumptions and simplifications
The same notes appear in the component's Info output.
Method
- Each Guide Curve is projected vertically onto Terrain and output.
- For i = 1 to Count, the guide is offset in the World XY plane by ± Spacing × i (sharp corners, tolerance 0.01) and each offset is projected vertically (along Z) onto Terrain.
- All projected curves form Keylines; the HUD and Dashboard Data report the number of curves and their total 3D length.
Assumptions
- Guide Curves are planar in plan (for example contours or a drawn keyline); offsets are computed in World XY.
- Spacing is a horizontal distance in model units (metres assumed in the dashboard text).
Simplifications and limits
- Lines are equal plan offsets of the guide, not true keyline geometry: no fall or grade is computed or controlled along each line, and they do not follow the contours.
- Offsets that self-intersect on tight curves are kept as returned by Rhino; offsets that fall off the terrain are dropped.
Workflow
- Terrain mesh -> Terrain; a contour or keyline through the keypoint (for example from a contour component) -> Guide Curves.
- Keylines -> drawings or swale layout; Dashboard Data -> Analysis Dashboard.
References
- Yeomans P.A. (1958), The Challenge of Landscape: the keyline system.