From 55dc2280aa6f4a2f8078b7fa86d98f3ef8d59813 Mon Sep 17 00:00:00 2001 From: Dave Walker Date: Tue, 12 May 2026 12:05:59 +0100 Subject: [PATCH 1/2] Update modelling README --- modelling/README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/modelling/README.md b/modelling/README.md index 456c473..d22cc0e 100644 --- a/modelling/README.md +++ b/modelling/README.md @@ -132,7 +132,9 @@ Rather than producing opaque embeddings or black-box similarity scores, the syst ### 6. Cluster and neighbourhood analysis -Once pairwise species similarity has been calculated, the resulting similarity matrix can be explored using hierarchical clustering and heatmap visualisation techniques. +Once pairwise species similarity has been calculated, the resulting similarity matrix can be explored using hierarchical clustering, dendrogram analysis, and heatmap visualisation techniques. + +The dendrogram visualisation exposes the hierarchy directly, allowing seasonal ecological neighbourhoods and nested sub-structure to be explored across multiple scales simultaneously. The clustering system attempts to identify groups of species occupying similar regions of seasonal ecological space. @@ -154,7 +156,7 @@ The resulting clusters often contain ecologically plausible seasonal assemblages Importantly, the clustering structure is hierarchical rather than absolute. -The heatmaps and extracted clusters should therefore be interpreted as exploratory views of seasonal ecological structure rather than fixed ecological categories. Different clustering resolutions may reveal broader assemblages or finer sub-structure within the same ecological neighbourhood. +The heatmaps, dendrograms, and extracted clusters should therefore be interpreted as exploratory views of seasonal ecological structure rather than fixed ecological categories. A major design goal remains interpretability. From f69eb33e9695f18b6ed2812d76bccc14e8abb24b Mon Sep 17 00:00:00 2001 From: Dave Walker Date: Tue, 12 May 2026 12:11:42 +0100 Subject: [PATCH 2/2] Update modelling README --- modelling/README.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/modelling/README.md b/modelling/README.md index d22cc0e..25c3930 100644 --- a/modelling/README.md +++ b/modelling/README.md @@ -60,7 +60,9 @@ The emphasis is on: ### 3. Parameter fitting -Parameter fitting is currently implemented for the model for seasonally present and winter visitor models, rather than residents where observations are driven by detectability changes. +The parameter fitting workflow is illustrated below: + +![Parameter Fitting](https://github.com/davewalker5/OdeSolver/blob/main/docs/images/parameter-fitting.png?raw=true) Given observed data (typically monthly presence or detectability), we: @@ -74,6 +76,10 @@ This produces a set of parameters that describe the species’ seasonal behaviou ### 4. Feature extraction +The feature extraction, similarity and clustering workflow is illustrated below: + +![Similarity Analysis and Clustering](https://github.com/davewalker5/OdeSolver/blob/main/docs/images/similarity-analysis.png?raw=true) + Once species have been fitted, the resulting parameter sets and observed seasonal characteristics can be converted into a structured feature matrix. The feature matrix acts as a common ecological description layer across all species and model families.