Analitik istatistik ve çıkarım

Bu sayfa src/cluster_erp/modules/analytics/ içindeki analytics modülünün beş dosyasını anlatır: statistics.py (sağlam betimleyiciler ve aykırı değer taramaları), inference.py (hipotez testleri ve modeller), inference_service.py (bildirilmiş olguları örneklemlere çeviren alma katmanı), distributions.py (p-değerlerinin arkasındaki dağılım işlevleri) ve stratification.py (tabakalı oranlar). Her yöntem ön koşulunu bir kapıya çevirir ve ön koşul sağlanmadığında yanıt vermeyi reddeder (src/cluster_erp/modules/analytics/statistics.py:1-14).

Kapsam ve kaynak¶

• Tanımlandığı yer: StatisticsEngine (src/cluster_erp/modules/analytics/statistics.py:97), inference.py içindeki saf test işlevleri, InferenceEngine (src/cluster_erp/modules/analytics/inference_service.py:153), distributions.py ve stratified_ratio (src/cluster_erp/modules/analytics/stratification.py:54).
• Uçlar: GET /analysis/statistics/{fact_key}/{column}, GET /analysis/outliers/{fact_key}/{column}, GET /analysis/stratified/{fact_key}, GET /analysis/levels/{fact_key} ile /analysis/tests/, /analysis/pca/ ve /analysis/cluster/ altındaki uçlar (src/cluster_erp/modules/analytics/routes.py:117-940).

Betimleyici istatistikler ve aykırı değerler¶

Motor, veritabanının doğal olarak hesapladığı iki nicelik türünü, 1 ve 7'yi destekler (src/cluster_erp/modules/analytics/statistics.py:64-68). Parametreler ayarlardan gelir: analytics_quantile_type (varsayılan 1), analytics_trimmed_mean_pct (10), analytics_mad_sigma_constant (1.4826), analytics_min_n_for_zscore (11) ve analytics_min_iqr_for_fence (0) (src/cluster_erp/config/settings.py:437-452, src/cluster_erp/modules/analytics/service.py:242-253). Belge dizesi, aykırı değer taramasının bir insan inceleme kuyruğu olduğunu, hiçbir zaman otomatik silme veya düzeltme olmadığını belirtir (src/cluster_erp/modules/analytics/statistics.py:21-25).

Hipotez testleri ve modeller¶

Her test listeler üzerinde saf bir işlevdir. InferenceEngine örneklemleri alır ve işlevi çağırır.

Modülün belirttiği kurallar (src/cluster_erp/modules/analytics/inference.py:1-34):

• Her test p-değeriyle birlikte bir etki büyüklüğü döndürür.
• İki sabit grup t değerini tanımsız yapar; test reddedilir.
• Ki-kare Cochran kuralını izler; kuralı çiğneyen daha büyük bir tablo, kuralı bozan sayılarla reddedilir.
• Mann-Whitney küçük ve bağsız gruplarda kesin dağılımı, aksi halde düzeltilmiş normal yaklaşımı kullanır ve hangisini kullandığını söyler.
• Her ölçüm dize olarak döner; sayılar tamsayı kalır.

Örneklem alma¶

Örneklemlerin geldiği tek yer InferenceEngine olur (src/cluster_erp/modules/analytics/inference_service.py:1-17):

• Sütunlar, diğer her okuyucuyla aynı izin listesi olan profile_targets üzerinden çözülür.
• Olgunun canlı süzgeci her zaman uygulanır.
• Birden çok para birimine yayılan parasal bir değer sütunu, para birimi boyutu adlandırılarak reddedilir.
• Satırlar analytics_inference_max_rows (varsayılan 100000) ile sınırlanır ve sınır kesmek yerine reddeder (src/cluster_erp/config/settings.py:524, src/cluster_erp/modules/analytics/inference_service.py:156-158).
• Boş değerler dışarıda bırakılır ve yanıtta sayılır.

GET /analysis/levels/{fact_key}, arayüz grup sunabilsin diye bir boyutun düzeylerini listeler (src/cluster_erp/modules/analytics/routes.py:385-407, src/cluster_erp/modules/analytics/inference_service.py:571).

Dağılım işlevleri¶

distributions.py, p-değerlerinin arkasındaki normal, gama, beta, t, F ve ki-kare işlevlerini standart sayısal algoritmalardan standart kitaplık üzerinde, ek bağımlılık olmadan, çift duyarlıkta uygular (src/cluster_erp/modules/analytics/distributions.py:1-17, src/cluster_erp/modules/analytics/distributions.py:31-185).

Tabakalı oranlar¶

stratified_ratio, grup başına her biri yanıtladığı soruyla etiketlenmiş üç oran döndürür: tabakalı oran, ham oran ve doğrudan standartlaştırılmış oran. Ham ve standartlaştırılmış sıralamalar arasındaki bir tersine dönmeyi işaretler ve bir grubun bir tabakada gözlemi olmadığında kapsamı bildirir (src/cluster_erp/modules/analytics/stratification.py:1-35, src/cluster_erp/modules/analytics/stratification.py:54, src/cluster_erp/modules/analytics/stratification.py:195). Uç GET /analysis/stratified/{fact_key} olur (src/cluster_erp/modules/analytics/routes.py:310-383).

Kısıtlar ve doğrulama¶

• İstatistiksel rakamlar IEEE çift duyarlıkta hesaplanır; parasal girdiler yalnızca test istatistikleri için float tipine çevrilir (src/cluster_erp/modules/analytics/distributions.py:11-17). Bkz. analytics modülü üzerindeki tutarsızlık.
• Tüm motorlar serviste tek bir noktada kurulur; böylece her yanıt aynı nicelik türünü ve kapıları kullanır (src/cluster_erp/modules/analytics/service.py:242-253).

Tanıtılan terimler¶

İlgili sayfalar¶

• Analytics modülü
• Tarifler ve sorgu kurucu
• Tahmin ve sınıflandırma
• Raporlar, özetler ve çapraz

92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.