CitySim Python Interface

Installation

Import submodules

After cloning the repository, update the submodules

git submodule update --init --recursive

Install Package manager

Install Pixi (general):

curl -fsSL https://pixi.sh/install.sh | bash

Or via Homebrew (MacOS, takes a while to build deps):

brew install pixi

(Homebrew will compile and install if not present: python3.12, python3.13, ninja, llvm and rust)

See pixi.sh/dev/

MacOS: install build deps

brew install gcc gfortran cmake
brew install mesa-glu

Install Pixi packages

pixi install

Build CitySim

pixi shell
pixi run citysim-build-macos

TODO: remove hardcoded path in makefile

Build binder

pixi shell
mkdir binder_build
cd binder_build
brew link llvm --force
llvm-config --ldflags # outpout to CMAKE_EXE_LINKER_FLAGS
cmake -DCMAKE_INSTALL_PREFIX:PATH=$PIXI_PROJECT_ROOT/.pixi/envs/default/ -DCMAKE_EXE_LINKER_FLAGS="$(llvm-config --ldflags) $(llvm-config --libs)" ../citysim/binder
make
ctest
make install