entry_exit_mouse_box package

Submodules

• 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.fix_visibility()
    • MiceVisibilityProcessor.process_n_in_out()
    • MiceVisibilityProcessor.process_sessions()
    • MiceVisibilityProcessor.process_visibility_pos()
    • MiceVisibilityProcessor.read_frames()
    • MiceVisibilityProcessor.release_resources()
    • MiceVisibilityProcessor.smooth_centroids()
    • MiceVisibilityProcessor.start_processing()
    • MiceVisibilityProcessor.worker()
  • QtWorkerMVP
    • QtWorkerMVP.measures_ready
    • QtWorkerMVP.run()
  • calculate_maximal_length()
• 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.

duration_to_frames()

experiment_duration_ui()

export_results()

extract_classes()

extract_measures()

hide_paths(state)

init_ui()

jump_backward()

jump_forward()

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_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_calibration(pixelSize, unit)

set_frame(n)

set_media(file_path)

set_min_area()

Uses a polygon drawn by the user over the head of a mouse to define the minimal area to consider that a mouse is present. When summoned, this function must find a shape layer as the active layer, and extract the area of the polygon. The shape layer is then deleted. The value extracted is not stored, it is written in the spinbox.

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, in_out_count, sessions, centroids)

toggle_inputs(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.

tracking_ready

update_boxes()

update_calibration(event)

update_centroids()

update_face_color()

update_mice_path()

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(tableWidget: QTableWidget, filename: str)

init_ui()

set_data(data)

set_exp_name(name)

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)