Makefile

# osm-tiny-maps, OpenStreetMap downloads and image-creation
# Copyright (C) 2016, Neil Freeman

# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# at your option) any later version.

# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.

# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.
SHELL = bash

# Useful for downloading another iteration of similar data
# setting this will put all files in the named folder
PREFIX = .

# INI files are valid Make variable declarations
include config.ini 

# Overpass API endpoint
API ?= http://overpass-api.de/api/interpreter
CURLFLAGS = -s

# List of bounding boxes to target for download
LOCATIONS = $(shell cut -f1 -d, $(BOUNDSFILE))

# OSM verbosity
# valid options: skel, body, meta
VERBOSITY ?= body

# default configuration file for ogr2ogr
OSM_CONFIG_FILE ?= osm.ini
OSM_USE_CUSTOM_INDEXING = NO
export OSM_CONFIG_FILE OSM_USE_CUSTOM_INDEXING
OGRFLAGS = -f GeoJSON -lco ENCODING=UTF-8

# imagemagick flags for adding small border
DENSITY = 144
BORDER = 10
REPAGEFLAGS = -trim +repage
BORDERFLAGS = -bordercolor white -border $(BORDER)x$(BORDER)

# no-viewbox gives better compatibility for Adobe Illustrator
DRAWFLAGS = --no-viewbox --inline --padding 10
CLASSFIELDS = ''
SCALE = 10
# generate a local transverse-mercator projection
PROJECTION = local
# For clarity:
drawopts = --crs $(PROJECTION) \
	--scale $(SCALE) \
	--style $(STYLEFILE) \
	--class-fields $(CLASSFIELDS) \
	$(DRAWFLAGS)

# Valid GEOMETRY types: points lines multipolygons
GEOMETRY = multipolygons lines

# Slightly-too-clever declaration of folders and shorthand tasks
FILETYPES = overpassql osm svg geojson eps png
DIRS = $(addprefix $(PREFIX)/,$(FILETYPES)) $(addprefix $(PREFIX)/geojson/,$(GEOMETRY))
TASKS = $(addsuffix s,$(FILETYPES))

# These don't create literal files
.PHONY: info install ready clean $(TASKS)

info:
	@echo query template: $(QUERYFILE)
	@echo bounds file: $(BOUNDSFILE)
	@echo bounds count: $(words $(LOCATIONS))
	@echo css file: $(STYLEFILE)
	@echo osm conversion settings: $(OSM_CONFIG_FILE)
	@echo available commands: $(TASKS)

# Shorthand tasks

# list of png files to generate, based on the keys of the bounding box
pngs: $(addsuffix .png,$(addprefix $(PREFIX)/png/,$(LOCATIONS)))

# Geojson rule requires replacement for each GEOMETRY
geojsons: $(foreach G,$(GEOMETRY),$(foreach L,$(LOCATIONS),$(PREFIX)/geojson/$G/$L.geojson))

# Other rules require a second expansion to state simply
# Without ".SECONDEXPANSION" this would yield a file ending in .%
.SECONDEXPANSION:
overpassqls osms epss svgs: %s: $(foreach x,$(LOCATIONS),$(PREFIX)/%/$x.$$*)

# file creation tasks in reverse-chronological order

# Generate a png from a svg.
# the order-only prerequisite ("| PREFIX/png") doesn't check the folder timestamp
$(PREFIX)/png/%.png: $(PREFIX)/svg/%.svg | $(PREFIX)/png
	convert $< -density $(DENSITY) $(REPAGEFLAGS) $(BORDERFLAGS) $@

# Generate an EPS from a SVG
$(PREFIX)/eps/%.eps: $(PREFIX)/svg/%.svg | $(PREFIX)/eps
	convert $< $(REPAGEFLAGS) $@

# Draw the svg with SVGIS using one or more GEOMETRYs
$(PREFIX)/svg/%.svg: $(foreach x,$(GEOMETRY),$(PREFIX)/geojson/$x/%.geojson) $(STYLEFILE) | $(PREFIX)/svg
	svgis draw -o $@ $(drawopts) $(filter-out %.css,$^)

# Create geodata from OSM data
# This task uses a complicated expansion in order to address all the GEOMETRYs without repetition.
# The actual ogr2ogr command will look like:
# ogr2ogr placelines.geojson place.osm lines -f GeoJSON
# where 'lines' could be any of the GEOMETRYs
$(PREFIX)/geojson/%.geojson: $(PREFIX)/osm/$$(*F).osm | $$(@D)
	@rm -f $@
	ogr2ogr $@ $^ $(*D) $(OGRFLAGS)

# OSM files are precious because they tend to be big, we don't want make to delete them
.PRECIOUS: osm/%.osm

# Post the query to the OSM api.
$(PREFIX)/osm/%.osm: $(PREFIX)/overpassql/%.overpassql | $(PREFIX)/osm
	curl $(API) $(CURLFLAGS) -o $@ --data @$<

# Read bounding box from the bounds file, use sed to do some quick templating on the query file
	read BBOX <<<$$(fgrep '$*' $< | cut -d, -f2-); \
	sed -e "s/{{bbox}}/$${BBOX}/g;s/{{verbosity}}/$(VERBOSITY)/g;s,//.*,,;s/ *//" $(QUERYFILE) | \
	tr -d '\n' | \
	sed -e 's,/\*.*\*/,,g' > $@
$(PREFIX)/overpassql/%.overpassql: $(BOUNDSFILE) | $(PREFIX)/overpassql

# Create directories
$(DIRS): ; mkdir -p $@

# Clean and install tasks
clean: ; rm -rf $(DIRS)

# requires Homebrew and pip out of the gate
install:
	which gdalinfo || brew install gdal
	pip list | grep svgis || pip install -U "svgis>=0.3.8,<1"
	which $(CONVERT) || brew install Caskroom/cask/xquartz imagemagick

ready:
	-@ogr2ogr --version >/dev/null && echo GDAL ok || echo install GDAL
	-@which svgis >/dev/null && echo svgis ok || echo install svgis
	-@convert --version >/dev/null && echo ImageMagick ok || echo install ImageMagick