Convert Inscopix Movie To MP4¶
Overview and purpose¶
This tool allows you to convert a miniscope or nVision movie to a MP4 file.
Use this tool if you want to use this data in another application that requires data to be in this format.
This tool uses 1.0 compute credits per hour.
Parameters¶
Parameter | Required? | Default | Description |
---|---|---|---|
Movie Files | True | N/A | Input Inscopix movie files (isxd, isxb) |
Compression Quality | True | 0.1 | A value between 0.001 and 1 that controls the quality and size of the output file for the MP4 format |
Write Invalid Frames | True | False | If checked, write any invalid frames, including dropped, cropped, and blank frames, as frames containing only zeros. otherwise, do not write invalid frames |
Frame Rate Format | True | float | Choosing float is more precise, but less compatible with third party software. choose int to round the frame rate to the nearest integer (more compatible) |
Draw Bounding Box | False | True | Only used if exporting an .ISXB movie. determines whether the bounding box of the animal is drawn on the movie |
Draw Bounding Box Center | True | True | Only used if exporting an .ISXB movie. determines whether the center of bounding box of the animal is drawn on the movie |
Draw Zones | False | True | Only used if exporting an .ISXB movie. determines whether the zone annotations are drawn on the movie |
Details¶
Valid Inputs¶
Source Parameter | File Type | File Format |
---|---|---|
Movie Files | miniscope_movie, nvision_movie | isxd, isxb |
Movie Files¶
One or more movie files. If more than one movie file is provided, they should be a valid series. A series input can also be provided.
Compression quality¶
A value between 0.001 and 1 that controls the quality and size of the output file for the MP4 format. The larger the value, the better the quality of the movie, but the larger the size of the file. The default value of 0.1 typically produces a good quality movie where the file is at most 10% of the uncompressed original file size, but may be smaller if the movie content can be efficiently encoded. More formally, this represents a rough maximum on the output file size as a fraction of the original file size.
Frame Rate format¶
This is the format to encode the frame rate of the input movie in the output file. It can be one of:
float
: the precise frame rate of the input movie is encoded in the output file.
The frame rate of the output file is not guaranteed to be exactly equal to the frame rate of the input movie due to limitations of the MPEG-4 codec used to encode video data in the output file.
However, generally the frame rate of the output file will equal the frame rate of the input movie within at least 3 decimal places.
int
(rounded): the frame rate of the input movie is rounded to the closest integer, which is then encoded in the output file.
Use this option in order to maintain compatibility with the Ethovision software for behavioral analysis.
Outputs¶
MP4 movie¶
MP4 movie containing input data. If multiple files are provided, they are combined into a single MP4 movie.