# HDFView

用于浏览和编辑 HDF4 与 HDF5 文件的可视化 Java 工具。

> 这是 OpenNavo 上 HDFView 页面的 Markdown 版本，内容与网页相同： <https://opennavo.com/zh/apps/hdfview>

- **最新版本**: `3.5.0`
- **开发者**: The HDF Group
- **主页**: <https://www.hdfgroup.org/download-hdfview/>
- **分类**: [数据分析](https://opennavo.com/zh/categories/data-analysis)
- **安装**: `brew install --cask hdfview`
- **近 30 天安装**: 47
- **Homebrew**: 可以安装，由 Homebrew 更新
- **下载地址**: <https://github.com/HDFGroup/hdfview/releases/download/v3.5.0/HDFView-3.5.0App-Darwin-arm64.tar.gz>
- **SHA-256**: `3bf23866c99e9baf85b32e31fd89386a593ee782a5e5a4170162d266f83a2c1b`

SHA-256 只用来核对下载的文件是否完整，不代表安全认证。

## 安装与卸载内容

```json
[
  {
    "declaration": {
      "app": [
        "HDFView.app"
      ],
      "target": "/Applications/HDFView.app"
    },
    "phase": "install",
    "sources": [
      "HDFView.app"
    ],
    "target": "/Applications/HDFView.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/.hdfview*",
            "~/Library/Preferences/hdf.view.plist",
            "~/Library/Preferences/HDFView.hdfgroup.org.plist",
            "~/Library/Saved Application State/hdf.view.savedState"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## 介绍

HDFView 是一款可视化 Java 应用，用于浏览和编辑 HDF4 与 HDF5 格式的文件。它以树形结构显示文件层级，并通过 Java HDF Object Package 处理 HDF 数据对象。

使用 HDFView 可以：
- 以树形视图浏览文件层级。
- 创建 HDF 文件，并添加或删除组和数据集。
- 查看和修改数据集内容。
- 添加、删除和修改属性。

要通过 Homebrew 安装 macOS 应用，请运行 `brew install --cask hdfview`。该 cask 会将 `HDFView.app` 安装到 `/Applications`。打开应用并选择 HDF 文件即可开始浏览。该 cask 提供 Apple silicon 和 Intel 版本。

HDFView 是图形应用，而非命令行工具。其文档说明的文件格式范围为 HDF4 和 HDF5。

来源：[HDFView](https://www.hdfgroup.org/download-hdfview/) · [Homebrew cask](https://raw.githubusercontent.com/Homebrew/homebrew-cask/HEAD/Casks/h/hdfview.rb)

## 系统要求

- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 3.5.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/hdfview.rb> · 核查于 2026-11-22
  - <https://github.com/HDFGroup/hdfview/releases/download/v3.5.0/HDFView-3.5.0App-Darwin-x86_64.tar.gz>
  - SHA-256: `e5b02e5af56b8d641722acab4ae258020877774a1ad6f914cfa6f439bc831815`
- 适用于 macOS 27, 26, 15, 14, 13, 12, 11 的版本 · 应用版本: 3.5.0 · Apple 芯片 · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/hdfview.rb> · 核查于 2026-11-22
  - <https://github.com/HDFGroup/hdfview/releases/download/v3.5.0/HDFView-3.5.0App-Darwin-arm64.tar.gz>
  - SHA-256: `3bf23866c99e9baf85b32e31fd89386a593ee782a5e5a4170162d266f83a2c1b`

## 卸载

- `brew uninstall --cask hdfview`

普通卸载会删除应用本身，设置和缓存会保留。

### 深度清理（可选）

- `brew uninstall --zap --cask hdfview`

`--zap` 还会删除 Homebrew 定义里列出的设置、缓存等文件，其中可能有其他应用共用的数据，删除后无法恢复；它也不保证没有任何残留。请先备份需要保留的数据；如要保留设置和缓存，请不要加 `--zap`。

普通卸载会删除应用本身，设置和缓存会保留。

- 文件和文件夹: `~/.hdfview*` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/hdfview.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Preferences/hdf.view.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/hdfview.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Preferences/HDFView.hdfgroup.org.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/hdfview.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。
- 文件和文件夹: `~/Library/Saved Application State/hdf.view.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/hdfview.rb> · 以上条目来自 Homebrew 定义，核查于 2026-11-22；它们只说明定义声明会删除什么，不代表你的 Mac 上都有。

## 最新版本说明

### 99.99.99-prerelease (2024-06-20)

HDFView version 99.99.99

### 🔺 HDFView Changelog
All notable changes to this project will be documented in this file. This document describes the differences between this release and the previous HDFView release, platforms tested, and known problems in this release.

### 🔗 Quick Links
* [HDFView releases](https://github.com/HDFGroup/hdfview/releases)
* [HDFView source](https://github.com/HDFGroup/hdfview)
* [Getting help, questions, or comments](https://github.com/HDFGroup/hdfview/issues)

#### 📖 Contents
* [Executive Summary](#-executive-summary-hdfview-version-430)
* [New Features & Improvements](#-new-features--improvements)
* [Bug Fixes](#-bug-fixes)
* [Platforms Tested](#%EF%B8%8F-platforms-tested)
* [Known Problems](#-known-problems)

### 🔆 Executive Summary: HDFView Version 3.4.0

#### Enhanced Features:

* **Float16 Datatype Support**: Added comprehensive support for operating with float16 datatypes
* **Plugin Path Configuration**: New user option for editing the plugin path and managing plugins

#### Updated Foundation:

> [!IMPORTANT]
>
> - Built and tested with **HDF 4.3.X** and **HDF5 2.Y.Z**
> - Built and tested with **OpenJDK 21**
> - Uses Java modules for improved modularity
> - Utilizes newest `jpackage` for distribution

### 🚀 New Features & Improvements

#### Major Enhancements

* Build system converted to Maven

* **[GH #117](https://github.com/HDFGroup/hdfview/issues/117)** - Add User Option for editing the plugin path and include plugins
* **[GH #138](https://github.com/HDFGroup/hdfview/issues/138)** - Add Support for operating with float16 and complex datatypes

### 🪲 Bug Fixes

#### Major Bug Fixes

* **HDFVIEW-284** - Fixed crashes on NETCDF-4 grids

  The problem was that references in variable-length containers were handled like strings. Upon investigation, the problem found was that references in any container were handled like strings.

  The table display code for vlen references also changed to account for the changes which fixed the hdf5 Java API. The fix required that variable-length types in the Java wrappers in the hdf5 library for read and write also be fixed.

  Related work:
  - **HDFView-221** - Add support for true Variable-length types in Java
  - **HDFView-222** - Fixed the read/write support for variable-length in the Java wrappers. This fix involved handling the data object as a list of lists and using the datatype of the list.
  - **HDFView-222** - Fixed the object library to handle the List of Lists concept
  - **HDFView-223** - Updated the DataProviders, DataDisplayConverters and DataValidators to work with variable-length List of Lists

#### Minor Bug Fixes

* **[GH #171](https://github.com/HDFGroup/hdfview/issues/171)** - HDFView fails to find input files on command line when using relative paths

* **[GH #387](https://github.com/HDFGroup/hdfview/issues/387)** (checkHDF5Filters shows 'NONE') Replace corrupted tfilters.h5 test data file with correct version.

* **[GH #352](https://github.com/HDFGroup/hdfview/issues/352)** (isn't displaying attribute values correctly) Incorrectly using the array value as a character limit.

### ☑️ Platforms Tested

HDFView is tested on the following platforms:

* Linux (x86_64, aarch64)
* Windows
* macOS

Current test results and detailed platform information are available in the [GitHub repository](https://github.com/HDFGroup/hdfview).

### ⛔ Known Problems

* **Large Dataset Handling**: HDFView currently cannot nicely handle large datasets when using the default display mode, as the data is loaded in its entirety. To view large datasets, it is recommended to right click on a data object and use the "Open As" menu item, where a subset of data to view can be selected.

* **Large Number of Objects**: HDFView also cannot nicely handle large numbers of objects, because of a design issue that requires HDFView to visit all the objects in a file.

* **Object/Region References in Compound Types**: Object/region references can't be opened by a double-click or by right-clicking and choosing "Show As Table/Image" when inside a compound datatype.

* **Export Dataset in Read-Only Mode**: If a file is opened in read-only mode, right-clicking on a dataset in the tree view and choosing any of the options under the "Export Dataset" menu item will fail with a message of 'Unable to export dataset: Unable to open file'. The current workaround is to re-open the file in read/write mode.

* **Recent Files Button on Mac**: The 'Recent Files' button does not work on Mac due to a cross-platform issue with SWT.

* **PaletteView Selection**: Selecting and changing individual points in PaletteView for an image palette is broken.

* **Source Rebuild Requirements**: Logging and optional HDF4 requires rebuilds from source.

* **Mac File Display**: Automatically opening HDFView and displaying a file selected still does not display the file on a mac.

Please report any new problems found to the [HDFView issue tracker](https://github.com/HDFGroup/hdfview/issues).

## 资料与来源

- <https://opennavo.com/zh/apps/hdfview>
- <https://opennavo.com/zh/apps/hdfview/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/h/hdfview.rb> · 核查于 2026-11-22
- <https://formulae.brew.sh/cask/hdfview>
