wombat: A Python repository from bgriffen

Wombat is a Python toolkit designed help answer geospatial related questions about Australian cities & regions. A simple to use set of functionalities enable the querying of of a large number of open-source datasets simultaneously. These datasets range from aerial imagery, building morphology, census information (e.g. demographics), points of interest, elevation, flooding, education, property sale history and transport networks. The goal of wombat is to make it a good means to an ends, such that data products can be easily fed into other downstream geospatial analyses and visualisations.

Lastly, this builds of the shoulders of many other works¹²³⁴⁵ (and many more) - thank you.

📐 Features

Datasets

wombat draws on a number of off-the-shelf datasets as well as post-processed datasets. Nearly all datasets of siginificant size are stored locally. In some cases, datsets are streamed from various online sources but only where the bandwidth requirements are modest (e.g. population tile data). The data sources can be broken down into broadly three categories, Government, Public, post-processed.

Category	Goverment	Open	Brisbane	Sydney	Melbourne	Perth	Adelaide	Hobart	Canberra	Darwin
Addresses		G-NAF	✅	✅	✅	✅	✅	✅	✅	✅
Elevation	GeoScience Australia, ELVIS	TessaDSM, FABDEM	✅	✅	✅	✅	✅	✅	✅	✅
Education	ACARA		✅	✅	✅	✅	✅	✅	✅	✅
Population	ABS	Meta HDX	✅	✅	✅	✅	✅	✅	✅	✅
Buildings		Overture, OSM Buildings, Microsoft	✅	✅	✅	✅	✅	✅	✅	✅
POIs		Overture, OSM POIs	✅	✅	✅	✅	✅	✅	✅	✅
Transport		GTFS	✅	⏰	⏰	⏰	⏰	⏰	⏰	⏰
Noise		BCC	✅	⏰	⏰	⏰	⏰	⏰	⏰	⏰

💻 Installation

Install wombat via pip:

pip install wombat-python (coming soon)

Or clone the repository and install manually:

git clone https://github.com/bgriffen/wombat.git
cd wombat
python setup.py install

🎹 Usage

Here's a quick example to get you started:

import wombat

# initialise
w = wombat.Wombat(dataset_path=os.environ['WOMBAT_DATASET_PATH'])
w.set_city("Brisbane")
# more coming soon...

License

wombat is distributed under the MIT License.

Contact

Feel free to reach out with questions or suggestions:

GitHub Issues: https://github.com/bgriffen/wombat/issues
Contact: @brendangriffen

Higgs C, Alderton A, Rozek J, Adlakha D, Badland H, Boeing G, Both A, Cerin E, Chandrabose M, Gruyter CD, Gunn L, Livera AD, Hinckson E, Liu S, Mavoa S, Sallis J, Simons K, Giles-Corti B. Policy-Relevant Spatial Inidicators of Urban Liveability And Sustainability: Scaling From Local to Global. Urban Policy and Research. 2022 2022/12//;40(4). en. doi:10.1080/08111146.2022.2076215. ↩
Alderton A, Higgs C, Davern M, Butterworth I, Correia J, Nitvimol K, Badland H. Measuring and monitoring liveability in a low-to-middle income country: a proof-of-concept for Bangkok, Thailand and lessons from an international partnership. Cities & Health. 2020 2020/09/07/;5(3):320-328. doi:10.1080/23748834.2020.1813537. ↩
Liu S, Higgs C, Arundel J, Boeing G, Cerdera N, Moctezuma D, Cerin E, Adlakha D, Lowe M, Giles-Corti B. A Generalized Framework for Measuring Pedestrian Accessibility around the World Using Open Data. Geographical Analysis. 2021. en. doi:10.1111/gean.12290. ↩
Boeing G, Higgs C, Liu S, Giles-Corti B, Sallis JF, Cerin E, Lowe M, Adlakha D, Hinckson E, Moudon AV, Salvo D, Adams MA, Barrozo LV, Bozovic T, Delclòs-Alió X, Dygrýn J, Ferguson S, Gebel K, Ho TP, Lai P-C, Martori JC, Nitvimol K, Queralt A, Roberts JD, Sambo GH, Schipperijn J, Vale D, Van de Weghe N, Vich G, Arundel J. Using open data and open-source software to develop spatial indicators of urban design and transport features for achieving healthy and sustainable cities. The Lancet Global Health. 2022 2022/06//;10(6):e907-e918. en. doi:10.1016/S2214-109X(22)00072-9. ↩
Yap, W., Stouffs, R. & Biljecki, F. Urbanity: automated modelling and analysis of multidimensional networks in cities. npj Urban Sustain 3, 45 (2023). doi.org/10.1038/s42949-023-00125-w ↩

bgriffen/wombat