102 online 3 members  + Join RP Base  +
FreeScript

FullPlot

by saakethramoju  ·  version 2026.11.11  ·  updated 2 days ago

No reviews yet

Downloads
0
Reviews
0
Size
168 KB
Code check
Clean
Licence
GPL-3.0
Released
Nov 2026

FullPlot is a lightweight HDF5 plotting, trace-processing, and map-generation package for engineering simulation and test data.

FullPlot
FullPlot
FullPlot is a lightweight HDF5 plotting, trace-processing, and map-generation package for engineering simulation and test data.

It is designed for workflows where the data is already in HDF5 and the user wants a simple Python interface for inspecting, plotting, filtering, aligning, and saving engineering traces without building a large application around the file format.

FullPlot is especially useful for:

  • simulation outputs stored in HDF5,
  • rocket-engine and test-stand time histories,
  • generic sensor data,
  • controller commands and sequence traces,
  • redline, blueline, yellowline, and greenline overlays,
  • quick HDF5 inspection,
  • 1D trace overlays,
  • dual-axis plots,
  • 2D heat maps,
  • multidimensional dataset slicing,
  • simple rectangular-grid map generation for downstream tools such as FullFlow.

FullPlot does not require a special FullFlow file format. If your HDF5 file contains normal numeric datasets, FullPlot can inspect and plot them.

Installation
pip3 install fullplot

FullPlot requires Python 3.11 or newer.

Quick start
Create or open an HDF5 file that contains a time dataset and one or more numeric channels:

hotfire.h5
├── time
├── PCMC_1
├── PCMC_2
├── PCMC_3
├── OIPT
├── FIPT
├── PBTC_1
└── MOV_CMD

Plot a single trace:

import fullplot as fplt

run = fplt.open("hotfire.h5")

run.plot(
    x="time",
    y="PCMC_1",
    xlabel="Time [s]",
    ylabel="Pressure [psia]",
    title="Chamber Pressure",
)

Plot several traces:

run.plot(
    x="time",
    y=["PCMC_1", "PCMC_2", "PCMC_3"],
    xlabel="Time [s]",
    ylabel="Pressure [psia]",
    title="Chamber Pressure Sensors",
)

Make a dual-axis plot:

run.plot(
    x="time",
    y=["PCMC_1", "OIPT", "FIPT"],
    y2="MOV_CMD",
    xlabel="Time [s]",
    ylabel="Pressure [psia]",
    y2label="Command [-]",
    title="Pressure and Main Ox Valve Command",
)

Save a figure without showing a GUI window:

run.plot(
    x="time",
    y="PCMC_1",
    save="pcmc_1.png",
    show=False,
)

HDF5 inspection
FullPlot starts with inspection. Use tree() when you want to see the file layout and list() when you want the datasets grouped by dimensionality.

import fullplot as fplt

run = fplt.open("hotfire.h5")

run.tree()
run.list()

The same operations are available at module level:

fplt.tree("hotfire.h5")
fplt.list("hotfire.h5")

You can scope an H5File to a group:

run = fplt.open("engine_sim.h5")
transient = run.at("/Engine/transient/runs/startup")

transient.tree()
transient.plot(x="time", y="Chamber_Pressure")

Dataset selectors can be:

  • absolute HDF5 paths, such as "/Engine/transient/time",
  • paths relative to the current root, such as "tracks/PCMC_1",
  • unique short names, such as "PCMC_1".

If a short name matches more than one dataset, FullPlot raises AmbiguousDatasetError instead of guessing.

Read a raw dataset:

pressure = run.read("PCMC_1")

Read scalar datasets under a group:

settings = run.values("metadata")

Reading FullFlow linearizations
FullPlot can read previously calculated FullFlow steady-state and transient linearization records. The result is a labeled Linearization object containing the state-space matrices and the operating point at which they were computed.

A continuous-time linear model takes the form

\Delta\dot{x}=A\Delta x+B\Delta u

\Delta y=C\Delta x+D\Delta u

where:

  • x: physical dynamic state vector (for example stored mass or energy),
  • u: selected input vector (for example valve area),
  • y: selected output vector (for example chamber pressure),
  • A: how state changes affect the state derivatives,
  • B: how input changes affect the state derivatives,
  • C: how state changes affect outputs,
  • D: how input changes directly affect outputs.

\Delta denotes a deviation from the saved operating point. For a non-equilibrium transient point, the model also needs the saved baseline derivative:

\dot{x}\approx\dot{x}_0+A(x-x_0)+B(u-u_0)

y\approx y_0+C(x-x_0)+D(u-u_0)

FullPlot does not create these matrices. It reads them from FullFlow's linearization HDF5 output, without needing the original nonlinear network or property-model packages.
Discover available results
import fullplot as fplt

file = fplt.open("Linearization.h5")
info = file.linearizations()

linearizations() prints a summary of each available run and returns a list of dictionaries. Each record includes network, solver, run, path, time, matrix dimensions (states, inputs, outputs), and saved transient point times (times). When only transient points were saved, time is None because there is no separate base result.

For programmatic discovery without printing:

info = file.linearizations(print_output=False)

for run in info:
    print(run["solver"], run["time"], run["times"])

Read one linearization
steady = file.linearization(solver="steady_state")

print(steady.A)
print(steady.B)
print(steady.C)
print(steady.D)

Read the final/base transient result with:

final = file.linearization(solver="transient")

Omitting time selects the base result, not the latest point stored in points/. If only saved points are present, specify time= or times=. If the file contains both steady-state and transient records, select solver= explicitly. If only one record is available, it can be inferred.
Read transient operating points
point = file.linearization(solver="transient", time=0.1)

print(point.time)
print(point.A.shape)
print(point.states)

Read several points at once:

points = file.linearization(
    solver="transient",
    times=[0.1, 0.3],
)

for requested_time, linear in points.items():
    print(requested_time, linear.A, linear.D)

times= returns an ordin

…