82 lines
2.5 KiB
Markdown
82 lines
2.5 KiB
Markdown
|
# Configuration Profiles
|
||
|
|
|
||
|
|
This directory contains pre-configured YAML files for common use cases.
|
||
|
|
|
||
|
|
## Available Profiles
|
||
|
|
|
||
|
|
### default.yaml
|
||
|
|
Balanced settings suitable for most indoor surveillance scenarios.
|
||
|
|
- Good balance between sensitivity and noise reduction
|
||
|
|
- Moderate processing speed
|
||
|
|
- **Use when**: Processing typical indoor surveillance footage
|
||
|
|
|
||
|
|
### high-sensitivity.yaml
|
||
|
|
Optimized for detecting smaller movements and objects.
|
||
|
|
- Lower detection thresholds
|
||
|
|
- Shorter minimum layer lengths
|
||
|
|
- Less frame averaging
|
||
|
|
- **Use when**: You need to catch subtle movements or smaller objects
|
||
|
|
- **Use when**: Indoor scenes with good lighting
|
||
|
|
|
||
|
|
### low-sensitivity.yaml
|
||
|
|
Reduced sensitivity to avoid false positives from environmental noise.
|
||
|
|
- Higher detection thresholds
|
||
|
|
- Longer minimum layer lengths
|
||
|
|
- More frame averaging
|
||
|
|
- **Use when**: Outdoor scenes with weather changes (clouds, wind)
|
||
|
|
- **Use when**: You want to focus only on significant movements
|
||
|
|
- **Use when**: Reducing false positives is more important than catching everything
|
||
|
|
|
||
|
|
### fast.yaml
|
||
|
|
Optimized for processing speed at the cost of some accuracy.
|
||
|
|
- Lower resolution processing (480p instead of 700p)
|
||
|
|
- Smaller buffers
|
||
|
|
- Minimal averaging
|
||
|
|
- **Use when**: Quick preview or testing
|
||
|
|
- **Use when**: Processing very long videos
|
||
|
|
- **Use when**: Running on limited hardware
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Use a specific profile
|
||
|
|
python main.py input_video.mp4 output_dir configs/default.yaml
|
||
|
|
|
||
|
|
# Override specific settings with environment variables
|
||
|
|
export VIDEO_SUMMARY_THRESHOLD=10
|
||
|
|
python main.py input_video.mp4 output_dir configs/default.yaml
|
||
|
|
```
|
||
|
|
|
||
|
|
## Creating Custom Profiles
|
||
|
|
|
||
|
|
Copy any of these files and modify parameters to create your own profile:
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cp configs/default.yaml configs/my-custom.yaml
|
||
|
|
# Edit my-custom.yaml with your preferred settings
|
||
|
|
python main.py input_video.mp4 output_dir configs/my-custom.yaml
|
||
|
|
```
|
||
|
|
|
||
|
|
## Parameter Tuning Guide
|
||
|
|
|
||
|
|
### Increasing Sensitivity (detect more movement)
|
||
|
|
- Decrease `threshold` (e.g., 4-5)
|
||
|
|
- Decrease `min_area` (e.g., 100-200)
|
||
|
|
- Decrease `minLayerLength` (e.g., 20-30)
|
||
|
|
|
||
|
|
### Decreasing Sensitivity (reduce noise)
|
||
|
|
- Increase `threshold` (e.g., 10-15)
|
||
|
|
- Increase `min_area` (e.g., 500-1000)
|
||
|
|
- Increase `minLayerLength` (e.g., 60-100)
|
||
|
|
- Increase `avgNum` (e.g., 15-20)
|
||
|
|
|
||
|
|
### Improving Performance
|
||
|
|
- Decrease `resizeWidth` (e.g., 480-600)
|
||
|
|
- Decrease `videoBufferLength` (e.g., 100-150)
|
||
|
|
- Decrease `avgNum` (e.g., 5)
|
||
|
|
|
||
|
|
### Handling Outdoor Scenes
|
||
|
|
- Increase `avgNum` (e.g., 15-20) to smooth out clouds/leaves
|
||
|
|
- Increase `threshold` (e.g., 10-12)
|
||
|
|
- Increase `ttolerance` (e.g., 80-100) for wind-affected objects
|