Skip to main content

GNSS processing engine benchmarking data set

This repository contains several datasets to compute the performance of a GNSS processing engine. This repository has been developed to help Rokubun Jason users to assess the expected performance of the platform. However, the orchestrator can be also used to test your own engine.

The repository includes also a tool to run the complete pipeline. Pandoc and textlive packages are required. To do that, simply use these commands:

apt-get update
apt-get install -y pandoc texlive
pip install gnss-benchmark
gnss_benchmark make_report

This tool will take a while to process (ca. 5 minutes), and after that a PDF report should have been generated.

Note that if you do not have LaTEX installed in your system you may not be able to generate the report in PDF. In this case, you can try other formats such as LibreOffice ODT. To do that type

gnss_benchmark make_report --filename report.odt

Use the help of the tool to get more information

gnss_benchmark -h

Running and developing in a container

To make sure you have all necessary components in the system, you can work using Docker containers (recommended).

The first step would be to build the container

docker build -t gnss-benchmark .
# Usage with docker run
docker run -v `pwd`:/gnss_benchmark -w /gnss_benchmark -ti gnss-benchmark bash

# Development with Jupyter
docker run --env-file .env -v `pwd`:/data -w /data -p 8888:8888 -ti gnss-benchmark jupyter notebook

# Usage with docker compose (recommended)
docker-compose -f docker-compose.yml build
docker-compose -f docker-compose.yml run gnss_benchmark bash
python setup.py install
gnss_benchmark make_report -l DEBUG

When using docker-compose remember to place your Jason credentials in an .env file with these contents:

JASON_API_KEY=<api key>
JASON_SECRET_TOKEN=<your secret token>

Although probably not used for the end user, just for debugging purposes, in the event that you have a local instance of the Jason service running in your facilities, you can set the Jason entry point by defining the JASON_API_URL environment variable (along with its corresponding credentials). As an example:

JASON_API_URL=http://192.168.1.54:10000/api
JASON_API_KEY=<api key>
JASON_SECRET_TOKEN=<your secret token>

Using custom processing engine

By default, the tool comes bundled with Rokubun Jason's processing engine, but the user can specify its own processing engine. This cannot be done with the command line tool: a custom Python code will have to be made using the gnss_benchmark module. In this module, there is a package named jason with an example of processing_engine that the user can follow to define other processing engines.

Metadata

Release files for gnss-benchmark 2.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gnss-benchmark 2.3.0
File Size Uploaded Provenance
gnss-benchmark-2.3.0.tar.gz 50.8 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for gnss-benchmark 2.3.0
File Interpreter ABI Platform
gnss_benchmark-2.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 103.8 MB

Release files / gnss-benchmark-2.3.0.tar.gz

Download URL gnss-benchmark-2.3.0.tar.gz
Size 50.8 MB
Tags Source
SHA-256 checksum
How to use checksums
c0b07de44c87989a2d5c7808f34e1ebc64435dc0648df33fde732b897e7144fa
BLAKE2b-256 checksum
How to use checksums
c1ece8891379244637ab11e835ecb096ca2626644803a956419a18c781b0f6ff
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0

Release files / gnss_benchmark-2.3.0-py3-none-any.whl

Download URL gnss_benchmark-2.3.0-py3-none-any.whl
Size 53.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
75a0a69642e5d5f863ac8e7d9bd2fc9c9d2444eb70b539a9da3ec93128054e0f
BLAKE2b-256 checksum
How to use checksums
ebc30aed42acfa08660672eee12977f0ad4671d27554b97041a5a34452870afb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0

Security for gnss-benchmark 2.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page