Skip to content

gRPC API

The server exposes a gRPC API. The service and message definitions live in mef3io_server/protobufs/gRPCMef3Server.proto.

Every data access is oriented in channels and time — there is no segment grid and no server-side channel selection; each request is self-contained.

Key RPCs

RPC Client method Purpose
GetSignalRange get_signal_range(file_path, channels, start_uutc, end_uutc) Read any channels over any [start_uutc, end_uutc) window; streams float32. channels=None means all channels. With n_points, exactly that many points per channel (MinMaxLTTB; never upsampled).
FileInfo get_file_info(file_path) Metadata: channel_names, channel_sampling_rates, channel_start_uutc, channel_end_uutc (parallel per-channel arrays) plus the global start_uutc / end_uutc / duration_s.
OpenFile open_file(file_path, cache_fs=None, allow_mixed_rates=False) Open a file for this client and return its metadata. With cache_fs, this client's reads are served, cached and prefetched at that rate (order-preserving min-max); channel_served_sampling_rates lists the rate per channel.
CloseFile close_file(file_path) End this client's session on the file. The reader is released, and the file's tiles purged from the shared cache, when no other client's session uses it.
ListOpenFiles list_open_files() List the currently open files.

Streaming

GetSignalRange streams the result in ~2.5 MB SignalChunk messages carrying raw float32 bytes plus the shape, dtype, channel names, and the uUTC span of each chunk. The client reassembles them into a single (n_channels, n_samples) array. See the Python client guide for usage.