# h5tui

**Repository Path**: zrainx/h5tui

## Basic Information

- **Project Name**: h5tui
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-05
- **Last Updated**: 2026-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 简介

`h5v` 是一个 文本风格的 HDF5 文件浏览终端界面程序，灵感来源于yazi 终端管理器。

- **浏览:** 三列树形视图，Vim 风格快捷键，支持模糊搜索快速导航。
- **绘图:** 终端内联 1D 折线图/直方图、2D 热力图（plotext），或通过 matplotlib 导出为 PNG。

## 安装

```sh
pip install -r requirements.txt
```

## 使用

```sh
python h5v.py file.h5
```

## 文档

### 文件导航

`h5v` 默认打开 HDF5 根 group。Group 标记为 📁，Dataset 标记为 📊。

| 键                      | 操作                    |
| :---------------------- | :---------------------- |
| `h` / `j` / `k` / `l`  | 左 / 下 / 上 / 右 移动  |
| `g` / `G`               | 跳到顶部 / 底部         |
| `d` / `u`               | 向下 / 向上翻页         |
| `~`                     | 返回根目录              |

#### 搜索

| 键         | 操作                 |
| :--------- | :------------------- |
| `/`        | 当前 group 内查找    |
| `n` / `p`  | 下一个 / 上一个匹配  |
| `f`        | 全局模糊搜索         |

### 查看数据集

打开数据集后，支持相同的 Vim 风格快捷键浏览单元格。

额外快捷键：

| 键  | 操作                                  |
| :-- | :------------------------------------ |
| `:` | 跳转到指定行                          |
| `y` | 复制当前单元格到剪贴板                |
| `x` | 循环显示格式：十进制 → 十六进制 → 科学计数法 |
| `S` | 切片/reshape（numpy 表达式）          |

### 切片与 Reshape

按 `S` 打开切片/reshape 对话框。用 `[...]` 表示 numpy 风格切片，`(...)` 表示 reshape。两者可以按从左到右的顺序组合。

| 表达式                 | 含义                                    |
| :--------------------- | :-------------------------------------- |
| `[0:100]`              | 切取第 0–99 行                          |
| `[0:10, ::2]`          | 多维切片                                |
| `(-1,)`                | 展平为 1D                               |
| `(10, 10)`             | reshape 为 10×10                        |
| `[0:100](10, 10)`      | 先切 100 行，再 reshape 为 10×10        |
| `[0,:,:,0](:)`         | 先切片再展平（reshape 中 `:` = -1）     |
| `0:10`                 | 兼容旧格式：纯切片表达式                |

再次按 `S` 清除当前切片/reshape。

按 `x` 可在十进制、十六进制和科学计数法之间循环切换整数/浮点数的显示格式。

统计值（**mean**、**std**、**min**、**max**）会内联显示在数据集视图 header 和浏览预览侧栏的 shape/dtype/size 旁边。

### 绘图

#### 终端内联

`h5v` 使用 plotext 在终端中绘图。

| 键  | 1D       | 2D     | >2D |
| :-- | :------- | :----- | :-- |
| `v` | 折线图   | 热力图 | —   |
| `V` | 直方图   | —      | —   |

对于复合类型，可自由选择 X/Y 轴对应的字段。

> 大数据集会进行均匀采样后再绘图。

#### 导出为 PNG

按 `s` 打开对话框，通过 matplotlib **保存为 PNG**。

### 属性

带有属性的项目会显示 **▼** 和数量标记。按 `a` 查看属性。

### 统计

在数据集视图中按 `A` 查看数值摘要（均值、方差、最大值等）。对复合类型按字段分别统计。

基本统计值（**mean**、**std**、**min**、**max**）也会内联显示在 header（数据集视图）和预览侧栏（浏览模式）中，无需按 `A`。

### 通用导航

大多数界面复用相同的移动和退出快捷键，具体含义取决于焦点（文件树 vs 表格 vs 弹窗）。

| 模式             | 按键                         |
| :--------------- | :--------------------------- |
| 移动             | `h` `j` `k` `l`、方向键      |
| 跳动 10 格       | `H` `J` `K` `L`              |
| 首/尾            | `g` `G`                      |
| 翻页             | `u` `d`、`PageUp` `PageDown` |
| 关闭/退出        | `Esc`、`q`、`Q`              |

### 限制

`h5v` 仅用于读取 HDF5 文件，不支持修改操作。

## 致谢

感谢原项目 [h5tui](https://github.com/kszenes/h5tui) 作者 **Kalman Szenes**。