Skip to content

Custom events

Xavier MD edited this page Jun 5, 2026 · 6 revisions

All current custom event description

To get more detailed information on a specific event, go see the BuildEvent___.py script to understand how it is created.

BuildEventFloorSniffing.py

  • Floor sniffing: The animal is sniffing the floor. This event is detected when the animal's body slope (frontZ - backZ) is between -25 and -15 (px), indicating the animal's head/front is lower than its tail/back, characteristic of a downward sniffing posture.

BuildEventHouse.py

  • In house corner: The animal is located in the corner of the house. Detected when the animal is within 200 pixels from the corner position (100, 350).
  • Over house: The animal is on top of the house. Detected when the animal is 25-100 pixels from the corner and its head (massZ) is above 130.

BuildEventInCorner.py

  • Corner, Corner NW, Corner NE, Corner SW, Corner SE: Detects when the animal is in one of the arena corners (NW, NE, SW, SE). Each corner is a 5 cm radius circle. Events require minimum 6-frame duration (0.2s), with gaps ≤3 frames merged. Corners positions are NW: (114, 63), NE: (398, 63), SE: (398, 353), SW: (114, 353), all in pixels.

BuildEventOnHouse.py

  • onHouse: The animal is on top of the house. Detected when the animal is in the center zone and meets height thresholds: massZ > 128, frontZ > 30. This indicates the animal has climbed onto the house structure.

BuildEventWaterPoint.py

  • Water Zone: The animal is in the zone around the water source. Detected when the animal is within 10 cm from the water source position (398, 353).
  • Water Stop: The animal is stopped and drinking at the water point. Detected when the animal is within 5 cm from the water source position and the animal is in a "Stop" event for at least 2 seconds.

Clone this wiki locally