diff --git a/README.rst b/README.rst index 4e88878..b0bddba 100644 --- a/README.rst +++ b/README.rst @@ -1,52 +1,55 @@ The Python ADS-B/Mode-S Decoder =============================== -If you find this project useful for your research, please considering cite this tool as:: - - @article{sun2019pymodes, - author={J. {Sun} and H. {V\^u} and J. {Ellerbroek} and J. M. {Hoekstra}}, - journal={IEEE Transactions on Intelligent Transportation Systems}, - title={pyModeS: Decoding Mode-S Surveillance Data for Open Air Transportation Research}, - year={2019}, - doi={10.1109/TITS.2019.2914770}, - ISSN={1524-9050}, - } +PyModeS is a Python library designed to decode Mode-S (including ADS-B) message. It can be imported to your python project or used as a standalone tool to view and save live traffic data. +This is a projected created by Junzi Sun, who works at `TU Delft `_, `Aerospace Engineering Faculty `_, `CNS/ATM research group `_. It is supported by a number of `contributors `_ from different institutions. Introduction ---------------------- -PyModeS is a Python library designed to decode Mode-S (including ADS-B) message. It can be imported to your python project or be used as a standalone tool to view and save live traffic data. +------------ + +pyModeS supports the decoding of following types of messages: -Messages with following Downlink Formats (DF) are supported: +- DF4 / DF20: Altitude code +- DF5 / DF21: Identity code (squawk code) -**DF17 / DF18: Automatic Dependent Surveillance-Broadcast (ADS-B)** +- DF17 / DF18: Automatic Dependent Surveillance-Broadcast (ADS-B) -- TC=1-4 / BDS 0,8: Aircraft identification and category -- TC=5-8 / BDS 0,6: Surface position -- TC=9-18 / BDS 0,5: Airborne position -- TC=19 / BDS 0,9: Airborne velocity -- TC=28 / BDS 6,1: Airborne status [to be implemented] -- TC=29 / BDS 6,2: Target state and status information [to be implemented] -- TC=31 / BDS 6,5: Aircraft operational status [to be implemented] + - TC=1-4 / BDS 0,8: Aircraft identification and category + - TC=5-8 / BDS 0,6: Surface position + - TC=9-18 / BDS 0,5: Airborne position + - TC=19 / BDS 0,9: Airborne velocity + - TC=28 / BDS 6,1: Airborne status [to be implemented] + - TC=29 / BDS 6,2: Target state and status information [to be implemented] + - TC=31 / BDS 6,5: Aircraft operational status [to be implemented] +- DF20 / DF21: Mode-S Comm-B messages -**DF20 / DF21: Mode-S Comm-B replies** + - BDS 1,0: Data link capability report + - BDS 1,7: Common usage GICB capability report + - BDS 2,0: Aircraft identification + - BDS 3,0: ACAS active resolution advisory + - BDS 4,0: Selected vertical intention + - BDS 4,4: Meteorological routine air report (experimental) + - BDS 4,5: Meteorological hazard report (experimental) + - BDS 5,0: Track and turn report + - BDS 6,0: Heading and speed report -- BDS 1,0: Data link capability report -- BDS 1,7: Common usage GICB capability report -- BDS 2,0: Aircraft identification -- BDS 3,0: ACAS active resolution advisory -- BDS 4,0: Selected vertical intention -- BDS 4,4: Meteorological routine air report (experimental) -- BDS 4,5: Meteorological hazard report (experimental) -- BDS 5,0: Track and turn report -- BDS 6,0: Heading and speed report -**DF4 / DF20: Altitude code** +If you find this project useful for your research, please considering cite this tool as:: + + @article{sun2019pymodes, + author={J. {Sun} and H. {V\^u} and J. {Ellerbroek} and J. M. {Hoekstra}}, + journal={IEEE Transactions on Intelligent Transportation Systems}, + title={pyModeS: Decoding Mode-S Surveillance Data for Open Air Transportation Research}, + year={2019}, + doi={10.1109/TITS.2019.2914770}, + ISSN={1524-9050}, + } + -**DF5 / DF21: Identity code (squawk code)** Resources