p835 0.1.0__tar.gz

p835-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Evgeny Gennadievich Prutkov <sviazist.pr@gmail.com>
+
+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.

p835-0.1.0/NOTICE

@@ -0,0 +1,26 @@
+ATTRIBUTION AND SOURCES
+========================
+
+This software (PyP835) is a Python implementation of the mathematical
+model described in:
+
+    ITU-R P.835-7 — "Reference standard atmospheres"
+    International Telecommunication Union, Radiocommunication Sector (ITU-R)
+    Geneva, Switzerland
+
+The ITU-R Recommendations are publicly available at:
+    https://www.itu.int/rec/R-REC-P.835-7/en
+
+The original reference implementation in C++ was published by the
+U.S. National Telecommunications and Information Administration (NTIA)
+and is available at:
+    https://github.com/NTIA/p835-7
+
+The Python port was created by:
+    Evgeny Gennadievich Prutkov <sviazist.pr@gmail.com>, 2026
+
+This software is provided under the MIT License (see LICENSE).
+
+The author of this port is not affiliated with ITU or NTIA. All
+formulas and algorithms are taken from the publicly available
+ITU-R Recommendations.

p835-0.1.0/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: p835
+Version: 0.1.0
+Summary: ITU-R P.835-7 reference standard atmospheres
+Author-email: Evgeny Gennadievich Prutkov <sviazist.pr@gmail.com>
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Dynamic: license-file
+
+# p835
+
+Python-реализация **ITU-R P.835-7** — «Reference standard
+atmospheres».
+
+## Установка
+
+```bash
+pip install -e .
+```
+
+## Использование
+
+```python
+from p835 import global_temperature, global_pressure
+
+T = global_temperature(10.0)   # K
+P = global_pressure(10.0)      # гПа
+```
+
+## Тесты
+
+```bash
+pytest tests/ -v
+```
+
+## Attribution
+
+ATTRIBUTION AND SOURCES
+========================
+
+This software (PyP835) is a Python implementation of the mathematical
+model described in:
+
+    ITU-R P.835-7 — "Reference standard atmospheres"
+    International Telecommunication Union, Radiocommunication Sector (ITU-R)
+    Geneva, Switzerland
+
+The ITU-R Recommendations are publicly available at:
+    https://www.itu.int/rec/R-REC-P.835-7/en
+
+The original reference implementation in C++ was published by the
+U.S. National Telecommunications and Information Administration (NTIA)
+and is available at:
+    https://github.com/NTIA/p835-7
+
+The Python port was created by:
+    Evgeny Gennadievich Prutkov <sviazist.pr@gmail.com>, 2026
+
+This software is provided under the MIT License (see LICENSE).
+
+The author of this port is not affiliated with ITU or NTIA. All
+formulas and algorithms are taken from the publicly available
+ITU-R Recommendations.

p835-0.1.0/README.md

@@ -0,0 +1,54 @@
+# p835
+
+Python-реализация **ITU-R P.835-7** — «Reference standard
+atmospheres».
+
+## Установка
+
+```bash
+pip install -e .
+```
+
+## Использование
+
+```python
+from p835 import global_temperature, global_pressure
+
+T = global_temperature(10.0)   # K
+P = global_pressure(10.0)      # гПа
+```
+
+## Тесты
+
+```bash
+pytest tests/ -v
+```
+
+## Attribution
+
+ATTRIBUTION AND SOURCES
+========================
+
+This software (PyP835) is a Python implementation of the mathematical
+model described in:
+
+    ITU-R P.835-7 — "Reference standard atmospheres"
+    International Telecommunication Union, Radiocommunication Sector (ITU-R)
+    Geneva, Switzerland
+
+The ITU-R Recommendations are publicly available at:
+    https://www.itu.int/rec/R-REC-P.835-7/en
+
+The original reference implementation in C++ was published by the
+U.S. National Telecommunications and Information Administration (NTIA)
+and is available at:
+    https://github.com/NTIA/p835-7
+
+The Python port was created by:
+    Evgeny Gennadievich Prutkov <sviazist.pr@gmail.com>, 2026
+
+This software is provided under the MIT License (see LICENSE).
+
+The author of this port is not affiliated with ITU or NTIA. All
+formulas and algorithms are taken from the publicly available
+ITU-R Recommendations.

p835-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "p835"
+version = "0.1.0"
+description = "ITU-R P.835-7 reference standard atmospheres"
+readme = "README.md"
+dependencies = []
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [
+    { name = "Evgeny Gennadievich Prutkov", email = "sviazist.pr@gmail.com" },
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+
+[project.optional-dependencies]
+test = ["pytest>=7"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

p835-0.1.0/setup.cfg

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

p835-0.1.0/src/p835/__init__.py

@@ -0,0 +1,87 @@
+# Copyright (c) 2026 Evgeny Gennadievich Prutkov <sviazist.pr@gmail.com>
+# SPDX-License-Identifier: MIT
+#
+# Python implementation of ITU-R P.835-7.
+# See README.md and NOTICE for attribution.
+
+"""
+p835 — ITU-R P.835-7 (Reference standard atmospheres).
+
+Использование:
+    from p835 import global_temperature, global_pressure
+
+    T = global_temperature(10.0)   # K
+    P = global_pressure(10.0)      # гПа
+"""
+
+from .reference_atmosphere import (
+    global_temperature,
+    global_pressure,
+    global_water_vapour_density,
+    global_wet_pressure,
+    MODEL_NAME,
+)
+from .seasonal_atmosphere import (
+    AtmosphereRegion,
+    Season,
+    interpolated_temperature,
+    interpolated_pressure,
+    interpolated_water_vapour,
+    get_region_for_latitude,
+    regional_temperature,
+    regional_pressure,
+    regional_water_vapour,
+    low_latitude_annual_temperature,
+    low_latitude_annual_pressure,
+    low_latitude_annual_water_vapour,
+    mid_latitude_summer_temperature,
+    mid_latitude_summer_pressure,
+    mid_latitude_summer_water_vapour,
+    mid_latitude_winter_temperature,
+    mid_latitude_winter_pressure,
+    mid_latitude_winter_water_vapour,
+    high_latitude_summer_temperature,
+    high_latitude_summer_pressure,
+    high_latitude_summer_water_vapour,
+    high_latitude_winter_temperature,
+    high_latitude_winter_pressure,
+    high_latitude_winter_water_vapour,
+)
+from .conversions import (
+    convert_to_geopotential_height,
+    convert_to_geometric_height,
+    water_vapour_density_to_pressure,
+    water_vapour_pressure_to_density,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "global_temperature", "global_pressure",
+    "global_water_vapour_density", "global_wet_pressure",
+    "MODEL_NAME",
+    "AtmosphereRegion", "Season",
+    "interpolated_temperature", "interpolated_pressure",
+    "interpolated_water_vapour", "get_region_for_latitude",
+    "regional_temperature", "regional_pressure",
+    "regional_water_vapour",
+    "low_latitude_annual_temperature",
+    "low_latitude_annual_pressure",
+    "low_latitude_annual_water_vapour",
+    "mid_latitude_summer_temperature",
+    "mid_latitude_summer_pressure",
+    "mid_latitude_summer_water_vapour",
+    "mid_latitude_winter_temperature",
+    "mid_latitude_winter_pressure",
+    "mid_latitude_winter_water_vapour",
+    "high_latitude_summer_temperature",
+    "high_latitude_summer_pressure",
+    "high_latitude_summer_water_vapour",
+    "high_latitude_winter_temperature",
+    "high_latitude_winter_pressure",
+    "high_latitude_winter_water_vapour",
+    "convert_to_geopotential_height",
+    "convert_to_geometric_height",
+    "water_vapour_density_to_pressure",
+    "water_vapour_pressure_to_density",
+]

p835-0.1.0/src/p835/common/__init__.py

@@ -0,0 +1,7 @@
+# Copyright (c) 2026 Evgeny Gennadievich Prutkov <sviazist.pr@gmail.com>
+# SPDX-License-Identifier: MIT
+#
+# Python implementation of ITU-R P.835-7.
+# See README.md and NOTICE for attribution.
+
+

p835-0.1.0/src/p835/common/constants.py

@@ -0,0 +1,172 @@
+# Copyright (c) 2026 Evgeny Gennadievich Prutkov <sviazist.pr@gmail.com>
+# SPDX-License-Identifier: MIT
+#
+# Python implementation of ITU-R P.835-7.
+# See README.md and NOTICE for attribution.
+
+"""
+core/itu/common/constants.py — Физические и математические константы,
+используемые во всех моделях ITU-R.
+
+Источник: Рекомендации ITU-R P-серии, U.S. Standard Atmosphere 1976.
+"""
+
+import math
+
+# =====================================================================
+# ГЕОМЕТРИЧЕСКИЕ И ГРАВИТАЦИОННЫЕ КОНСТАНТЫ
+# =====================================================================
+
+# Радиус Земли (средний), км — ITU-R P.452, P.526, P.530, P.1812
+EARTH_RADIUS_KM = 6371.0
+
+# Радиус Земли по U.S. Standard Atmosphere 1976, км — P.835 (1a/1b)
+# ВАЖНО: в P.835 используется именно это значение (6 356.766 км),
+# а не 6371. Не путать!
+EARTH_RADIUS_P835_KM = 6356.766
+
+# Ускорение свободного падения на поверхности Земли, м/с²
+G0 = 9.80665
+
+# =====================================================================
+# АТМОСФЕРНЫЕ КОНСТАНТЫ (стандартные, на уровне моря)
+# =====================================================================
+
+# Стандартные условия U.S. Standard Atmosphere 1976 / ITU-R P.835
+T0_K = 288.15              # температура, K
+P0_HPA = 1013.25           # давление, гПа
+RHO0_WATER_G_M3 = 7.5      # плотность водяного пара, г/м³
+
+# Универсальная газовая постоянная, Дж/(моль·К)
+R_UNIVERSAL = 8.314462618
+
+# Газовая постоянная сухого воздуха, Дж/(кг·К)
+R_DRY = 287.053
+
+# Газовая постоянная водяного пара, Дж/(кг·К)
+R_H2O = 461.495
+
+# Молярные массы (кг/моль)
+M_DRY_AIR = 28.9644e-3
+M_H2O = 18.0153e-3
+
+# Молекулярные массы (относительные, для P.676)
+# M_d = 28.966, M_w = 18.01528
+M_DRY_AIR_P676 = 28.966
+M_H2O_P676 = 18.01528
+
+# =====================================================================
+# МАТЕМАТИЧЕСКИЕ КОНСТАНТЫ
+# =====================================================================
+
+# Скорость света в вакууме, м/с
+SPEED_OF_LIGHT = 299792458.0
+
+# Скорость света, приближённая, км/с — для удобства формул (c ≈ 300 000)
+SPEED_OF_LIGHT_KM_S = 300000.0
+
+# Постоянная Больцмана, Дж/К
+K_BOLTZMANN = 1.380649e-23
+
+# Температура стандартного шума, K (ITU-R P.372)
+T_NOISE_K = 290.0
+
+# Постоянная Эйлера-Маскерони (не путать с числом e!)
+EULER_GAMMA = 0.5772156649015329
+
+# Число e
+E = math.e
+
+# π
+PI = math.pi
+
+# =====================================================================
+# ПРЕДЕЛЫ ПРИМЕНИМОСТИ МОДЕЛЕЙ ITU-R
+# (для валидации входных параметров)
+# =====================================================================
+
+# P.835: диапазон высот
+P835_Z_MIN_KM = 0.0
+P835_Z_MAX_KM = 100.0
+P835_Z_REGIME1_MAX_KM = 86.0        # переход на regime 2
+P835_H_REGIME1_MAX_KM = 84.852      # геопотенциальная граница
+
+# P.676: диапазон частот
+P676_F_MIN_GHZ = 1.0
+P676_F_MAX_GHZ = 1000.0
+
+# P.528: диапазон частот, расстояний, высот
+P528_F_MIN_MHZ = 100.0
+P528_F_MAX_MHZ = 30000.0
+P528_H_MIN_M = 1.5
+P528_H_MAX_M = 20000.0
+P528_D_MAX_KM = 1800.0
+
+# P.530: диапазон частот, расстояний
+P530_F_MIN_GHZ = 0.45
+P530_F_MAX_GHZ = 45.0
+P530_D_MIN_KM = 7.5
+P530_D_MAX_KM = 300.0
+
+# P.452: диапазон частот, расстояний
+P452_F_MIN_GHZ = 0.1
+P452_F_MAX_GHZ = 50.0
+P452_D_MAX_KM = 10000.0
+
+# P.1812: диапазон частот, расстояний
+P1812_F_MIN_MHZ = 30.0
+P1812_F_MAX_MHZ = 6000.0
+P1812_D_MIN_KM = 0.25
+P1812_D_MAX_KM = 3000.0
+
+# P.2108: диапазон частот
+P2108_F_MIN_GHZ = 0.03
+P2108_F_MAX_GHZ = 100.0
+
+# P.533: диапазон частот
+P533_F_MIN_MHZ = 2.0
+P533_F_MAX_MHZ = 30.0
+
+# =====================================================================
+# ЗНАЧЕНИЯ ПО УМОЛЧАНИЮ
+# =====================================================================
+
+DEFAULT_TEMPERATURE_C = 15.0
+DEFAULT_PRESSURE_HPA = 1013.25
+DEFAULT_HUMIDITY_PERCENT = 50.0
+DEFAULT_WATER_VAPOUR_DENSITY_G_M3 = 7.5
+DEFAULT_POLARIZATION = 'V'
+
+# __all__ — публичный API модуля
+__all__ = [
+    # Геометрия и гравитация
+    'EARTH_RADIUS_KM',
+    'EARTH_RADIUS_P835_KM',
+    'G0',
+    # Атмосфера
+    'T0_K', 'P0_HPA', 'RHO0_WATER_G_M3',
+    'R_UNIVERSAL', 'R_DRY', 'R_H2O',
+    'M_DRY_AIR', 'M_H2O',
+    'M_DRY_AIR_P676', 'M_H2O_P676',
+    # Математика
+    'SPEED_OF_LIGHT', 'SPEED_OF_LIGHT_KM_S',
+    'K_BOLTZMANN', 'T_NOISE_K',
+    'EULER_GAMMA', 'E', 'PI',
+    # Пределы
+    'P835_Z_MIN_KM', 'P835_Z_MAX_KM',
+    'P835_Z_REGIME1_MAX_KM', 'P835_H_REGIME1_MAX_KM',
+    'P676_F_MIN_GHZ', 'P676_F_MAX_GHZ',
+    'P528_F_MIN_MHZ', 'P528_F_MAX_MHZ',
+    'P528_H_MIN_M', 'P528_H_MAX_M', 'P528_D_MAX_KM',
+    'P530_F_MIN_GHZ', 'P530_F_MAX_GHZ',
+    'P530_D_MIN_KM', 'P530_D_MAX_KM',
+    'P452_F_MIN_GHZ', 'P452_F_MAX_GHZ', 'P452_D_MAX_KM',
+    'P1812_F_MIN_MHZ', 'P1812_F_MAX_MHZ',
+    'P1812_D_MIN_KM', 'P1812_D_MAX_KM',
+    'P2108_F_MIN_GHZ', 'P2108_F_MAX_GHZ',
+    'P533_F_MIN_MHZ', 'P533_F_MAX_MHZ',
+    # Умолчания
+    'DEFAULT_TEMPERATURE_C', 'DEFAULT_PRESSURE_HPA',
+    'DEFAULT_HUMIDITY_PERCENT', 'DEFAULT_WATER_VAPOUR_DENSITY_G_M3',
+    'DEFAULT_POLARIZATION',
+]

p835-0.1.0/src/p835/common/exceptions.py

@@ -0,0 +1,40 @@
+# Copyright (c) 2026 Evgeny Gennadievich Prutkov <sviazist.pr@gmail.com>
+# SPDX-License-Identifier: MIT
+#
+# Python implementation of ITU-R P.835-7.
+# See README.md and NOTICE for attribution.
+
+"""
+core/itu/common/exceptions.py — Исключения для моделей ITU-R.
+"""
+
+
+class ITUError(Exception):
+    """Базовый класс для всех ошибок моделей ITU-R."""
+    pass
+
+
+class ITUValidationError(ITUError):
+    """
+    Ошибка валидации входных параметров.
+
+    Поднимается, когда параметр критически вне диапазона применимости
+    модели, и клиент запросил строгий режим (strict=True).
+    """
+
+    def __init__(self, model: str, param: str, value, expected: str):
+        self.model = model
+        self.param = param
+        self.value = value
+        self.expected = expected
+        super().__init__(
+            f"[{model}] Параметр '{param}' = {value} вне диапазона: {expected}"
+        )
+
+
+class ITUComputationError(ITUError):
+    """Ошибка в процессе вычисления (NaN, деление на ноль и т.п.)."""
+    pass
+
+
+__all__ = ['ITUError', 'ITUValidationError', 'ITUComputationError']

p835-0.1.0/src/p835/conversions.py

@@ -0,0 +1,106 @@
+# Copyright (c) 2026 Evgeny Gennadievich Prutkov <sviazist.pr@gmail.com>
+# SPDX-License-Identifier: MIT
+#
+# Python implementation of ITU-R P.835-7.
+# See README.md and NOTICE for attribution.
+
+"""
+core/itu/p835/conversions.py — Преобразования высот и давлений
+по ITU-R P.835-7 (Annex 1).
+
+Формулы:
+    (1a): H = 6356.766·Z / (6356.766 + Z)
+    (1b): Z = 6356.766·H / (6356.766 − H)
+    (7):  e = ρ·T / 216.7
+"""
+
+from .common.constants import EARTH_RADIUS_P835_KM
+
+
+def convert_to_geopotential_height(z_km: float) -> float:
+    """
+    Геометрическая высота Z (км) → геопотенциальная H (км).
+
+    P.835-7, ур. (1a):
+        H = 6356.766·Z / (6356.766 + Z)
+
+    Args:
+        z_km: геометрическая высота, км (0..100).
+
+    Returns:
+        Геопотенциальная высота, км.
+    """
+    r = EARTH_RADIUS_P835_KM
+    return (r * z_km) / (r + z_km)
+
+
+def convert_to_geometric_height(h_km: float) -> float:
+    """
+    Геопотенциальная высота H (км) → геометрическая Z (км).
+
+    P.835-7, ур. (1b):
+        Z = 6356.766·H / (6356.766 − H)
+
+    Args:
+        h_km: геопотенциальная высота, км (0..84.852).
+
+    Returns:
+        Геометрическая высота, км.
+
+    Raises:
+        ValueError: если h_km >= 6356.766 (вырожденный случай).
+    """
+    r = EARTH_RADIUS_P835_KM
+    if h_km >= r:
+        raise ValueError(
+            f"convert_to_geometric_height: H={h_km} км ≥ {r} км"
+        )
+    return (r * h_km) / (r - h_km)
+
+
+def water_vapour_density_to_pressure(
+    rho_g_m3: float, temperature_k: float
+) -> float:
+    """
+    Плотность водяного пара ρ (г/м³) → парциальное давление e (гПа).
+
+    P.835-7, ур. (7):
+        e = ρ·T / 216.7
+
+    Args:
+        rho_g_m3: плотность водяного пара, г/м³.
+        temperature_k: температура, K.
+
+    Returns:
+        Парциальное давление водяного пара, гПа.
+    """
+    return rho_g_m3 * temperature_k / 216.7
+
+
+def water_vapour_pressure_to_density(
+    e_hpa: float, temperature_k: float
+) -> float:
+    """
+    Парциальное давление e (гПа) → плотность ρ (г/м³).
+
+    Обратная к (7):
+        ρ = e·216.7 / T
+
+    Args:
+        e_hpa: парциальное давление, гПа.
+        temperature_k: температура, K.
+
+    Returns:
+        Плотность водяного пара, г/м³.
+    """
+    if temperature_k <= 0:
+        return 0.0
+    return e_hpa * 216.7 / temperature_k
+
+
+__all__ = [
+    'convert_to_geopotential_height',
+    'convert_to_geometric_height',
+    'water_vapour_density_to_pressure',
+    'water_vapour_pressure_to_density',
+]