Building instructions

If packages are not available on your system, you can build Datoviz yourself.

Ubuntu 24.04

# Install the build and system dependencies.
sudo apt install build-essential cmake gcc ccache ninja-build xorg-dev clang-format patchelf tree libtinyxml2-dev libfreetype-dev

# Install just, see https://github.com/casey/just
curl --proto '=https' --tlsv1.2 -sSf https://just.systems/install.sh | bash

# Clone the Datoviz repo and build.
git clone https://github.com/datoviz/datoviz.git --recursive
cd datoviz

# Build Python requirements
pip install -r requirements-dev.txt

# NOTE: this call will fail, but the build will succeed the second time.
# Fix welcome (see https://github.com/Chlumsky/msdf-atlas-gen/issues/98)
just build

# That one should succeed.
just build

# Try a demo.
just demo

# Compile and run a C example.
just example scatter

# Run the demo from Python.
python -c "import datoviz; datoviz.demo()"

macOS (arm64)

# Install brew if you don't have it already.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
(echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> ~/.zprofile
    eval "$(/opt/homebrew/bin/brew shellenv)"

# Install build dependencies.
brew install just cmake ccache ninja freetype clang-format tree cloc

# Clone the Datoviz repo.
git clone https://github.com/datoviz/datoviz.git --recursive
cd datoviz

# Build Python requirements
pip install -r requirements-dev.txt

# NOTE: this call will fail, but the build will succeed the second time.
# Fix welcome (see https://github.com/Chlumsky/msdf-atlas-gen/issues/98)
just build

# That one should succeed.
just build

# Try a demo.
just demo

# Compile and run a C example.
just example scatter

# Run the demo from Python.
python -c "import datoviz; datoviz.demo()"

macOS (Intel x86-64)

# Install brew if you don't have it already.
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
(echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> ~/.zprofile
    eval "$(/opt/homebrew/bin/brew shellenv)"

# Install build dependencies.
brew install just cmake ccache ninja freetype clang-format tree cloc

# Clone the Datoviz repo.
git clone https://github.com/datoviz/datoviz.git --recursive
cd datoviz

# Build Python requirements
pip install -r requirements-dev.txt

# NOTE: this call will fail, but the build will succeed the second time.
# Fix welcome (see https://github.com/Chlumsky/msdf-atlas-gen/issues/98)
just build

# That one should succeed.
just build

# Try a demo.
just demo

# Compile and run a C example.
just example scatter

# Run the demo from Python.
python -c "import datoviz; datoviz.demo()"

Windows

Note: we have less experience with Windows, improvements welcome.

Requirements:

• Git for Windows.
• WinLibs: download and install the latest gcc UCRT version with POSIX threads..
• just.
• LunarG Vulkan SDK for Windows.
• WSL2.
• vcpkg. The VCPKG_ROOT environment variable should be set and should be in the PATH.
• Python (e.g. conda).

Instructions:

1. Copy the decompressed just.exe into C:\mingw64\bin (which should have been created by WinLibs).
2. Open a Git Bash terminal.
3. Add this to your ~/.bash_profile: export VCPKG_ROOT=/path/to/vcpkg after putting the path to vcpkg.
4. Clone the Datoviz GitHub repository in a folder.
5. Go to that folder in the terminal.
6. Type:

wsl.exe --install
wsl.exe --update
pip install -r requirements-dev.txt
just build  # this one may fail, try again below:
just build
# Try the builtin demo.
build\datoviz.exe demo
# Try running the demo from Python.
python -c "import datoviz; datoviz.demo()"