# FAQ (Frequently Asked Questions) Common answers and troubleshooting tips for DRerio LogAI users. --- ## Q: The wizard is missing. How do I enable it? **A:** Since v1.6 the project creation wizard is enabled by default. If you disabled it previously, add the following to `config.local.yaml`: ```yaml ui_features: use_wizard_for_project_creation: true ``` Restart the application and the 5-step wizard will appear when you click **Create Project**. --- ## Q: Detections are flaky or the animal disappears. What should I check? 1. **Lighting & Contrast:** Ensure the arena background contrasts with the animal. Avoid reflections or strong shadows. 2. **Processing Area:** Confirm the arena polygon fully covers the region where the animal moves. With the new clamping logic, the snap indicator stays inside the arena — if you cannot place a point, the arena is probably too small. 3. **Confidence / NMS:** Lower the detector confidence threshold (e.g., from 0.85 to 0.65) or tweak NMS in the advanced configuration tab. 4. **Single-subject mode:** Calibration and diagnostics force single-subject tracking. The overlay shows the active mode; make sure the correct mode is being used for your experiment. --- ## Q: What's the recommended video format? **A:** MP4 (H.264) at 25-30 fps offers the best balance between size and quality. Higher bitrates improve detection, but ensure your storage and GPU can keep up. Other formats (AVI, MOV) work as long as OpenCV can decode them. --- ## Q: How do ROI templates work? **A:** Draw the arena/ROIs once, then use **💾 Salvar Zonas Atuais** to store the layout in `templates/`. Later projects can: - Select a saved template from **Templates salvos** and click **Aplicar**. - Import external JSON files via **📂 Importar e Aplicar Arquivo...** (applies immediately and saves to the library). Templates include arena, ROI polygons, names, and colors. The wizard also reuses templates when you import Parquet files containing zones. --- ## Q: Do I still need to calibrate? **A:** Yes. Calibration translates pixels into centimeters. Without it, distances and velocities are expressed in pixels. Use the calibration dialog (or wizard Step 4 for live projects) to record real-world dimensions. Once the calibration is saved, Recorder adds `x_cm`/`y_cm` columns and reports show metrics in centimeters. --- ## Q: Can DRerio LogAI handle videos recorded from an angle? **A:** Yes. Draw the arena corners in the zone editor; DRerio LogAI computes a homography that warps coordinates into a normalized top-down plane. Metrics and ROI checks operate in this warped space, so moderate perspective skew is fine. --- ## Q: Reports tab is empty even after processing. How do I refresh it? **A:** The GUI automatically refreshes after each processing batch. If you still see an empty list: 1. Check the status bar for errors while processing. 2. Click **Atualizar** in the Reports tab to rescan the project folder. 3. Confirm that the `