disdrodb 0.3.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

disdrodb/data_transfer/zenodo.py

@@ -160,7 +160,7 @@ def _define_creators_list(metadata):
 
         # Create info dictionary of each author
         list_creator_dict = []
-        for name, identifier, affiliation in zip(list_names, list_identifier, list_affiliation):
+        for name, identifier, affiliation in zip(list_names, list_identifier, list_affiliation, strict=True):
             creator_dict = {}
             creator_dict["name"] = name.strip()
             creator_dict["orcid"] = identifier.strip()

disdrodb/fall_velocity/__init__.py

@@ -15,6 +15,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 # -----------------------------------------------------------------------------.
 """DISDRODB fall velocity module."""
+
 from disdrodb.fall_velocity.graupel import (
     available_graupel_fall_velocity_models,
     get_graupel_fall_velocity,

disdrodb/fall_velocity/graupel.py

@@ -15,6 +15,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 # -----------------------------------------------------------------------------.
 """Theoretical models to estimate the graupel fall velocity based on particle maximum diameter in mm."""
+
 import numpy as np
 import xarray as xr
 

disdrodb/fall_velocity/hail.py

@@ -15,6 +15,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 # -----------------------------------------------------------------------------.
 """Theoretical models to estimate hailstones fall velocity based on particle maximum diameter in mm."""
+
 import numpy as np
 import xarray as xr
 

disdrodb/fall_velocity/rain.py

@@ -15,6 +15,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 # -----------------------------------------------------------------------------.
 """Theoretical models to estimate the raindrop fall velocity based on drop diameter in mm."""
+
 import numpy as np
 import xarray as xr
 

disdrodb/issue/checks.py

@@ -15,6 +15,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 # -----------------------------------------------------------------------------.
 """Checks for issue YAML files."""
+
 import logging
 
 import numpy as np

disdrodb/issue/reader.py

@@ -15,6 +15,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 # -----------------------------------------------------------------------------.
 """Issue YAML File Reader."""
+
 import logging
 
 import yaml

disdrodb/issue/writer.py

@@ -18,7 +18,6 @@
 
 import logging
 import os
-from typing import Optional
 
 import yaml
 
@@ -50,7 +49,7 @@ def _write_issue_docs(f):
     )
 
 
-def write_issue(filepath: str, timesteps: Optional[list] = None, time_periods: Optional[list] = None) -> None:
+def write_issue(filepath: str, timesteps: list | None = None, time_periods: list | None = None) -> None:
     """Write the issue YAML file.
 
     Parameters

disdrodb/l0/__init__.py

@@ -15,6 +15,7 @@
 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
 # -----------------------------------------------------------------------------.
 """DISDRODB L0 software."""
+
 from disdrodb.l0.l0_reader import available_readers, get_reader, get_station_reader
 from disdrodb.l0.l0a_processing import generate_l0a
 from disdrodb.l0.l0b_nc_processing import generate_l0b_from_nc

disdrodb/l0/check_configs.py

@@ -17,7 +17,6 @@
 """Check configuration files."""
 
 import os
-from typing import Optional, Union
 
 import numpy as np
 from pydantic import Field, field_validator, model_validator
@@ -103,7 +102,7 @@ def check_variable_consistency(sensor_name: str) -> None:
             raise ValueError(msg)
 
 
-def _schema_error(object_to_validate: Union[str, list], schema: CustomBaseModel, message) -> bool:
+def _schema_error(object_to_validate: str | list, schema: CustomBaseModel, message) -> bool:
     """Function that validate the schema of a given object with a given schema.
 
     Parameters
@@ -129,10 +128,10 @@ class L0BEncodingSchema(CustomBaseModel):
     complevel: int
     shuffle: bool
     fletcher32: bool
-    FillValue: Optional[Union[int, float]] = Field(default=None, alias="_FillValue")
-    chunksizes: Optional[Union[int, list[int]]]
-    add_offset: Optional[float] = None
-    scale_factor: Optional[float] = None
+    FillValue: int | float | None = Field(default=None, alias="_FillValue")
+    chunksizes: int | list[int] | None
+    add_offset: float | None = None
+    scale_factor: float | None = None
 
     # if contiguous=False, chunksizes specified, otherwise should be not !
     @model_validator(mode="before")
@@ -198,16 +197,15 @@ class L0BEncodingSchema(CustomBaseModel):
         return values
 
     @model_validator(mode="after")
-    def remove_offset_and_scale_if_not_int(cls, values):
+    def remove_offset_and_scale_if_not_int(self):
         """Ensure add_offset and scale_factor only apply to integer/uint dtypes."""
-        integer_types = ["int8", "int16", "int32", "int64", "uint8", "uint16", "uint32", "uint64"]
+        integer_types = {"int8", "int16", "int32", "int64", "uint8", "uint16", "uint32", "uint64"}
 
-        if values.dtype not in integer_types:
-            # drop those keys to keep model clean
-            values.add_offset = None
-            values.scale_factor = None
+        if self.dtype not in integer_types:
+            self.add_offset = None
+            self.scale_factor = None
 
-        return values
+        return self
 
 
 def check_l0b_encoding(sensor_name: str) -> None:
@@ -255,16 +253,16 @@ def check_l0a_encoding(sensor_name: str) -> None:
 class RawDataFormatSchema(CustomBaseModel):
     """Pydantic model for the DISDRODB RAW Data Format YAML files."""
 
-    n_digits: Optional[int]
-    n_characters: Optional[int]
-    n_decimals: Optional[int]
-    n_naturals: Optional[int]
-    data_range: Optional[list[float]]
-    nan_flags: Optional[Union[int, float, str]] = None
-    valid_values: Optional[list[float]] = None
-    dimension_order: Optional[list[str]] = None
-    n_values: Optional[int] = None
-    field_number: Optional[str] = None
+    n_digits: int | None
+    n_characters: int | None
+    n_decimals: int | None
+    n_naturals: int | None
+    data_range: list[float] | None
+    nan_flags: int | float | str | None = None
+    valid_values: list[float] | None = None
+    dimension_order: list[str] | None = None
+    n_values: int | None = None
+    field_number: str | None = None
 
     @field_validator("data_range")
     def check_list_length(cls, value):

disdrodb/l0/check_standards.py

@@ -16,7 +16,6 @@
 # -----------------------------------------------------------------------------.
 """Check data standards."""
 
-
 import logging
 
 import numpy as np

disdrodb/l0/configs/LPM/l0a_encodings.yml

@@ -53,23 +53,23 @@ number_particles_min_diameter_internal_data: "float32"
 number_particles_no_hydrometeor: "float32" # 'uint16'
 number_particles_no_hydrometeor_internal_data: "float32"
 number_particles_unknown_classification: "float32" # 'uint16'
-number_particles_unknown_classification_internal_data: "float32"
-number_particles_class_1: "float32" #  'uint16'
-number_particles_class_1_internal_data: "float32"
-number_particles_class_2: "float32" # 'uint16'
-number_particles_class_2_internal_data: "float32"
-number_particles_class_3: "float32" # 'uint16'
-number_particles_class_3_internal_data: "float32"
-number_particles_class_4: "float32" # 'uint16'
-number_particles_class_4_internal_data: "float32"
-number_particles_class_5: "float32" # 'uint16'
-number_particles_class_5_internal_data: "float32"
-number_particles_class_6: "float32" # 'uint16'
-number_particles_class_6_internal_data: "float32"
-number_particles_class_7: "float32" # 'uint16'
-number_particles_class_7_internal_data: "float32"
-number_particles_class_8: "float32" # 'uint16'
-number_particles_class_8_internal_data: "float32"
+total_gross_volume_unknown_classification: "float32"
+number_particles_hail: "float32" #  'uint16'
+total_gross_volume_hail: "float32"
+number_particles_solid_precipitation: "float32" # 'uint16'
+total_gross_volume_solid_precipitation: "float32"
+number_particles_large_pellet: "float32" # 'uint16'
+total_gross_volume_large_pellet: "float32"
+number_particles_small_pellet: "float32" # 'uint16'
+total_gross_volume_small_pellet: "float32"
+number_particles_snowgrain: "float32" # 'uint16'
+total_gross_volume_snowgrain: "float32"
+number_particles_rain: "float32" # 'uint16'
+total_gross_volume_rain: "float32"
+number_particles_small_rain: "float32" # 'uint16'
+total_gross_volume_small_rain: "float32"
+number_particles_drizzle: "float32" # 'uint16'
+total_gross_volume_drizzle: "float32"
 number_particles_class_9: "float32" # 'uint16'
 number_particles_class_9_internal_data: "float32"
 raw_drop_number: "str"

disdrodb/l0/configs/LPM/l0b_cf_attrs.yml

@@ -224,81 +224,81 @@ number_particles_unknown_classification:
   description: Number of particles with unknown classification
   long_name: Number of particles with unknown classification
   units: ""
-number_particles_unknown_classification_internal_data:
-  description: Total volume (gross) of this class
-  long_name: Number of particles with unknown classification internal data
+total_gross_volume_unknown_classification:
+  description: Total (gross) volume of particles classified as unknown
+  long_name: Total (gross) volume of particles classified as unknown
   units: ""
-number_particles_class_1:
-  description: Number of particles class 1
-  long_name: Number of particles class 1
+number_particles_hail:
+  description: Number of particles classified as hail
+  long_name: Number of particles classified as hail
   units: ""
-number_particles_class_1_internal_data:
-  description: Total volume (gross) of class 1
-  long_name: Total volume of class 1
+total_gross_volume_hail:
+  description: Total (gross) volume of particles classified as hail
+  long_name: Total (gross) volume of particles classified as hail
   units: ""
-number_particles_class_2:
-  description: Number of particles class 2
-  long_name: Number of particles class 2
+number_particles_solid_precipitation:
+  description: Number of particles classified as solid precipitation
+  long_name: Number of particles classified as solid precipitation
   units: ""
-number_particles_class_2_internal_data:
-  description: Total volume (gross) of class 2
-  long_name: Total volume of class 2
+total_gross_volume_solid_precipitation:
+  description: Total (gross) volume of particles classified as solid precipitation
+  long_name: Total (gross) volume of particles classified as solid precipitation
   units: ""
-number_particles_class_3:
-  description: Number of particles class 3
-  long_name: Number of particles class 3
+number_particles_large_pellet:
+  description: Number of particles classified as great pellet
+  long_name: Number of particles classified as great pellet
   units: ""
-number_particles_class_3_internal_data:
-  description: Total volume (gross) of class 3
-  long_name: Total volume of class 3
+total_gross_volume_large_pellet:
+  description: Total (gross) volume of particles classified as great pellet
+  long_name: Total (gross) volume of particles classified as great pellet
   units: ""
-number_particles_class_4:
-  description: Number of particles class 4
-  long_name: Number of particles class 4
+number_particles_small_pellet:
+  description: Number of particles classified as small pellet
+  long_name: Number of particles classified as small pellet
   units: ""
-number_particles_class_4_internal_data:
-  description: Total volume (gross) of class 4
-  long_name: Total volume of class 4
+total_gross_volume_small_pellet:
+  description: Total (gross) volume of particles classified as small pellet
+  long_name: Total (gross) volume of particles classified as small pellet
   units: ""
-number_particles_class_5:
-  description: Number of particles class 5
-  long_name: Number of particles class 5
+number_particles_snowgrain:
+  description: Number of particles classified as snowgrain
+  long_name: Number of particles classified as snowgrain
   units: ""
-number_particles_class_5_internal_data:
-  description: Total volume (gross) of class 5
-  long_name: Total volume of class 5
+total_gross_volume_snowgrain:
+  description: Total (gross) volume of particles classified as snowgrain
+  long_name: Total (gross) volume of particles classified as snowgrain
   units: ""
-number_particles_class_6:
-  description: Number of particles class 6
-  long_name: Number of particles class 6
+number_particles_rain:
+  description: Number of particles classified as rain
+  long_name: Number of particles classified as rain
   units: ""
-number_particles_class_6_internal_data:
-  description: Total volume (gross) of class 6
-  long_name: Total volume of class 6
+total_gross_volume_rain:
+  description: Total (gross) volume of particles classified as rain
+  long_name: Total (gross) volume of particles classified as rain
   units: ""
-number_particles_class_7:
-  description: Number of particles class 7
-  long_name: Number of particles class 7
+number_particles_small_rain:
+  description: Number of particles classified as small rain
+  long_name: Number of particles classified as small rain
   units: ""
-number_particles_class_7_internal_data:
-  description: Total volume (gross) of class 7
-  long_name: Total volume of class 7
+total_gross_volume_small_rain:
+  description: Total (gross) volume of particles classified as small rain
+  long_name: Total (gross) volume of particles classified as small rain
   units: ""
-number_particles_class_8:
-  description: Number of particles class 8
-  long_name: Number of particles class 8
+number_particles_drizzle:
+  description: Number of particles classified as drizzle
+  long_name: Number of particles classified as drizzle
   units: ""
-number_particles_class_8_internal_data:
-  description: Total volume (gross) of class 8
-  long_name: Total volume of class 8
+total_gross_volume_drizzle:
+  description: Total (gross) volume of particles classified as drizzle
+  long_name: Total (gross) volume of particles classified as drizzle
   units: ""
 number_particles_class_9:
-  description: Number of particles class 9
-  long_name: Number of particles class 9
+  description: Number of particles for reserved class 9
+  long_name: Number of particles for reserved class 9
   units: ""
 number_particles_class_9_internal_data:
-  description: Total volume (gross) of class 9
-  long_name: Total volume of class 9
+  description: Total volume (gross) for reserved class 9
+  long_name: Total volume of reserved class 9
   units: ""
 raw_drop_number:
   description: Precipitation spectrum

disdrodb/l0/configs/LPM/l0b_encodings.yml

@@ -520,7 +520,7 @@ number_particles_unknown_classification:
   contiguous: false
   chunksizes: 5000
   _FillValue: 65535
-number_particles_unknown_classification_internal_data:
+total_gross_volume_unknown_classification:
   dtype: float32
   zlib: true
   complevel: 3
@@ -528,7 +528,7 @@ number_particles_unknown_classification_internal_data:
   fletcher32: false
   contiguous: false
   chunksizes: 5000
-number_particles_class_1:
+number_particles_hail:
   dtype: uint16
   zlib: true
   complevel: 3
@@ -537,7 +537,7 @@ number_particles_class_1:
   contiguous: false
   chunksizes: 5000
   _FillValue: 65535
-number_particles_class_1_internal_data:
+total_gross_volume_hail:
   dtype: float32
   zlib: true
   complevel: 3
@@ -545,7 +545,7 @@ number_particles_class_1_internal_data:
   fletcher32: false
   contiguous: false
   chunksizes: 5000
-number_particles_class_2:
+number_particles_solid_precipitation:
   dtype: uint16
   zlib: true
   complevel: 3
@@ -554,7 +554,7 @@ number_particles_class_2:
   contiguous: false
   chunksizes: 5000
   _FillValue: 65535
-number_particles_class_2_internal_data:
+total_gross_volume_solid_precipitation:
   dtype: float32
   zlib: true
   complevel: 3
@@ -562,7 +562,7 @@ number_particles_class_2_internal_data:
   fletcher32: false
   contiguous: false
   chunksizes: 5000
-number_particles_class_3:
+number_particles_large_pellet:
   dtype: uint16
   zlib: true
   complevel: 3
@@ -571,7 +571,7 @@ number_particles_class_3:
   contiguous: false
   chunksizes: 5000
   _FillValue: 65535
-number_particles_class_3_internal_data:
+total_gross_volume_large_pellet:
   dtype: float32
   zlib: true
   complevel: 3
@@ -579,7 +579,7 @@ number_particles_class_3_internal_data:
   fletcher32: false
   contiguous: false
   chunksizes: 5000
-number_particles_class_4:
+number_particles_small_pellet:
   dtype: uint16
   zlib: true
   complevel: 3
@@ -588,7 +588,7 @@ number_particles_class_4:
   contiguous: false
   chunksizes: 5000
   _FillValue: 65535
-number_particles_class_4_internal_data:
+total_gross_volume_small_pellet:
   dtype: float32
   zlib: true
   complevel: 3
@@ -596,7 +596,7 @@ number_particles_class_4_internal_data:
   fletcher32: false
   contiguous: false
   chunksizes: 5000
-number_particles_class_5:
+number_particles_snowgrain:
   dtype: uint16
   zlib: true
   complevel: 3
@@ -605,7 +605,7 @@ number_particles_class_5:
   contiguous: false
   chunksizes: 5000
   _FillValue: 65535
-number_particles_class_5_internal_data:
+total_gross_volume_snowgrain:
   dtype: float32
   zlib: true
   complevel: 3
@@ -613,7 +613,7 @@ number_particles_class_5_internal_data:
   fletcher32: false
   contiguous: false
   chunksizes: 5000
-number_particles_class_6:
+number_particles_rain:
   dtype: uint16
   zlib: true
   complevel: 3
@@ -622,7 +622,7 @@ number_particles_class_6:
   contiguous: false
   chunksizes: 5000
   _FillValue: 65535
-number_particles_class_6_internal_data:
+total_gross_volume_rain:
   dtype: float32
   zlib: true
   complevel: 3
@@ -630,7 +630,7 @@ number_particles_class_6_internal_data:
   fletcher32: false
   contiguous: false
   chunksizes: 5000
-number_particles_class_7:
+number_particles_small_rain:
   dtype: uint16
   zlib: true
   complevel: 3
@@ -639,7 +639,7 @@ number_particles_class_7:
   contiguous: false
   chunksizes: 5000
   _FillValue: 65535
-number_particles_class_7_internal_data:
+total_gross_volume_small_rain:
   dtype: float32
   zlib: true
   complevel: 3
@@ -647,7 +647,7 @@ number_particles_class_7_internal_data:
   fletcher32: false
   contiguous: false
   chunksizes: 5000
-number_particles_class_8:
+number_particles_drizzle:
   dtype: uint16
   zlib: true
   complevel: 3
@@ -656,7 +656,7 @@ number_particles_class_8:
   contiguous: false
   chunksizes: 5000
   _FillValue: 65535
-number_particles_class_8_internal_data:
+total_gross_volume_drizzle:
   dtype: float32
   zlib: true
   complevel: 3

disdrodb/l0/configs/LPM/raw_data_format.yml

@@ -626,7 +626,7 @@ number_particles_unknown_classification:
     - 99999
   nan_flags: null
   field_number: "61"
-number_particles_unknown_classification_internal_data:
+total_gross_volume_unknown_classification:
   n_digits: 8
   n_characters: 9
   n_decimals: 5
@@ -636,7 +636,7 @@ number_particles_unknown_classification_internal_data:
     - 99999.999
   nan_flags: null
   field_number: "62"
-number_particles_class_1:
+number_particles_hail:
   n_digits: 5
   n_characters: 5
   n_decimals: 5
@@ -646,7 +646,7 @@ number_particles_class_1:
     - 99999
   nan_flags: null
   field_number: "63"
-number_particles_class_1_internal_data:
+total_gross_volume_hail:
   n_digits: 8
   n_characters: 9
   n_decimals: 5
@@ -656,7 +656,7 @@ number_particles_class_1_internal_data:
     - 99999.999
   nan_flags: null
   field_number: "64"
-number_particles_class_2:
+number_particles_solid_precipitation:
   n_digits: 5
   n_characters: 5
   n_decimals: 5
@@ -666,7 +666,7 @@ number_particles_class_2:
     - 99999
   nan_flags: null
   field_number: "65"
-number_particles_class_2_internal_data:
+total_gross_volume_solid_precipitation:
   n_digits: 8
   n_characters: 9
   n_decimals: 5
@@ -676,7 +676,7 @@ number_particles_class_2_internal_data:
     - 99999.999
   nan_flags: null
   field_number: "66"
-number_particles_class_3:
+number_particles_large_pellet:
   n_digits: 5
   n_characters: 5
   n_decimals: 5
@@ -686,7 +686,7 @@ number_particles_class_3:
     - 99999
   nan_flags: null
   field_number: "67"
-number_particles_class_3_internal_data:
+total_gross_volume_large_pellet:
   n_digits: 8
   n_characters: 9
   n_decimals: 5
@@ -696,7 +696,7 @@ number_particles_class_3_internal_data:
     - 99999.999
   nan_flags: null
   field_number: "68"
-number_particles_class_4:
+number_particles_small_pellet:
   n_digits: 5
   n_characters: 5
   n_decimals: 5
@@ -706,7 +706,7 @@ number_particles_class_4:
     - 99999
   nan_flags: null
   field_number: "69"
-number_particles_class_4_internal_data:
+total_gross_volume_small_pellet:
   n_digits: 8
   n_characters: 9
   n_decimals: 5
@@ -716,7 +716,7 @@ number_particles_class_4_internal_data:
     - 99999.999
   nan_flags: null
   field_number: "70"
-number_particles_class_5:
+number_particles_snowgrain:
   n_digits: 5
   n_characters: 5
   n_decimals: 5
@@ -726,7 +726,7 @@ number_particles_class_5:
     - 99999
   nan_flags: null
   field_number: "71"
-number_particles_class_5_internal_data:
+total_gross_volume_snowgrain:
   n_digits: 8
   n_characters: 9
   n_decimals: 5
@@ -736,7 +736,7 @@ number_particles_class_5_internal_data:
     - 99999.999
   nan_flags: null
   field_number: "72"
-number_particles_class_6:
+number_particles_rain:
   n_digits: 5
   n_characters: 5
   n_decimals: 5
@@ -746,7 +746,7 @@ number_particles_class_6:
     - 99999
   nan_flags: null
   field_number: "73"
-number_particles_class_6_internal_data:
+total_gross_volume_rain:
   n_digits: 8
   n_characters: 9
   n_decimals: 5
@@ -756,7 +756,7 @@ number_particles_class_6_internal_data:
     - 99999.999
   nan_flags: null
   field_number: "74"
-number_particles_class_7:
+number_particles_small_rain:
   n_digits: 5
   n_characters: 5
   n_decimals: 5
@@ -766,7 +766,7 @@ number_particles_class_7:
     - 99999
   nan_flags: null
   field_number: "75"
-number_particles_class_7_internal_data:
+total_gross_volume_small_rain:
   n_digits: 8
   n_characters: 9
   n_decimals: 5
@@ -776,7 +776,7 @@ number_particles_class_7_internal_data:
     - 99999.999
   nan_flags: null
   field_number: "76"
-number_particles_class_8:
+number_particles_drizzle:
   n_digits: 5
   n_characters: 5
   n_decimals: 5
@@ -786,7 +786,7 @@ number_particles_class_8:
     - 99999
   nan_flags: null
   field_number: "77"
-number_particles_class_8_internal_data:
+total_gross_volume_drizzle:
   n_digits: 8
   n_characters: 9
   n_decimals: 5

disdrodb/l0/configs/LPM_V0/l0a_encodings.yml

@@ -26,8 +26,8 @@ number_particles_hail: "float32" #  'uint16'
 total_gross_volume_hail: "float32"
 number_particles_solid_precipitation: "float32" # 'uint16'
 total_gross_volume_solid_precipitation: "float32"
-number_particles_great_pellet: "float32" # 'uint16'
-total_gross_volume_great_pellet: "float32"
+number_particles_large_pellet: "float32" # 'uint16'
+total_gross_volume_large_pellet: "float32"
 number_particles_small_pellet: "float32" # 'uint16'
 total_gross_volume_small_pellet: "float32"
 number_particles_snowgrain: "float32" # 'uint16'