openfreemap/modules/tile_gen/scripts/extract_mbtiles.py

#!/usr/bin/env python3
import json
import os
import shutil
import sqlite3
import sys
from pathlib import Path

import click


@click.command()
@click.argument(
    'mbtiles_path',
    type=click.Path(exists=True, dir_okay=False, file_okay=True, path_type=Path),
)
@click.argument('dir_path', type=click.Path(dir_okay=True, file_okay=False, path_type=Path))
def cli(mbtiles_path: Path, dir_path: Path):
    """
    Extracts a mbtiles sqlite to a folder
    Deduplicating identical tiles as hard-links

    used for reference: https://github.com/mapbox/mbutil
    """

    if dir_path.exists() and any(dir_path.iterdir()):
        sys.exit('  dir not empty')

    dir_path.mkdir(exist_ok=True)

    conn = sqlite3.connect(mbtiles_path)
    c = conn.cursor()

    write_dedupl_files(c, dir_path=dir_path)
    write_tile_files(c, dir_path=dir_path)

    # planetiler has missing tiles by design, so disabling this
    # assert_all_tiles_present(mbtiles_path, dir_path)

    write_metadata(c, dir_path=dir_path)
    conn.commit()

    print('extract_mbtiles.py DONE')


def write_metadata(c, *, dir_path):
    metadata = dict(c.execute('select name, value from metadata').fetchall())
    c.execute("update metadata set value='OpenFreeMap' where name='name'")
    c.execute("update metadata set value='https://openfreemap.org' where name='description'")

    if 'openfreemap' not in metadata['attribution']:
        attr_str = (
            '<a href="https://openfreemap.org" target="_blank">OpenFreeMap</a> '
            + metadata['attribution']
        )
        c.execute("UPDATE metadata SET value = ? WHERE name = 'attribution'", (attr_str,))

    if 'osm_date' not in metadata:
        if 'planetiler:osm:osmosisreplicationtime' in metadata:
            osm_date = metadata['planetiler:osm:osmosisreplicationtime'][:10]
            c.execute('INSERT INTO metadata (name, value) VALUES (?, ?)', ('osm_date', osm_date))

    metadata = dict(c.execute('select name, value from metadata').fetchall())
    with open(dir_path / 'metadata.json', 'w') as fp:
        json.dump(metadata, fp, indent=2)

    with open(dir_path / 'osm_date', 'w') as fp:
        fp.write(metadata['osm_date'])


def write_dedupl_files(c, *, dir_path):
    """
    dedupl files
    write out the tiles_data files into a multi-level folder
    """

    total = c.execute('select count(*) from tiles_data').fetchone()[0]

    c.execute('select tile_data_id, tile_data from tiles_data')
    for i, row in enumerate(c, start=1):
        dedupl_id = row[0]
        dedupl_path = dir_path / 'dedupl' / dedupl_helper_path(dedupl_id)
        dedupl_path.parent.mkdir(parents=True, exist_ok=True)
        with open(dedupl_path, 'wb') as fp:
            fp.write(row[1])
            print(f'written dedupl file {i}/{total}')


def write_tile_files(c, *, dir_path):
    total = c.execute('select count(*) from tiles_shallow').fetchone()[0]

    bug_fix_dict = {}

    c.execute('select zoom_level, tile_column, tile_row, tile_data_id from tiles_shallow')
    for i, row in enumerate(c, start=1):
        z = row[0]
        x = row[1]
        y = flip_y(z, row[2])
        dedupl_id = row[3]

        dedupl_path = dir_path / 'dedupl' / dedupl_helper_path(dedupl_id)
        dedupl_path_fixed = get_fixed_dedupl_name(bug_fix_dict, dedupl_path)

        tile_path = dir_path / 'tiles' / str(z) / str(x) / f'{y}.pbf'
        tile_path.parent.mkdir(parents=True, exist_ok=True)

        if tile_path.is_file():
            continue

        # create the hard link
        try:
            tile_path.hardlink_to(dedupl_path_fixed)
            print(f'hard link created {i}/{total} {i / total * 100:.1f}%: {tile_path}')
        except OSError as e:
            # fixing Btrfs's 64k max link limit
            if e.errno == 31:
                bug_fix_dict.setdefault(dedupl_path, 0)
                bug_fix_dict[dedupl_path] += 1
                dedupl_path_fixed = get_fixed_dedupl_name(bug_fix_dict, dedupl_path)
                shutil.copyfile(dedupl_path, dedupl_path_fixed)
                print(f'Created fixed dedupl file: {dedupl_path_fixed}')
                tile_path.hardlink_to(dedupl_path_fixed)
                print(f'hard link created {i}/{total} {i / total * 100:.1f}%: {tile_path}')
            else:
                raise


def assert_all_tiles_present(mbtiles_path, dir_path):
    """
    If it's a full planet run,
    make sure there are exactly the right number of files generated.
    """

    if 'planet' in mbtiles_path.resolve().parent.name:
        assert count_files(dir_path / 'tiles') == calculate_tiles_sum(14)
        print(f'Tile number: {calculate_tiles_sum(14)} - OK')


def count_files(folder):
    total = 0
    for root, dirs, files in os.walk(folder):
        total += len(files)
    return


def get_fixed_dedupl_name(bug_fix_dict, dedupl_path):
    if dedupl_path in bug_fix_dict:
        return dedupl_path.with_name(f'{dedupl_path.name}-{bug_fix_dict[dedupl_path]}')
    else:
        return dedupl_path


def dedupl_helper_path(dedupl_id: int) -> Path:
    """
    Naming 200 million files such that each subdir has max 1000 children
    """

    str_num = f'{dedupl_id:09}'
    l1 = str_num[:3]
    l2 = str_num[3:6]
    l3 = str_num[6:]
    return Path(l1) / l2 / f'{l3}.pbf'


def flip_y(zoom, y):
    return (2**zoom - 1) - y


def calculate_tiles(zoom_level):
    return (2**zoom_level) ** 2


def calculate_tiles_sum(zoom_level):
    """
    Sum of tiles up to zoom level (geometric series)
    """
    return (4 ** (zoom_level + 1) - 1) // 3


if __name__ == '__main__':
    cli()