doppy 0.2.2__cp310-abi3-macosx_11_0_arm64.whl → 0.2.4__cp310-abi3-macosx_11_0_arm64.whl

doppy/netcdf.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import warnings
 from typing import Literal, TypeAlias
 
 import netCDF4
@@ -17,10 +18,14 @@ class Dataset:
         self.nc.createDimension(dim, None)
         return self
 
-    def add_atribute(self, key: str, val: str) -> Dataset:
+    def add_attribute(self, key: str, val: str) -> Dataset:
         setattr(self.nc, key, val)
         return self
 
+    def add_atribute(self, key: str, val: str) -> Dataset:
+        warnings.warn("Use add_attribute", DeprecationWarning)
+        return self.add_attribute(key, val)
+
     def add_time(
         self,
         name: str,

doppy/product/stare.py

@@ -142,7 +142,7 @@ def _compute_beta(
     c
         speed of light
     B
-        reveiver bandwidth
+        receiver bandwidth
 
     References
     ----------
@@ -560,7 +560,7 @@ def _select_raws_for_stare(
 
 
 def _selection_key(raw: doppy.raw.HaloHpl) -> SelectionGroupKeyType:
-    return (raw.header.mergable_hash(),)
+    return (raw.header.mergeable_hash(),)
 
 
 def _time2bg_time(

doppy/product/wind.py

@@ -406,7 +406,7 @@ def _selection_key(raw: doppy.raw.HaloHpl) -> SelectionGroupKeyType:
     if len(raw.elevation_angles) != 1:
         raise ValueError("Expected only one elevation angle")
     return (
-        raw.header.mergable_hash(),
+        raw.header.mergeable_hash(),
         next(iter(raw.elevation_angles)),
         tuple(sorted(raw.azimuth_angles)),
     )

doppy/raw/halo_hpl.py

@@ -207,7 +207,7 @@ class HaloHplHeader:
     system_id: str
     instrument_spectral_width: float | None
 
-    def mergable_hash(self) -> int:
+    def mergeable_hash(self) -> int:
         return hash(
             (
                 self.gate_points,

doppy/raw/halo_sys_params.py

@@ -81,7 +81,7 @@ def _from_src(data: BufferedIOBase) -> HaloSysParams:
     b = [r.split(b"\t") for r in a]
     arr = np.array(b)
     if arr.shape[1] != 7:
-        raise ValueError("Unexpected data fromat")
+        raise ValueError("Unexpected data format")
 
     def timestr2datetime64_12H(datetime_bytes: bytes) -> np.datetime64:
         return datetime64(

doppy/raw/wls70.py

@@ -33,6 +33,7 @@ class Wls70:
     ]  # v := meridional wind?, dim: (time, altitude)
     vertical_wind: npt.NDArray[np.float64]  # w := vertical wind?, dim: (time, altitude)
     system_id: str
+    cnr_threshold: float
 
     @classmethod
     def from_srcs(
@@ -111,6 +112,7 @@ class Wls70:
                 meridional_wind=self.meridional_wind[index],
                 vertical_wind=self.vertical_wind[index],
                 system_id=self.system_id,
+                cnr_threshold=self.cnr_threshold,
             )
         raise TypeError
 
@@ -137,6 +139,9 @@ class Wls70:
             meridional_wind=np.concatenate(tuple(r.meridional_wind for r in raws)),
             vertical_wind=np.concatenate(tuple(r.vertical_wind for r in raws)),
             system_id=merge_all_equal("system_id", [r.system_id for r in raws]),
+            cnr_threshold=merge_all_equal(
+                "cnr_threshold", [r.cnr_threshold for r in raws]
+            ),
         )
 
     def non_strictly_increasing_timesteps_removed(self) -> Wls70:
@@ -158,6 +163,7 @@ def _raw_rs_to_wls70(
     info, cols, data = raw_rs
     altitude = info["altitude"]
     system_id = info["system_id"]
+    cnr_threshold = float(info["cnr_threshold"])
     data = data.reshape(-1, len(cols))
     time_ts = data[:, 0]
     time = np.array([datetime64(datetime.utcfromtimestamp(ts)) for ts in time_ts])
@@ -173,7 +179,10 @@ def _raw_rs_to_wls70(
     u = data[:, 9::8]
     v = data[:, 10::8]
     w = data[:, 11::8]
-
+    mask = (np.abs(u) > 90) | (np.abs(v) > 90) | (np.abs(w) > 90)
+    u[mask] = np.nan
+    v[mask] = np.nan
+    w[mask] = np.nan
     return Wls70(
         time=time,
         altitude=altitude,
@@ -189,4 +198,5 @@ def _raw_rs_to_wls70(
         meridional_wind=v,
         vertical_wind=w,
         system_id=system_id,
+        cnr_threshold=cnr_threshold,
     )

doppy-0.2.4.dist-info/METADATA

@@ -0,0 +1,137 @@
+Metadata-Version: 2.3
+Name: doppy
+Version: 0.2.4
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Requires-Dist: requests
+Requires-Dist: urllib3
+Requires-Dist: numpy
+Requires-Dist: netcdf4
+Requires-Dist: typer
+Requires-Dist: matplotlib
+Requires-Dist: scikit-learn
+Requires-Dist: scipy
+Requires-Dist: mypy ; extra == 'dev'
+Requires-Dist: ruff ; extra == 'dev'
+Requires-Dist: pytest ; extra == 'dev'
+Requires-Dist: types-requests ; extra == 'dev'
+Requires-Dist: py-spy ; extra == 'dev'
+Requires-Dist: maturin ==1.4 ; extra == 'dev'
+Requires-Dist: release-version ; extra == 'dev'
+Requires-Dist: pre-commit ; extra == 'dev'
+Provides-Extra: dev
+License-File: LICENSE
+License-File: LICENSE
+Author: Niko Leskinen <niko.leskinen@fmi.fi>
+Author-email: Niko Leskinen <niko.leskinen@fmi.fi>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/actris-cloudnet/doppy
+Project-URL: Repository, https://github.com/actris-cloudnet/doppy
+Project-URL: Changelog, https://github.com/actris-cloudnet/doppy/blob/main/CHANGELOG.md
+Project-URL: Bug Tracker, https://github.com/actris-cloudnet/doppy/issues
+
+# Doppy – Doppler wind lidar processing
+
+[![CI](https://github.com/actris-cloudnet/doppy/actions/workflows/ci.yml/badge.svg)](https://github.com/actris-cloudnet/doppy/actions/workflows/ci.yml)
+[![PyPI version](https://badge.fury.io/py/doppy.svg)](https://badge.fury.io/py/doppy)
+
+## Products
+
+- [Stare](https://github.com/actris-cloudnet/doppy/blob/main/src/doppy/product/stare.py): [Examples](https://cloudnet.fmi.fi/search/visualizations?experimental=true&product=doppler-lidar&dateFrom=2024-06-05&dateTo=2024-06-05)
+- [Wind](https://github.com/actris-cloudnet/doppy/blob/main/src/doppy/product/wind.py): [Examples](https://cloudnet.fmi.fi/search/visualizations?experimental=true&product=doppler-lidar-wind&dateFrom=2024-06-05&dateTo=2024-06-05)
+
+## Instruments
+
+- HALO Photonics Streamline lidars (stare, wind)
+- Leosphere WindCube WLS200S (wind)
+- Leosphere WindCube WLS70 (wind)
+
+## Install
+
+```sh
+pip install doppy
+```
+
+## Usage
+
+```python
+import doppy
+
+stare = doppy.product.Stare.from_halo_data(
+    data=LIST_OF_STARE_FILE_PATHS,
+    data_bg=LIST_OF_BACKGROUND_FILE_PATHS,
+    bg_correction_method=doppy.options.BgCorrectionMethod.FIT,
+)
+
+
+(
+    doppy.netcdf.Dataset(FILENAME)
+    .add_dimension("time")
+    .add_dimension("range")
+    .add_time(
+        name="time",
+        dimensions=("time",),
+        standard_name="time",
+        long_name="Time UTC",
+        data=stare.time,
+        dtype="f8",
+    )
+    .add_variable(
+        name="range",
+        dimensions=("range",),
+        units="m",
+        data=stare.radial_distance,
+        dtype="f4",
+    )
+    .add_variable(
+        name="elevation",
+        dimensions=("time",),
+        units="degrees",
+        data=stare.elevation,
+        dtype="f4",
+        long_name="elevation from horizontal",
+    )
+    .add_variable(
+        name="beta_raw",
+        dimensions=("time", "range"),
+        units="sr-1 m-1",
+        data=stare.beta,
+        dtype="f4",
+    )
+    .add_variable(
+        name="beta",
+        dimensions=("time", "range"),
+        units="sr-1 m-1",
+        data=stare.beta,
+        dtype="f4",
+        mask=stare.mask,
+    )
+    .add_variable(
+        name="v",
+        dimensions=("time", "range"),
+        units="m s-1",
+        long_name="Doppler velocity",
+        data=stare.radial_velocity,
+        dtype="f4",
+        mask=stare.mask,
+    )
+    .add_scalar_variable(
+        name="wavelength",
+        units="m",
+        standard_name="radiation_wavelength",
+        data=stare.wavelength,
+        dtype="f4",
+    )
+    .add_attribute("serial_number", stare.system_id)
+    .add_attribute("doppy_version", doppy.__version__)
+).close()
+
+```
+

{doppy-0.2.2.dist-info → doppy-0.2.4.dist-info}/RECORD

@@ -1,15 +1,14 @@
-doppy-0.2.2.dist-info/METADATA,sha256=D5HIkmOh9XCD5O0B1Vf8A4dSuSqLp5wEuEV9FKJNM70,1789
-doppy-0.2.2.dist-info/WHEEL,sha256=Eyff-rEDSOF0Q7IZpSwsYe3r6zR3sNi9c9VlO0C9EVo,103
-doppy-0.2.2.dist-info/entry_points.txt,sha256=9b_Ca7vJoh6AwL3W8qAPh_UmJ_1Pa6hi-TDfCTDjvSk,43
-doppy-0.2.2.dist-info/license_files/LICENSE,sha256=V-0iroMNMI8ctnLgUau1kdFvwhkYhr9vi-5kWKxw2wc,1089
-doppy-0.2.2.dist-info/license_files/LICENSE,sha256=V-0iroMNMI8ctnLgUau1kdFvwhkYhr9vi-5kWKxw2wc,1089
+doppy-0.2.4.dist-info/METADATA,sha256=v9HI3W9NwDiBFoi7WimE35gNO4zd4wddz1sg0JM_0Qo,4146
+doppy-0.2.4.dist-info/WHEEL,sha256=8YVHbP9g43_6FVsydzNKX35DdPN9RlBfh4bOfODYltg,103
+doppy-0.2.4.dist-info/entry_points.txt,sha256=9b_Ca7vJoh6AwL3W8qAPh_UmJ_1Pa6hi-TDfCTDjvSk,43
+doppy-0.2.4.dist-info/license_files/LICENSE,sha256=V-0iroMNMI8ctnLgUau1kdFvwhkYhr9vi-5kWKxw2wc,1089
 doppy/options.py,sha256=73BDODO4OYHn2qOshhwz6u6G3J1kNd3uj6P0a3V4HBE,205
 doppy/__init__.py,sha256=Z9aEUlbPRWRUAoB8_-djkgrJuS4-6pjem4-mVSB6Z9I,191
-doppy/product/wind.py,sha256=mL8Ru7Hefq8YBYFIklBkySO3OEoRQ32ZPgB3deIhO7c,13042
+doppy/product/wind.py,sha256=MXm5HDoO3X6AzvpPHYPlpUXB_MYp_TBPP81aZ151wj8,13043
 doppy/product/__init__.py,sha256=DwTrvhMY_Eq-RG3H6Qyg_R_E9ie1wv0ofKr_1rSJ4Sk,172
-doppy/product/stare.py,sha256=aMhOA5yXjcnwgzAp4GvLF1HT1cD-Zuqg9sEQIPlxWa0,19907
+doppy/product/stare.py,sha256=jt1vHptufBFwUH5Un_0pk44eHKbAWnkhrU7HUI7gYJ4,19908
 doppy/bench.py,sha256=iVNYveMVGGRES2oe3Orsn31jQFCKTXOmxRFuFiJ8_OA,248
-doppy/netcdf.py,sha256=uEiJfqxXxHwe5ghT6OpIu8xeY1HgWDW1ENTBlFLOGtE,3416
+doppy/netcdf.py,sha256=bGl3oeXtL04Qz0RR2mIdNYp-nWq-OI7_aR3oFfeezOc,3600
 doppy/utils.py,sha256=qPtIYBJPaKKTmRWwJI93TFUuhJg7CAoecpyHCm5ZyxI,214
 doppy/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 doppy/exceptions.py,sha256=1tljrtzp0McQhB6INFXj4yfLjxj6mXor5jLF9HZjp1A,138
@@ -18,12 +17,12 @@ doppy/data/cache.py,sha256=2rxmkWFn-FPy2LNGuCW2Vu4KKLBwIV9sb2gPBA-Jfck,996
 doppy/data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 doppy/data/api.py,sha256=QaVKj304OPcu8OF5xgtduQzDis8Srn-I6UgR9qb2u9E,1863
 doppy/data/exceptions.py,sha256=6CS6OHIWq8CqlxiceEvC1j0EfWUYoIfM7dW88apQVn4,89
-doppy/raw/halo_sys_params.py,sha256=IXH40xBHyXCGX0ZE79KnSeXRj1wbqoqL0RYUQyBJqdE,3937
+doppy/raw/halo_sys_params.py,sha256=DeOIIRtVdO7HnNY3FaI4u035ScI65jfDgUrEccLepEo,3937
 doppy/raw/__init__.py,sha256=AMHyONuH0aUJUQz20EhlANaq9UjWJtSZf7kWUVx3ZjA,228
-doppy/raw/wls70.py,sha256=paFT8PddRemtiDAXxkZVcMljCq_CFw1DHmxLHXY0ZhE,7008
+doppy/raw/wls70.py,sha256=PMyr_JYTiKuYv1JpWHgVX6OA5zU83DOnr8vBCxFyFAw,7420
 doppy/raw/halo_bg.py,sha256=kO03yGlKS-DpMMGHYuy_BuidyeUL38TxT5vMn8H_8lE,4809
-doppy/raw/halo_hpl.py,sha256=VkWemJfGFu-tF-fkhjYwF6dCZPrNQanqL0NBFJVS-TQ,18485
+doppy/raw/halo_hpl.py,sha256=YFTepAWXvIfAVGgLZCadsc1d-VaOh7j2RB3cpb6Sv6k,18486
 doppy/raw/windcube.py,sha256=ZaOswQJbVDPBYj5oU1pTYmsX8F-mKIbjJRZmLYEMXP0,9906
 doppy/__main__.py,sha256=zrKQJVj0k0ypBQCGK65Czt9G9FZ_qx3ussw6Q9VJ14g,346
-doppy/rs.abi3.so,sha256=401CPVp5BPllewqgL2SbsDbFLQvzaIdcTr8sKuj7mX0,2719712
-doppy-0.2.2.dist-info/RECORD,,
+doppy/rs.abi3.so,sha256=yJdzK3Fx1x93awEqLHJr85ucM_t8YabwGAzksFGRdWQ,2680384
+doppy-0.2.4.dist-info/RECORD,,

{doppy-0.2.2.dist-info → doppy-0.2.4.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: maturin (1.5.1)
+Generator: maturin (1.7.0)
 Root-Is-Purelib: false
 Tag: cp310-abi3-macosx_11_0_arm64

doppy-0.2.2.dist-info/METADATA

@@ -1,44 +0,0 @@
-Metadata-Version: 2.3
-Name: doppy
-Version: 0.2.2
-Classifier: Development Status :: 4 - Beta
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Intended Audience :: Science/Research
-Classifier: Operating System :: OS Independent
-Requires-Dist: requests
-Requires-Dist: urllib3
-Requires-Dist: numpy
-Requires-Dist: netcdf4
-Requires-Dist: typer
-Requires-Dist: matplotlib
-Requires-Dist: scikit-learn
-Requires-Dist: scipy
-Requires-Dist: mypy ; extra == 'dev'
-Requires-Dist: ruff ; extra == 'dev'
-Requires-Dist: pytest ; extra == 'dev'
-Requires-Dist: types-requests ; extra == 'dev'
-Requires-Dist: py-spy ; extra == 'dev'
-Requires-Dist: maturin ==1.4 ; extra == 'dev'
-Requires-Dist: release-version ; extra == 'dev'
-Requires-Dist: pre-commit ; extra == 'dev'
-Provides-Extra: dev
-License-File: LICENSE
-License-File: LICENSE
-Author: Niko Leskinen <niko.leskinen@fmi.fi>
-Author-email: Niko Leskinen <niko.leskinen@fmi.fi>
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
-Project-URL: Homepage, https://github.com/actris-cloudnet/doppy
-Project-URL: Repository, https://github.com/actris-cloudnet/doppy
-Project-URL: Changelog, https://github.com/actris-cloudnet/doppy/blob/main/CHANGELOG.md
-Project-URL: Bug Tracker, https://github.com/actris-cloudnet/doppy/issues
-
-# Doppy - Wind doppler lidar processing
-
-[![CI](https://github.com/actris-cloudnet/doppy/actions/workflows/ci.yml/badge.svg)](https://github.com/actris-cloudnet/doppy/actions/workflows/ci.yml)
-[![PyPI version](https://badge.fury.io/py/doppy.svg)](https://badge.fury.io/py/doppy)
-