# @gmod/newick 中文文档

规范地址：https://npmcn.com/package/%40gmod/newick/

版本：1\.1\.0
npm 元数据更新时间：2026-11-10T17:44:24.037Z
中文译文更新时间：2026-11-16T17:10:56.687Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gmod/newick
原文对照：https://npmcn.com/package/%40gmod/newick/?lang=original
项目主页：https://github.com/GMOD/newick#readme
源码仓库：https://github.com/GMOD/newick

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：118 kB，39 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-08-16T04:42:45.555Z
- 最新版本发布：2026-11-10T17:44:23.694Z
- 近 30 天下载量：23483（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

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

## 安装

```sh
npm install @gmod/newick
```

也可以使用：`pnpm add @gmod/newick`、`yarn add @gmod/newick`、`bun add @gmod/newick`

## README

# @gmod/ newick (英语)

[![NPM version](https://img.shields.io/npm/v/@gmod/newick.svg?style=flat-square)](https://npmjs.org/package/@gmod/newick) [![Build Status](https://img.shields.io/github/actions/workflow/status/GMOD/newick/publish.yml?branch=main)](https://github.com/GMOD/newick/actions/workflows/publish.yml)

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

```sh
npm install @gmod/newick
```

```js
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](https://github.com/GMOD/JBrowseMSA) 财务报告和审定财务报表 [jbrowse 组件](https://github.com/GMOD/jbrowse-components) 用它来 页:1 `d3-hierarchy` 在没有纯粹的无害环境管理要求的情况下 [比较简单的类型](https://npmcn.com/package/%40gmod/newick/docs/hierarchy.md#types)。 。 。 .

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

```js
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 },
// ] }
```

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

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

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

```js
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` 只有树没有 `:` 任意分支长度 :

```js
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` 选项将读取标记;见 [文件/教学](https://npmcn.com/package/%40gmod/newick/docs/dialects.md)。 。 。 .

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

```js
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
```

[文献/等级](https://npmcn.com/package/%40gmod/newick/docs/hierarchy.md) 覆盖 `eachAfter`, (中文(简体) ), `sort`,则 无分配 `forEachDescendant` 财务报告和审定财务报表 `forEachLink`每个人的拜访 秩序。 秩序。 每条倒行道都是迭接的,所以一棵深树不会溢出堆放.

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

```js
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 这些. [文档/绘图](https://npmcn.com/package/%40gmod/newick/docs/drawing.md) 在一打中构建一个凹槽布局 线条.

## 文档

-   [文献/等级](https://npmcn.com/package/%40gmod/newick/docs/hierarchy.md) —— 说 `hierarchy` 和转动的助手 函数
-   [文档/绘图](https://npmcn.com/package/%40gmod/newick/docs/drawing.md) - 铺设并绘制出一个凹槽或 画布上的光谱图
-   [文件/教学](https://npmcn.com/package/%40gmod/newick/docs/dialects.md) 空数后..`)` 含糊不清 页:1 `postParenNumeric` 选项

## 许可证

麻省理工学院

## 常见问题

### @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 和提交记录判断。

