N499CP Flight Planner

N499CP Flight Planner — User Guide

A route planner, nav-log generator, and performance/W&B calculator built around N499CP (2020 Cessna 172S NAV III), CAP San Diego Sr. Sq. 57.

⚠️ SIM USE ONLY. This tool is for training and planning practice. Weather is partly simulated, terrain sampling is approximate, and airport/navaid data comes from the public OurAirports dataset. Always brief with official sources (1800wxbrief.com, ForeFlight, current charts, the POH) before any real flight.


1. Getting to the app

Where URL
Production (public) https://flightplanner.rpc-cyberflight.com
Cloud Run direct https://flight-planner-383916130890.us-west1.run.app
Local dev server http://192.168.50.236:5001 (or http://127.0.0.1:5001 on the host)

The app is a single page — no login. On first load it checks the aviation database; the status pill in the top-right shows either an airport count (e.g. 32,553 apts) or No data. If it is empty it downloads automatically; you can also force a refresh with the DB ↻ button.


2. The interface at a glance

The screen has four regions:

  1. Toolbar (top) — route input, cruise settings, the Fly button, and the tool buttons (Perf, W&B, Ref, DB ↻).
  2. Map (center) — the moving-map with chart layers and route editing.
  3. Layer switcher & map controls (over the map) — chart selection, Plan mode, Fit.
  4. Flight Log drawer (bottom) — slides up to show the nav log, weather, airport details, and terrain profile.

3. Building a route

3.1 The route box

Type a route as space-separated identifiers, departure first, destination last. The box auto-uppercases as you type.

KSEE JLI TRM KPSP

Three kinds of identifiers are accepted:

Type Example Notes
Airport (ICAO) KSEE, KPSP US airports from the OurAirports dataset.
Navaid JLI (Julian VORTAC), TRM (Thermal VORTAC) VORs, VORTACs, NDBs, etc.
User waypoint @33.0450,-116.5880 A raw @lat,lon point. You normally create these by dragging on the map (see §4.3) rather than typing them, but you can type them too. They appear in the log as USR1, USR2, …

At least two identifiers are required (a departure and a destination). Press Enter in the box or click Fly to calculate.

Note: RNAV named intersections (e.g. KAYOH, LIMBO) are not in the dataset — use nearby VORs/airports or drop a user waypoint at the fix's coordinates instead.

3.2 Cruise settings

Three dropdowns to the right of the route box drive the performance math:

3.3 Fly

Fly calculates the route and:


4. The map

4.1 Chart layers

The top-left switcher chooses the base layer:

FAA chart tiles are served from the FAA ArcGIS service (with any locally cached tiles used first).

4.2 Plan mode (click-to-add)

Click ✈ Plan (top-right of the map) to arm planning mode; the cursor becomes a crosshair. Click anywhere on the map and the app finds the nearest fixes within 20 NM and offers Dep / Wpt / Dest buttons to insert that fix into the route box in the chosen role. Click ✈ Planning again to disarm.

⊙ Fit re-centers and zooms the map to frame the whole active route.

4.3 Rubber-band route editing ⭐

This is the fastest way to shape a route directly on the map.

Midpoint handles — every route segment has a small white dot at its midpoint. Drag one to bend the route:

Existing waypoint markers are also draggable:

The green dot is the departure, the red dot is the destination, blue dots are intermediate waypoints.


5. The Flight Log drawer

Click the ▲ Flight Log tab at the bottom (or it opens automatically after Fly). Four tabs:

5.1 Log

Column Meaning
FROM / TO Leg endpoints
DIST Leg distance (NM, great-circle)
TC True course
WCA Wind correction angle
MH Magnetic heading — TC + WCA − magnetic variation. Variation now comes from the World Magnetic Model at each leg's midpoint (≈ 11° E in SoCal).
GS Ground speed (kt)
TIME Leg time (min)
FUEL Leg fuel (gal)

5.2 Weather

Loads automatically after a route calc. Shows METARs, TAFs, winds aloft, and NOTAM placeholders for each airport on the route.

METARs/TAFs are fetched live from aviationweather.gov when reachable; anything tagged (sim) is simulated. Winds aloft are real — GFS forecast winds from Open-Meteo at the route midpoint, interpolated to the standard altitudes (tagged with the source; they fall back to a deterministic estimate only if the service is unreachable). NOTAMs are still placeholders pointing you to notams.faa.gov. Always confirm with an official briefing.

5.3 Airports

Per-airport cards for the airports on your route: name/city/state, elevation, lat/lon, current flight category, raw METAR, and a runway table (runway, length, surface).

5.4 Terrain

An elevation profile sampled along the route (USGS elevation data):


6. Tools (toolbar buttons)

6.1 Perf

Takeoff and landing distances for N499CP from the POH tables. Enter weight (takeoff), pressure altitude, temperature, and headwind; get ground roll and distance over a 50 ft obstacle. The tables use conservative (round-up) interpolation and a simple headwind credit.

6.2 W&B (Weight & Balance)

Enter empty weight/moment and the loading (pilot, front pax, rear pax, baggage, fuel). The calculator returns total weight, CG, and moment, and checks limits:

6.3 Ref

A quick-reference card: V-speeds, weights, fuel, CG limits, and station arms.

Known discrepancy: the Ref card currently lists the old fixed forward CG limit (35.0") and a front-seat arm of 40.0". The W&B calculator uses the corrected sloped envelope and a 37.0" front-seat arm. When in doubt, trust the W&B calculator (and the POH). This card is slated to be updated.

6.4 DB ↻

Re-downloads the airport/runway/navaid database from OurAirports. Runs in the background with a progress modal; the app stays usable meanwhile.


7. Worked example — KSEE → JLI → TRM → KPSP

A short cross-country from Gillespie Field (KSEE) in El Cajon, over the Julian VORTAC (JLI), across to the Thermal VORTAC (TRM) in the Coachella Valley, and into Palm Springs (KPSP) — a nice mountains-to-desert VFR hop.

Step by step

  1. Open the app and confirm the DB pill shows an airport count (not "No data").
  2. In the route box, type:

KSEE JLI TRM KPSP

  1. Set Altitude to 9,500 ft (good terrain clearance over the Peninsular Ranges / San Jacinto area), leave RPM at 2400 (55%) and Reserve at 45 min.
  2. Press Fly.
  3. The route draws KSEE → JLI → TRM → KPSP and the Log drawer opens.

What you should see (illustrative)

Distances and courses are stable; times/fuel/headings depend on the current winds aloft (live GFS forecast), so your exact numbers will vary with the weather.

Leg Dist (NM) TC MH GS (kt) Time (min)
KSEE → JLI ~27 046° ~022° ~98 ~17
JLI → TRM ~36 036° ~014° ~95 ~23
TRM → KPSP ~21 305° ~301° ~88 ~14
Total ~85 ~74

Total fuel required ≈ 19 gal (taxi + climb + cruise + 45-min reserve) — well within the 53-gal usable, but always confirm with a real W&B and reserve plan.

Note the magnetic headings run about 11° less than the true courses — that's the ~11° E magnetic variation for Southern California being applied correctly.

Explore the rest


8. Civil Air Patrol Search & Rescue (SAR) Patterns

The flight planner incorporates specialized search pattern generators used in Civil Air Patrol aerial search missions, coupled with export options for flight simulators and the CAP V-SAR exercise console.

8.1 Accessing the SAR Tool

Click the SAR button in the main toolbar. This opens the SAR Pattern Generator dialog and enables interactive datum selection on the map.

8.2 Supported Search Patterns

  1. Expanding Square (SS): - Used when searching a concentrated area around a known datum (e.g., last known position or initial ELT alert location). - Parameters: Datum coordinates (lat/lon), track spacing (0.5–2.0 NM), number of legs, initial heading, and turn direction (Right or Left). - Generates sequential expansion legs (1×S, 1×S, 2×S, 2×S, 3×S, 3×S...) with calculated magnetic courses and leg distances.

  2. Creeping Line (CS): - Used when searching a route corridor, valley floor, or canyon where the target is likely located along a specific track. - Parameters: Start point, end point, sweep width (NM), track spacing (NM), and maximum legs. - Generates alternating orthogonal cross-track sweeps advancing along the route axis.

  3. Parallel Track (PS): - Used for systematic grid searches covering large rectangular areas or CAP quadrangles. - Parameters: Corner coordinate, search box length (NM), search box width (NM), axis heading, and track spacing (NM). - Generates parallel search tracks stepped across the search area.

8.3 Route Integration & Search Sortie Metrics

Clicking Apply to Route integrates the generated search waypoints (SS01, CS01, PS01...) into the active flight plan: - The route box is automatically populated with geodesic user coordinates (@lat,lon). - The nav-log drawer recomputes fuel burn, time-on-station, and terrain clearances for the search pattern using the aircraft POH performance polar. - The map visualizes the search grid overlaid against FAA VFR Sectionals and IFR enroute charts.

8.4 Exporting & Simulator Integration


Questions or fixes: this app lives at github.com/rpcraighead/flight-planner-n499cp-v2 (and Gitea internally). Fly safe, brief for real.