1
0
mirror of https://github.com/gnss-sdr/gnss-sdr synced 2024-06-28 16:03:15 +00:00
gnss-sdr/src/utils/reproducibility/ieee-access18
Carles Fernandez 4d0d263280
Make the software package compliant with the REUSE Specification v3.0 (see https://reuse.software/spec/)
Update license headers to SPDX format (see https://spdx.org/)
Add license to all files
Add CI job in GitHub Actions to ensure compliance
2020-02-08 01:20:02 +01:00
..
L2-access18.conf Make the software package compliant with the REUSE Specification v3.0 (see https://reuse.software/spec/) 2020-02-08 01:20:02 +01:00
plot_dump.m Make the software package compliant with the REUSE Specification v3.0 (see https://reuse.software/spec/) 2020-02-08 01:20:02 +01:00
README.md Make the software package compliant with the REUSE Specification v3.0 (see https://reuse.software/spec/) 2020-02-08 01:20:02 +01:00

{::comment} SPDX-License-Identifier: GPL-3.0-or-later SPDX-FileCopyrightText: 2011-2020 Carles Fernandez-Prades carles.fernandez@cttc.es {:/comment} Continuous Reproducibility in GNSS Signal Processing

This folder contains files required for the reproduction of the experiment proposed in:

C. Fernández-Prades, J. Vilà-Valls, J. Arribas and A. Ramos, Continuous Reproducibility in GNSS Signal Processing, IEEE Access, Vol. 6, No. 1, pp. 20451-20463, April 2018. DOI: 10.1109/ACCESS.2018.2822835

The data set used in this paper is available at https://zenodo.org/record/1184601

The sample format is ibyte: Interleaved (I&Q) stream of samples of type signed integer, 8-bit twos complement number ranging from -128 to 127. The sampling rate is 3 MSps.

The figure appearing in that paper can be automatically generated with the pipeline available at https://gitlab.com/gnss-sdr/gnss-sdr/pipelines

After the Build stage, which compiles the source code in several versions of the most popular GNU/Linux distributions, and the Test stage, which executes GNSS-SDRs QA code, the Deploy stage creates and publishes an image of a software container ready to execute the experiment. This container is available by doing:

$ docker pull carlesfernandez/docker-gnsssdr:access18

Then, in the Experiment stage, a job installs the image created in the previous step, grabs the data file, executes the experiment and produces a figure with the obtained results.

The steps to reproduce the experiment in your own machine (with Docker already installed and running) are:

$ docker pull carlesfernandez/docker-gnsssdr:access18
$ docker run -it -v $PWD/access18:/home/access18 carlesfernandez/docker-gnsssdr:access18
$ git clone https://github.com/gnss-sdr/gnss-sdr
$ cd gnss-sdr
$ git checkout next
$ mkdir -p exp-access18/data
$ cd exp-access18/data
$ curl https://zenodo.org/record/1184601/files/L2_signal_samples.tar.xz --output L2_signal_samples.tar.xz
$ tar xvfJ L2_signal_samples.tar.xz
$ echo "3a04c1eeb970776bb77f5e3b7eaff2df  L2_signal_samples.tar.xz" > data.md5
$ md5sum -c data.md5
$ cd ..
$ cp ../src/utils/reproducibility/ieee-access18/L2-access18.conf .
$ cp ../src/utils/reproducibility/ieee-access18/plot_dump.m .
$ cp -r ../src/utils/matlab/libs/geoFunctions .
$ gnss-sdr --c=L2-access18.conf
$ octave --no-gui plot_dump.m
$ epspdf Figure2.eps Figure2.pdf
$ cp Figure2.pdf /home/access18/
$ exit

You will find the file Figure2.pdf in a newly created folder called access18.