用途:PyGraphistry Core 是 PyGraphistry 的核心入门工作流,覆盖注册认证、DataFrame 到图的结构化整理,以及首次交互式绘图。适用于被要求“注册 graphistry”“开始使用 PyGraphistry”等场景。
主要能力:支持多种认证方式,包括用户名/密码、组织范围登录(SSO 或用户/密码组织路由)、服务账号或个人密钥流程;支持从边/节点表构建图,或从宽表构建超图;支持绑定可视化列、物化节点、执行 GFQL 查询与迭代绘图。
使用方式:先注册到 Graphistry 服务器,再构建图并绘图。基础认证示例:graphistry.register(api=3, username=os.environ.get('GRAPHISTRY_USERNAME'), password=os.environ.get('GRAPHISTRY_PASSWORD'))。组织范围登录使用 org_name 与 idp_name;服务账号使用 personal_key_id 与 personal_key_secret。构建图示例:g = graphistry.edges(edges_df, 'src', 'dst').nodes(nodes_df, 'id'),随后 g.plot()。超图示例:hg = graphistry.hypergraph(df, ['actor', 'event', 'location'], engine='pandas'),再 hg['graph'].plot()。
ETL 整理要点:绑定前规范化标识列(src/dst/id 类型一致、处理空值);在边和节点上保留普通 type 列以便图例与类别编码;首次上传前去重高重复行;节点中心操作前可用 g.materialize_nodes() 物化节点。
限制与注意:GFQL 执行若需保留 Polars 结果须显式指定 engine='polars',默认路径不会选择 Polars;引擎字面量为 'pandas'、'cudf'、'dask'、'dask_cudf'、'polars'、'polars-gpu'、'auto',其中 'polars-gpu' 带连字符,无 polars_gpu 拼写。gfql() 没有 strict= 参数,离引擎分析策略通过 graphistry.compute.gfql.lazy.set_call_mode('auto'|'strict') 或 GFQL_POLARS_CALL_MODE 环境变量设置。当前不建议对 hypergraph 使用 engine='polars' 或 'polars-gpu',应使用 pandas/cuDF 引擎,后续 GFQL 工作再选用 Polars/Polars-GPU。邻域扩展与模式挖掘应使用 .gfql([...]) 或 .gfql("MATCH ..."),hop() 与 chain() 已弃用。凭据仅存于环境变量,不要硬编码。