MASH video files

MASH video files are binary files with the extension .sira. They are usually found in the main, main/simulations, or main/video_processing/average_images analysis folders.

Table of contents

  1. Description
  2. File name
  3. Structure

Description

MASH video files are the graphic files written and used by MASH. They contain the strict necessary information about the single molecule video (SMV) or image, including pixel data, video dimensions, the frame rate and MASH-FRET version.

They are created in the /simulations analysis sub-folder when exported from module Simulation, at a user-defined location or in video_processing/average_images when exported from module Video processing.

They are created when:

  • exporting the simulated SMV in panel Export options of module Simulation
  • exporting the SMV in panel Edit video of module Video processing
  • exporting the average image in panel Molecule coordinates of module Video processing

File name

The file is named by the user.

By default, the file is named after the video file loaded in module Video processing, with the extension _ave for average images.


Structure

The file header contains information about the version of MASH, the frame acquisition time and the video dimensions.

The version of MASH used at the creation of the video file is written in the first file line such as:

MASH-FRET exported binary graphic Version: X.X.X (prev. commit: XXXXXXX)

The frame acquisition time, x- and y- video dimensions and the video frame length are then written in the second file line using double, single, single and single precision respectively. Finally, the file is appended with pixel data written column by column and frame by frame using single precision.

MATLAB scripts used to read and write .sira video files can be found in MASH source code at:

MASH-FRET/source/video_processing/graphic_files/readSira.m
MASH-FRET/source/video_processing/graphic_files/export2Sira.m

with the function export2Sira.m requiring the use of:

MASH-FRET/source/video_processing/graphic_files/getFrames.m