https://github.com/euctrl-pru/trrrj

R 📦 to analyse flight ✈️ trajectories
https://github.com/euctrl-pru/trrrj

aviation flight-trajectories r r-package rstats trajectories

Last synced: 9 days ago
JSON representation

R 📦 to analyse flight ✈️ trajectories

• Host: GitHub
• URL: https://github.com/euctrl-pru/trrrj
• Owner: euctrl-pru
• License: other
• Created: 2019-07-06T09:12:34.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-04-12T09:56:11.000Z (8 months ago)
• Last Synced: 2024-08-13T07:11:43.278Z (4 months ago)
• Topics: aviation, flight-trajectories, r, r-package, rstats, trajectories
• Language: R
• Homepage: https://trrrj.ansperformance.eu/
• Size: 41.6 MB
• Stars: 12
• Watchers: 3
• Forks: 3
• Open Issues: 8
• Metadata Files:
  • Readme: README.Rmd
  • Changelog: NEWS.md
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - euctrl-pru/trrrj - R 📦 to analyse flight ✈️ trajectories (R)

README

        
---

output: github_document

---

```{r, echo = FALSE}

knitr::opts_chunk$set(

  collapse = TRUE,

  comment = "#>",

  fig.path = "man/figures/README-"

)

```

# trrrj

[![R Render README](https://github.com/euctrl-pru/trrrj/workflows/Render README/badge.svg)](https://github.com/euctrl-pru/trrrj/actions)

[![R build status](https://github.com/euctrl-pru/trrrj/workflows/R-CMD-check/badge.svg)](https://github.com/euctrl-pru/trrrj/actions)

[![pkgdown deploy](https://github.com/euctrl-pru/trrrj/workflows/pkgdown/badge.svg)](https://github.com/euctrl-pru/trrrj/actions)

[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://www.tidyverse.org/lifecycle/#experimental)

**THIS IS WORK IN PROGRESS: use at your own risk.**

The `{trrrj}` package provides facilities to aid in the analysis of flight trajectories.

It is in contiuous flux both because new features are added but also because of users'

feedback.

If you want to contribute but you feel overwhelmed by the git/github scaffolding, please have a 

look at the `usethis` vignette "[Pull request helpers][prh]". It marvellously describes

a nice workflow and would make collaboration very easy and fruitful.

[prh]: https://usethis.r-lib.org/articles/articles/pr-functions.html

## Installation

`{trrrj}` is not yet available from CRAN, but you can install the development

version from github with:

```{r, eval = FALSE}

# install.packages("remotes")

remotes::install_github("euctrl-pru/trrrj")

```

## Usage

There are functions that allow you to:

* Load trajectories from various providers/sources:

    - [Flightradar24][fr24]'s archived/live feed files (ADS-B)

    - [Flightradar24][fr24]'s live feed from EUROCONTROL's DB (ADS-B)

    - [Network Manager][nm-cfmu]'s archived CPR files (see CPRs in the [Notes])

    - [DDR2][ddr2]'s SO6 trajectories from EUROCONTROL's DB (Flight plan and CPR based)

    - [OpenSky Network][osn]'s historical data, **removed** see [osn package](https://github.com/espinielli/osn)

* Plot trajectories

    - 2D plot

    - vertical profiles (time or distance based)

    

* Analyse trajectories (Under work: more to come!)

    - extract level flight segments

* Read/transform/*save your day*

    - parse Longitude/Latitude in various formats

    - determine the AIRAC cyle for a date or its range (ICAO or CFMU format); see AIRAC in the [Notes]

## Data

The package contains small data source files in order to

provide realistic examples and use cases for guides and vignettes.

## Tutorials and Guides et al.

The vignette [Plotting trajectories](https://trrrj.ansperformance.eu/articles/trrrj-plotting.html)

provides a good introduction on how to use the package.

The [`{osn}` package](https://github.com/espinielli/osn) can be used to access

the [OpenSky Network Data](osn).

## Notes

### CPRs

Correlated Position Reports (CPR) are position report provided by the ATC radar facilities.

They are *correlated* because they contain flight information

### AIRAC

An AIRAC (Aeronautical Information Regulation And Control) cycle is the 28-day period

that regulates the [pubblication of aeronautical information][airac]

[airac]:  "AIP - Aeronautical Information Publication"

[fr24]:  "Flightradar24"

[ddr2]:  "Demand Data Repository - EUROCONTROL"

[nm-cfmu]:  "Network Manager - EUROCONTROL"

[cpr]:  "Correlated Position Report"

[osn]:  "OpenSky Network"

### Building the documentation

# Development

In order to build the relevant `pkgdown` web pages while developing,

execute the following code:

```{r, eval=FALSE}

# How to build the pakgdown from behind proxied Internet

library(withr)

library(pkgdown)

with_options(list(pkgdown.internet = FALSE),

             build_site())

```