Vinery Lab 🍇¶
Open-source parametric vineyard generator for developing and testing vineyard robots, and one of Misina Lab's reference generators.
Warning
Developer preview. Expect breaking changes.
Configured scene in Isaac Lab
Standalone parameter editor and visualizer app
🌐 Try the parameter editor in your browser: azazdeaz.github.io/misina-lab/playground/vinery, a bit slower, and it needs WebGPU.
Contents: Features · Install · Parameter editor · Isaac Lab · Examples · Roadmap
Features¶
- 🎛️ Parameter configurator with live preview
- 🎲 Fully reproducible scene generation
- 🍃 Leaves are modelled as detailed meshes to enable depth perception based workflows
- ⚡ Performance tuning: LoD and mesh variance are configurable to support low-end hardware and large vineyards
- 🏷️ Every plant, shoot and leaf is an addressable prim
- 🌿 Flexible stray shoots that the robot can push aside, and cut anywhere along their length
- ❄️ A dormant mode: bare brown canes with a bud at every node, every one of them cuttable
- 🌾 Cover crops and weeds, whose long stems can bend as a robot pushes through
docs/parameters.md lists every parameter, with its default and range.
Install¶
pip install vinery-lab
Wheels are built for Linux x86_64 and Python 3.12 and later; anywhere else pip builds it from source, which needs Rust. The examples install it from this checkout instead.
Parameter editor¶
From the repository root, with Rust installed:
cargo run --release
This brings up the viewer: every parameter is a slider, and the vineyard rebuilds as you drag. Misina Lab's front page has a video of it.
Isaac Lab¶
VineyardCfg is a standard Isaac Lab FileCfg config class. The options are
many, so set them in the parameter editor and copy them out of it:
flowchart LR
editor["Parameter editor"] -- "Copy Isaac Lab cfg" --> cfg["VineyardCfg<br/>in your scene config"]
cfg --> cached{"Cached for<br/>these parameters?"}
cached -- no --> generate["Generate the vineyard<br/>and write its USD"] --> spawn["Spawn the USD"]
cached -- yes --> spawn
- Start the parameter editor with
cargo run --release, or open the playground. - Edit the scene parameters in the panel.
- Press Copy Isaac Lab cfg to put the current settings on the clipboard
as a
VineyardCfg(...)construction, with only the fields you moved. - Paste it into your Isaac Lab environment's scene config:
from vinery_lab.isaaclab import VineyardCfg, ParcelCfg, SceneCfg, VineCfg
VINEYARD_CFG = VineyardCfg(
scene=SceneCfg(seed=42),
parcel=ParcelCfg(row_spacing=2.8, vine_spacing=1.05),
vine=VineCfg(arms=1),
)
# in the env's scene config
vineyard = AssetBaseCfg(prim_path="/World/Vineyard", spawn=VINEYARD_CFG)
Declare it in a scene: under Newton, the physics holds only the assets a scene
declares, so nothing collides with a vineyard spawned straight onto the
stage. A plain script builds an InteractiveScene around it, as design_scene
in the quadruped example does.
Examples¶
Each example is a uv project of its own that builds the generator from this checkout, so it needs Rust and hardware that runs Isaac Sim 6.2.
Quadruped¶
Navigate the rows with a quadruped. See its README for more detail.
cd examples/isaaclab_demo/
uv run main.py
The same demo on the PhysX backend (the stray shoots spawn static there):
uv run main.py --physics physx
The same demo on MJWarp alone, the fastest of the backends (the stray shoots spawn static there too):
uv run main.py --physics newton_mjwarp
Straddler¶
Drive a straddling robot down every row. See its README for more detail.
cd examples/straddler_demo/
uv run main.py
The same robot with a hedger hung under it, trimming the stray shoots back to the canopy:
uv run main.py --trim
Pruning¶
Prune a dormant vineyard with a UGV-mounted arm, Bumblebee style: every cane cut back to two buds, planned from the scene's own bud positions. See its README for more detail.
cd examples/pruning_demo/
uv run main.py
Roadmap¶
Upcoming
- More detailed cover crop and weed definitions
Planned
- Reconstruct real vineyard parcels from EU vineyard-register data, public orthophotos, and regional DTMs
- Support multiple vine-training systems
Misina Lab's roadmap has what every generator gets next.