DataSpace Nastran H5

Nastran HDF5 data space — solution file navigation, modal data extraction, and result access for MSC.Nastran H5 output files.

Overview

MSC.Nastran writes simulation results (eigenvalues, modal participation factors, displacements, etc.) into HDF5 (.h5) output files with a standard hierarchical structure rooted at NASTRAN/RESULT/. This library provides read-only access to those files, wrapping h5py to navigate the Nastran HDF5 hierarchy and extract datasets as NumPy arrays.

Two main classes cover different levels of access:

• NastranH5File — opens a single .h5 file for direct dataset, group, and attribute access by HDF5 path.
• NastranSolutionFolder — scans a directory for .h5 files and provides dataset retrieval by logical type (e.g., {"type": "modes"}).

Installation

pip install vcti-dataspace-nastran-h5>=1.0.0

Quick Start

from pathlib import Path
from vcti.dataspace_nastran_h5 import NastranH5File, NastranSolutionFolder

# Direct H5 file access
with NastranH5File(Path("sol103.h5")) as h5:
    tables = h5.get_modal_tables()
    mpf = h5.get_modal_participation_factors()
    eigenvalues = h5.get_dataset("NASTRAN/RESULT/MODAL/EIGENVALUE")

# Solution folder access
with NastranSolutionFolder(Path("sol103_results/")) as folder:
    data = folder.get_dataset({"type": "modes"})

Core API

NastranH5File

NastranSolutionFolder

Both classes support context managers (with statement).

Dependencies

• h5py (>=3.0)
• numpy (>=1.24)