planx-sdk 0.1.0__tar.gz

planx_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yusuf Eminoğlu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

planx_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: planx-sdk
+Version: 0.1.0
+Summary: Core spatial analytics, spatial statistics, and urban resilience engines for the PlanX ecosystem.
+Author-email: Yusuf Eminoğlu <yusufeminoglu@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.20.0
+Requires-Dist: scipy>=1.7.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+# PlanX SDK (Software Development Kit)
+
+PlanX QGIS eklenti ekosisteminin çekirdek mekansal analiz, istatistik ve yerleşilebilirlik (MCDA) hesaplama motorlarını barındıran, QGIS arayüzünden bağımsız, saf Python ve NumPy tabanlı resmi kütüphanesidir.
+
+Bu kütüphane sayesinde, QGIS eklentilerinizdeki karmaşık algoritmaları:
+1. QGIS'i başlatmadan (örneğin Jupyter Notebooks, bağımsız komut dosyaları veya sunucularda) çalıştırabilir,
+2. `pytest` ile hızlı ve headless bir şekilde test edebilir,
+3. Tek bir merkezden güncelleyerek tüm eklentilerinizde tutarlı bir şekilde kullanabilirsiniz.
+
+---
+
+## 📂 Proje Yapısı (Directory Structure)
+
+```text
+planx_sdk/
+  ├── pyproject.toml              # Modern paket tanımı, bağımlılıklar ve metadata (PEP 517/621)
+  ├── README.md                   # Bu dökümantasyon dosyası
+  ├── LICENSE                     # Lisans dosyası
+  ├── .gitignore                  # Python önbellek ve build klasörlerini yoksayan git kuralları
+  ├── src/                        # Kaynak kodlar (Standard src-layout)
+  │   └── planx/                  # Ana paket dizini
+  │       ├── __init__.py         # Versiyon ve paket tanımı
+  │       ├── spatial/            # Çekirdek mekansal ağ analizi ve space syntax motoru
+  │       │   ├── __init__.py
+  │       │   ├── paths.py        # En kısa yol algoritmaları (Dijkstra, SciPy entegrasyonu)
+  │       │   └── centrality.py   # Yakınlık, Brandes Arasılık (Betweenness) ve Özdeğer (Eigenvector)
+  │       ├── geostats/           # Mekansal istatistik ve otokorelasyon motorları
+  │       │   ├── __init__.py
+  │       │   └── stats_engines.py# Getis-Ord Gi*, Local/Global Moran's I, OLS, GWR, SDE, k-means
+  │       └── suitability/        # Raster tabanlı MCDA (Multi-Criteria Decision Analysis) motoru
+  │           ├── __init__.py
+  │           └── mcda.py         # Normalizasyon metotları (Sigmoid, Gaussian, Min-Max) ve WLC
+  └── tests/                      # Birim testler (Unit Tests)
+      ├── __init__.py
+      ├── test_spatial.py         # Network algoritmaları testleri
+      ├── test_geostats.py        # İstatistik testleri
+      └── test_suitability.py     # MCDA testleri
+```
+
+---
+
+## 🛠️ Kurulum (Installation)
+
+### 1. Geliştirici Modunda Kurulum (Editable Install - Geliştirme İçin)
+SDK kodlarında yaptığınız değişikliklerin anında QGIS veya test ortamınızda yansıması için kütüphaneyi **geliştirici (editable) modda** kurmalısınız.
+
+QGIS'in veya geliştirme yaptığınız IDE'nin (PyCharm/VS Code) aktif Python ortamında terminali açarak şu komutu çalıştırın:
+```bash
+pip install -e C:\Users\YE\PyCharmMiscProject\planx_sdk
+```
+*(Ya da `planx_sdk` klasörünün içindeyken: `pip install -e .`)*
+
+### 2. Geliştirici Bağımlılıklarının Kurulumu
+Birim testlerini koşmak, kod formatlamak veya lint araçlarını kullanmak için geliştirici paketlerini kurabilirsiniz:
+```bash
+pip install -e .[dev]
+```
+
+---
+
+## 💡 QGIS Eklentilerinde Kullanım Stratejileri
+
+QGIS eklentilerinizin bu paket ile haberleşmesi için iki temel yöntem mevcuttur:
+
+### Yöntem A: Yerel Geliştirici Ortamı (Development)
+Geliştirme makinenizde, QGIS'in kullandığı Python interpreter'ına (`OSGeo4W` veya `conda` ortamı) SDK'yı yukarıdaki gibi `pip install -e` ile kurun. 
+Eklenti kodunuzda doğrudan standart importları yapabilirsiniz:
+```python
+from planx.spatial import brandes_betweenness
+from planx.geostats import calculate_getis_ord
+```
+
+### Yöntem B: Dağıtım / Yayınlama Süreci (Vendoring / Bundling)
+QGIS Hub'da yayınlarken, eklenti zip paketinin kendi kendine yetmesi gerekir (kullanıcıdan harici `pip install` yapması beklenemez).
+Bu sorunu çözmek için, `Build-PluginZip.ps1` veya release betiğinizin içine SDK'yı eklentinin kendi `libs` klasörüne yükleyen bir adım ekleyebilirsiniz:
+
+```powershell
+# Eklentinin zip paketleme aşamasında target klasör olarak eklenti altındaki 'libs' belirlenir:
+pip install C:\Users\YE\PyCharmMiscProject\planx_sdk -t C:\Users\YE\PyCharmMiscProject\qgis_plugins\<eklenti_klasoru>\libs --upgrade
+```
+
+Eklentinizin giriş noktasında (`__init__.py` veya ana modülün en üstünde) bu `libs` klasörünü Python arama yoluna (`sys.path`) eklemeniz yeterlidir:
+```python
+import os
+import sys
+
+# Eklenti altındaki 'libs' klasörünü sys.path'e en yüksek öncelikle ekle
+libs_path = os.path.join(os.path.dirname(__file__), 'libs')
+if libs_path not in sys.path:
+    sys.path.insert(0, libs_path)
+
+# Artık SDK sorunsuzca import edilebilir
+from planx.spatial import many_to_many
+```
+
+---
+
+## 🧪 Testleri Koşturma (Running Tests)
+
+SDK'nın doğruluğunu test etmek için `pytest` kullanabilirsiniz. Proje kök dizininde (`C:\Users\YE\PyCharmMiscProject\planx_sdk`) şu komutu çalıştırmanız yeterlidir:
+
+```bash
+pytest
+```
+
+---
+
+## 📝 Lisans (License)
+
+Bu proje **MIT Lisansı** ile lisanslanmıştır. Detaylar için [LICENSE](LICENSE) dosyasına göz atabilirsiniz.

planx_sdk-0.1.0/README.md

@@ -0,0 +1,110 @@
+# PlanX SDK (Software Development Kit)
+
+PlanX QGIS eklenti ekosisteminin çekirdek mekansal analiz, istatistik ve yerleşilebilirlik (MCDA) hesaplama motorlarını barındıran, QGIS arayüzünden bağımsız, saf Python ve NumPy tabanlı resmi kütüphanesidir.
+
+Bu kütüphane sayesinde, QGIS eklentilerinizdeki karmaşık algoritmaları:
+1. QGIS'i başlatmadan (örneğin Jupyter Notebooks, bağımsız komut dosyaları veya sunucularda) çalıştırabilir,
+2. `pytest` ile hızlı ve headless bir şekilde test edebilir,
+3. Tek bir merkezden güncelleyerek tüm eklentilerinizde tutarlı bir şekilde kullanabilirsiniz.
+
+---
+
+## 📂 Proje Yapısı (Directory Structure)
+
+```text
+planx_sdk/
+  ├── pyproject.toml              # Modern paket tanımı, bağımlılıklar ve metadata (PEP 517/621)
+  ├── README.md                   # Bu dökümantasyon dosyası
+  ├── LICENSE                     # Lisans dosyası
+  ├── .gitignore                  # Python önbellek ve build klasörlerini yoksayan git kuralları
+  ├── src/                        # Kaynak kodlar (Standard src-layout)
+  │   └── planx/                  # Ana paket dizini
+  │       ├── __init__.py         # Versiyon ve paket tanımı
+  │       ├── spatial/            # Çekirdek mekansal ağ analizi ve space syntax motoru
+  │       │   ├── __init__.py
+  │       │   ├── paths.py        # En kısa yol algoritmaları (Dijkstra, SciPy entegrasyonu)
+  │       │   └── centrality.py   # Yakınlık, Brandes Arasılık (Betweenness) ve Özdeğer (Eigenvector)
+  │       ├── geostats/           # Mekansal istatistik ve otokorelasyon motorları
+  │       │   ├── __init__.py
+  │       │   └── stats_engines.py# Getis-Ord Gi*, Local/Global Moran's I, OLS, GWR, SDE, k-means
+  │       └── suitability/        # Raster tabanlı MCDA (Multi-Criteria Decision Analysis) motoru
+  │           ├── __init__.py
+  │           └── mcda.py         # Normalizasyon metotları (Sigmoid, Gaussian, Min-Max) ve WLC
+  └── tests/                      # Birim testler (Unit Tests)
+      ├── __init__.py
+      ├── test_spatial.py         # Network algoritmaları testleri
+      ├── test_geostats.py        # İstatistik testleri
+      └── test_suitability.py     # MCDA testleri
+```
+
+---
+
+## 🛠️ Kurulum (Installation)
+
+### 1. Geliştirici Modunda Kurulum (Editable Install - Geliştirme İçin)
+SDK kodlarında yaptığınız değişikliklerin anında QGIS veya test ortamınızda yansıması için kütüphaneyi **geliştirici (editable) modda** kurmalısınız.
+
+QGIS'in veya geliştirme yaptığınız IDE'nin (PyCharm/VS Code) aktif Python ortamında terminali açarak şu komutu çalıştırın:
+```bash
+pip install -e C:\Users\YE\PyCharmMiscProject\planx_sdk
+```
+*(Ya da `planx_sdk` klasörünün içindeyken: `pip install -e .`)*
+
+### 2. Geliştirici Bağımlılıklarının Kurulumu
+Birim testlerini koşmak, kod formatlamak veya lint araçlarını kullanmak için geliştirici paketlerini kurabilirsiniz:
+```bash
+pip install -e .[dev]
+```
+
+---
+
+## 💡 QGIS Eklentilerinde Kullanım Stratejileri
+
+QGIS eklentilerinizin bu paket ile haberleşmesi için iki temel yöntem mevcuttur:
+
+### Yöntem A: Yerel Geliştirici Ortamı (Development)
+Geliştirme makinenizde, QGIS'in kullandığı Python interpreter'ına (`OSGeo4W` veya `conda` ortamı) SDK'yı yukarıdaki gibi `pip install -e` ile kurun. 
+Eklenti kodunuzda doğrudan standart importları yapabilirsiniz:
+```python
+from planx.spatial import brandes_betweenness
+from planx.geostats import calculate_getis_ord
+```
+
+### Yöntem B: Dağıtım / Yayınlama Süreci (Vendoring / Bundling)
+QGIS Hub'da yayınlarken, eklenti zip paketinin kendi kendine yetmesi gerekir (kullanıcıdan harici `pip install` yapması beklenemez).
+Bu sorunu çözmek için, `Build-PluginZip.ps1` veya release betiğinizin içine SDK'yı eklentinin kendi `libs` klasörüne yükleyen bir adım ekleyebilirsiniz:
+
+```powershell
+# Eklentinin zip paketleme aşamasında target klasör olarak eklenti altındaki 'libs' belirlenir:
+pip install C:\Users\YE\PyCharmMiscProject\planx_sdk -t C:\Users\YE\PyCharmMiscProject\qgis_plugins\<eklenti_klasoru>\libs --upgrade
+```
+
+Eklentinizin giriş noktasında (`__init__.py` veya ana modülün en üstünde) bu `libs` klasörünü Python arama yoluna (`sys.path`) eklemeniz yeterlidir:
+```python
+import os
+import sys
+
+# Eklenti altındaki 'libs' klasörünü sys.path'e en yüksek öncelikle ekle
+libs_path = os.path.join(os.path.dirname(__file__), 'libs')
+if libs_path not in sys.path:
+    sys.path.insert(0, libs_path)
+
+# Artık SDK sorunsuzca import edilebilir
+from planx.spatial import many_to_many
+```
+
+---
+
+## 🧪 Testleri Koşturma (Running Tests)
+
+SDK'nın doğruluğunu test etmek için `pytest` kullanabilirsiniz. Proje kök dizininde (`C:\Users\YE\PyCharmMiscProject\planx_sdk`) şu komutu çalıştırmanız yeterlidir:
+
+```bash
+pytest
+```
+
+---
+
+## 📝 Lisans (License)
+
+Bu proje **MIT Lisansı** ile lisanslanmıştır. Detaylar için [LICENSE](LICENSE) dosyasına göz atabilirsiniz.

planx_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "planx-sdk"
+version = "0.1.0"
+authors = [
+    { name = "Yusuf Eminoğlu", email = "yusufeminoglu@gmail.com" }
+]
+description = "Core spatial analytics, spatial statistics, and urban resilience engines for the PlanX ecosystem."
+readme = "README.md"
+requires-python = ">=3.9"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: GIS",
+]
+dependencies = [
+    "numpy>=1.20.0",
+    "scipy>=1.7.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "black>=22.0.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.black]
+line-length = 100
+target-version = ['py39']
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+select = ["E", "F", "W", "I"]
+ignore = []

planx_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

planx_sdk-0.1.0/src/planx/__init__.py

@@ -0,0 +1,9 @@
+# -*- coding: utf-8 -*-
+"""
+PlanX SDK
+~~~~~~~~~
+Core spatial analytics, statistics, and urban resilience engines.
+"""
+
+__version__ = "0.1.0"
+__author__ = "Yusuf Eminoğlu"

planx_sdk-0.1.0/src/planx/geostats/__init__.py

@@ -0,0 +1,59 @@
+# -*- coding: utf-8 -*-
+"""
+PlanX Spatial Statistics Submodule
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Core spatial statistical engines including local/global spatial autocorrelation,
+regression modeling, point pattern analysis, and clustering.
+"""
+
+from .stats_engines import (
+    calculate_average_nearest_neighbor,
+    calculate_bivariate_lee_l,
+    calculate_central_feature,
+    calculate_distance_band_stats,
+    calculate_exploratory_regression,
+    calculate_general_g,
+    calculate_getis_ord,
+    calculate_global_moran,
+    calculate_glr,
+    calculate_gwr,
+    calculate_incremental_autocorrelation,
+    calculate_kmeans,
+    calculate_linear_directional_mean,
+    calculate_local_moran,
+    calculate_mean_center,
+    calculate_median_center,
+    calculate_ols,
+    calculate_ripleys_k,
+    calculate_sde,
+    calculate_similarity_search,
+    calculate_spatial_gini,
+    calculate_standard_distance,
+    run_sensitivity_simulation,
+)
+
+__all__ = [
+    "calculate_getis_ord",
+    "calculate_bivariate_lee_l",
+    "calculate_mean_center",
+    "calculate_central_feature",
+    "calculate_sde",
+    "calculate_local_moran",
+    "calculate_ols",
+    "calculate_global_moran",
+    "calculate_spatial_gini",
+    "calculate_average_nearest_neighbor",
+    "calculate_standard_distance",
+    "calculate_gwr",
+    "calculate_median_center",
+    "calculate_general_g",
+    "calculate_similarity_search",
+    "calculate_distance_band_stats",
+    "calculate_kmeans",
+    "calculate_linear_directional_mean",
+    "run_sensitivity_simulation",
+    "calculate_incremental_autocorrelation",
+    "calculate_ripleys_k",
+    "calculate_exploratory_regression",
+    "calculate_glr",
+]