中文

cffview

CFF is an abbreviation for Ansys Common Fluids Format.

A command-line tool for viewing Ansys Fluent .cas.h5 / .msh.h5 / .dat.h5 files without opening Fluent.

• Read solver settings, materials, boundary conditions, discretisation schemes, and more directly from the HDF5 file.
• Visualise mesh or data with PyVista.

Installation

PyPI

pip install cffview

From source

git clone https://github.com/preamer/cffview.git
cd cffview
pip install .

Usage

Important

Only tested with Ansys Fluent 25R2!

cffview <file> [options]

Options

Option	Description
--version	Print the Fluent version of file
--extract	Dump raw Scheme settings to general.scm / boundary.scm / cortex.scm
--plotmesh	Visualise the mesh interactively with PyVista
--plotdata	Visualise the data interactively with PyVista (may not work, depending on vtkFLUENTCFFReader)
--solver	Solver type, time, dimension, precision, turbulence model, energy, radiation, gravity, ...
--mat [TYPE ...], --materials	Material properties grouped by material type (fluid / solid); filters match a material type or a material name (e.g. --mat fluid, --mat air)
--bd [TYPE ...], --boundary	Boundary condition settings; filters match a boundary type (vi for velocity-inlet, whole word for single-word types) or a zone name (e.g. --bd vi wall po, --bd shadow)
--interfaces	Mesh interfaces settings
--ne, --named-expressions	Named expressions
--cff, --custom-field-functions	Custom field functions
--units [KEYWORD ...]	Show changed units (filtered by one or more keywords; empty means default SI units)
--solution	Solution methods and controls
--rd, --report-definitions	Report definitions
--residuals	Residual settings
--monitorsets	Monitor sets
--plotsets	Plot sets
--convergencesets	Convergence sets
--cell, --cell-registers	Cell registers settings
--iter	Iteration / time-step settings
--surfaces	Surfaces settings
--mesh	Graphics mesh settings
--contours	Graphics contours settings
--vectors	Graphics vectors settings
--pathlines	Graphics pathlines settings
--xy-plot	Graphics xy-plot settings
--scene	Graphics scene settings
--parameters	Input / output parameters
--save	Save the output to file_name.json (if file_name not specified, it is the same as input file)
--plot [out|xy|dat]	Plot a data file; without TYPE, infer from the file extension

Multiple flags can be combined freely. Case settings flags (--solver, --mat, etc.) apply to .cas.h5 files only.

Tip

Long options can be abbreviated to any unambiguous prefix. For example, --inter works for --interfaces and --vec for --vectors. An ambiguous prefix (e.g. --so, which could match --solver or --solution) is rejected with an error.

Examples

# Show all settings and save to JSON
cffview case.cas.h5 --save

# Show solver configuration and boundary conditions
cffview case.cas.h5 --solver --bd

# Visualise the mesh
cffview case.cas.h5 --plotmesh
cffview mesh.msh.h5

# Visualise the data
cffview case.cas.h5 --plotdata

# Check the Fluent version of file
cffview case.cas.h5 --version

# Extract raw Scheme strings for manual inspection
cffview case.cas.h5 --extract

Demo

demo.2.mp4

License

BSD-3-Clause