entry_exit_mouse_box package

Submodules

• entry_exit_mouse_box.convert_format module
  • QtWorkerC2A
    • QtWorkerC2A.convert_to_avi()
    • QtWorkerC2A.file_ready
    • QtWorkerC2A.run()
• entry_exit_mouse_box.mask_from_video module
  • MaskFromBackground
    • MaskFromBackground.add_frames_to_video()
    • MaskFromBackground.process_frames()
    • MaskFromBackground.read_frames()
    • MaskFromBackground.release_resources()
    • MaskFromBackground.start_processing()
    • MaskFromBackground.worker()
  • QtWorkerMFV
    • QtWorkerMFV.mask_ready
    • QtWorkerMFV.run()
• entry_exit_mouse_box.measures module
  • MiceVisibilityProcessor
    • MiceVisibilityProcessor.filter_visibility()
    • MiceVisibilityProcessor.get_session_length()
    • MiceVisibilityProcessor.process_sessions()
    • MiceVisibilityProcessor.process_visibility_pos()
    • MiceVisibilityProcessor.smooth_centroids()
    • MiceVisibilityProcessor.split_frame_ranges()
    • MiceVisibilityProcessor.start_processing()
    • MiceVisibilityProcessor.worker()
  • QtWorkerMVP
    • QtWorkerMVP.measures_ready
    • QtWorkerMVP.run()
• entry_exit_mouse_box.media_manager module
  • MediaManager
    • MediaManager.add_source()
    • MediaManager.get_current_frame_number()
    • MediaManager.get_fps()
    • MediaManager.get_height()
    • MediaManager.get_n_frames()
    • MediaManager.get_n_sources()
    • MediaManager.get_source_by_index()
    • MediaManager.get_source_by_name()
    • MediaManager.get_video_properties()
    • MediaManager.get_width()
    • MediaManager.release()
    • MediaManager.release_source()
    • MediaManager.set_frame()
    • MediaManager.set_logger()
  • properties_match()
• entry_exit_mouse_box.results_table module
  • FrameWiseResultsTable
    • FrameWiseResultsTable.set_data()
  • ResultsTable
    • ResultsTable.export_data()
    • ResultsTable.export_table_to_csv()
    • ResultsTable.init_ui()
    • ResultsTable.set_data()
    • ResultsTable.set_exp_name()
  • SessionsResultsTable
    • SessionsResultsTable.set_data()
  • main_sessions()
  • read_names()
• entry_exit_mouse_box.utils module
  • apply_lut()
  • cast_to_pixels()
  • merge_close_points()
  • setup_logger()
  • smooth_path_2d()
• entry_exit_mouse_box.video_mean_processor module
  • QtWorkerVMP
    • QtWorkerVMP.bg_ready
    • QtWorkerVMP.run()
  • VideoMeanProcessor
    • VideoMeanProcessor.process_frames()
    • VideoMeanProcessor.read_frames()
    • VideoMeanProcessor.release_resources()
    • VideoMeanProcessor.start_processing()
    • VideoMeanProcessor.worker()

Module contents

class entry_exit_mouse_box.MediaManager(viewer)

Bases: object

add_source(file_path, target_layer, img_type, process=None)

Add a new video source to the manager.

Parameters:

• file_path – Path of the video file to be opened.

• target_layer – Name of the layer to which each frame of the video will be loaded.

• img_type – Type of the image to be loaded (‘image’ or ‘labels’).

• process – Function to be applied to each frame of the video before displaying it.

Raises:

• FileNotFoundError – If the file is not found at the specified path.

• IOError – If the file cannot be opened.

• ValueError – If the properties of the video do not match the properties of the media already opened.

Returns:

The properties of the last video added under the form of a dictionary.

get_current_frame_number()

get_fps()

get_height()

get_n_frames()

get_n_sources()

get_source_by_index(index)

get_source_by_name(name)

get_video_properties()

get_width()

release()

release_source(index)

set_frame(frame_target)

set_logger(logger)

class entry_exit_mouse_box.MouseInOutWidget(napari_viewer: Viewer)

Bases: QWidget

add_calibration_ui()

add_media_control_ui()

add_row()

add_tracking_ui()

add_video_control_ui()

apply_calibration()

background_ready

build_labels_from_polygon()

calibrate_results()

Applies the calibration to the distance traveled by the mice, stored in the sessions table.

clear_state()

Resets the state of the widget to its initial state.

create_temp_dir(root=None)

dump_table()

Dumps the content of the table in a dictionary.

dump_temp_files()

duration_to_frames()

experiment_duration_ui()

export_results()

extract_classes()

extract_measures()

get_min_track_length()

get_min_track_length_pxl()

hide_paths(state)

init_ui()

jump_backward()

jump_forward()

launch_convert(file_path)

launch_mask_processing()

launch_tracking()

make_start_frame(row, button)

Sets the frame at which we start measures from the current frame being displayed. The saved index is the one displayed on the screen. (The real one + 1). A source is required before we can set the start frame.

measures_ready

on_min_track_length_update()

on_slider_change(value)

on_spinbox_change(value)

on_table_item_changed(item)

Called when the user modifies an existing line of the table containing the colors and names of the boxes. The new name is processed here before it is provided by the user. Both the layer’s name and the box’s name are updated.

on_threshold_update(value)

Creates a preview layer showing what the mask would be for the current frame for a given threshold. Updates are made only when the threshold is edited. The background reference is required. The produced layer is named ‘threshold_preview’ and is temporary, it will be discarded. This function is the callback for the threshold spinbox.

Parameters:

value – int - The threshold value to use for the preview.

remove_row()

select_color(row, button, k=None)

select_file()

set_active_ui(t)

Used to disable the inputs (buttons and text fields) when a long process is running.

Parameters:

t – bool - True to enable the inputs, False to disable them.

set_calibration(pixelSize, unit)

set_frame(n)

set_media(file_path)

set_mouse_length(pxl_length)

start_extract_background()

switch_log_file(new_file_name)

Creates a new log file when we switch to a new experiment video.

terminate_extract_background(ref, src_path)

terminate_mask_processing(mask_path)

terminate_measures(visibility, centroids, sessions)

tracking_ready

update_boxes()

update_calibration(event)

update_centroids()

update_face_color()

update_mice_path()

update_mouse_length_from_line()

Uses a line or the value in the spinbox to determine a length in pixels that will be converted to physical units. The length is used to determine the size of the mouse in pixels. Later, a fraction of this length will be used to determine the minimum length of a path.

update_mouse_length_from_number()

update_playback_info()

class entry_exit_mouse_box.QtWorkerMFV(in_path, out_path, ref, t, s, r)

Bases: QObject

mask_ready

run()

class entry_exit_mouse_box.QtWorkerMVP(mask_path, areas, ma, start, duration)

Bases: QObject

measures_ready

run()

class entry_exit_mouse_box.QtWorkerVMP(video_path, shape)

Bases: QObject

bg_ready

run()

class entry_exit_mouse_box.ResultsTable(data, name='Data Table', parent=None)

Bases: QMainWindow

export_data()

export_table_to_csv(filename: str)

init_ui()

set_data(data)

set_exp_name(name)

class entry_exit_mouse_box.VideoConverterWidget(napari_viewer: Viewer)

Bases: QWidget

done_a_file(_)

init_ui()

launch_convert(file_path)

select_folder()

set_active_ui(active)

start_conversion()

entry_exit_mouse_box.napari_get_reader(path)

A basic implementation of a Reader contribution.

Parameters:

path (str or list of str) – Path to file, or list of paths.

Returns:

If the path is a recognized format, return a function that accepts the same path or list of paths, and returns a list of layer data tuples.

Return type:

function or None

entry_exit_mouse_box.setup_logger(file_path)