CONFIGURATION INDEX
| Item | Configuration |
|---|---|
| Document | wind.html |
| Markdown source / build | wind_R02.md / B261109 |
| File revision / build | R004 / B261109 |
| Content revision / build | R001 / B261013 |
| Date | 2026-11-09 |
| Approved source application | SPOTMAP v0.9.9R01 FIX1 |
| Standalone application | n/a |
| Source display / package build | B261013 / 2026101303 |
| Standalone package build | n/a |
| Status | Prepared for project-owner review; not uploaded. |
Generic information
- The offline app help stays available even when not connected to internet.
- The online web help requires an internet connection.
- This is a reference tool only and not a substitute for knowledge, experience or approved operational data; always strictly use, adhere, follow and verify with approved operational data.
- If you do not have a FULL understanding of the tool, do not use it!
How to use the help section
🔴Disclaimer: A disclaimer is a legal statement designed to limit a company's liability or specify the boundaries of a product's warranty. It informs the user about what the product or company is not responsible for, or clarifies that certain information (like third-party software updates) is outside of the company's control. Impact: Legal/Financial. It protects the organization from lawsuits and sets realistic expectations for the product's performance or usage.
⚠️Warning: A warning alerts the user to potential hazards that could result in personal injury, death, severe data loss, or permanent damage to equipment. It is the most critical type of callout and must clearly explain the hazard, the consequences of ignoring it, and how to avoid it. Impact: High. Ignoring a warning can lead to physical harm or catastrophic system failure, or both.
🔼 Note: A note provides helpful, non-critical information to the user. It emphasizes points, clarifies steps, or offers background context that is not essential to completing the main task but improves the user's understanding. Impact: Low. Ignoring a note will not cause harm, damage, or data loss.
INTRODUCTION
WIND FROM TURN estimates a wind vector (direction and speed) from changes in GPS motion during a turn. It reports wind direction/speed and data quality, and can add a reviewed result to the SPOTMAP map.
BASIC USAGE
Open WIND from the main toolbar. It uses SPOTMAP's existing location feed independently of whether the main track recorder is recording.
1. LEFT, RIGHT, SETUP, and HELP
Choose LEFT or RIGHT for the turn direction to detect. SETUP opens saved detection, GPS, framing, and arrow settings; these are explained below. HELP or ? opens the offline guide.
2. REFERENCE BANK
Use − and + to select a reference bank from 5° to 60°, in 5° steps. The initial default is 20°. This is a user-selected reference for the illustrative no-wind circle, not a measured bank angle or a command to fly a particular bank.
3. SOURCE, PLAY, and replay speed
Choose SPOTMAP GPS for the live location feed. A supported external receiver must already be supplying that feed; WIND does not pair directly to a receiver or start a second GPS service.
The source list also includes clean/rough simulations, GPS-gap simulations, straight flight, and recorded replays. For these, tap PLAY and select 1×, 4×, or 8× playback as available.
🔼 Note: Replays feed only the Wind tool. They do not move SPOTMAP's live ownship, record a host GPS track, create a POI, or trigger cameras. A replay result sent to the map remains labeled SIMULATION.
4. BASELINE and ARMED
The tool first acquires a straight-motion reference. The initial default is 3 seconds, with at least three distinct usable fixes spanning the selected interval. Three fixes at roughly 1 Hz normally span about two seconds, so they do not by themselves complete a three-second baseline.
BASELINE fills as the reference qualifies. It can pause at 90% while readiness conditions remain unmet. ARMED turns green when ready. The detector then waits for the selected turn without an overall attempt timeout.
Small pre-turn corrections can update the reference. A GPS/provider or timestamp discontinuity may require a fresh baseline. Read the live state message when progress pauses.
5. Turn detection, progress, and completion
The default detector needs at least a 5° track change in the selected direction and a sustained 3°/s rate for 2 seconds. Track is direction over the ground, not aircraft nose heading. The detector uses a short motion window, separate from the longer position-to-velocity window used for the wind fit.
Once detected, the reference freezes at the buffered turn-start position. The TURN bar has ten segments. Early progress uses filtered track change, capped at 90%; once a circle fit is accepted, fitted directional coverage controls completion. With the default 300° coverage target, each segment corresponds approximately to 30° of fitted coverage. Lit segments do not move backward, and all ten require reaching the fitted target.
Automatic rollout is considered after the coverage target. The default requires at least two seconds at or below the smaller of the 3°/s rollout limit and half the established turn rate. A full TURN bar can therefore wait for rollout.
COMPLETED is green when the attempt ends with a numerical estimate and red when it ends without one. A green indicator does not establish high quality. A manually finished attempt can have partial TURN coverage and still produce a numerical result.
⚠️Warning: The estimator assumes approximately steady wind and airspeed during the turn. Changing airspeed can imitate a wind change. The reference circle and progress indicators are explanatory displays, not flight guidance.
6. Map and no-wind reference
The light-gray circle and tangent line use selected bank and averaged ground speed. They illustrate a theoretical no-wind turn and do not supply wind information to the estimator.
Before usable speed is available, an unscaled side preview confirms LEFT/RIGHT. Once the baseline is ready, the map scale locks. During measurement it stays Track Up and centered on the latest GPS point. After a result, it centers on the wind-arrow tip and holds the completion orientation. The magenta dot still shows the actual GPS position.
The current initial framing defaults include 25 seconds of straight distance before and after the turn, plus 25% margin. Saved preferences can differ. A large speed change or a different flown path may put part of the reference outside the fixed view; RESTART acquires a new reference and scale. Resizing the window changes the available rectangle, not the locked geographic span.
7. Wind result and DETAILS
Read wind FROM true north, speed in knots, and the quality score. The arrow points downwind: wind from 270° points toward 090°. Below 0.5 kt, direction is shown as indeterminate and a point replaces the directional arrow.
The arrow's nose is anchored at the estimated turn-start position. Its shaft extends upwind, with length proportional to the configured display scale. The initial arrow color is orange #F5AD27.
Open DETAILS for the fit, coverage, interruptions, stability information, and weak-direction indications. Light wind can have an uncertain direction even when the overall fit score is high.
| Rating | Score / 100 |
|---|---|
| Perfect | 99–100 |
| Very Good | 80–98 |
| Good | 70–79 |
| Fair | 60–69 |
| Poor | 50–59 |
| Very Poor | 40–49 |
| Bad | 30–39 |
| Very Bad | 20–29 |
| Inconclusive | 0–19 |
🔼 Note: Quality describes support for the fit from the recorded data: scatter, coverage, geometry, sample support, GPS continuity, and sensitivity to alternative fits. It is not a probability of accuracy or a calibrated wind-error bound. “Perfect” is the highest score label, not a guarantee. Inconclusive can accompany a numerical estimate; insufficient data means no adequately constrained solution is available.
8. RESTART, FINISH NOW, and SEND TO MAP
- RESTART ends the current attempt and starts a new baseline. It keeps preferences and winds already sent to the map.
- FINISH NOW requests a result from the data already collected. A partial attempt may yield a lower-quality estimate or no solution; it does not manufacture missing turn data.
- SEND TO MAP appends the available result to the current SPOTMAP workspace. Review direction, speed, quality, source, and simulation status first.
Sent winds are independent retained records and cannot be removed individually. They remain through card closure, RESTART, source/setting changes, and START/PAUSE/STOP. Starting another recording after STOP retains workspace winds with their original provenance. NEW SESSION clears the workspace's sent winds.
The map label, such as 343°/14kt (Q97%), reports rounded wind FROM true, rounded speed, and quality. Q97% means 97/100 in this quality scale, not a 97% probability of accuracy.
9. EXPORT TEST and session export
EXPORT TEST creates a ZIP for the latest/current or recovered diagnostic attempt, including an unfinished attempt. It includes GPS samples, settings, result, state events, and the detection stream. Use it when reporting a measurement issue. Copies remain under Documents / SPOTMAP Wind / Exports.
The main EXPORT → KMZ includes all sent winds in the selected session snapshot, each with its measurement track and metadata. Unsent attempts are excluded. JSON retains complete sent-wind records. Winds sent after an export starts belong to the next snapshot.
10. WIND SETUP — controls and initial defaults
These defaults describe the current referenced source. The app retains saved settings, so check the values actually shown. Changes apply to the next attempt.
| Setting | Initial default | Purpose |
|---|---|---|
| Straight baseline | 3 s | Required straight reference interval. |
| Return tolerance | 15° | Allowed return-to-start track difference for target assessment. |
| Turn detect rate | 3°/s | Minimum rate used to recognize turn onset. |
| Coverage target | 300° | Required fitted directional coverage for automatic rollout evaluation. |
| Minimum track change | 5° | Directional change needed before turn confirmation. |
| Turn confirmation | 2 s | Duration required to confirm turn onset. |
| Rollout rate limit | 3°/s | Upper configured rate used in rollout detection. |
| Rollout confirmation | 2 s | Duration required to confirm reduced turn rate. |
| Straight-flight rate limit | 2°/s | Baseline straightness criterion. |
| Straight-track scatter limit | 10° | Baseline track-scatter criterion. |
| Baseline speed variation | 0.20 | Fractional speed variation allowed for the reference. |
| Groundspeed averaging | 5 s | Averaging interval for reference ground speed. |
| Position-to-velocity window | 5 s | Position regression interval used for fit velocities. |
| GPS recovery limit | 8 s | In-turn interruption allowance before finishing with available data. |
| Maximum position uncertainty | 200 m | Maximum accepted reported horizontal uncertainty. |
| Maximum fix age | 10 s | Maximum accepted age of a location sample. |
| Straight distance before turn | 25 s at average GS | Reference framing before the turn. |
| Straight distance after turn | 25 s at average GS | Reference framing after the turn. |
| Extra framing margin | 25% | Extra space around the framed reference. |
| Visible shaft length | 30 m/kt | Arrow display scale. |
| Arrow color | #F5AD27 |
Wind-arrow color. |
RESTORE DEFAULTS loads the default settings into the setup panel. SAVE stores the panel's settings; use RESTART to apply them to a new attempt. CANCEL discards panel edits. Changing detection criteria changes how the data are selected; it does not improve the underlying GPS observations. The setup fields display their accepted ranges.
11. GPS interruptions, closing, and recovery
The lower usable ground-speed limit is 3 kt. No velocity is calculated across a GPS gap. Before a turn, a loss of usable GPS requires recovery and a fresh reference. During a turn, an interruption beyond the selected recovery limit ends the attempt using any usable collected data. GPS HOLD pauses progress while the tool waits.
Tap the top-right X to return to SPOTMAP. The current attempt remains available and can continue while SPOTMAP is active. Locking the iPad or switching apps interrupts Wind sampling and is handled as a gap on return; the main recorder controls its own background behavior separately.
Settings and diagnostic attempts are saved separately under SPOTMAP Wind. Live raw fixes also append to GPS_Journals. Extended attempts may reduce display/fitting samples; diagnostic metadata records this, and the full live journal remains available in Files.
After relaunch, Wind begins a fresh attempt rather than silently resuming an interrupted calculation. Recovery of an unfinished main session can restore its saved sent winds; a fresh session does not import old-session winds automatically.
ABBREVIATION
- GPS — Global Positioning System.
- GS — Ground Speed.
- JSON — JavaScript Object Notation.
- KMZ — A ZIP archive containing KML and any packaged resources.
- kt — Knot.
- m — Meters.
- POI — Point of Interest.
- Q — Quality index, from 0 to 100 in this tool.
- s — Seconds.
- UTC — Coordinated Universal Time.
- °/s — Degrees per second.
DEFINITION
- Baseline — The usable straight-motion reference acquired before turn detection.
- Armed — Ready to recognize the selected turn.
- Coverage — The range of directions supporting the fitted velocity circle; this is separate from SWATH ground coverage.
- Rollout — The reduction in detected ground-track turn rate used to end an attempt automatically.
- Wind FROM — The direction from which the estimated wind originates.
- Downwind — The direction toward which that wind vector points.
- Reference bank — The selected bank angle used for illustration, not a measured attitude.
- Quality index — A data-support score for the fit, not a probability of correctness.
- Sent wind — A reviewed result appended to the current main workspace.
- Replay — Recorded or simulated samples used inside WIND instead of live GPS.
