From a937edcafe376be1679406c21a05ead8907e99da Mon Sep 17 00:00:00 2001 From: Tarik Moussa Date: Thu, 14 May 2026 12:33:30 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20Dissertation,=20GitHub-Repo,=20Website?= =?UTF-8?q?=20und=20LinkedIn=20von=20Stefan=20Sechelmann=20erg=C3=A4nzt?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit README: - Neuer Einstieg mit vollständiger Dissertation-Referenz (Titel, TU Berlin 2016, DOI 10.14279/depositonce-5415, CC BY-SA 4.0) - Links zu Original-Java-Repo, sechel.de und linkedin.com/in/sechel - Neuer Abschnitt "Ursprung & Danksagung" vor der Lizenz doc/architecture/overall_pipeline.md: - Neuer "Origin"-Abschnitt ganz oben mit vollständiger Quellenangabe - Literaturabschnitt erweitert: Dissertation als "Primary source" hervorgehoben, Java-Original-Repo als direkter Port-Bezug dokumentiert Co-Authored-By: Claude Sonnet 4.6 --- README.md | 38 +++++++++++++++++++++++++++- doc/architecture/overall_pipeline.md | 35 +++++++++++++++++++++++++ 2 files changed, 72 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index b5b56d4..7f2997e 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,24 @@ # conformallab++ -conformallab++ is a modern C++ reimplementation of the [ConformalLab](https://github.com/sechel/conformallab) software by Stefan Sechelmann for experiments in discrete conformal geometry and related mesh transformations. +conformallab++ is a modern C++ reimplementation of +[ConformalLab](https://github.com/varylab/conformallab) — +the research software for discrete conformal geometry by +**Stefan Sechelmann** (TU Berlin, Institut für Mathematik). + +The algorithmic foundation is his doctoral dissertation: + +> Stefan Sechelmann — +> **Variational Methods for Discrete Surface Parameterization: Applications and Implementation** +> Doctoral thesis, Technische Universität Berlin, 2016. +> DOI: [10.14279/depositonce-5415](https://depositonce.tu-berlin.de/items/8e2988b2-d991-45b5-aad5-9fb7988f3b2f) +> License: CC BY-SA 4.0 + +The dissertation develops the variational framework for discrete conformal equivalence +on triangulations — discrete uniformization of Riemann surfaces, cone metrics, period +matrices — that forms the mathematical core of both the Java original and this C++ port. + +**Original Java library:** [github.com/varylab/conformallab](https://github.com/varylab/conformallab) (Java, ~850 commits, v1.0.0 2018) +**Author's website:** [sechel.de](https://sechel.de/) · **LinkedIn:** [linkedin.com/in/sechel](https://www.linkedin.com/in/sechel/) The long-term goal is a **CGAL package** that brings discrete conformal maps (hyper-ideal, spherical, Euclidean) to the CGAL ecosystem using `CGAL::Surface_mesh` as the underlying half-edge data structure. @@ -567,6 +585,24 @@ Phase 8 (geplant) --- +## Ursprung & Danksagung + +conformallab++ wäre ohne die Grundlagenarbeit von **Stefan Sechelmann** nicht möglich. +Die Algorithmen, die Variationsformulierung und die Idee, diskrete konforme Geometrie +als Newton-Problem auf Winkel-Summen-Energie-Funktionalen zu behandeln, stammen aus: + +| | | +|---|---| +| **Dissertation** | Stefan Sechelmann — *Variational Methods for Discrete Surface Parameterization: Applications and Implementation*, TU Berlin 2016 | +| **DOI** | [10.14279/depositonce-5415](https://depositonce.tu-berlin.de/items/8e2988b2-d991-45b5-aad5-9fb7988f3b2f) | +| **Java-Originalbibliothek** | [github.com/varylab/conformallab](https://github.com/varylab/conformallab) | +| **Website** | [sechel.de](https://sechel.de/) | +| **LinkedIn** | [linkedin.com/in/sechel](https://www.linkedin.com/in/sechel/) | + +Die Dissertation steht unter Creative Commons Attribution ShareAlike 4.0 (CC BY-SA 4.0). + +--- + ## Lizenz conformallab++ steht unter der MIT-Lizenz (siehe [LICENSE](LICENSE)). diff --git a/doc/architecture/overall_pipeline.md b/doc/architecture/overall_pipeline.md index 07699ed..b8bdc7a 100644 --- a/doc/architecture/overall_pipeline.md +++ b/doc/architecture/overall_pipeline.md @@ -1,5 +1,31 @@ # conformallab++ — Architecture & Pipeline +## Origin + +conformallab++ is a C++ reimplementation of +[ConformalLab](https://github.com/varylab/conformallab), +the Java research library for discrete conformal geometry by +**Stefan Sechelmann** (TU Berlin, Institut für Mathematik, +SFB/Transregio 109 *Discretization in Geometry and Dynamics*). + +The algorithmic foundation is his doctoral dissertation: + +> Stefan Sechelmann — +> **Variational Methods for Discrete Surface Parameterization: Applications and Implementation** +> Doctoral thesis, Technische Universität Berlin, 2016. +> DOI: [10.14279/depositonce-5415](https://depositonce.tu-berlin.de/items/8e2988b2-d991-45b5-aad5-9fb7988f3b2f) · CC BY-SA 4.0 + +The dissertation develops the variational framework for discrete conformal equivalence: +discrete uniformization of Riemann surfaces, cone metrics, period matrices, and +holonomy — all of which are directly implemented in this library. + +Further links: +**Java original:** [github.com/varylab/conformallab](https://github.com/varylab/conformallab) · +**Website:** [sechel.de](https://sechel.de/) · +**LinkedIn:** [linkedin.com/in/sechel](https://www.linkedin.com/in/sechel/) + +--- + ## Positioning conformallab++ is a **specialised research library for discrete conformal geometry** on @@ -447,6 +473,15 @@ This mirrors exactly the contract table in this document. ## Recommended reading +### Primary source — the dissertation this library implements + +| | | +|---|---| +| **Sechelmann** — *Variational Methods for Discrete Surface Parameterization: Applications and Implementation*, TU Berlin 2016 | The mathematical foundation of the entire library: discrete conformal equivalence, variational angle-sum functionals, Newton solver, uniformization, period matrices. DOI: [10.14279/depositonce-5415](https://depositonce.tu-berlin.de/items/8e2988b2-d991-45b5-aad5-9fb7988f3b2f) | +| **Java original** — [github.com/varylab/conformallab](https://github.com/varylab/conformallab) | Reference implementation in Java — the direct source for all algorithms ported to C++ | + +### Further references + | Source | Relevance in conformallab++ | |--------|----------------------------| | Springborn — *Ideal Hyperbolic Polyhedra and Discrete Uniformization* (2020) | HyperIdeal functional; ζ₁₃/ζ₁₄/ζ₁₅ in `hyper_ideal_geometry.hpp` |