@gmod/newick

中文文档
1.1.0发布于 2026/11/11MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 2.3万

Newick 解析和堆栈安全树的倒移, 没有依赖性

中文使用文档

@gmod/ newick (英语)

NPM version Build Status

Newick 解析和小树厂 无相依相.

npm install @gmod/newick
import { hierarchy, leaves, parseNewick } from '@gmod/newick'

const tree = parseNewick('(A:0.1,B:0.2,(C:0.3,D:0.4)E:0.5)F;')
// { name: 'F', children: [
//   { name: 'A', length: 0.1 },
//   { name: 'B', length: 0.2 },
//   { name: 'E', length: 0.5, children: [
//     { name: 'C', length: 0.3 },
//     { name: 'D', length: 0.4 },
//   ] },
// ] }

const root = hierarchy(tree, d => d.children)
leaves(root).map(n => n.data.name) // ['A', 'B', 'C', 'D']

反应- msaview 财务报告和审定财务报表 jbrowse 组件 用它来 页:1 d3-hierarchy 在没有纯粹的无害环境管理要求的情况下 比较简单的类型。 。 。 .

每个字段 parseNewick 生产是可选的——节点是 { name?: string, length?: number, children?: NewickNode[] } 所以一个节点与 没有 children 是一棵叶子,整棵树可以是一个裸露的节点:

parseNewick('A;') // { name: 'A' }
parseNewick('(A,B)Foo;') // { name: 'Foo', children: [{ name: 'A' }, { name: 'B' }] }
parseNewick('(A:0.1,B:0.2)F:0.5;')
// { name: 'F', length: 0.5, children: [
//   { name: 'A', length: 0.1 },
//   { name: 'B', length: 0.2 },
// ] }

单引号标签保留一个包含 ,, (中文(简体) ), : 或一成不变, 与 '' 为字面引用。 没有它们,标签里面的逗号就会分裂一个 叶入二分,会回错 树 不只是个坏名字:

parseNewick("('A,x','B (y)','it''s')Root;")
// { name: 'Root', children: [
//   { name: 'A,x' },
//   { name: 'B (y)' },
//   { name: "it's" },
// ] }

方括号是一个注释,解析器会降低其中的内容。 NHX 和 BEAST 将其每个节点的元数据放入括号中,而不放入解析器 将读取 : 字符在一个 [&&NHX:...] 块为分支长度 :

parseNewick('(A:0.1[&&NHX:S=human],B:0.2[&&NHX:S=mouse]);')
// { children: [{ name: 'A', length: 0.1 }, { name: 'B', length: 0.2 }] }

仅次于一个 ) 是一个花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序花序 集群高度(a) length)在德德克拉姆语中. parseNewick 读起来像一个 length 只有树没有 : 任意分支长度 :

parseNewick('((A:1,B:1)95,(C:1,D:1)80);') // 95 and 80 are names
parseNewick('(A,B)1.5;') // { length: 1.5, children: [{ name: 'A' }, { name: 'B' }] }

这个 postParenNumeric 选项将读取标记;见 文件/教学。 。 。 .

hierarchy 将任何嵌入式数据( Newick 或其他) 包裹在节点中 parent, (中文(简体) ), depth 财务报告和审定财务报表 height。横道是自由的功能,可以行走子树 在节点下你通过:

import { descendants, find, leaves, links, sum } from '@gmod/newick'

const root = hierarchy(
  parseNewick('(A:0.1,B:0.2,(C:0.3,D:0.4)E:0.5)F;'),
  d => d.children,
)
const e = root.children[2]

descendants(root).map(n => n.data.name) // ['F', 'A', 'B', 'E', 'C', 'D']
leaves(root).map(n => n.data.name) // ['A', 'B', 'C', 'D']
leaves(e).map(n => n.data.name) // ['C', 'D'] — only under E
links(root).length // 5 — { source, target } per branch
find(root, n => n.data.name === 'C').data.length // 0.3
sum(root, d => (d.children ? 0 : 1)).value // 4 — leaves under the root

文献/等级 覆盖 eachAfter, (中文(简体) ), sort,则 无分配 forEachDescendant 财务报告和审定财务报表 forEachLink每个人的拜访 秩序。 秩序。 每条倒行道都是迭接的,所以一棵深树不会溢出堆放.

writeNewick 写出一棵解析后树, 引用任何持有 Newick 的名称 点,和 parseNewick 将结果读回同棵树. midpointRoot 树根在两道小道之间最长的路由中 通常选择无根树 FastTree, IQ-TREE 或相邻的加入写作 . rerootTree 把它根植在给定节点上方的分枝上,在中间 分支或一个 offset 从节点起 :

import {
  midpointRoot,
  parseNewick,
  rerootTree,
  writeNewick,
} from '@gmod/newick'

const tree = parseNewick('((A:1,B:1):1,(C:1,D:5):1);')
writeNewick(midpointRoot(tree)) // '(D:4,(C:1,(A:1,B:1):2):1);'

const a = tree.children[0].children[0]
writeNewick(rerootTree(tree, a)) // '(A:0.5,(B:1,(C:1,D:5):2):0.5);'
writeNewick(rerootTree(tree, a, 0.25)) // '(A:0.25,(B:1,(C:1,D:5):2):0.75);'

两个函数都无法修改树经过 .

@gmod/newick 没有布局算法或 stratify; 使用 d3-hierarchy 页:1 这些. 文档/绘图 在一打中构建一个凹槽布局 线条.

文档

  • 文献/等级 —— 说 hierarchy 和转动的助手 函数
  • 文档/绘图 - 铺设并绘制出一个凹槽或 画布上的光谱图
  • 文件/教学 空数后..) 含糊不清 页:1 postParenNumeric 选项

许可证

麻省理工学院

版本与发布记录

@gmod/newick 共发布 6 个版本,首次发布于 2026/08/16;过去 12 个月发布了 6 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.1.0latest2026/11/116 天前
1.0.32026/09/142 个月前
1.0.22026/08/163 个月前
1.0.12026/08/163 个月前
1.0.02026/08/163 个月前
0.1.02026/08/163 个月前

关于 @gmod/newick 的常见问题

@gmod/newick 是什么?

Newick 解析和堆栈安全树的倒移, 没有依赖性

如何安装 @gmod/newick?

在项目目录运行 npm install @gmod/newick,或使用 pnpm add / yarn add / bun add。

@gmod/newick 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gmod/newick 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@gmod/newick 可以商用吗?

@gmod/newick 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gmod/newick 的下载量有多少?

根据 npm 官方下载统计,@gmod/newick 在 2026/10/17 – 2026/11/15 这 30 天内被下载 23,483 次,日均约 783 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gmod/newick 还在维护吗?

最新版本 1.1.0 发布于 2026/11/11(6 天前);至今共发布 6 个版本,其中过去 12 个月发布了 6 个;首次发布于 2026/08/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。