Planting Runs¶

A planting run groups related plants for shared lifecycle tracking. Instead of managing 20 tomatoes individually, you create a run — and can then apply phase transitions and watering events to the whole group at once.

Prerequisites¶

• At least one site with a location
• Master data: plant species must be set up
• Optional: a nutrient plan for the group

What Is a Planting Run?¶

A planting run is a lightweight group container. It has no lifecycle of its own — it simply groups plants. Each plant in the run retains full independence:

• Individual plants can be edited on their own (e.g. notes)
• A plant can be detached from the run at any time
• As long as a plant belongs to the run, its phase transitions only happen together with the whole group (batch phase transition) — a transition for that one plant alone is blocked until it has been detached from the run

Two types of planting runs:

Creating a New Planting Run¶

Step 1: Navigate to Runs¶

Click Planting Runs in the navigation, under the Planting Runs section. The overview shows all active and past planting runs.

Step 2: Create a New Run¶

Click Create Run. A dialog opens.

Step 3: Enter Basic Data¶

Step 4: Set Up Entries — Create New Plants or Adopt Existing Ones¶

For a new run you have two options: create new plant entries (default) or take over existing, standalone plants into the run. These are mutually exclusive and toggled with the Adopt existing plants switch.

Creating new plant entries¶

Click Add Entry and fill in for each entry:

You can add multiple entries if a run should contain several varieties of the same species or — with appropriate planning — several species at once (see the mixed-culture note above).

Adopting existing plants¶

Turn on the Adopt existing plants switch to bring already existing, unassigned plants into the new run instead of creating new entries:

1. Turn on the switch. The input fields for new entries disappear, and a searchable list of all standalone plants appears instead.
2. Search by ID, name, or current phase and select the plants you want (or use Select All).
3. When you save, the selected plants are assigned to the newly created run without creating new plant records. The run switches directly to "Active".

This is useful if you first created individual plants and want to group them together afterwards.

Step 5: Save the Run¶

Click Create.

• New-entries mode: The run is created with the entered entries in "Planned" status. The individual plant records do not exist yet — that requires a separate step (see below).
• Adopt mode: The selected existing plants are taken over immediately, and the run is already "Active" afterwards.

Step 6: Create Plants From the Entries (new-entries mode only)¶

As long as a run is "Planned" and used entries (not adoption), the individual plants do not exist yet. To create them:

1. Open the run.
2. Click Create Plants at the top.
3. Confirm the number of plants to be created in the dialog.
4. Kamerplanter automatically creates all individual plants with sequential IDs in the format LOCATION-KEY_PREFIX_SEQUENCE (e.g. raised-bed-a_TOM_01 to raised-bed-a_TOM_08, where raised-bed-a is the internal key of the chosen location) and sets the run to "Active".

If a plant is assigned a slot in the process, Kamerplanter automatically checks crop rotation and companion-planting compatibility for it — exactly as for an individually created plant. A conflict for even a single plant blocks the creation of the entire run. See the Companion Planting & Crop Rotation guide for details.

The Tabs on the Run Detail Page¶

The run's detail page is organized into five tabs:

The sections below cover the most important actions in these tabs.

Planting Run Status¶

A planting run passes through the following states:

stateDiagram-v2
    [*] --> Planned
    Planned --> Active : Plants moved in
    Active --> Harvesting : First harvest initiated
    Harvesting --> Completed : All plants harvested
    Active --> Cancelled : Cancel run
    Planned --> Cancelled : Cancel run

Phase History in the "Phases" Tab¶

In the Phases tab, Kamerplanter shows a visual phase timeline for every species represented in the run, plus a table with the actual history:

The pencil icon lets you correct the actual start or end date of a completed or current phase after the fact — for example when a transition was only entered into the system later. This correction applies to all plants of the run together: you can't correct it for individual plants — the correction always applies to the whole run.

Below that, Kamerplanter lists all plants, grouped by their current phase, with a direct link to each plant's detail page.

Batch Operations¶

The power of planting runs lies in batch operations — actions applied to all eligible plants at once.

Batch Phase Transition¶

Move all eligible plants in a run to the next phase at once:

1. Open the planting run ("Active" or "Harvesting" status).
2. Click Phase Transition.
3. Kamerplanter determines the currently most common ("dominant") phase among the still-active plants and suggests the phases that follow it in the phase sequence.
4. Select the target phase (e.g. "Vegetative" → "Flowering").
5. If the run contains several species (several entries with different species), Kamerplanter warns you that only compatible plants will be transitioned.
6. Confirm — Kamerplanter reports how many plants were transitioned, skipped (e.g. already in a later phase), or failed.

Confirming Watering (Batch)¶

Once a nutrient plan is assigned, the Fertilization & Watering tab shows a calendar with the due watering/feeding dates. For a due date, you have two options:

• Quick Confirm — applies the system-suggested amount/EC directly, without further input.
• Confirm Watering — opens a dialog where you can enter the measured amount, EC, and pH manually, if you mixed differently.

Either way, a feeding event is recorded for the run.

Ending a Run¶

At the end of a cycle (or if you want to cancel it early), you end the entire run in one step:

1. Click End Run (visible as long as the run is active or in "Harvesting" status).
2. Choose the final status: Cancelled or Completed.
3. Confirm — all still-active plants in the run are marked as removed, and the run switches to the chosen final status.

Ending the run does not delete the plants from the system — they remain accessible but are no longer considered active.

Completing the Harvest¶

Once a run has been harvested, you complete the harvest for all still-active plants of the run in a single step:

1. Click Complete harvest at the top of the detail page (visible as long as the run is active or in "Harvesting" status).
2. Confirm in the dialog — it shows how many plants are affected.
3. Every still-active plant of the run moves to its terminal "harvested" state: its phase history is closed, occupied slots are freed, and the plants disappear from the active task queue. The resulting phase transition then shows up in the Plants tab ("Current phase" / "Removed on" columns). Existing harvest batches are fully retained.

If no active plants remained when you clicked (the run was already fully harvested), you get a notice and nothing changes. The step cannot be undone.

Activity Plan (Tab)¶

The Activity Plan tab manages recurring care activities (e.g. topping, defoliation, repotting) for the run:

• No plan assigned yet: Click Generate Plan to produce a suggestion from the species-specific growth phases. Kamerplanter groups the suggested activities by phase and shows, for each one, the day offset, category, stress level, skill level, required tools, and a rationale.
• Adjust the suggestion: enable/disable individual activities with the switch, change the day offset, or remove an activity entirely.
• Kamerplanter flags activities whose stress level exceeds the tolerance of the respective phase.
• Click Apply to Run to turn the plan into actual tasks for the run.
• Plan already assigned: The tab instead shows a list of the assigned tasks grouped by phase, with progress (completed/total).

Assigning a Nutrient Plan¶

You can assign a nutrient plan to a planting run to simplify watering planning:

1. Open the run and switch to the Fertilization & Watering tab.
2. Click Assign Nutrient Plan.
3. Select a plan from the list.

The plan defines which nutrients to use in which phase at which dosage. When watering, Kamerplanter automatically suggests the phase-appropriate dosages.

Detaching Individual Plants from a Run¶

If one plant needs to follow a different path from the group (e.g. it shows deficiency symptoms and needs individual treatment):

1. Switch to the Plants tab.
2. Click Detach in the row of the affected plant (only available while the run is active).
3. The plant stays active but is now independent — its phase can be transitioned individually again afterwards.

Detaching a plant from the run does not delete the plant.

Plant Diary (currently API-only)¶

Each entry has a type (observation, problem, milestone, measurement, photo, or note), an optional title, text (up to 5,000 characters), optional photo references, tags, and free-form measurements. A second technical API endpoint lets you retrieve the diary entries of all plants in a run together.

Frequently Asked Questions¶

See Also¶

• Master Data: Plant Species
• Growth Phases
• Locations & Substrates
• Companion Planting & Crop Rotation
• Task Planning
• Harvest
• Fertilization