Skip to content

Commit

Permalink
Draft PR: Live Visualization (#11)
Browse files Browse the repository at this point in the history
* Added ability to select flight by its (FlightAware) "flight id" instead of (only by) tail number and date cutoff
* Correct AeroAPI altitude units to MSL, added 'featured' Galactic 02 flight to README
  • Loading branch information
noodnik2 authored Aug 13, 2023
1 parent a451a92 commit ffdfca8
Show file tree
Hide file tree
Showing 22 changed files with 1,865 additions and 125 deletions.
18 changes: 15 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,18 @@ $ fviz tracks --tailNumber N8050J --cutoffTime 2023-05-22T19:45:00-04:00 --launc
$ fviz tracks --tailNumber N81497 --flightCount 1 --launch
```

## Featured Flights

<details>
<summary><a href="https://en.wikipedia.org/wiki/Galactic_02">Virgin Galactic 02</a> Spaceflight</summary>

> See [this write-up](docs/featured/galactic02.md) about a visualization of
> [Galactic 02], the second commercial spaceflight of the American aerospace
> company [Virgin Galactic].
>
> ![Galactic 02 Flight Path](docs/featured/230813-VirginGalactic02-SkyPath.jpg)
</details>
## Packaging

Flight Visualizer is packaged into a standalone CLI command named `fviz`.
Expand Down Expand Up @@ -62,8 +74,6 @@ into your `PATH` from where it can be accessed.
Everything needed is contained in the single binary which is pre-built for popular operating systems
and included in the standard [Releases](https://github.com/noodnik2/flightvisualizer/releases).



### Configuration
In order to retrieve flight information using [AeroAPI], you'll need to obtain and install an API Key.
See the [AeroAPI] documentation to learn more about this.
Expand Down Expand Up @@ -199,7 +209,7 @@ The [output file produced by the command above](artifacts/fvk__230531150622Z-201
visualizes an [actual flight from Los Angeles to Maui](artifacts/fvt_SWA3774-1685372217-schedule-57p.json)
taken by some lucky vacationers on Southwest Airlines flight SWA3774 on May 31st.

## Enjoying Visualizations
## Other Visualizations

While [KML] is a standard "Markup Language," and is supported by many other geospatial applications (perhaps most
notably [Google Maps], [QGIS] and [ArcGIS Earth]), only [Google Earth] (as of this writing) appears to best support
Expand Down Expand Up @@ -265,3 +275,5 @@ mission and value-add: in this case, _vicarious aviation!_
[QGIS]: https://qgis.org
[Keyhole Markup Language]: https://www.ogc.org/standard/kml
[Microsoft Flight Simulator]: https://www.flightsimulator.com
[Galactic 02]: https://en.wikipedia.org/wiki/Galactic_02
[Virgin Galactic]: https://www.virgingalactic.com/
1 change: 1 addition & 0 deletions artifacts/fvf_N202VG_cutoff-20230810T100000-0600.json
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
{"flights":[{"ident":"VGX3","ident_icao":"VGX3","ident_iata":null,"fa_flight_id":"VGX3-1691670738-sw-1757p","operator":"VGX","operator_icao":"VGX","operator_iata":null,"flight_number":"3","registration":"N202VG","atc_ident":null,"inbound_fa_flight_id":null,"codeshares":[],"codeshares_iata":[],"blocked":false,"diverted":false,"cancelled":false,"position_only":false,"origin":{"code":"9NM9","code_icao":null,"code_iata":null,"code_lid":"9NM9","timezone":"America/Denver","name":"Spaceport America","city":"Truth Or Consequences","airport_info_url":"/airports/9NM9"},"destination":{"code":"9NM9","code_icao":null,"code_iata":null,"code_lid":"9NM9","timezone":"America/Denver","name":"Spaceport America","city":"Truth Or Consequences","airport_info_url":"/airports/9NM9"},"departure_delay":-15,"arrival_delay":-8132,"filed_ete":12060,"foresight_predictions_available":true,"scheduled_out":null,"estimated_out":null,"actual_out":null,"scheduled_off":"2023-08-10T14:30:00Z","estimated_off":"2023-08-10T14:30:00Z","actual_off":"2023-08-10T14:29:45Z","scheduled_on":"2023-08-10T17:51:00Z","estimated_on":"2023-08-10T15:35:28Z","actual_on":"2023-08-10T15:35:28Z","scheduled_in":null,"estimated_in":null,"actual_in":null,"progress_percent":100,"status":"Arrived","aircraft_type":"SS2","route_distance":308,"filed_airspeed":482,"filed_altitude":510,"route":"LOOBY TCS/D300 EBUTE","baggage_claim":null,"seats_cabin_business":null,"seats_cabin_coach":null,"seats_cabin_first":null,"gate_origin":null,"gate_destination":null,"terminal_origin":null,"terminal_destination":null,"type":"General_Aviation"}],"links":null,"num_pages":1}
Binary file not shown.
Binary file not shown.
Loading

0 comments on commit ffdfca8

Please sign in to comment.