DroneDB is free and open source software for aerial data storage. It provides a convenient location to store images, orthophotos, digital elevation models, point clouds and vector files.

See it in action: https://hub.dronedb.app/r/odm/waterbury

Installation

Debian/Ubuntu

# Install from the latest release
sudo apt install ./ddb_X.Y.Z_amd64.deb

See Debian Package Documentation for more details.

Documentation

https://docs.dronedb.app

Project Overview

DroneDB is designed to efficiently manage, process, and share aerial and geospatial data. The project consists of several key components:

• Core Library: A C++ library that handles file processing, metadata extraction, and database operations
• Command-Line Interface: A powerful CLI tool to interact with DroneDB repositories
• Plugins System: Extensible architecture for adding custom functionality

Building with vcpkg

DroneDB now uses vcpkg for dependency management. This simplifies the build process and ensures consistent dependency versions.

Prerequisites

• CMake 3.16.3 or higher
• C++17 compatible compiler
• Git
• vcpkg

Building on Linux

1. Clone the vcpkg repository:

   git clone https://github.com/microsoft/vcpkg.git
   cd vcpkg
   ./bootstrap-vcpkg.sh
   export VCPKG_ROOT=$(pwd)

2. Clone the DroneDB repository and build:

   git clone https://github.com/DroneDB/DroneDB.git
   cd DroneDB
   ./full-build-linux.sh

Building on Windows

1. Clone the vcpkg repository:

   git clone https://github.com/microsoft/vcpkg.git
   cd vcpkg
   .\bootstrap-vcpkg.bat
   $env:VCPKG_ROOT = $(Get-Location).Path

2. Clone the DroneDB repository and build:

   git clone https://github.com/DroneDB/DroneDB.git
   cd DroneDB
   .\full-build-win.ps1

Using Docker

We provide Docker images for both development and production use:

1. Build the Docker images:

   # On Linux
   ./build-docker.sh
   # On Windows
   .\build-docker.ps1

2. Run DroneDB in a container:

   docker run --rm -it -v $(pwd):/data ddb/app:latest

Requirements

Windows

• Visual Studio 2019 or newer with C++ development tools
• CMake 3.16 or newer
• Git
• vcpkg package manager

Linux

• GCC 9.0 or newer
• CMake 3.16 or newer
• Git
• vcpkg package manager
• Additional dependencies:
  • bison
  • flex
  • libreadline-dev
  • libssl-dev

Build Instructions

Prerequisites

Before building, make sure to set the VCPKG_ROOT environment variable to point to your vcpkg installation:

Windows (PowerShell):

$env:VCPKG_ROOT = "C:\path\to\vcpkg"

Linux/macOS:

export VCPKG_ROOT=/path/to/vcpkg

Clone Repository

git clone https://github.com/DroneDB/DroneDB.git
cd DroneDB
git submodule update --init --recursive

Windows Build

# Configure with CMake
cmake -B build -S . -A x64 -DCMAKE_TOOLCHAIN_FILE="$env:VCPKG_ROOT\scripts\buildsystems\vcpkg.cmake"
# Build
cmake --build build --config Release --target ALL_BUILD -- /maxcpucount:14
# Run tests
.\build\tests\Release\ddbtest.exe --gtest_shuffle --gtest_repeat=2 --gtest_recreate_environments_when_repeating

For a quicker build, you can use the provided batch script:

.\full-build-win.bat

Linux Build

# Install required dependencies
sudo apt install build-essential cmake git bison flex libreadline-dev libssl-dev
# Configure with CMake
cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE="$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake"
# Build
cmake --build build --config Release -j$(nproc)
# Run tests
./build/tests/ddbtest --gtest_shuffle --gtest_repeat=2 --gtest_recreate_environments_when_repeating

Updating Vcpkg Dependencies

If you need to update the vcpkg dependencies:

vcpkg x-update-baseline --add-initial-baseline

Running Tests

Tests are built using Google Test framework:

Windows:

.\build\tests\Release\ddbtest.exe --gtest_shuffle --gtest_repeat=2 --gtest_recreate_environments_when_repeating

Linux:

./build/tests/ddbtest --gtest_shuffle --gtest_repeat=2 --gtest_recreate_environments_when_repeating

Contributing

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

License

This project is licensed under the Mozilla Public License Version 2.0 (MPL 2.0) - see the LICENSE.md file for details.