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 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:
Installation
FullPlot requires Python 3.11 or newer.
Quick start
Create or open an HDF5 file that contains a
Plot a single trace:
Plot several traces:
Make a dual-axis plot:
Save a figure without showing a GUI window:
HDF5 inspection
FullPlot starts with inspection. Use
The same operations are available at module level:
You can scope an
Dataset selectors can be:
Read a raw dataset:
Read scalar datasets under a group:
Reading FullFlow linearizations
FullPlot can read previously calculated FullFlow steady-state and transient linearization records. The result is a labeled
A continuous-time linear model takes the form
where:
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
For programmatic discovery without printing:
Read one linearization
Read the final/base transient result with:
Omitting
Read transient operating points
Read several points at once:
…
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.
Installation
pip3 install fullplotFullPlot 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_CMDPlot 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".
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 uwhere:
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…