To build, type

make duckdb_release release

To run, run the bundled duckdb shell:

./duckdb/build/release/duckdb 

Then, load the H3 extension like so:

LOAD 'build/release/h3.duckdb_extension';

Test running an H3 function:

SELECT h3_cell_to_parent(cast(586265647244115967 as ubigint), 1);

• h3_latlng_to_cell
• h3_cell_to_lat
• h3_cell_to_lng
• h3_get_resolution
• h3_get_base_cell_number
• h3_string_to_h3
• h3_h3_to_string
• h3_is_valid_cell
• h3_is_res_class_iii
• h3_is_pentagon
• h3_cell_to_parent
• h3_cell_to_center_child

For a greatly sped up build (enables parallelism), run:

CMAKE_BUILD_PARALLEL_LEVEL=4 make duckdb_release release

To update the submodules to latest upstream, run:

make update_deps

To run tests:

make test

h3-duckdb Copyright 2022 Isaac Brodsky. Licensed under the Apache 2.0 License.

H3 Copyright 2018 Uber Technologies Inc. (Apache 2.0 License)

DGGRID Copyright (c) 2015 Southern Oregon University

DuckDB Copyright 2018-2022 Stichting DuckDB Foundation (MIT License)

Build system adapted from sqlitescanner Copyright 2018-2022 DuckDB Labs BV (MIT License)