Installation

Set up environment

Use conda or mamba or micromamba to create the virtual environment sb_env:

conda create -n sb_env -c conda-forge superblockify
conda activate sb_env

Note: While pip can install superblockify, it’s not officially supported due to potential issues with C dependencies needed for OSMnx. If unsure, use conda as instructed above to avoid problems.

Alternatively, or if you run into issues, clone this repository and create the environment via the environment.yml file:

conda env create --file environment.yml
conda activate sb_env
pip install superblockify

Set up Jupyter kernel

If you want to use superblockify with its environment sb_env in Jupyter, run:

pip install --user ipykernel
python -m ipykernel install --user --name=sb_env

This allows you to run Jupyter with the kernel sb_env (Kernel > Change Kernel > sb_env)

For a guided start after installation, see the following Usage section.