Saving files

After a successful Run, SigGer writes one file in the Destination folder. The path is Destination / SignalName . ext where the extension depends on the target-format tumbler. I/O is performed by the project module ScyIO_UnB.

1. Formats

Tumbler	Extension	Typical contents	Spec / docs
HDF5	`.h5`	Hierarchical datasets; waveform plus `fs`	HDF5 documentation
Parquet	`.parquet`	Columnar table (Apache Arrow / Parquet)	Parquet documentation
Matlab	`.mat`	MATLAB Level-compatible MAT-file	MAT-file versions

2. Sampling frequency as a first-class variable

Every writer attaches f_s so a reader does not have to guess the rate from the file name. After the ScyIO write, generate_signal._attach_sampling_frequency stores fs as:

HDF5 attributes fs and sampling_frequency, dataset fs, and variables/fs;
the corresponding metadata fields on Parquet and MAT files.

When you later open the record in an analyser, treat fs as the official rate in hertz used in (3)–(5).

3. Data types

Signal type	After synthesis	On disk
Floating-point	`float64` working buffer	`float32`
Fixed-point	rounded `int32`	`int16`, clipped to [−32768, 32767]

Large growing geometrics (|a| > 1) or heavy-tailed noise with a large scale can clip in fixed-point mode. Prefer floating-point when the dynamic range is unknown.

4. Overwrite policy

Writes use overwrite=True. Saving again with the same name and folder replaces the previous file.

5. Progress model

Generators fill the array in ten contiguous slices

I_k = [ ⌊N(k−1)/10⌋ , ⌊N k / 10⌋ ) , k = 1,…,10 (37)

and call progress_callback(10k) after each slice. The UI processes events so the circular gauge can repaint.

6. Using the files elsewhere

Python: h5py, pandas.read_parquet, scipy.io.loadmat.
MATLAB: load('name.mat') and read the fs variable.
SigScope / other UnB tools that already speak ScyIO.