tr-gurultu
English summary. tr-gurultu is a dependency-free Python library and CLI for
environmental noise assessment under the Turkish Çevresel Gürültü Kontrol Yönetmeliği
(Environmental Noise Control Regulation, Official Gazette 30.11.2022 No. 32029). It
computes the noise indicators Lgündüz, Lakşam, Lgece and Lgag (Lden) from hourly or
interval Leq data, checks levels against the regulation's limit values (and the repealed
2010 area-type tables for reference), screens construction-site hours, does energetic
decibel arithmetic and simple distance attenuation, and builds the population exposure
band tables used in strategic noise maps. Reports and CLI output are in Turkish.
Türkçe. tr-gurultu, Çevresel Gürültü Kontrol Yönetmeliği (Resmî Gazete
30.11.2022, sayı 32029) kapsamında çevresel gürültü değerlendirmesi için bağımlılıksız
bir Python kütüphanesi ve komut satırı aracıdır:
- Gürültü göstergeleri: saatlik veya istenen sürede (ör. 5 dakikalık) Leq verisinden Lgündüz, Lakşam, Lgece ve Lgag (Lden). Dönem sınırlarını (07:00, 19:00, 23:00) aşan aralıklar bölünür, birden çok günün verisi enerjetik olarak birleştirilir, her dönemin kapsanan süresi raporlanır.
- Desibel aritmetiği: enerjetik toplama, (zaman ağırlıklı) ortalama, çıkarma ve arka plan gürültüsü düzeltmesi.
- Sınır değerler: 2022 yönetmeliğinin Ek-2 Tablo 1'i (endüstri, ulaşım, müzik yayını yapan işyerleri, işyerleri, LCmax) ve başvuru için yürürlükten kaldırılmış 2010 yönetmeliğinin alan türüne göre tabloları (kara yolu, hava alanı, endüstri, şantiye, raylı sistem, eğlence yerleri). Tüm tablolar kullanıcı tarafından (Python veya JSON ile) değiştirilebilir; örneğin İl Mahalli Çevre Kurulu kararları.
- Aşım kontrolü ve rapor: dönem bazında ölçülen/sınır/fark tablosu, Türkçe metin ve Markdown rapor, JSON çıktı.
- Şantiye: Ek-2 Tablo 2 izinli saatleri (şantiye 10:00-22:00, açık hava etkinlikleri 10:00-01:00, havai fişek 20:00-22:00, patlatma 10:00-20:00), LCmax 100 dB(C) ve 2010 Tablo-5 sınırları.
- Mesafe azalımı: nokta ve çizgi kaynak için geometrik yayılma, ses gücünden ses basıncı düzeyi (ISO 9613-2 Adiv), tampon mesafe hesabı (ön değerlendirme).
- Maruziyet tablosu: gürültü haritası alıcı noktalarından 50-54, 55-59 … ≥75 dB aralıklarına düşen nüfus/konut sayıları, en yakın yüzlüğe yuvarlama ve 55/65/75 dB üzeri toplamlar.
pip install tr-gurultu
Python 3.9 veya üstü gerekir; çalışma zamanı bağımlılığı yoktur.
Hızlı başlangıç (Python)
from tr_gurultu import (
indicators_from_hourly, get_limit, check_compliance,
db_sum, level_at_distance, exposure_table, check_construction,
)
# 00:00'dan 23:00'e 24 saatlik LAeq,1h değerleri
hourly = [52.1, 50.4, 49.8, 49.5, 50.2, 53.7, 58.9, 63.5,
66.2, 65.8, 65.1, 64.9, 65.3, 65.0, 64.8, 65.2,
66.0, 66.4, 65.7, 63.9, 62.5, 61.8, 60.2, 57.0]
ind = indicators_from_hourly(hourly)
print(round(ind.lgunduz, 1), round(ind.laksam, 1), round(ind.lgece, 1), round(ind.lgag, 1))
# 65.4 62.3 54.1 65.4
res = check_compliance(ind, get_limit("ulasim"), location="Örnek cephe")
print(res.to_text()) # Türkçe aşım raporu
res.exceeded # True (gündüz +0.4, akşam +2.3 dB)
db_sum([60, 60]) # 63.01 dB
level_at_distance(82, 10, 120) # nokta kaynak: 60.4 dB
check_construction("08:00", "23:00").hours_ok # False: 180 dk izin dışı
exposure_table([53.2, 57.9, 76.5], [120, 340, 14]).to_text()
Aralık verisi (ör. 5 dakikalık ölçümler, birden çok gün) için:
from tr_gurultu import indicators_from_intervals
ind = indicators_from_intervals([
("2025-06-01T18:30:00", 60, 70.0), # (başlangıç, süre_dk, LAeq) — 30 dk gündüz + 30 dk akşam
("23:00", 480, 50.0),
("07:00", 690, 70.0),
])
Hızlı başlangıç (komut satırı)
tr-gurultu gosterge olcum.csv # 'saat;leq' veya 'baslangic;sure_dk;leq'
tr-gurultu lgag 65 62 57 # Lgag = 66.1 dB(A)
tr-gurultu topla 68 71 # enerjetik toplam
tr-gurultu ortalama 70 50 --agirlik 45,15 # zaman ağırlıklı ortalama
tr-gurultu arkaplan 60 55 # arka plan düzeltmesi
tr-gurultu sinir # 2022 sınır değer tablosu
tr-gurultu sinir --surum 2010 # 2010 tabloları (kaldırıldı, başvuru)
tr-gurultu kontrol --kaynak ulasim --gunduz 66 --aksam 58 --gece 56 --lcmax 98
tr-gurultu kontrol --kaynak isyeri --gunduz 54 --arka-plan 50
tr-gurultu kontrol --kaynak karayolu --surum 2010 --alan konut --tur mevcut --dosya olcum.csv
tr-gurultu mesafe --duzey 82 --ref 10 --mesafe 120 --hedef 55
tr-gurultu santiye --baslangic 08:00 --bitis 23:00 --lcmax 97
tr-gurultu maruziyet alicilar.csv --nufus-sutun nufus --csv
tr-gurultu kategori 62 # 2010 madde 27 planlama kategorisi
Her komut --json ile makine tarafından okunabilir çıktı verir. kontrol ve santiye
komutları aşım olduğunda çıkış kodu 1, hata durumunda 2 döndürür; betiklerde ve
sürekli entegrasyonda kullanılabilir. CSV dosyaları UTF-8 (BOM'lu olabilir) veya
Windows-1254, ;/,/sekme ayırıcılı ve ondalık virgüllü olabilir.
API özeti
| İşlev / sınıf | Açıklama |
|---|---|
indicators_from_hourly(values) |
24×n saatlik değer veya {saat: leq} → NoiseIndicators |
indicators_from_intervals(items) |
(başlangıç, süre_dk, leq) aralıkları → NoiseIndicators |
lgag(ld, le, ln) / lden |
Ek-3 madde 2.1 formülü |
PeriodScheme(...) |
dönem başlangıçları ve cezalar (varsayılan 07/19/23, +5/+10 dB) |
db_sum, db_mean, db_subtract, background_correction |
desibel aritmetiği |
get_limit(kaynak, alan, edition=, variant=) |
LimitValue (gündüz/akşam/gece) |
LIMITS_2022, LIMITS_2010, load_limit_table(json) |
tablolar ve kullanıcı değişiklikleri |
check_compliance(levels, limit, background=, lcmax=) |
ComplianceResult (to_text, to_markdown, to_dict) |
check_construction(start, end, ...), is_permitted |
şantiye ve açık hava faaliyet saatleri |
level_at_distance, distance_for_level, lw_to_lp, lw_line_to_lp |
mesafe azalımı |
exposure_table(levels, weights, bands=), exposure_above |
maruziyet tabloları |
planning_category_2010(lgunduz) |
2010 madde 27 A-D kategorisi |
Sınır değerlerin değiştirilmesi:
from tr_gurultu import LIMITS_2022, get_limit
karar = LIMITS_2022.with_overrides({"ulasim": {"gece": 50},
"sessiz_alan": {"gunduz": 50, "aksam": 45, "gece": 40}})
get_limit("sessiz_alan", table=karar)
{"endustri": {"gece": 50}, "sessiz_alan": {"gunduz": 50, "aksam": 45, "gece": 40}}
tr-gurultu kontrol ... --sinir-dosyasi karar.json
Yöntem ve kaynaklar
| Konu | Kaynak |
|---|---|
| Dönemler (gündüz 07-19, akşam 19-23, gece 23-07) | Çevresel Gürültü Kontrol Yönetmeliği (RG 30.11.2022/32029) Ek-1 (c), (ğ), (h) |
| Lgag formülü, 12/4/8 saat, +5/+10 dB | aynı yönetmelik Ek-3 madde 2.1; AB 2002/49/EC Ek I (Lden) |
| Sınır değerler 2022 (65/60/55; müzik 60/55/50, 63-250 Hz; işyeri arka plan +5/+3, çoklu +7/+5; LCmax 100 dB(C)) | Ek-2 Tablo 1 |
| İzinli saatler (şantiye 10-22, açık hava etkinlik 10-01, havai fişek 20-22, patlatma 10-20) | Ek-2 Tablo 2; kamu yararı projeleri Ek-2 madde 10; sınav günleri madde 11 |
| Maruziyet aralıkları 50-54 … >75 dB, yüzlüğe yuvarlama, >55/65/75 dB toplamları | Ek-3 madde 1.8.1.4, 1.8.1.5, 1.8.2.7 |
| 2010 tabloları (kara yolu, hava alanı, endüstri, şantiye), raylı/helikopter/su yolu 65/60/55, işyeri/eğlence arka plan + 5 dBA, madde 27 kategorileri | Çevresel Gürültünün Değerlendirilmesi ve Yönetimi Yönetmeliği (RG 04.06.2010/27601) Ek-VII ve madde 19-24, 27 (30.11.2022'de yürürlükten kaldırıldı) |
| Yüzlüğe yuvarlama kuralı (5150-5249 → 5200) | 2010 yönetmeliği Ek-VI 1.5 örneği |
| Nokta kaynak Adiv = 20 lg d + 11 dB | ISO 9613-2:1996 eşitlik (7) |
| Çizgi kaynak 10 lg(r2/r1), Lp = Lw' − 10 lg(2πd) | silindirik yayılma (temel akustik) |
| Arka plan düzeltmesi (≥10 dB düzeltme yok, 3-10 dB enerjetik çıkarma, <3 dB güvenilmez) | TS ISO 1996-2 uygulaması |
2022 metni ve ek PDF'i Resmî Gazete'den, 2010 ekleri 04.06.2010 tarihli Resmî Gazete'nin ek dosyasından doğrulanmıştır. Güncel metin: https://www.mevzuat.gov.tr (MevzuatNo 39864).
Not: Yönetmeliğin 2022 sürümünün adı Çevresel Gürültü Kontrol Yönetmeliğidir; 2010 tarihli Çevresel Gürültünün Değerlendirilmesi ve Yönetimi Yönetmeliğini yürürlükten kaldırmıştır (madde 21).
Sınırlamalar
- Bu paket ön değerlendirme ve eğitim içindir; resmî akustik rapor, stratejik gürültü haritası veya denetim ölçümünün yerini tutmaz. Ölçümler TS ISO 1996-1/-2'ye göre, yetkin kişilerce yapılmalıdır.
- 2022 Tablo 1 sınırları LAeq,5dk (müzik yayınında 63-250 Hz bandında LAeq) olarak
tanımlıdır.
check_compliancekendisine verilen düzeyi doğrudan karşılaştırır; uzun dönem Lgündüz/Lakşam/Lgece ile karşılaştırmak bir yorumdur. 5 dakikalık değerleri tek tek kontrol etmek için her aralığı ayrı ayrı verin. - 2022 tablosunda alan türüne göre ayrım ve şantiyeler için düzey sınırı yoktur. Şantiye
düzeyi için il kurullarının uyguladığı değer
level_limitile verilebilir. - 2010 tabloları yalnızca başvuru içindir, ilk yayımlanmış hâliyle aktarılmıştır; 2011, 2015 ve 2022 değişiklikleri işlenmemiştir. 2010'daki "7-10 dBA" aralıkları için alt sınır (7 dBA) kullanılır.
- Ek-2 madde 3'teki ton/darbe seviye ayarlamaları otomatik uygulanmaz.
- Mesafe azalımı yalnızca geometrik yayılma ve isteğe bağlı doğrusal hava yutmasıdır;
zemin etkisi, perdeleme, yansıma ve meteoroloji yoktur. Kaynak modellemesi (CNOSSOS-EU)
ve ISO 9613-2 yayılımı için aynı yazarın
roadnoisepaketine bakın;tr-gurultuyönetmelik göstergeleri ve sınır değerlerine odaklanır. - Arka plan düzeltmesi eşikleri (3 ve 10 dB) ISO 1996-2'nin yaygın uygulamasından alınmıştır ve parametre olarak değiştirilebilir.
Akademik atıf
@software{eminoglu_tr_gurultu,
author = {Eminoğlu, Yusuf},
title = {tr-gurultu},
year = {2026},
version = {0.1.0},
url = {https://gitlab.com/geophilo1/tr_gurultu_sdk}
}
Lisans
MIT © 2026 Yusuf Eminoğlu. Ayrıntılar için LICENSE. İletişim: geospacephilo@gmail.com
Metadata
Release files for tr-gurultu 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tr_gurultu-0.1.0.tar.gz | 53.2 kB | Without provenance | Details for tr_gurultu-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tr_gurultu-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for tr_gurultu-0.1.0-py3-none-any.whl |
Total release size: 96.7 kB
Release files / tr_gurultu-0.1.0.tar.gz
| Download URL | tr_gurultu-0.1.0.tar.gz |
|---|---|
| Size | 53.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bdf68e98b9215ee1451955120c18218f95f39a9fa3bccc9e63c86a64acd4a608
|
|
BLAKE2b-256 checksum How to use checksums |
579e9f09bb2d9c672cc08fb184821b03686d11e3e8632436591cda22e553a713
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.18
|
Release files / tr_gurultu-0.1.0-py3-none-any.whl
| Download URL | tr_gurultu-0.1.0-py3-none-any.whl |
|---|---|
| Size | 43.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b2e22f7ecb8829b4e76113ef3635aa787cd2b395f8791e43edd0343ba1ce07b5
|
|
BLAKE2b-256 checksum How to use checksums |
115bd0817d3de06d83642bb58e131ad5c2f9511bb7e49acc0a8e621753279a87
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.18
|
Security for tr-gurultu 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.