saakethramoju/fullplot

FullPlot is a lightweight Python package for inspecting, plotting, and processing engineering data that is stored in HDF5 files, a common format for simulation output and test rig recordings. It is built for cases where the data already exists in HDF5 and a user just wants a simple way to look at it, filter it, line up different signals in time, and save results, without building a whole application around the file format. The package is aimed at things like rocket engine and test stand time histories, generic sensor data, controller command sequences, and reference lines such as redline or greenline limits overlaid on a plot. It does not require any special file layout: if an HDF5 file has normal numeric datasets, FullPlot can open, inspect, and plot them directly. After installing with pip, a user opens a file and can call a tree or list function to see how the file is organized, then plot one or several traces against a shared time axis, including dual axis plots that show two different units on the same chart. Plots can either be shown in a window or saved directly to an image file without opening a GUI. A central idea in the package is the Trace object, a reusable one dimensional line of data with a name, a role such as data, redline, or command, and metadata attached to it. Traces can come from a file, from raw arrays, from a constant value, from a list of points describing a command sequence, or from a mathematical function. A shared TimeAxis object lets several traces move together when the user shifts or aligns time, which is useful when lining up a test run's raw timestamps with a simulation's model time. FullPlot also includes a way to generate rectangular grid maps across independent variables, meant to feed downstream tools such as a companion project called FullFlow, though the specifics of that integration are not detailed in what is shown here.