Skip to content

Commit c0634f1

Browse files
lmeyerovclaude
andcommitted
docs(gfql/searchAny): twin + kernel docstrings — cuDF explicit float/date decline (wave-4 S-w4a)
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent ae29cb5 commit c0634f1

2 files changed

Lines changed: 10 additions & 5 deletions

File tree

graphistry/compute/ComputeMixin.py

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -491,8 +491,10 @@ def search_nodes(self, term, columns=None, case_sensitive=False, regex=False):
491491
"""Keep nodes where ANY column matches ``term`` (viz-filter L2 inspector
492492
semantics: OR across columns; case-insensitive substring default; regex
493493
opt-in; string columns always, integer columns iff the term is a numeric
494-
literal — floats/dates via explicit ``columns=``). pandas/cuDF native;
495-
polars frames raise NotImplementedError (use the cypher ``search_any`` op).
494+
literal — floats/dates via explicit ``columns=`` on pandas ONLY: cuDF
495+
declines them, its float/temporal stringification diverges from pandas).
496+
pandas/cuDF native; polars frames raise NotImplementedError (use the
497+
cypher ``search_any`` op).
496498
"""
497499
from graphistry.compute.gfql.search_any import search_any_mask
498500
from graphistry.compute.exceptions import ErrorCode, GFQLValidationError

graphistry/compute/gfql/search_any.py

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,12 @@
11
"""Cross-column search kernel (viz-filter L2, panel-algebra D2): OR-across-columns
22
substring/regex match, dtype-gated AS SEMANTICS — string columns always; integer
33
columns iff the term is a numeric literal (inspector gate); float/date/bool are
4-
auto-gated OUT (float stringification is engine-divergent — reach them via explicit
5-
``columns=``). Per-column matching delegates to the parity-hardened ``Contains``
6-
predicate, so every pandas/cuDF quirk and honest decline gate carries over."""
4+
auto-gated OUT (float stringification is engine-divergent — explicit ``columns=``
5+
reaches bool on both engines, float/date on pandas only: cuDF declines them, its
6+
astype(str) rendering diverges from pandas — dgx-probed). Per-column matching
7+
delegates to the parity-hardened ``Contains`` predicate, so every pandas/cuDF
8+
quirk and honest decline gate carries over; cuDF regex obeys the same decline
9+
rules as ``=~``."""
710
import re
811
from typing import Any, List, Optional
912

0 commit comments

Comments
 (0)