summary

pulserver.ir.summary()

Return the segmentation of a sequence: subsequences, segments and readouts.

Each subsequence lists its unique RF definitions under rf: the flip angle in degrees at the largest amplitude the definition plays, as pypulseqpp.Sequence.rf_flip_angles gives it; and the bandwidth at half the spectral peak, the number of bands, each band’s offset from the carrier and the widest band’s bandwidth, all in Hz, as pypulseqpp.calc_rf_bandwidth measures them; and b1sq_integral_s, the integral of the squared envelope scaled to unit peak, in s: pypulseqpp.calc_rf_power’s energy over its peak power, both summed over a dynamic pTx pulse’s channels. vop_sar_ratio and vop_global_sar_ratio are those the cache was written with, zero when the chain is read and segmented again; spl_peak_db and spl_average_dba likewise, -1 when it is. readout_labels lists, per readout in play order, the values of the three labels label_column_map selects, as in force at that readout. waves lists the subsequence’s waves, as play() indexes them: each one’s point count, and its largest magnitude along x, y and z over that of the largest gradient event it combines. grad_raster_us is the raster the file’s gradient shapes are sampled on, in µs.

With cache_ext, the cache beside the file is loaded instead of the chain being read and segmented again; this build loads only vendor-neutral caches, and only when the size recorded in the cache matches the file.

Raises:

ValueError – If the file cannot be read or the cache cannot be loaded.