Theta preamble diagnostic misreports historical single-item images
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
调研方向
从 theta.PreambleUtil.preambleToString() 开始，检查对于长度为一个 preamble 的 image，CurrentCount 是如何推导出来的。使用提议的单项 compact sketch serialization，只清除 single-item 标志，并验证诊断报告 CurrentCount: 1，同时保留 SINGLE_ITEM: false；还要确认空 image 报告 CurrentCount: 0。
由索引模型根据 Issue 内容生成。
描述
Problem
theta.PreambleUtil.preambleToString() derives CurrentCount for one-preamble-long images from SINGLEITEM_FLAG_MASK.
Historical C++ single-item images may omit that flag. Java accepts those images because the theta parser deliberately does not depend on the flag, but the diagnostic output reports CurrentCount: 0 even though the image contains one retained item.
This was identified while resolving the cross-language differences tracked in apache/datasketches-cpp#460. Current C++ now writes the flag, but older valid images still expose the diagnostic mismatch.
Expected behavior
For a one-preamble-long theta image, derive the diagnostic count from the empty flag:
- empty image:
CurrentCount: 0 - non-empty image:
CurrentCount: 1
The printed SINGLE_ITEM field should continue to reflect the serialized flag itself.
Proposed test
Serialize a single-item compact sketch, clear only the single-item flag to model a historical C++ image, and verify that preambleToString() reports CurrentCount: 1 while preserving SINGLE_ITEM: false.
- 主要语言
- Java
- 星标
- 958
- 派生
- 226
- 平均合并
- 2 天 5 小时
- 30 天内合并 PR
- 15
环境准备
这个项目没有提供开发容器、Dockerfile 或贡献指南，环境需要你自己搭建：先看它的 README，通用步骤见我们的新手贡献指南。
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
apache/datasketches-java 的其他 Issue
-
难度 2/5 1-3 小时 新手友好度 65/100
apache/datasketches-java#731 · 16 条评论 ·
维护者通常 1 天内回复
-
难度 3/5 1-2 天 新手友好度 58/100
apache/datasketches-java#739 · 1 条评论 ·
维护者通常 1 天内回复
-
难度 3/5 1-2 天 新手友好度 35/100
apache/datasketches-java#720 · 3 条评论 ·
维护者通常 1 天内回复
-
难度 3/5 1-2 天 新手友好度 45/100
apache/datasketches-java#693 · 13 条评论 ·
维护者通常 1 天内回复
-
难度 5/5 一周以上 新手友好度 30/100
apache/datasketches-java#647 · 5 条评论 ·
维护者通常 1 天内回复
查看 apache/datasketches-java 的全部 Issue
相似的 Issue
-
难度 2/5 1-3 小时 新手友好度 90/100
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 65/100
aoqia194/leaf-loader#19 ·
-
难度 2/5 1-3 小时 新手友好度 84/100
apache/streampark#4521 ·
-
0 - Backlog 1 - Ready documentation good first issue help wanted
难度 2/5 1-3 小时 新手友好度 78/100
-
cbor
难度 2/5 1-3 小时 新手友好度 84/100
FasterXML/jackson-dataformats-binary#844 ·
维护者通常 1 天内回复