Commit 411dfac
committed
docs: Document --force-export flag and clarify filtering thresholds
UPDATES:
1. README.md - Smart export filtering section
- Added note about gyro range detection (<500 = ground test)
- Documented MIN_GYRO_RANGE = 500.0 threshold
- Clarified --force-export behavior
- Added explanation of filtering rationale
2. OVERVIEW.md - Smart Export Filtering section
- Updated with accurate threshold values:
* FALLBACK_MIN_FRAMES = 7_500 (not 15,000)
* MIN_GYRO_RANGE = 500.0 (not 1500.0)
- Documented conservative filtering philosophy
- Clarified --force-export as override for all filtering
RATIONALE:
The PR description feedback (CodeRabbit analysis) noted that thresholds were
lowered in later commits but PR description still referenced original values.
This update ensures:
- Documentation reflects actual implementation
- Users understand filtering behavior and thresholds
- --force-export is prominently documented as escape hatch
- Conservative approach (prefer false negatives) is explained
THRESHOLDS EXPLAINED:
✅ FALLBACK_MIN_FRAMES = 7_500
- Allows short flights (~5 seconds) to be captured
- Conservative: balances noise reduction with data preservation
- Catches very short test arming but not legitimate flights
✅ MIN_GYRO_RANGE = 500.0
- Ground tests: <500 (sensor noise only)
- Gentle/beginner flights: >500 (actual movement)
- Conservative: some 500-1000 range marginal logs export
- Trade-off: safer to export marginal than skip real data1 parent 8ab34e7 commit 411dfac
2 files changed
Lines changed: 9 additions & 3 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
118 | 118 | | |
119 | 119 | | |
120 | 120 | | |
121 | | - | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
122 | 125 | | |
123 | | - | |
| 126 | + | |
124 | 127 | | |
125 | 128 | | |
126 | 129 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
64 | 64 | | |
65 | 65 | | |
66 | 66 | | |
| 67 | + | |
67 | 68 | | |
68 | | - | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
69 | 72 | | |
70 | 73 | | |
71 | 74 | | |
| |||
0 commit comments