save_mp4

3. save_mp4#

mbo_utilities.save_mp4()

save_mp4 converts a 3D numpy array or TIFF stack ([T, Y, X]) into an .mp4 video.

It supports optional temporal smoothing, playback speed adjustment, and colormaps.

from pathlib import Path
import mbo_utilities as mbo
import tifffile

3.1. Load Data#

save_path = Path().home().joinpath("dev")
files = mbo.get_files(save_path, 'tif', 4)
data = tifffile.imread(files[0])
data.shape  # should be [T, Y, X]

3.2. Example Usage#

mbo.save_mp4(save_path / "default.mp4", data)

mbo.save_mp4(save_path / "speedup_2x.mp4", data, speedup=2)

mbo.save_mp4(save_path / "speedup_4x.mp4", data, speedup=4)

mbo.save_mp4(save_path / "windowed_5frames_4x.mp4", data, speedup=4, win=5)

3.3. Parameters#

mbo.save_mp4(
    fname,         # output filename
    images,        # 3D array or TIFF path
    framerate=17,
    speedup=1,
    chunk_size=100,
    cmap="gray",
    win=7,
    vcodec="libx264",
    normalize=True
)
Contents