Getting and building newsched

The following instructions describe how to create a prefix and install newsched into it

1. Set up a prefix

PREFIX=/path/to/my/prefix
mkdir -p $PREFIX/src 

Put the following contents into a file called setup_env.sh (and adjust python paths as necessary) - (This is copied from PyBOMBS)

# Store a variable with the path to the directory in which this file resides
DIR=/path/to/my/prefix #e.g. /opt/newsched_prefix/ or $HOME/newsched_prefix
# If sh is bash we can obtain this automatically
#DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )" 
export PATH="$DIR/bin:$PATH"
export PYTHONPATH="$DIR/lib/python3/site-packages:$DIR/lib/python3/dist-packages:$DIR/lib/python3.8/site-packages:$DIR/lib/python3.8/dist-packages:$DIR/lib64/python3/site-packages:$DIR/lib64/python3/dist-packages:$DIR/lib64/python3.8/site-packages:$DIR/lib64/python3.8/dist-packages:$PYTHONPATH"
export LD_LIBRARY_PATH="$DIR/lib:$DIR/lib64/:$DIR/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH"
export LIBRARY_PATH="$DIR/lib:$DIR/lib64/:$DIR/lib/x86_64-linux-gnu:$LIBRARY_PATH"
export PKG_CONFIG_PATH="$DIR/lib/pkgconfig:$DIR/lib64/pkgconfig:$PKG_CONFIG_PATH"

Every time a new terminal is launched where newsched is to be used, just call

source setup_env.sh

2. Install Dependencies

The following dependencies are necessary to build and run newsched

• Meson Build
• Ninja Build
• VOLK
• spdlog
• yamlcpp
• GTest
• FFTW
• C++17 capable compiler (g++9)
• flatbuffers (>=2.0.0)

Optionally

• Python3
• Numpy
• QT/QWT
• SoapySDR

Required for building VOLK

• CMake
• python3-mako

On Ubuntu 20.04, the following should be sufficient to get all the prerequisites installed

sudo apt-get update -q  && apt-get -y upgrade
sudo apt-get install -qy \
    build-essential \
    --no-install-recommends \
    libspdlog-dev \
    libyaml-cpp-dev \
    libgtest-dev \
    libfmt-dev \
    pybind11-dev \
    python3-dev \
    python3-numpy \
    libqwt-qt5-dev \
    ninja-build \
    libfftw3-dev \
    git \ 
    cmake \
    pkg-config \
    python3-pip

pip3 install meson mako

VOLK must be built from source

cd $PREFIX/src
git clone --recursive https://github.com/gnuradio/volk.git --branch v2.4.1
cd volk && mkdir build && cd build &&cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/prefix && make install -j8

Flatc must be built from source (used for PMT subproject)

cd $PREFIX/src
git clone https://github.com/google/flatbuffers.git /src/flatbuffers --branch v2.0.0
cd flatbuffers && mkdir build && cd build && cmake -DCMAKE_BUILD_TYPE=Release .. && make -j8 && make install 

3. Clone and build newsched

cd $PREFIX/src
git clone https://github.com/gnuradio/newsched
cd newsched
meson setup build --buildtype=debugoptimized --prefix=$PREFIX --libdir=lib
cd build
ninja
ninja test
ninja install

Installing from Packaging

TODO: build and distribute conda and ppa packages

Next: Setting up a Flowgraph