nominal 1.111.1__py3-none-any.whl → 1.111.2__py3-none-any.whl

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.111.2](https://github.com/nominal-io/nominal-client/compare/v1.111.1...v1.111.2) (2026-02-04)
+
+
+### Bug Fixes
+
+* prevent decimated exports from bricking polars export handler ([#596](https://github.com/nominal-io/nominal-client/issues/596)) ([8106f74](https://github.com/nominal-io/nominal-client/commit/8106f74dbc985c3f62946dbc4861eefa8e064964))
+
 ## [1.111.1](https://github.com/nominal-io/nominal-client/compare/v1.111.0...v1.111.1) (2026-01-29)
 
 

nominal/thirdparty/polars/polars_export_handler.py

@@ -42,6 +42,10 @@ DEFAULT_POINTS_PER_DATAFRAME = 25_000_000
 # Maximum number of channels to get data for within a single request to Nominal
 DEFAULT_CHANNELS_PER_REQUEST = 25
 
+# Maximum number of buckets / decimated points exported per compute query.
+# TODO(drake) raise 1000 limit once backend limit is raised
+MAX_NUM_BUCKETS = 1000
+
 DEFAULT_EXPORTED_TIMESTAMP_COL_NAME = "timestamp"
 _INTERNAL_TS_COL = "__nmnl_ts__"  # internal join key, chosen to avoid collision with channel names
 
@@ -133,8 +137,8 @@ def _batch_channel_points_per_second(
     if not channels:
         logger.warning("No channels given!")
         return {}
-    elif num_buckets > 1000:
-        raise ValueError("num_buckets must be <=1000")
+    elif num_buckets > MAX_NUM_BUCKETS:
+        raise ValueError(f"num_buckets ({num_buckets}) must be <= {MAX_NUM_BUCKETS}")
 
     # For each channel that has data with the given tags within the provided time range, add a
     # compute expression to later retrieve decimated bucket stats
@@ -683,6 +687,27 @@ class PolarsExportHandler:
         if None not in (buckets, resolution):
             raise ValueError("Cannot export data decimated with both buckets and resolution")
 
+        if resolution is not None:
+            # If the batch duration is higher than this number, and data is actually downsampled with the
+            # given resolution, then it would error today if the batch duration is any larger than this.
+            computed_batch_duration = datetime.timedelta(seconds=(resolution * MAX_NUM_BUCKETS) / 1e9)
+            if batch_duration is None:
+                logger.info(
+                    "Manually setting batch_duration to %fs (resolution=%dns)",
+                    computed_batch_duration.total_seconds(),
+                    resolution,
+                )
+                batch_duration = computed_batch_duration
+            elif computed_batch_duration < batch_duration:
+                logger.warning(
+                    "Configured batch_duration of %fs would result in failing exports with resolution=%dns. "
+                    "Setting batch_duration to %fs instead.",
+                    batch_duration.total_seconds(),
+                    resolution,
+                    computed_batch_duration.total_seconds(),
+                )
+                batch_duration = computed_batch_duration
+
         # Determine download schedule
         export_jobs = self._compute_export_jobs(
             channels, _TimeRange(start, end), timestamp_type, tags or {}, buckets, resolution, batch_duration

{nominal-1.111.1.dist-info → nominal-1.111.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nominal
-Version: 1.111.1
+Version: 1.111.2
 Summary: Automate Nominal workflows in Python
 Project-URL: Homepage, https://nominal.io
 Project-URL: Documentation, https://docs.nominal.io
@@ -21,7 +21,7 @@ Requires-Dist: click<9,>=8
 Requires-Dist: conjure-python-client<4,>=3.1.0
 Requires-Dist: ffmpeg-python>=0.2.0
 Requires-Dist: nominal-api==0.1079.0
-Requires-Dist: nominal-streaming==0.5.8; platform_python_implementation == 'CPython' and python_version >= '3.10' and ((sys_platform == 'win32' and platform_machine == 'AMD64') or (sys_platform == 'darwin' and platform_machine == 'arm64') or (sys_platform == 'linux' and (platform_machine == 'x86_64' or platform_machine == 'armv7l')))
+Requires-Dist: nominal-streaming==0.7.12; platform_python_implementation == 'CPython' and python_version >= '3.10' and ((sys_platform == 'win32' and platform_machine == 'AMD64') or (sys_platform == 'darwin' and platform_machine == 'arm64') or (sys_platform == 'linux' and (platform_machine == 'x86_64' or platform_machine == 'armv7l' or platform_machine == 'aarch64' or platform_machine == 'arm64')))
 Requires-Dist: openpyxl>=0.0.0
 Requires-Dist: pandas>=0.0.0
 Requires-Dist: polars>=0.0.0

{nominal-1.111.1.dist-info → nominal-1.111.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-CHANGELOG.md,sha256=jHCernM5EkOd7IWlG7EiBylcKPNjD0wHgEJdNIstFoc,92050
+CHANGELOG.md,sha256=N98MknWWJvVP9TF_wOjm8wgAofSWzf2v0kOHmv34MvQ,92404
 LICENSE,sha256=zEGHG9mjDjaIS3I79O8mweQo-yiTbqx8jJvUPppVAwk,1067
 README.md,sha256=KKe0dxh_pHXCtB7I9G4qWGQYvot_BZU8yW6MJyuyUHM,311
 nominal/__init__.py,sha256=rbraORnXUrNn1hywLXM0XwSQCd9UmQt20PDYlsBalfE,2167
@@ -109,12 +109,12 @@ nominal/thirdparty/matlab/_matlab.py,sha256=qtrO_wP_o9J2oqiwhriSfL0LYO7rBzssoHyg
 nominal/thirdparty/pandas/__init__.py,sha256=wnPcbvZrTCNM5cphvwn198dCn7Dcp1QJFDK12mcdd8w,361
 nominal/thirdparty/pandas/_pandas.py,sha256=QcM1tk-Z5W8bKd9oYz5rD6M3qIHZ0N5uUe_UOVOQC08,16367
 nominal/thirdparty/polars/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nominal/thirdparty/polars/polars_export_handler.py,sha256=hGCSwXX9dC4MG01CmmjlTbcajktMYDb-GpNNTwLUsRw,32951
+nominal/thirdparty/polars/polars_export_handler.py,sha256=1XjdOYWpiU2ilSU5tcjNpoLoRw1GrgrhtcgwR8Cobxo,34301
 nominal/thirdparty/tdms/__init__.py,sha256=6n2ImFr2Wiil6JM1P5Q7Mpr0VzLcnDkmup_ftNpPq-s,142
 nominal/thirdparty/tdms/_tdms.py,sha256=m4gxbpxB9MTLi2FuYvGlbUGSyDAZKFxbM3ia2x1wIz0,8746
 nominal/ts/__init__.py,sha256=hmd0ENvDhxRnzDKGLxIub6QG8LpcxCgcyAct029CaEs,21442
-nominal-1.111.1.dist-info/METADATA,sha256=F-Dar1ZHrNnsCswYsOuIaA8zKfsKsBVtm47o7RflGMo,2307
-nominal-1.111.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-nominal-1.111.1.dist-info/entry_points.txt,sha256=-mCLhxgg9R_lm5efT7vW9wuBH12izvY322R0a3TYxbE,66
-nominal-1.111.1.dist-info/licenses/LICENSE,sha256=zEGHG9mjDjaIS3I79O8mweQo-yiTbqx8jJvUPppVAwk,1067
-nominal-1.111.1.dist-info/RECORD,,
+nominal-1.111.2.dist-info/METADATA,sha256=7Bx_PWaPm2gNVpTzZAfRp7s0s3LOlBhYaGOIuWFuF7s,2372
+nominal-1.111.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+nominal-1.111.2.dist-info/entry_points.txt,sha256=-mCLhxgg9R_lm5efT7vW9wuBH12izvY322R0a3TYxbE,66
+nominal-1.111.2.dist-info/licenses/LICENSE,sha256=zEGHG9mjDjaIS3I79O8mweQo-yiTbqx8jJvUPppVAwk,1067
+nominal-1.111.2.dist-info/RECORD,,