PlumeDynamics 0.1.0

Tools for loading, visualizing, and analyzing pulsed-laser-deposition plume dynamics.

PlumeDynamics is a Python package for loading, visualizing, aligning, and analyzing pulsed-laser-deposition (PLD) plume image stacks. The canonical import namespace is plume_dynamics.

Installation

Install from a local checkout:

git clone https://github.com/yig319/PlumeDynamics.git
cd PlumeDynamics
python -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -e .

Optional feature groups:

pip install -e ".[ml]"
pip install -e ".[xrd]"

Quick Start

import numpy as np
from plume_dynamics.plume_io import extract_frame_metrics, plot_sample_frames

frames = np.random.random((24, 128, 192))
metrics = extract_frame_metrics(frames, frame_interval_us=10, direction="right")
fig, axes = plot_sample_frames(frames, n_frames=8)

Core Modules

• plume_dynamics.alignment: perspective alignment for plume frame stacks.

• plume_dynamics.datasets: HDF5 plume dataset loading helpers.

• plume_dynamics.metrics: connected-component area and centroid metrics.

• plume_dynamics.velocity: plume-front distance and velocity extraction.

• plume_dynamics.plume_io: plume frame I/O and starter metrics.

• plume_dynamics.visualization and plume_dynamics.plotting: image grids, labels, colorbars, and publication plotting helpers.

• plume_dynamics.ml: optional model, dataset, and training utilities.

Versioning And Publishing

This repository follows the AFM-tools release convention:

• Versions are generated from Git tags with setuptools_scm.

• The GitHub Actions workflow builds and checks distributions on PRs and pushes.

• A push to main or master with #major, #minor, or #patch in the commit message creates the next vX.Y.Z tag and publishes to PyPI by Trusted Publishing.

License

This project is licensed under the MIT License. See LICENSE.txt.