commit bfaa73b4ee45e4fb71e3c48cbf322c7346ba1e87 (tree)
parent 7e20617e6582d44bb4eae41ff28fbd070f8513bf
Author: Motiejus Jakštys <motiejus@uber.com>
Date: Tue, 4 May 2021 10:35:27 +0300
rename some files, add README
Diffstat:
4 files changed, 56 insertions(+), 2 deletions(-)
diff --git a/IV/Makefile b/IV/Makefile
@@ -159,11 +159,11 @@ salvis-overlaid-visvalingam-64-chaikin-50k_WIDTHDIV = 2
salvis-overlaid-visvalingam-64-chaikin-50k_QUADRANT = 1
-.faux_test-rivers: tests-rivers.sql wm.sql Makefile .faux_db
+.faux_test-rivers: test-rivers.sql wm.sql Makefile .faux_db
bash db -v scaledwidth=$(SCALEDWIDTH) -f $<
touch $@
-.faux_test: tests.sql wm.sql .faux_db
+.faux_test: test.sql wm.sql .faux_db
bash db -f $<
touch $@
diff --git a/IV/README.md b/IV/README.md
@@ -0,0 +1,54 @@
+Wang–Müller algorithm in PostGIS
+--------------------------------
+
+This is a work-in-progress implementation following "Line generalization based
+on analysis of shape characteristics" by Wang and Müller, 1998 paper.
+
+Structure
+---------
+
+Detailed implementation description: `mj-msc.tex`. It is describing in detail
+what is implemented and what isn't, and why.
+
+Algorithm itself: `wm.sql`. This is the main file you probably want to look at.
+
+Synthetic tests are in `tests.sql`. They are exercising various pieces of the
+algorithm and asserting the results are what expect them to be.
+
+Tests with real rivers are in `test-rivers.sql`.
+
+`Makefile` glues everything together.
+
+Executing the algorithm
+-----------------------
+
+```
+$ make help
+mj-msc-full.pdf Thesis for publishing
+test Unit tests (fast)
+test-rivers Rivers tests (slow)
+clean Clean the current working directory
+clean-tables Remove tables created during unit or rivers tests
+help Print this help message
+wc Character and page count
+refresh-rivers Refresh rivers.sql from Open Street Maps
+```
+
+To execute the algorithm, run:
+
+- `make test` for tests with synthetic data.
+- `make test-rivers` for tests with real rivers. You may adjust the rivers and
+ data source (e.g. use a different country instead of Lithuania) by changing
+ the `Makefile` and the test files.
+
+Building the paper (pdf)
+------------------------
+
+`mj-msc.tex` results in `mj-msc-full.pdf`, which will be at some point
+published. It needs quite a few dependencies, including a functioning Docker
+environment.
+
+License
+-------
+
+GPL 2.0 or later. Same as QGIS and PostGIS.
diff --git a/IV/tests-rivers.sql b/IV/test-rivers.sql
diff --git a/IV/tests.sql b/IV/test.sql
