feat: SATP circumplex SEM module — functional API and architecture refactor

CHANGELOG.md

@@ -9,6 +9,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- New **SATP** (Soundscape Attributes Translation Project) circumplex SEM module
+
+  - `fit_circe(data, language, datasource)` — primary API; validates, ipsatizes, fits
+    all four circumplex model types, and returns a tidy DataFrame directly
+  - `ipsatize(data, by="participant")` — public participant-wise centering function
+  - `CircE` dataclass — typed result container with `to_dict()` and `gdiff` property
+  - `CircModelE` enum with `equal_ang` / `equal_com` constraint properties
+  - Uses listwise deletion (complete cases) consistent with R's `na.omit`
+
 - New **Soundscape Perception Indices (SPI)** module
 
   - Provides tools for calculating Soundscape Perception Indices

docs/tutorials/.gitignore

@@ -0,0 +1,5 @@
+/.quarto/
+**/*.quarto_ipynb
+/.jupyter_cache/
+SATP_CircE_Analysis.qmd
+SATP_CircE_Analysis.html

docs/tutorials/5_Working_with_Soundscape_Databases.ipynb

@@ -997,7 +997,7 @@
     "# Note: This is a placeholder for the ARAUS database functionality\n",
     "# The actual implementation may differ\n",
     "try:\n",
-    "    araus_data = araus.load()\n",
+    "    araus_data = araus.load()  # noqa: F821\n",
     "    print(f\"ARAUS Dataset shape: {araus_data.shape}\")\n",
     "except (ImportError, AttributeError):\n",
     "    print(\"ARAUS database functionality is not yet fully implemented.\")\n",