GeoKernel Python

Official Python package for the GeoKernel GIS SDK.

The package name is geokernel:

pip install geokernel

Install extended GDAL formats, DuckDB and GeoParquet support when needed:

pip install "geokernel[formats]"

all is the forward-compatible option for installing every optional GeoKernel runtime:

pip install "geokernel[all]"

Usage

import sys

from PySide6.QtWidgets import QApplication, QMainWindow

from geokernel import Viewer, ViewerTool

app = QApplication(sys.argv)

window = QMainWindow()
window.setWindowTitle("HelloMap")
window.resize(1200, 800)

viewer = Viewer(width=1200, height=800)
viewer.set_tool(ViewerTool.PAN)
viewer.add_layer(r"D:\data\world_4326.shp")

window.setCentralWidget(viewer.qt_widget())
window.closeEvent = lambda event: (viewer.close(), event.accept())

window.show()
app.processEvents()
viewer.show()
viewer.resize(window.centralWidget().width(), window.centralWidget().height())
viewer.full_extent()
viewer.refresh_layers()
app.exec()

Development

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e .

Runtime Binaries

The PyPI package includes the universal, license-neutral GeoKernel runtime under:

src/geokernel/bin/

The runtime should include GeoKernel.Viewer.dll, GeoKernel DLLs, Qt DLLs, Skia/GDAL/PROJ dependencies, Qt plugins, GDAL plugins, gdal-data, and proj-data.

For development builds, copy the current local SDK runtime into the package with:

python tools\sync_runtime_binaries.py --source "D:\projects\GeoKernel\outputs\build\Release" --clean

If the package does not contain binaries yet, the wrapper also checks:

GEOKERNEL_BIN
D:\projects\GeoKernel\outputs\build\Release

Package Layout

src/
  geokernel/
    __init__.py
    geometry.py
    layer.py
    dll.py
    viewer.py
    bin/
tools/
  sync_runtime_binaries.py