dohamaps is a program for generative adversarial prediction of urban growth in Doha.

If you are on MacOS, install command line tools

xcode-select --install

Clone the repository, either from GitHub Desktop or the command line

git clone https://github.com/dohamaps/dohamaps.git

Then install python3.7 from here, and then create a virtual environment in the dohamaps directory

python3 -m venv --copies venv

Activate the virtual environment using the instructions here and install dependencies using pip

pip3 install --upgrade pip
pip3 install tensorflow==2.2.0 pillow==7.2.0

Make sure the virtual environment is still activated and run

python3 main.py <options...>

To see the full list of options, run

python3 main.py --help

Most commonly, to process, train, test, and predict, you will want to run something like,

python3 main.py --process=<number of clips>
python3 main.py --train=<epochs> --batch-size=<size>
python3 main.py --test=<steps>
python3 main.py --predict

To run a pre-trained model prediction, you will want to run,

python3 main.py --predict --load-weights=<.../path/to/weights>

All outputs (cache, clips, predictions, and saved models) are saved in ~/.dohamaps/. This is a hidden folder, so navigate to it with Terminal or using cmd + shift + . on MacOS.

Install node from here, and then in the dohamaps folder, run

npm install
npm start

and use the app. That's it!