D2V — Free Dump-to-VTK Converter (Windows)

[English]

dump2vtk.exe is a fast bulk converter that turns LIGGGHTS/LAMMPS dump files into VTK (legacy format, ASCII/BINARY).

It offers a 3-tab GUI (Particles / Header Replace / Force chain) and an equivalent CLI. It supports force-chain export and Louvain method community aggregation, making it easy to visualize results in ParaView and similar tools.

[Features]

- VTK conversion (particles): Automatically collects sequential dump files and converts them in bulk (ASCII/BINARY).

- Header replace: Batch-replace the `ITEM: ENTRIES ...` line.

- Force chain: Build a network from pair/local dumps and export as VTK; also outputs Louvain aggregation metrics.

- Performance: Parallelization and chunk processing for large datasets.

- Drag & drop: Drop files onto the GUI.

- CLI: Suitable for batch jobs and automation.

Note: Output is VTK legacy only (no VTU support).

Security & Environment

- Scanned with WithSecure Elements Agent — no malware detected.

- Functionality verified on Windows 11 Sandbox.

---

[日本語]

dump2vtk.exe は、LIGGGHTS/LAMMPS の dump を VTK（レガシー形式・ASCII/BINARY）に高速一括変換するツールです。

Particles / Header Replace / Force chain の 3タブ構成GUI に加え、同等機能の CLI を搭載。フォースチェーン出力と Louvain 法によるコミュニティ集約に対応し、ParaView 等での可視化へスムーズに接続できます。

[機能]

- VTK 変換（粒子）：連番 dump を自動収集して一括変換（ASCII/BINARY）

- ヘッダー置換：`ITEM: ENTRIES ...` 行の一括置換

- フォースチェーン：pair/local dump からネットワークを生成し VTK 出力、Louvain 集約量も出力

- 高速化：並列処理とチャンク処理で大規模データに対応

- ドラッグ＆ドロップ：GUI にファイルを放り込むだけ

- CLI：バッチ処理や自動実行に利用可能

注意: 出力は VTK（レガシー）のみです（VTU 非対応）。

セキュリティ・動作環境

- WithSecure Elements Agent でマルウェアスキャン済み（問題なし）

- Windows 11 Sandbox 上で動作確認済み

Official website

http://opendemjapan.parallel.jp/

Installation Method/インストール方法

[English]

1. Run the included `dump2vtk-Setup.exe`.

2. Follow the wizard to install (default location: `C:\ Program Files\dump2vtk`).

3. After installation, a desktop shortcut is created; when launched, an icon appears on the taskbar.

4. For details, see the "Installation" chapter in `manual.pdf` (with screenshots).

[日本語]

1. 同梱の `dump2vtk-Setup.exe` を実行

2. ウィザードに従いインストール（既定先：`C:\ Program Files\dump2vtk`）

3. インストール後は デスクトップにショートカットが作成され、起動時に タスクバーにアイコンが表示されます

4. 詳細は `manual.pdf` の「インストール」章をご参照ください（スクリーンショットあり）

System Requirements/動作環境

[English]

- OS: Windows 10/11 (64-bit)

- CPU: 4+ cores recommended

- Memory: 8 GB or more recommended (depends on dataset size)

[日本語]

- OS：Windows 10/11（64bit）

- CPU：4コア以上推奨

- メモリ：8 GB 以上推奨（データ規模に依存）

Detail/詳細

[English]

This software converts LIGGGHTS/LAMMPS dump files to VTK (legacy, ASCII/BINARY). The GUI has three tabs:

- Particles: particle dumps → VTK. Supports automatic sequential file collection and parallel processing.

- Header Replace: batch replacement of `ITEM: ENTRIES ...`. Can handle WSL paths.

- Force chain: generates a force network from pair/local dumps and outputs VTK. Also outputs community aggregation metrics via the Louvain method.

Note: Output is VTK only (no VTU support).

[日本語]

本ソフトは LIGGGHTS/LAMMPS の dump を VTK（legacy, ASCII/BINARY）へ変換する。GUI は 3 タブ構成である。

- Particles: 粒子 dump → VTK。連番自動収集と並列処理に対応。

- Header Replace: `ITEM: ENTRIES ...` の一括置換。WSL パスも扱える。

- Force chain: pair/local dump からフォースネットワークを生成し VTK を出力。Louvain 法によるコミュニティ集約量を併出力する。

注意：出力は VTK のみである（VTU には対応しない）。

Usage/使い方 (GUI)

[English]

Particles

1) Drop one dump file; the app automatically collects sequential files sharing the same prefix.

2) Specify the output directory if needed.

3) In Advanced settings, choose ASCII/BINARY, set parallel workers, chunk size, and `--no-overwrite`.

4) Click "Export VTK" to convert (the log shows `Start: particle VTK (parallel)... Done.`).

Header Replace

- Example replacement line:

`ITEM: ENTRIES x1 y1 z1 x2 y2 z2 id1 id2 periodic fx fy fz Fnx Fny Fnz Ftx Fty Ftz`

After running, a file with the suffix `-renamed.dump` is generated.

Force chain

- Select a single `-renamed.dump`; the app auto-collects the sequence and outputs VTK for each step.

Completion is indicated by the log: `Start: force chain batch (parallel)... All done.`

[日本語]

Particles（粒子）

1) dump を 1 つ投入すると、同名プレフィクスの連番を自動収集する。

2) 必要に応じて出力先を指定する。

3) Advanced settings で ASCII/BINARY、並列数、チャンクサイズ、`--no-overwrite` を設定する。

4) 「Export VTK」で変換（ログに `Start: particle VTK (parallel)... Done.` と表示）。

Header Replace

- 置換行の例：

`ITEM: ENTRIES x1 y1 z1 x2 y2 z2 id1 id2 periodic fx fy fz Fnx Fny Fnz Ftx Fty Ftz`

実行後に `-renamed.dump` が生成される。

Force chain

- `-renamed.dump` を 1 つ選ぶと連番を自動収集し、各ステップの VTK を出力する。

ログに `Start: force chain batch (parallel)... All done.` と表示されれば完了。

Usage/使い方（CLI）

[English]

You can run the same operations via the CLI. The executable is dump2vtk.exe.

Particle dump → VTK

dump2vtk.exe lpp DUMP_FILES... ^

-o OUTROOT --format {ascii|binary} ^

--cpunum N --chunksize K --no-overwrite

Header replace

dump2vtk.exe rename ^

-H "ITEM: ENTRIES x1 y1 z1 x2 y2 z2 id1 id2 periodic fx fy fz Fnx Fny Fnz Ftx Fty Ftz" ^

inputs.dump --inplace

Force chain (VTK output)

dump2vtk.exe force forcechain-.dump ^

--encoding {ascii|binary} --keep-periodic --resolution 1.0 --seed 42 ^

--write-pointdata --outdir outdir/ --nan-fill 0.0 ^

--cpunum N --chunksize K --no-overwrite

[日本語]

GUI と同等の処理を CLI でも実行できる。実行ファイル名は dump2vtk.exe である。

粒子 dump → VTK

dump2vtk.exe lpp DUMP_FILES... ^

-o OUTROOT --format {ascii|binary} ^

--cpunum N --chunksize K --no-overwrite

ヘッダー置換

dump2vtk.exe rename ^

-H "ITEM: ENTRIES x1 y1 z1 x2 y2 z2 id1 id2 periodic fx fy fz Fnx Fny Fnz Ftx Fty Ftz" ^

inputs.dump --inplace

フォースチェーン（VTK出力）

dump2vtk.exe force forcechain-.dump ^

--encoding {ascii|binary} --keep-periodic --resolution 1.0 --seed 42 ^

--write-pointdata --outdir outdir/ --nan-fill 0.0 ^

--cpunum N --chunksize K --no-overwrite

Licence/ライセンス

[English]

- Entire distribution: GNU GPL-2.0-or-later

- Original components: MIT also listed in NOTICE (for standalone reuse)

- Third-party: NumPy (BSD-3), PySide6/Qt (LGPL-3), VTK (BSD-3), NetworkX (BSD-3), python-louvain (BSD-like)

- Include src/ to satisfy the GPL source-distribution requirement.

[日本語]

- 配布物全体: GNU GPL-2.0-or-later

- 自作部分: NOTICE にて MIT を併記（単独再利用時）

- サードパーティ: NumPy（BSD-3）, PySide6/Qt（LGPL-3）, VTK（BSD-3）, NetworkX（BSD-3）, python-louvain（BSD系）

- src/ を同梱し、GPL のソース提供要件を満たす。

Update History/アップデート履歴

[3 November 2025] v1.0.0 Initial Release

github

[GUI]

[stand-alone]

https://github.com/opendemjapan/liggghts-lammps-dump2vtk.git

https://github.com/opendemjapan/liggghts-entries-header-replacer.git

https://github.com/opendemjapan/dump2force.git