📘 Screen: Trap Group
The Trap Group screen is used to register the types of traps used on the farm, grouping them by purpose or target pest. Besides naming the group, this is where you define what that trap catches and from what count a catch becomes an alert.
📍 Location in the system
Menu: Crops > Trap Group
🧩 Main function
Each group represents a general classification of the trap, such as the type of pest it monitors.
Common examples:
- Boll Weevil Trap
- Caterpillar Trap
- Leafhopper Trap
This group is selected later when registering a Trap x Season.
📝 Registration fields
| Field | Description |
|---|---|
| Code | Group identifier. |
| Description | Required. Name of the group (e.g., Armadilha geral). |
| Active | Defines whether the group is available for use in other records. |
🐛 Tab: Details (items)
This is where you say what that trap catches. Each row links to the group a Pest, weed or disease that is already registered, with a free-text Description and the Active checkbox.
A pheromone trap for boll weevil, for example, has a single item; a generic light trap group can have several, because it catches more than one species. This list defines what the operator will be able to count when reading the trap in the field.
📊 Tab: Levels
Levels turn the count into decision-making information: instead of the scout seeing "37 insects" and having to remember whether that is a lot or a little, the system classifies the catch into ranges you define.
| Field | Description |
|---|---|
| Starting Qty | Count that opens the range. |
| Ending Qty | Count that closes the range. |
| Description | Required. The name of the range — this is what the reader sees (e.g., "Low", "Watch", "Action threshold"). |
| Active | Lets you take a level out of use without deleting its history. |
The buttons on this tab are Save Levels, Cancel Levels and Delete Levels, so they are not confused with the header buttons.
The level color
Each level also stores a color, and that is what the app uses: the colored bar on the side of each trap in the list and its pin on the map come from the range the last collection fell into. This lets the scout see, without opening anything, where in the area the catch went up.
An example of a group set up for the cotton boll weevil, with ranges named in BAS (boll weevils per trap per week): 0 BAS in green, 0 to 1 BAS in blue, 1 to 2 BAS in yellow and Above 2 BAS in red. The complete path for this pest is in How to monitor the cotton boll weevil.
In the app, the trap list uses these levels to visually highlight the traps that are in an alert range — whoever looks at the phone sees right away which traps need attention, without comparing number by number.
- You can associate them when registering a Trap x Season
- The operator counts in the field only what that trap actually catches
- The catch becomes an automatic classification, and the app highlights traps at an alert level
- Monitoring reports and dashboards can be organized by pest type
- Trap management in the field becomes clearer and more segmented
❓ Frequently asked questions
What is a trap group for?
To classify traps by purpose or target pest — for example, a Boll Weevil trap, a Caterpillar trap or a Leafhopper trap. This is the group you select later when registering the Trap x Season.
Do I need to register the group before the traps?
Yes. The group is a prerequisite: without it, there is no way to classify the trap in the season record.
What do I gain by organizing traps by group?
Monitoring reports and dashboards can then be organized by pest type, which makes trap management in the field clearer and more segmented.
How do I say which pests a trap catches?
On the group's Details (items) tab: each row links a pest, weed or disease that is already registered. This list is what the operator sees when counting the trap's catch in the field.
How does the system know if a trap's catch is high?
Through the group's Levels. You register ranges with a Starting Qty, an Ending Qty and a name — "Low", "Watch", "Action threshold" —, and the count automatically falls into the matching range. In the app, traps in an alert range are highlighted in the list.
I can't save the level. What's wrong?
Three things block it: the Starting Qty cannot equal the Ending Qty, the starting value cannot be greater than the ending value, and the group must be saved before you enter the levels. The level description is also required.