private-jets

Track and quantify emissions of private jets

https://github.com/jorgecardleitao/private-jets

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
    Links to: nature.com
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (6.1%) to scientific vocabulary

Keywords

private-jets
Last synced: 10 months ago · JSON representation

Repository

Track and quantify emissions of private jets

Basic Info
  • Host: GitHub
  • Owner: jorgecardleitao
  • License: mit
  • Language: Rust
  • Default Branch: main
  • Homepage:
  • Size: 342 KB
Statistics
  • Stars: 43
  • Watchers: 2
  • Forks: 4
  • Open Issues: 0
  • Releases: 2
Topics
private-jets
Created over 2 years ago · Last pushed 12 months ago
Metadata Files
Readme License

README.md

Private jet flights

Test Coverage

This repository contains a CLI application to analyze flights of private jets.

It is supported by an S3 Blob storage container for caching data, thereby reducing its impact to https://adsbexchange.com/.

It resulted in a scientific publication in Communications Earth & Environment paper, and a bunch of press about it:

How to use the data

The data is available in an https/s3 endpoint. See analysis.sql for an example of how to use it (in duckdb SQL).

```bash pip install duckdb

python3 run_sql.py analysis.sql ```

See methodology.md for details of the full methodology and where data is available for consumption at different levels of aggregations.

Contributing

Risk and impact

This code performs API calls to https://adsbexchange.com/, a production website of a company.

Use critical thinking when using this code and how it impacts them.

We strongly recommend that if you plan to perform large scale analysis (e.g. in time or aircrafts), that you reach out via an issue before, so that we can work together to cache all hits to https://adsbexchange.com/ on an horizontally scaled remote storage and therefore remove its impact to adsbexchange.com of future calls.

All cached data is available on S3 blob storage at endpoint

https://private-jets.fra1.digitaloceanspaces.com

and has anonymous and public read permissions. See methodology.md for details.

How to use

  1. Install Rust
  2. run cargo run --features="build-binary" --release --bin etl_aircrafts
  3. open database/aircraft/db/date=<today date>/data.csv

Step 2. has an optional arguments, --access-key, --secret-access-key, specifying credentials to write to the remote storate, as opposed to disk.

In general:

  • Use the default parameters when creating ad-hoc stories
  • Use --access-key when improving the database with new data.

As of today, the flag --access-key is only available to the owner, as writing to the blob storage must be done through a controlled code base that preserves data integrity.

Examples

Licence

MIT, see LICENSE.md

Owner

  • Login: jorgecardleitao
  • Kind: user

GitHub Events

Total
  • Watch event: 24
  • Delete event: 2
  • Issue comment event: 4
  • Push event: 9
  • Pull request event: 6
  • Fork event: 2
  • Create event: 3
Last Year
  • Watch event: 24
  • Delete event: 2
  • Issue comment event: 4
  • Push event: 9
  • Pull request event: 6
  • Fork event: 2
  • Create event: 3

Committers

Last synced: 11 months ago

All Time
  • Total Commits: 80
  • Total Committers: 3
  • Avg Commits per committer: 26.667
  • Development Distribution Score (DDS): 0.088
Past Year
  • Commits: 11
  • Committers: 3
  • Avg Commits per committer: 3.667
  • Development Distribution Score (DDS): 0.273
Top Committers
Name Email Commits
jorgecardleitao 1****o 73
Jorge Leitao j****o@g****m 6
Milan Klöwer m****r@g****e 1
Committer Domains (Top 20 + Academic)
gmx.de: 1

Issues and Pull Requests

Last synced: 11 months ago

All Time
  • Total issues: 1
  • Total pull requests: 70
  • Average time to close issues: 11 days
  • Average time to close pull requests: 2 days
  • Total issue authors: 1
  • Total pull request authors: 2
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.59
  • Merged pull requests: 69
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 3
  • Average time to close issues: N/A
  • Average time to close pull requests: about 20 hours
  • Issue authors: 0
  • Pull request authors: 2
  • Average comments per issue: 0
  • Average comments per pull request: 1.67
  • Merged pull requests: 3
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • marta-ov (1)
Pull Request Authors
  • jorgecardleitao (117)
  • milankl (2)
Top Labels
Issue Labels
Pull Request Labels

Dependencies

Cargo.toml cargo