From aaf0425dba273453b9f8b6aaf54e98d4156ce634 Mon Sep 17 00:00:00 2001 From: nihalzp <81457724+nihalzp@users.noreply.github.com> Date: Sat, 6 Jun 2026 20:20:32 +0800 Subject: [PATCH 1/5] Add `CITATION.cff` --- CITATION.cff | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 CITATION.cff diff --git a/CITATION.cff b/CITATION.cff new file mode 100644 index 00000000..3ad47304 --- /dev/null +++ b/CITATION.cff @@ -0,0 +1,37 @@ +cff-version: 1.2.0 +message: "If you use this software, please cite the paper below." +type: software +title: "cartogram-cpp" +repository-code: "https://github.com/mgastner/cartogram-cpp" +url: "https://go-cart.io" +license: "AGPL-3.0-only" + +authors: + - family-names: "Gastner" + given-names: "Michael T." + - family-names: "Miaji" + given-names: "Nihal Z." + - family-names: "Singhania" + given-names: "Adi" + +preferred-citation: + type: article + title: "Topology-preserving line densification for creating contiguous cartograms" + authors: + - family-names: "Miaji" + given-names: "Nihal Z." + - family-names: "Singhania" + given-names: "Adi" + - family-names: "Goh" + given-names: "Matthias E." + - family-names: "Le" + given-names: "Callista" + - family-names: "Tharatipyakul" + given-names: "Atima" + - family-names: "Gastner" + given-names: "Michael T." + journal: "Cartography and Geographic Information Science" + year: 2026 + start: 1 + end: 16 + doi: "10.1080/15230406.2026.2625329" From 83cd59e0c021bac5ad8d951d59b26c134ebf2746 Mon Sep 17 00:00:00 2001 From: nihalzp <81457724+nihalzp@users.noreply.github.com> Date: Sat, 6 Jun 2026 20:40:52 +0800 Subject: [PATCH 2/5] Update readme with latest paper --- README.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index cc563174..ed7da871 100644 --- a/README.md +++ b/README.md @@ -6,11 +6,15 @@ This repository contains the underlying C++ program that powers [go-cart.io](https://go-cart.io). If you'd only like to create a cartogram, you may find it easier to visit the website directly. Otherwise, if you'd like to make code contributions, feature suggestions and/or play with the inner workings of our cartogram generator, you're at the right place! -This program uses the fast flow-based method developed by Michael T. Gastner, Vivien Seguy, and Pratyush More. For more information, you may refer to the following [paper](https://www.pnas.org/content/115/10/E2156): +This program implements 5FCarto, a topology-preserving contiguous cartogram generator that combines the topology-preserving line densification method developed by Nihal Z. Miaji, Adi Singhania, Matthias E. Goh, Callista Le, Atima Tharatipyakul, and Michael T. Gastner with the fast flow-based method developed by Michael T. Gastner, Vivien Seguy, and Pratyush More. For more information, you may refer to the following [paper](https://www.tandfonline.com/doi/full/10.1080/15230406.2026.2625329): -Gastner MT, Seguy V, More P. _Fast flow-based algorithm for creating density-equalizing map projections_. Proc Natl Acad Sci USA 115(10):E2156–E2164 (2018). +Miaji NZ, Singhania A, Goh ME, Le C, Tharatipyakul A, Gastner MT. _Topology-preserving line densification for creating contiguous cartograms_. Cartography and Geographic Information Science 1–16 (2026). -Data produced by code in this repository are subject to the MIT license found [here](./LICENSE) and should cite the aforementioned paper by Gastner et al. (2018). +Data produced by code in this repository are subject to the MIT license and should cite the aforementioned paper by Miaji et al. (2026). + +The underlying flow-based cartogram algorithm is described in: + +Gastner MT, Seguy V, More P. _Fast flow-based algorithm for creating density-equalizing map projections_. Proc Natl Acad Sci USA 115(10):E2156–E2164 (2018). ## Usage From c7663701f8bfff128284148d6ace7f53ee98f1b7 Mon Sep 17 00:00:00 2001 From: nihalzp <81457724+nihalzp@users.noreply.github.com> Date: Sat, 6 Jun 2026 20:47:25 +0800 Subject: [PATCH 3/5] Whitelist links --- .markdown-link-check.json | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/.markdown-link-check.json b/.markdown-link-check.json index b1eb32a8..1a1e666a 100644 --- a/.markdown-link-check.json +++ b/.markdown-link-check.json @@ -4,8 +4,11 @@ "retryCount": 3, "ignorePatterns": [ { "pattern": "go-cart\\.io" }, + { "pattern": "zenodo\\.org/badge/latestdoi/281575635" }, + { "pattern": "www\\.tandfonline\\.com/doi/full/10\\.1080/15230406\\.2026\\.2625329" }, + { "pattern": "doi\\.org/10\\.1080/15230406\\.2026\\.2625329" }, + { "pattern": "doi\\.org/10\\.1073/pnas\\.1712674115" }, { "pattern": "pnas\\.org/content/115/10/E2156" }, - { "pattern": "doi\\.org/10\\.1073/pnas\\.0400280101" }, { "pattern": "gnu\\.org/licenses/agpl-3\\.0" } ] } From f6b7f43a00accab17721201d082b58898b1b7068 Mon Sep 17 00:00:00 2001 From: nihalzp <81457724+nihalzp@users.noreply.github.com> Date: Sat, 6 Jun 2026 20:49:55 +0800 Subject: [PATCH 4/5] Whitelist names --- .cspell.json | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/.cspell.json b/.cspell.json index 265606ec..aaf52752 100644 --- a/.cspell.json +++ b/.cspell.json @@ -17,6 +17,15 @@ "adisidev", "virtualenv", "venv", - "lldb" + "lldb", + "Carto", + "densification", + "Nihal", + "Miaji", + "Singhania", + "Callista", + "Atima", + "Tharatipyakul", + "cartograms" ] } From 74093707d5ab0cc3719c81200da166be429791af Mon Sep 17 00:00:00 2001 From: nihalzp <81457724+nihalzp@users.noreply.github.com> Date: Sat, 6 Jun 2026 20:59:09 +0800 Subject: [PATCH 5/5] Add unreachable badge to unblock CI --- .markdown-link-check.json | 1 + 1 file changed, 1 insertion(+) diff --git a/.markdown-link-check.json b/.markdown-link-check.json index 1a1e666a..d162ac8d 100644 --- a/.markdown-link-check.json +++ b/.markdown-link-check.json @@ -4,6 +4,7 @@ "retryCount": 3, "ignorePatterns": [ { "pattern": "go-cart\\.io" }, + { "pattern": "zenodo\\.org/badge/281575635\\.svg" }, { "pattern": "zenodo\\.org/badge/latestdoi/281575635" }, { "pattern": "www\\.tandfonline\\.com/doi/full/10\\.1080/15230406\\.2026\\.2625329" }, { "pattern": "doi\\.org/10\\.1080/15230406\\.2026\\.2625329" },