#MoonTDMS

#已实现范围

• 读取版本 4713 的 TDMS 2.0 lead-in、对象路径、属性、原始索引和多段数据；检查偏移与数据边界。
• 属性覆盖、缓存索引复用、数据参与状态切换、无元数据追加段、完整重复 chunk、新对象列表和重排。
• 连续与交错布局、大小端；交错布局支持混合宽度但要求各通道等长，字符串只能连续存储。
• I8/I16/I32/I64、U8/U16/U32/U64、F32/F64、Boolean、UTF-8 字符串和 TDMS 时间戳。带单位的单/双精度类型码映射为 F32/F64；保留对象属性，不执行缩放。
• 写出规范完整元数据段和多段文件，支持交错写出；选取/裁剪通道并重写文件。
• 波形相对时间轴、有限数值摘要、长表 CSV、版本化 JSON 协议与命令入口。
• 输入/输出字节、段、对象、属性记录、单字符串 UTF-8 字节、累计样本数预算；错误分为 Invalid、Unsupported、Budget。

#环境与安装

moon add Lucaswang5777/moontdms@0.1.0

import {
  "Lucaswang5777/moontdms" @tdms,
}

pkgtype(kind: "executable")

#可运行快速开始

fn main raise {
  let doc : @tdms.Document = {
    objects: [@tdms.DataObject::new(
      @tdms.ObjectPath::channel("run", "voltage"),
      kind=@tdms.F64,
      values=[@tdms.Real(1.25), @tdms.Real(1.5)],
    )],
  }
  let bytes = @tdms.write(doc)
  let restored = @tdms.read(bytes)
  println(restored.csv())
}

moon run . --target js

#三个下游工作流

moon run examples/ingest --target js --deny-warn
moon run examples/crop --target js --deny-warn
moon run examples/report --target js --deny-warn

#API 和精度约定

• read(bytes, limits=...) / inspect(bytes, limits=...)：完整解码 / 段边界检查。
• write(doc, big_endian=false) / write_interleaved(doc, ...) / write_segments(parts, ...)：输出 TDMS 字节。多段写出使用每段完整对象列表与元数据。
• doc.find(path)、obj.property(name)、doc.channel_paths()：查询测量文档。
• doc.select(paths, start=0, end=...)：每个选中通道使用同一半开样本区间；省略 end 时取各自末尾。保留相关 root/group，复制数组；裁剪非零起点时用 wf_increment 调整 wf_start_offset。
• obj.waveform()、axis.at(i)、axis.values(max_samples=...)：正有限增量与有限偏移，相对时间为 offset + i * increment。wf_start_time 原始时间戳单独保存。
• obj.summary()：有限样本的总体方差、均值、极值与 RMS；统计排除 NaN/Inf 并计数，空集合返回 None。中间数值溢出返回错误。
• doc.csv(waveform_time=false)：列为 group、channel、index、value、unit、relative_time。启用波形列时每个通道均须有合法波形增量；单位来自 unit_string，时间量纲由调用方属性约定。

#JSON 协议和 CLI

moon build --target js --deny-warn
node _build/js/debug/build/cmd/main/main.js '{"protocol":"moontdms/1","op":"encode","objects":[{"path":"/\u0027g\u0027/\u0027c\u0027","type":3,"values":["1","2"]}]}'

#预算与已知限制

#验证与开发

moon info --target all
moon fmt --check
moon check --target js --deny-warn
moon test --target js --deny-warn
moon build --target js --deny-warn
python -m pip install numpy==2.3.5 npTDMS==1.10.0
python scripts/differential.py
python scripts/cli_smoke.py
python scripts/audit.py

#许可与参考