navigation

🛰 The navigation R package implements a framework to analyze the impact of sensor error modeling on performance of integrated navigation (sensor fusion) based on IMU, GPS, and barometer data.

https://github.com/smac-group/navigation

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
  • ✓
    DOI references
    Found 1 DOI reference(s) in README
  • ✓
    Academic publication links
    Links to: ieee.org
  • â—‹
    Committers with academic emails
  • â—‹
    Institutional organization owner
  • â—‹
    JOSS paper metadata
  • â—‹
    Scientific vocabulary similarity
    Low similarity (16.5%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

🛰 The navigation R package implements a framework to analyze the impact of sensor error modeling on performance of integrated navigation (sensor fusion) based on IMU, GPS, and barometer data.

Basic Info
Statistics
  • Stars: 5
  • Watchers: 2
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Created about 3 years ago · Last pushed about 3 years ago
Metadata Files
Readme Changelog

README.md

CRAN status Licence minimal R
version CRAN RStudio mirror
downloads CRAN RStudio mirror
downloads

navigation Overview

The navigation R package allows to analyze the impact of sensor error modeling on performance of integrated navigation (sensor fusion) based on IMU, GPS (generally speaking, GNSS), and barometer data. The package allows for one of the two major tasks:

  • Sensor model evaluation: The user shall provide a reference trajectory, along which the navigation performance is being evaluated using different sensor error models. Perfect sensor data along that reference trajectory are generated, and then corrupted by sensor error coming from either simulation based on the error models provided by user, or directly from user input (option to be added). Integrated navigation is then performed, whit a separately provided error model to be used within the Extended Kalman Filter (EKF). The user can easily introduce GPS outage periods, and there is a growing number of tools to visualize and summarize the results.

  • Integrated navigation (sensor fusion) As a natural by-product of the first main application, integrated navigation is also available to users. Providing only the sensor data and the sensor error model to be used within the navigation filter, the user is able to perform integrated navigation using the package and also benefit from a subset of visualization tools.

Caution A flat non-rotating Earth model is assumed throughout the package. We consider this not to be of major impact on sensor model evaluation, as the main contributor there are match/mismatch between the additive sensor errors and the provided error models to the navigation filter. For absolute navigation results though, is long distances and high speeds are involved, such simplifications start to have measurable impact on results. Also, attitude parameterization is done via Euler angles at the moment, bringing their interinsic limitations, such as the singularity at pitch $=\pm \pi/2$. This limitation may be resolved in future using other attitude parameterizations such as quaternions.

Installation Instructions

The navigation package is available on both CRAN and GitHub. The CRAN version is considered stable while the GitHub version is subject to modifications/updates which may lead to installation problems or broken functions. Note that the navigation package is currently in an early development phase. The user-available functions are stable while additional functions are still in development.

You can install the stable version of the navigation package with:

r install.packages("navigation")

For users who are interested in having the latest developments, the GitHub version is ideal although more dependencies are required to run a stable version of the package. Most importantly, users must have a (C++) compiler installed on their machine that is compatible with R (e.g. Clang).

``` r

Install dependencies

install.packages(c("devtools"))

Install/Update the package from GitHub

devtools::install_github("SMAC-Group/navigation")

Install the package with Vignettes/User Guides

devtools::installgithub("SMAC-Group/navigation", buildvignettes = TRUE) ```

External R libraries

The navigation package relies on a limited number of external libraries, but notably on Rcpp and RcppArmadillo which require a C++ compiler for installation, such as for example gcc.

Usage

Find detailed usage instructions, examples and the user's manual at the package website.

License

This source code is released under is the GNU AFFERO GENERAL PUBLIC LICENSE (AGPL) v3.0.

References

D. A. Cucci, L. Voirol, M. Khaghani and S. Guerrier, "On Performance Evaluation of Inertial Navigation Systems: the Case of Stochastic Calibration," in IEEE Transactions on Instrumentation and Measurement, doi: 10.1109/TIM.2023.3267360.

Owner

  • Name: Statistical Methods, Applications & Computing Group
  • Login: SMAC-Group
  • Kind: organization
  • Email: contact@smac-group.com

GitHub Events

Total
  • Watch event: 2
Last Year
  • Watch event: 2

Committers

Last synced: about 1 year ago

All Time
  • Total Commits: 102
  • Total Committers: 1
  • Avg Commits per committer: 102.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Lionel Voirol l****l@h****m 102

Issues and Pull Requests

Last synced: 12 months ago

All Time
  • Total issues: 1
  • Total pull requests: 0
  • Average time to close issues: about 21 hours
  • Average time to close pull requests: N/A
  • Total issue authors: 1
  • Total pull request authors: 0
  • Average comments per issue: 1.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • stefangachter (1)
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • cran 185 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 0
  • Total versions: 1
  • Total maintainers: 1
cran.r-project.org: navigation

Analyze the Impact of Sensor Error Modelling on Navigation Performance

  • Versions: 1
  • Dependent Packages: 0
  • Dependent Repositories: 0
  • Downloads: 185 Last month
Rankings
Stargazers count: 28.6%
Forks count: 28.8%
Dependent packages count: 29.4%
Dependent repos count: 35.1%
Average: 42.3%
Downloads: 89.6%
Maintainers (1)
Last synced: 11 months ago

Dependencies

.github/workflows/R-CMD-check.yaml actions
  • actions/checkout v3 composite
  • r-lib/actions/check-r-package v2 composite
  • r-lib/actions/setup-pandoc v2 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-r-dependencies v2 composite
.github/workflows/pkgdown.yaml actions
  • JamesIves/github-pages-deploy-action 4.1.4 composite
  • actions/checkout v2 composite
  • r-lib/actions/setup-pandoc v2 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-r-dependencies v2 composite
DESCRIPTION cran
  • R >= 4.0.0 depends
  • magrittr * depends
  • plotly * depends
  • simts * depends
  • MASS * imports
  • Rcpp >= 0.8.0 imports
  • RcppArmadillo >= 0.2.0 imports
  • expm * imports
  • leaflet * imports
  • pbmcapply * imports
  • rbenchmark * imports
  • knitr * suggests
  • rmarkdown * suggests