celldetective 1.1.1.post4__py3-none-any.whl → 1.2.0__py3-none-any.whl

celldetective/io.py

@@ -30,7 +30,7 @@ from scipy.interpolate import griddata
 def get_experiment_wells(experiment):
 	
 	"""
-	Retrieves the list of well directories from a given experiment directory, sorted 
+	Retrieves the list of well directories from a given experiment directory, sorted
 	naturally and returned as a NumPy array of strings.
 
 	Parameters
@@ -41,104 +41,107 @@ def get_experiment_wells(experiment):
 	Returns
 	-------
 	np.ndarray
-		An array of strings, each representing the full path to a well directory within the specified 
+		An array of strings, each representing the full path to a well directory within the specified
 		experiment. The array is empty if no well directories are found.
 
 	Notes
 	-----
-	- The function assumes well directories are prefixed with 'W' and uses this to filter directories 
+	- The function assumes well directories are prefixed with 'W' and uses this to filter directories
 	  within the experiment folder.
 
-	- Natural sorting is applied to the list of wells to ensure that the order is intuitive (e.g., 'W2' 
-	  comes before 'W10'). This sorting method is especially useful when dealing with numerical sequences 
+	- Natural sorting is applied to the list of wells to ensure that the order is intuitive (e.g., 'W2'
+	  comes before 'W10'). This sorting method is especially useful when dealing with numerical sequences
 	  that are part of the directory names.
-	
+
 	"""
 
 	if not experiment.endswith(os.sep):
 		experiment += os.sep
-		
+
 	wells = natsorted(glob(experiment + "W*" + os.sep))
-	return np.array(wells,dtype=str)
+	return np.array(wells, dtype=str)
+
 
 def get_config(experiment):
 
 	if not experiment.endswith(os.sep):
 		experiment += os.sep
-	
+
 	config = experiment + 'config.ini'
 	config = rf"{config}"
-	assert os.path.exists(config),'The experiment configuration could not be located...'
-	return config	
+	assert os.path.exists(config), 'The experiment configuration could not be located...'
+	return config
 
 
 def get_spatial_calibration(experiment):
 	
 	
 	config = get_config(experiment)
-	PxToUm = float(ConfigSectionMap(config,"MovieSettings")["pxtoum"])
-	
+	PxToUm = float(ConfigSectionMap(config, "MovieSettings")["pxtoum"])
+
 	return PxToUm
 
+
 def get_temporal_calibration(experiment):
 	
 	config = get_config(experiment)
-	FrameToMin = float(ConfigSectionMap(config,"MovieSettings")["frametomin"])
-	
+	FrameToMin = float(ConfigSectionMap(config, "MovieSettings")["frametomin"])
+
 	return FrameToMin
 
+
 def get_experiment_concentrations(experiment, dtype=str):
 	
 	
 	config = get_config(experiment)
 	wells = get_experiment_wells(experiment)
 	nbr_of_wells = len(wells)
-	
-	concentrations = ConfigSectionMap(config,"Labels")["concentrations"].split(",")
+
+	concentrations = ConfigSectionMap(config, "Labels")["concentrations"].split(",")
 	if nbr_of_wells != len(concentrations):
-		concentrations = [str(s) for s in np.linspace(0,nbr_of_wells-1,nbr_of_wells)]
-	
+		concentrations = [str(s) for s in np.linspace(0, nbr_of_wells - 1, nbr_of_wells)]
+
 	return np.array([dtype(c) for c in concentrations])
 
+
 def get_experiment_cell_types(experiment, dtype=str):
-	
 	config = get_config(experiment)
 	wells = get_experiment_wells(experiment)
 	nbr_of_wells = len(wells)
-	
-	cell_types = ConfigSectionMap(config,"Labels")["cell_types"].split(",")
+
+	cell_types = ConfigSectionMap(config, "Labels")["cell_types"].split(",")
 	if nbr_of_wells != len(cell_types):
-		cell_types = [str(s) for s in np.linspace(0,nbr_of_wells-1,nbr_of_wells)]
-	
+		cell_types = [str(s) for s in np.linspace(0, nbr_of_wells - 1, nbr_of_wells)]
+
 	return np.array([dtype(c) for c in cell_types])
 
+
 def get_experiment_antibodies(experiment, dtype=str):
 	
 	config = get_config(experiment)
 	wells = get_experiment_wells(experiment)
 	nbr_of_wells = len(wells)
-	
-	antibodies = ConfigSectionMap(config,"Labels")["antibodies"].split(",")
+
+	antibodies = ConfigSectionMap(config, "Labels")["antibodies"].split(",")
 	if nbr_of_wells != len(antibodies):
-		antibodies = [str(s) for s in np.linspace(0,nbr_of_wells-1,nbr_of_wells)]
-	
+		antibodies = [str(s) for s in np.linspace(0, nbr_of_wells - 1, nbr_of_wells)]
+
 	return np.array([dtype(c) for c in antibodies])
 
+
 def get_experiment_pharmaceutical_agents(experiment, dtype=str):
-	
 	config = get_config(experiment)
 	wells = get_experiment_wells(experiment)
 	nbr_of_wells = len(wells)
-	
-	pharmaceutical_agents = ConfigSectionMap(config,"Labels")["pharmaceutical_agents"].split(",")
+
+	pharmaceutical_agents = ConfigSectionMap(config, "Labels")["pharmaceutical_agents"].split(",")
 	if nbr_of_wells != len(pharmaceutical_agents):
-		pharmaceutical_agents = [str(s) for s in np.linspace(0,nbr_of_wells-1,nbr_of_wells)]
-	
+		pharmaceutical_agents = [str(s) for s in np.linspace(0, nbr_of_wells - 1, nbr_of_wells)]
+
 	return np.array([dtype(c) for c in pharmaceutical_agents])
 
 
 def interpret_wells_and_positions(experiment, well_option, position_option):
-	
 	"""
 	Interpret well and position options for a given experiment.
 
@@ -173,26 +176,26 @@ def interpret_wells_and_positions(experiment, well_option, position_option):
 	>>> experiment = ...  # Some experiment object
 	>>> interpret_wells_and_positions(experiment, '*', '*')
 	(array([0, 1, 2, ..., n-1]), None)
-	
+
 	>>> interpret_wells_and_positions(experiment, 2, '*')
 	([2], None)
-	
+
 	>>> interpret_wells_and_positions(experiment, [1, 3, 5], 2)
 	([1, 3, 5], array([2]))
 
 	"""
-	
+
 	wells = get_experiment_wells(experiment)
 	nbr_of_wells = len(wells)
 
-	if well_option=='*':
+	if well_option == '*':
 		well_indices = np.arange(nbr_of_wells)
 	elif isinstance(well_option, int) or isinstance(well_option, np.int_):
 		well_indices = [int(well_option)]
 	elif isinstance(well_option, list):
 		well_indices = well_option
-		
-	if position_option=='*':
+
+	if position_option == '*':
 		position_indices = None
 	elif isinstance(position_option, int):
 		position_indices = np.array([position_option], dtype=int)
@@ -200,9 +203,9 @@ def interpret_wells_and_positions(experiment, well_option, position_option):
 		position_indices = position_option
 
 	return well_indices, position_indices
-		
+
+
 def extract_well_name_and_number(well):
-	
 	"""
 	Extract the well name and number from a given well path.
 
@@ -238,10 +241,11 @@ def extract_well_name_and_number(well):
 	split_well_path = well.split(os.sep)
 	split_well_path = list(filter(None, split_well_path))
 	well_name = split_well_path[-1]
-	well_number = int(split_well_path[-1].replace('W',''))  
-	
+	well_number = int(split_well_path[-1].replace('W', ''))
+
 	return well_name, well_number
 
+
 def extract_position_name(pos):
 	
 	"""
@@ -275,17 +279,18 @@ def extract_position_name(pos):
 	split_pos_path = pos.split(os.sep)
 	split_pos_path = list(filter(None, split_pos_path))
 	pos_name = split_pos_path[-1]
-	
+
 	return pos_name
 
+
 def get_position_table(pos, population, return_path=False):
 	
 	"""
 	Retrieves the data table for a specified population at a given position, optionally returning the table's file path.
 
-	This function locates and loads a CSV data table associated with a specific population (e.g., 'targets', 'cells') 
-	from a specified position directory. The position directory should contain an 'output/tables' subdirectory where 
-	the CSV file named 'trajectories_{population}.csv' is expected to be found. If the file exists, it is loaded into 
+	This function locates and loads a CSV data table associated with a specific population (e.g., 'targets', 'cells')
+	from a specified position directory. The position directory should contain an 'output/tables' subdirectory where
+	the CSV file named 'trajectories_{population}.csv' is expected to be found. If the file exists, it is loaded into
 	a pandas DataFrame; otherwise, None is returned.
 
 	Parameters
@@ -293,17 +298,17 @@ def get_position_table(pos, population, return_path=False):
 	pos : str
 		The path to the position directory from which to load the data table.
 	population : str
-		The name of the population for which the data table is to be retrieved. This name is used to construct the 
+		The name of the population for which the data table is to be retrieved. This name is used to construct the
 		file name of the CSV file to be loaded.
 	return_path : bool, optional
-		If True, returns a tuple containing the loaded data table (or None) and the path to the CSV file. If False, 
+		If True, returns a tuple containing the loaded data table (or None) and the path to the CSV file. If False,
 		only the loaded data table (or None) is returned (default is False).
 
 	Returns
 	-------
 	pandas.DataFrame or None, or (pandas.DataFrame or None, str)
-		If return_path is False, returns the loaded data table as a pandas DataFrame, or None if the table file does 
-		not exist. If return_path is True, returns a tuple where the first element is the data table (or None) and the 
+		If return_path is False, returns the loaded data table as a pandas DataFrame, or None if the table file does
+		not exist. If return_path is True, returns a tuple where the first element is the data table (or None) and the
 		second element is the path to the CSV file.
 
 	Examples
@@ -313,13 +318,13 @@ def get_position_table(pos, population, return_path=False):
 
 	>>> df_pos, table_path = get_position_table('/path/to/position', 'targets', return_path=True)
 	# This will load the 'trajectories_targets.csv' table and also return the path to the CSV file.
-	
+
 	"""
-	
+
 	if not pos.endswith(os.sep):
-		table = os.sep.join([pos,'output','tables',f'trajectories_{population}.csv'])
+		table = os.sep.join([pos, 'output', 'tables', f'trajectories_{population}.csv'])
 	else:
-		table = pos + os.sep.join(['output','tables',f'trajectories_{population}.csv'])		
+		table = pos + os.sep.join(['output', 'tables', f'trajectories_{population}.csv'])
 
 	if os.path.exists(table):
 		df_pos = pd.read_csv(table, low_memory=False)
@@ -332,13 +337,13 @@ def get_position_table(pos, population, return_path=False):
 		return df_pos
 
 def get_position_pickle(pos, population, return_path=False):
-	
+
 	"""
 	Retrieves the data table for a specified population at a given position, optionally returning the table's file path.
 
-	This function locates and loads a CSV data table associated with a specific population (e.g., 'targets', 'cells') 
-	from a specified position directory. The position directory should contain an 'output/tables' subdirectory where 
-	the CSV file named 'trajectories_{population}.csv' is expected to be found. If the file exists, it is loaded into 
+	This function locates and loads a CSV data table associated with a specific population (e.g., 'targets', 'cells')
+	from a specified position directory. The position directory should contain an 'output/tables' subdirectory where
+	the CSV file named 'trajectories_{population}.csv' is expected to be found. If the file exists, it is loaded into
 	a pandas DataFrame; otherwise, None is returned.
 
 	Parameters
@@ -346,17 +351,17 @@ def get_position_pickle(pos, population, return_path=False):
 	pos : str
 		The path to the position directory from which to load the data table.
 	population : str
-		The name of the population for which the data table is to be retrieved. This name is used to construct the 
+		The name of the population for which the data table is to be retrieved. This name is used to construct the
 		file name of the CSV file to be loaded.
 	return_path : bool, optional
-		If True, returns a tuple containing the loaded data table (or None) and the path to the CSV file. If False, 
+		If True, returns a tuple containing the loaded data table (or None) and the path to the CSV file. If False,
 		only the loaded data table (or None) is returned (default is False).
 
 	Returns
 	-------
 	pandas.DataFrame or None, or (pandas.DataFrame or None, str)
-		If return_path is False, returns the loaded data table as a pandas DataFrame, or None if the table file does 
-		not exist. If return_path is True, returns a tuple where the first element is the data table (or None) and the 
+		If return_path is False, returns the loaded data table as a pandas DataFrame, or None if the table file does
+		not exist. If return_path is True, returns a tuple where the first element is the data table (or None) and the
 		second element is the path to the CSV file.
 
 	Examples
@@ -366,19 +371,19 @@ def get_position_pickle(pos, population, return_path=False):
 
 	>>> df_pos, table_path = get_position_table('/path/to/position', 'targets', return_path=True)
 	# This will load the 'trajectories_targets.csv' table and also return the path to the CSV file.
-	
+
 	"""
-	
+
 	if not pos.endswith(os.sep):
 		table = os.sep.join([pos,'output','tables',f'trajectories_{population}.pkl'])
 	else:
-		table = pos + os.sep.join(['output','tables',f'trajectories_{population}.pkl'])		
+		table = pos + os.sep.join(['output','tables',f'trajectories_{population}.pkl'])
 
 	if os.path.exists(table):
 		df_pos = np.load(table, allow_pickle=True)
 	else:
 		df_pos = None
-	
+
 	if return_path:
 		return df_pos, table
 	else:
@@ -423,29 +428,27 @@ def get_position_movie_path(pos, prefix=''):
 	
 
 	if not pos.endswith(os.sep):
-		pos+=os.sep
-	movies = glob(pos+os.sep.join(['movie',prefix+'*.tif']))
-	if len(movies)>0:
+		pos += os.sep
+	movies = glob(pos + os.sep.join(['movie', prefix + '*.tif']))
+	if len(movies) > 0:
 		stack_path = movies[0]
 	else:
 		stack_path = None
-	
-	return stack_path
-
 
+	return stack_path
 
-def load_experiment_tables(experiment, population='targets', well_option='*',position_option='*', return_pos_info=False):
-	
 
+def load_experiment_tables(experiment, population='targets', well_option='*', position_option='*',
+						   return_pos_info=False, load_pickle=False):
 	"""
-	Loads and aggregates data tables for specified wells and positions within an experiment, 
+	Loads and aggregates data tables for specified wells and positions within an experiment,
 	optionally returning position information alongside the aggregated data table.
 
-	This function collects data from tables associated with specific population types across 
-	various wells and positions within an experiment. It uses the experiment's configuration 
-	to gather metadata such as movie prefix, concentrations, cell types, antibodies, and 
-	pharmaceutical agents. Users can specify which wells and positions to include in the 
-	aggregation through pattern matching, and whether to include detailed position information 
+	This function collects data from tables associated with specific population types across
+	various wells and positions within an experiment. It uses the experiment's configuration
+	to gather metadata such as movie prefix, concentrations, cell types, antibodies, and
+	pharmaceutical agents. Users can specify which wells and positions to include in the
+	aggregation through pattern matching, and whether to include detailed position information
 	in the output.
 
 	Parameters
@@ -459,15 +462,15 @@ def load_experiment_tables(experiment, population='targets', well_option='*',pos
 	position_option : str, optional
 		A pattern to specify which positions to include (default is '*', which includes all positions).
 	return_pos_info : bool, optional
-		If True, returns a tuple where the first element is the aggregated data table and the 
+		If True, returns a tuple where the first element is the aggregated data table and the
 		second element is detailed position information (default is False).
 
 	Returns
 	-------
 	pandas.DataFrame or (pandas.DataFrame, pandas.DataFrame)
-		If return_pos_info is False, returns a pandas DataFrame aggregating the data from the 
-		specified tables. If return_pos_info is True, returns a tuple where the first element 
-		is the aggregated data table and the second element is a DataFrame with detailed position 
+		If return_pos_info is False, returns a pandas DataFrame aggregating the data from the
+		specified tables. If return_pos_info is True, returns a tuple where the first element
+		is the aggregated data table and the second element is a DataFrame with detailed position
 		information.
 
 	Raises
@@ -479,50 +482,49 @@ def load_experiment_tables(experiment, population='targets', well_option='*',pos
 
 	Notes
 	-----
-	- This function assumes that the naming conventions and directory structure of the experiment 
+	- This function assumes that the naming conventions and directory structure of the experiment
 	  follow a specific format, as outlined in the experiment's configuration file.
-	- The function utilizes several helper functions to extract metadata, interpret well and 
-	  position patterns, and load individual position tables. Errors in these helper functions 
+	- The function utilizes several helper functions to extract metadata, interpret well and
+	  position patterns, and load individual position tables. Errors in these helper functions
 	  may propagate up and affect the behavior of this function.
 
 	Examples
 	--------
 	>>> load_experiment_tables('/path/to/experiment', population='targets', well_option='W1', position_option='1-*')
 	# This will load and aggregate tables for the 'targets' population within well 'W1' and positions matching '1-*'.
-	
-	"""
 
+	"""
 
 	config = get_config(experiment)
 	wells = get_experiment_wells(experiment)
 
-	movie_prefix = ConfigSectionMap(config,"MovieSettings")["movie_prefix"]
+	movie_prefix = ConfigSectionMap(config, "MovieSettings")["movie_prefix"]
 	concentrations = get_experiment_concentrations(experiment, dtype=float)
 	cell_types = get_experiment_cell_types(experiment)
 	antibodies = get_experiment_antibodies(experiment)
 	pharmaceutical_agents = get_experiment_pharmaceutical_agents(experiment)
-	well_labels = _extract_labels_from_config(config,len(wells))
-	
+	well_labels = _extract_labels_from_config(config, len(wells))
+
 	well_indices, position_indices = interpret_wells_and_positions(experiment, well_option, position_option)
 
 	df = []
 	df_pos_info = []
 	real_well_index = 0
-	
+
 	for k, well_path in enumerate(tqdm(wells[well_indices])):
-		
-		any_table = False # assume no table
-		
+
+		any_table = False  # assume no table
+
 		well_name, well_number = extract_well_name_and_number(well_path)
 		widx = well_indices[k]
 
 		well_alias = well_labels[widx]
-		
+
 		well_concentration = concentrations[widx]
 		well_antibody = antibodies[widx]
 		well_cell_type = cell_types[widx]
 		well_pharmaceutical_agent = pharmaceutical_agents[widx]
-		
+
 		positions = get_positions_in_well(well_path)
 		if position_indices is not None:
 			try:
@@ -532,13 +534,17 @@ def load_experiment_tables(experiment, population='targets', well_option='*',pos
 				continue
 
 		real_pos_index = 0
-		for pidx,pos_path in enumerate(positions):
-			
+		for pidx, pos_path in enumerate(positions):
+
 			pos_name = extract_position_name(pos_path)
-			
+
 			stack_path = get_position_movie_path(pos_path, prefix=movie_prefix)
-			
-			df_pos,table = get_position_table(pos_path, population=population, return_path=True)
+
+			if not load_pickle:
+				df_pos, table = get_position_table(pos_path, population=population, return_path=True)
+			else:
+				df_pos, table = get_position_pickle(pos_path, population=population, return_path=True)
+
 			if df_pos is not None:
 			
 				df_pos['position'] = pos_path
@@ -551,25 +557,28 @@ def load_experiment_tables(experiment, population='targets', well_option='*',pos
 				df_pos['antibody'] = well_antibody
 				df_pos['cell_type'] = well_cell_type
 				df_pos['pharmaceutical_agent'] = well_pharmaceutical_agent
-				
+
 				df.append(df_pos)
 				any_table = True
-				
-				df_pos_info.append({'pos_path': pos_path, 'pos_index': real_pos_index, 'pos_name': pos_name, 'table_path': table, 'stack_path': stack_path,
-									'well_path': well_path, 'well_index': real_well_index, 'well_name': well_name, 'well_number': well_number, 'well_alias': well_alias})
-				
-				real_pos_index+=1
-		
+
+				df_pos_info.append(
+					{'pos_path': pos_path, 'pos_index': real_pos_index, 'pos_name': pos_name, 'table_path': table,
+					 'stack_path': stack_path,
+					 'well_path': well_path, 'well_index': real_well_index, 'well_name': well_name,
+					 'well_number': well_number, 'well_alias': well_alias})
+
+				real_pos_index += 1
+
 		if any_table:
 			real_well_index += 1
-	
+
 	df_pos_info = pd.DataFrame(df_pos_info)
-	if len(df)>0:
+	if len(df) > 0:
 		df = pd.concat(df)
 		df = df.reset_index(drop=True)
 	else:
 		df = None
-		
+
 	if return_pos_info:
 		return df, df_pos_info
 	else:
@@ -615,15 +624,15 @@ def locate_stack(position, prefix='Aligned'):
 	"""
 
 	if not position.endswith(os.sep):
-		position+=os.sep
+		position += os.sep
 
-	stack_path = glob(position+os.sep.join(['movie', f'{prefix}*.tif']))
-	assert len(stack_path)>0,f"No movie with prefix {prefix} found..."
-	stack = imread(stack_path[0].replace('\\','/'))
-	if stack.ndim==4:
+	stack_path = glob(position + os.sep.join(['movie', f'{prefix}*.tif']))
+	assert len(stack_path) > 0, f"No movie with prefix {prefix} found..."
+	stack = imread(stack_path[0].replace('\\', '/'), is_mmstack=False)
+	if stack.ndim == 4:
 		stack = np.moveaxis(stack, 1, -1)
-	elif stack.ndim==3:
-		stack = stack[:,:,:,np.newaxis]
+	elif stack.ndim == 3:
+		stack = stack[:, :, :, np.newaxis]
 
 	return stack
 
@@ -638,7 +647,7 @@ def locate_labels(position, population='target'):
 	position : str
 		The position folder within the well where the stack is located.
 	population : str, optional
-		The population for which to locate the labels. 
+		The population for which to locate the labels.
 		Valid options are 'target' and 'effector'.
 		The default is 'target'.
 
@@ -662,13 +671,13 @@ def locate_labels(position, population='target'):
 	"""
 
 	if not position.endswith(os.sep):
-		position+=os.sep
-	
-	if population.lower()=="target" or population.lower()=="targets":
-		label_path = natsorted(glob(position+os.sep.join(["labels_targets", "*.tif"])))
-	elif population.lower()=="effector" or population.lower()=="effectors":
-		label_path = natsorted(glob(position+os.sep.join(["labels_effectors", "*.tif"])))
-	labels = np.array([imread(i.replace('\\','/')) for i in label_path])
+		position += os.sep
+
+	if population.lower() == "target" or population.lower() == "targets":
+		label_path = natsorted(glob(position + os.sep.join(["labels_targets", "*.tif"])))
+	elif population.lower() == "effector" or population.lower() == "effectors":
+		label_path = natsorted(glob(position + os.sep.join(["labels_effectors", "*.tif"])))
+	labels = np.array([imread(i.replace('\\', '/')) for i in label_path])
 
 	return labels
 
@@ -711,20 +720,20 @@ def locate_stack_and_labels(position, prefix='Aligned', population="target"):
 	--------
 	>>> stack, labels = locate_stack_and_labels(position, prefix='Aligned', population="target")
 	# Locate and load the stack and segmentation labels for further processing.
-	
+
 	"""
 
-	position = position.replace('\\','/')
+	position = position.replace('\\', '/')
 	labels = locate_labels(position, population=population)
 	stack = locate_stack(position, prefix=prefix)
-	assert len(stack)==len(labels),f"The shape of the stack {stack.shape} does not match with the shape of the labels {labels.shape}"
+	assert len(stack) == len(
+		labels), f"The shape of the stack {stack.shape} does not match with the shape of the labels {labels.shape}"
 
-	return stack,labels
+	return stack, labels
 
 def load_tracking_data(position, prefix="Aligned", population="target"):
-
 	"""
-	
+
 	Load the tracking data, labels, and stack for a given position and population.
 
 	Parameters
@@ -759,15 +768,15 @@ def load_tracking_data(position, prefix="Aligned", population="target"):
 
 	"""
 
-	position = position.replace('\\','/')
-	if population.lower()=="target" or population.lower()=="targets":
-		trajectories = pd.read_csv(position+os.sep.join(['output', 'tables', 'trajectories_targets.csv']))
-	elif population.lower()=="effector" or population.lower()=="effectors":
-		trajectories = pd.read_csv(position+os.sep.join(['output', 'tables', 'trajectories_effectors.csv']))
+	position = position.replace('\\', '/')
+	if population.lower() == "target" or population.lower() == "targets":
+		trajectories = pd.read_csv(position + os.sep.join(['output', 'tables', 'trajectories_targets.csv']))
+	elif population.lower() == "effector" or population.lower() == "effectors":
+		trajectories = pd.read_csv(position + os.sep.join(['output', 'tables', 'trajectories_effectors.csv']))
 
-	stack,labels = locate_stack_and_labels(position, prefix=prefix, population=population)
+	stack, labels = locate_stack_and_labels(position, prefix=prefix, population=population)
 
-	return trajectories,labels,stack
+	return trajectories, labels, stack
 
 
 def auto_load_number_of_frames(stack_path):
@@ -798,11 +807,11 @@ def auto_load_number_of_frames(stack_path):
 	--------
 	>>> len_movie = auto_load_number_of_frames(stack_path)
 	# Automatically estimate the number of frames in the stack.
-	
+
 	"""
 
 	# Try to estimate automatically # frames
-	
+
 	if stack_path is None:
 		return None
 
@@ -821,7 +830,7 @@ def auto_load_number_of_frames(stack_path):
 		try:
 			# Try nframes
 			nslices = int(attr[np.argmax([s.startswith("frames") for s in attr])].split("=")[-1])
-			if nslices>1:
+			if nslices > 1:
 				len_movie = nslices
 				print(f"Auto-detected movie length movie: {len_movie}")
 			else:
@@ -841,27 +850,35 @@ def auto_load_number_of_frames(stack_path):
 		del img_desc;
 	except:
 		pass
+
+	if 'len_movie' not in locals():
+		stack = imread(stack_path)
+		len_movie = len(stack)
+		del stack
 	gc.collect()
 
+	print(f'Automatically detected stack length: {len_movie}...')
+
 	return len_movie if 'len_movie' in locals() else None
 
+
 def parse_isotropic_radii(string):
 	sections = re.split(',| ', string)
 	radii = []
-	for k,s in enumerate(sections):
+	for k, s in enumerate(sections):
 		if s.isdigit():
 			radii.append(int(s))
 		if '[' in s:
-			ring = [int(s.replace('[','')), int(sections[k+1].replace(']',''))]
+			ring = [int(s.replace('[', '')), int(sections[k + 1].replace(']', ''))]
 			radii.append(ring)
 		else:
 			pass
 	return radii
 
-def get_tracking_configs_list(return_path=False):
 
+def get_tracking_configs_list(return_path=False):
 	"""
-	
+
 	Retrieve a list of available tracking configurations.
 
 	Parameters
@@ -892,26 +909,30 @@ def get_tracking_configs_list(return_path=False):
 
 	"""
 
-	modelpath = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0],"celldetective", "models", "tracking_configs", os.sep])
-	available_models = glob(modelpath+'*.json')
-	available_models = [m.replace('\\','/').split('/')[-1] for m in available_models]
-	available_models = [m.replace('\\','/').split('.')[0] for m in available_models]
-
+	modelpath = os.sep.join(
+		[os.path.split(os.path.dirname(os.path.realpath(__file__)))[0], "celldetective", "models", "tracking_configs",
+		 os.sep])
+	available_models = glob(modelpath + '*.json')
+	available_models = [m.replace('\\', '/').split('/')[-1] for m in available_models]
+	available_models = [m.replace('\\', '/').split('.')[0] for m in available_models]
 
 	if not return_path:
 		return available_models
 	else:
 		return available_models, modelpath
 
+
 def interpret_tracking_configuration(config):
 	
 	if isinstance(config, str):
 		if os.path.exists(config):
 			return config
 		else:
-			modelpath = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0],"celldetective", "models", "tracking_configs", os.sep])
-			if os.path.exists(modelpath+config+'.json'):
-				return modelpath+config+'.json'
+			modelpath = os.sep.join(
+				[os.path.split(os.path.dirname(os.path.realpath(__file__)))[0], "celldetective", "models",
+				 "tracking_configs", os.sep])
+			if os.path.exists(modelpath + config + '.json'):
+				return modelpath + config + '.json'
 			else:
 				config = cell_config()
 	elif config is None:
@@ -919,10 +940,11 @@ def interpret_tracking_configuration(config):
 
 	return config
 
+
 def get_signal_models_list(return_path=False):
 
 	"""
-	
+
 	Retrieve a list of available signal detection models.
 
 	Parameters
@@ -953,11 +975,13 @@ def get_signal_models_list(return_path=False):
 
 	"""
 
-	modelpath = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0],"celldetective", "models", "signal_detection", os.sep])
-	repository_models = get_zenodo_files(cat=os.sep.join(["models","signal_detection"]))
+	modelpath = os.sep.join(
+		[os.path.split(os.path.dirname(os.path.realpath(__file__)))[0], "celldetective", "models", "signal_detection",
+		 os.sep])
+	repository_models = get_zenodo_files(cat=os.sep.join(["models", "signal_detection"]))
 
-	available_models = glob(modelpath+f'*{os.sep}')
-	available_models = [m.replace('\\','/').split('/')[-2] for m in available_models]
+	available_models = glob(modelpath + f'*{os.sep}')
+	available_models = [m.replace('\\', '/').split('/')[-2] for m in available_models]
 	for rm in repository_models:
 		if rm not in available_models:
 			available_models.append(rm)
@@ -967,21 +991,72 @@ def get_signal_models_list(return_path=False):
 	else:
 		return available_models, modelpath
 
+def get_pair_signal_models_list(return_path=False):
+	"""
 
-def locate_signal_model(name, path=None):
-	
-	main_dir = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0],"celldetective"])
+	Retrieve a list of available signal detection models.
+
+	Parameters
+	----------
+	return_path : bool, optional
+		If True, also returns the path to the models. Default is False.
+
+	Returns
+	-------
+	list or tuple
+		If return_path is False, returns a list of available signal detection models.
+		If return_path is True, returns a tuple containing the list of models and the path to the models.
+
+	Notes
+	-----
+	This function retrieves the list of available signal detection models by searching for model directories
+	in the predefined model path. The model path is derived from the parent directory of the current script
+	location and the path to the model directory. By default, it returns only the names of the models.
+	If return_path is set to True, it also returns the path to the models.
+
+	Examples
+	--------
+	>>> models = get_signal_models_list()
+	# Retrieve a list of available signal detection models.
+
+	>>> models, path = get_signal_models_list(return_path=True)
+	# Retrieve a list of available signal detection models and the path to the models.
+
+	"""
+
+	modelpath = os.sep.join(
+		[os.path.split(os.path.dirname(os.path.realpath(__file__)))[0], "celldetective", "models", "pair_signal_detection",
+		 os.sep])
+	#repository_models = get_zenodo_files(cat=os.sep.join(["models", "pair_signal_detection"]))
+
+	available_models = glob(modelpath + f'*{os.sep}')
+	available_models = [m.replace('\\', '/').split('/')[-2] for m in available_models]
+	#for rm in repository_models:
+	#	if rm not in available_models:
+	#		available_models.append(rm)
+
+	if not return_path:
+		return available_models
+	else:
+		return available_models, modelpath
+
+
+def locate_signal_model(name, path=None, pairs=False):
+
+	main_dir = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0], "celldetective"])
 	modelpath = os.sep.join([main_dir, "models", "signal_detection", os.sep])
+	if pairs:
+		modelpath = os.sep.join([main_dir, "models", "pair_signal_detection", os.sep])
 	print(f'Looking for {name} in {modelpath}')
-	models = glob(modelpath+f'*{os.sep}')
+	models = glob(modelpath + f'*{os.sep}')
 	if path is not None:
 		if not path.endswith(os.sep):
 			path += os.sep
-		models += glob(path+f'*{os.sep}')
+		models += glob(path + f'*{os.sep}')
 
-	match=None
+	match = None
 	for m in models:
-		if name==m.replace('\\',os.sep).split(os.sep)[-2]:
+		if name == m.replace('\\', os.sep).split(os.sep)[-2]:
 			match = m
 			return match
 	# else no match, try zenodo
@@ -990,9 +1065,18 @@ def locate_signal_model(name, path=None):
 		index = files.index(name)
 		cat = categories[index]
 		download_zenodo_file(name, os.sep.join([main_dir, cat]))
-		match = os.sep.join([main_dir, cat, name])+os.sep
+		match = os.sep.join([main_dir, cat, name]) + os.sep
 	return match
 
+def locate_pair_signal_model(name, path=None):
+	main_dir = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0], "celldetective"])
+	modelpath = os.sep.join([main_dir, "models", "pair_signal_detection", os.sep])
+	print(f'Looking for {name} in {modelpath}')
+	models = glob(modelpath + f'*{os.sep}')
+	if path is not None:
+		if not path.endswith(os.sep):
+			path += os.sep
+		models += glob(path + f'*{os.sep}')
 
 def relabel_segmentation(labels, data, properties, column_labels={'track': "track", 'frame': 'frame', 'y': 'y', 'x': 'x', 'label': 'class_id'}, threads=1):
 
@@ -1034,7 +1118,11 @@ def relabel_segmentation(labels, data, properties, column_labels={'track': "trac
 
 
 	n_threads = threads
-	df = pd.DataFrame(data,columns=[column_labels['track'],column_labels['frame'],column_labels['y'],column_labels['x']])
+	if data.shape[1]==4:
+		df = pd.DataFrame(data,columns=[column_labels['track'],column_labels['frame'],column_labels['y'],column_labels['x']])
+	else:
+		df = pd.DataFrame(data,columns=[column_labels['track'],column_labels['frame'],'z', column_labels['y'],column_labels['x']])
+		df = df.drop(columns=['z'])
 	df = df.merge(pd.DataFrame(properties),left_index=True, right_index=True)
 	df = df.sort_values(by=[column_labels['track'],column_labels['frame']])
 
@@ -1044,15 +1132,15 @@ def relabel_segmentation(labels, data, properties, column_labels={'track': "trac
 
 		for t in tqdm(indices):
 			f = int(t)
-			tracks_at_t = df.loc[df[column_labels['frame']]==f, column_labels['track']].to_numpy()
-			identities = df.loc[df[column_labels['frame']]==f, column_labels['label']].to_numpy()
+			tracks_at_t = df.loc[df[column_labels['frame']] == f, column_labels['track']].to_numpy()
+			identities = df.loc[df[column_labels['frame']] == f, column_labels['label']].to_numpy()
 
-			tracks_at_t = tracks_at_t[identities==identities]
-			identities = identities[identities==identities]
+			tracks_at_t = tracks_at_t[identities == identities]
+			identities = identities[identities == identities]
 
 			for k in range(len(identities)):
-				loc_i,loc_j = np.where(labels[f]==identities[k])
-				new_labels[f,loc_i,loc_j] = int(tracks_at_t[k])
+				loc_i, loc_j = np.where(labels[f] == identities[k])
+				new_labels[f, loc_i, loc_j] = int(tracks_at_t[k])
 
 	# Multithreading
 	indices = list(df[column_labels['frame']].unique())
@@ -1152,11 +1240,13 @@ def control_tracking_btrack(position, prefix="Aligned", population="target", rel
 
 	"""
 
-	data,properties,graph,labels,stack = load_napari_data(position, prefix=prefix, population=population)
-	view_on_napari_btrack(data,properties,graph,labels=labels, stack=stack, relabel=relabel, flush_memory=flush_memory, threads=threads)
+	data, properties, graph, labels, stack = load_napari_data(position, prefix=prefix, population=population)
+	view_on_napari_btrack(data, properties, graph, labels=labels, stack=stack, relabel=relabel,
+						  flush_memory=flush_memory, threads=threads)
 
-def view_on_napari_btrack(data,properties,graph,stack=None,labels=None,relabel=True, flush_memory=True, position=None, threads=1):
-	
+
+def view_on_napari_btrack(data, properties, graph, stack=None, labels=None, relabel=True, flush_memory=True,
+						  position=None, threads=1):
 	"""
 
 	Visualize btrack data, including stack, labels, points, and tracks, using the napari viewer.
@@ -1189,20 +1279,28 @@ def view_on_napari_btrack(data,properties,graph,stack=None,labels=None,relabel=T
 
 	"""
 
-	if (labels is not None)*relabel:
+	if (labels is not None) * relabel:
 		print('Relabeling the cell masks with the track ID.')
 		labels = relabel_segmentation(labels, data, properties, threads=threads)
 
-	vertices = data[:, 1:]
+	if data.shape[1]==4:
+		vertices = data[:, 1:]
+	else:
+		vertices = data[:, 2:]
 	viewer = napari.Viewer()
 	if stack is not None:
-		viewer.add_image(stack,channel_axis=-1,colormap=["gray"]*stack.shape[-1])
+		print(f'{stack.shape=}')
+		viewer.add_image(stack, channel_axis=-1, colormap=["gray"] * stack.shape[-1])
 	if labels is not None:
-		viewer.add_labels(labels, name='segmentation',opacity=0.4)
+		viewer.add_labels(labels, name='segmentation', opacity=0.4)
 	viewer.add_points(vertices, size=4, name='points', opacity=0.3)
-	viewer.add_tracks(data, properties=properties, graph=graph, name='tracks')
+	if data.shape[1]==4:
+		viewer.add_tracks(data, properties=properties, graph=graph, name='tracks')
+	else:
+		print(data)
+		viewer.add_tracks(data[:,[0,1,3,4]], properties=properties, graph=graph, name='tracks')		
 	viewer.show(block=True)
-	
+
 	if flush_memory:
 		# temporary fix for slight napari memory leak
 		for i in range(10000):
@@ -1216,8 +1314,8 @@ def view_on_napari_btrack(data,properties,graph,stack=None,labels=None,relabel=T
 		del labels
 		gc.collect()
 
-def load_napari_data(position, prefix="Aligned", population="target", return_stack=True):
 
+def load_napari_data(position, prefix="Aligned", population="target", return_stack=True):
 	"""
 	Load the necessary data for visualization in napari.
 
@@ -1239,7 +1337,7 @@ def load_napari_data(position, prefix="Aligned", population="target", return_sta
 	--------
 	>>> data, properties, graph, labels, stack = load_napari_data("path/to/position")
 	# Load the necessary data for visualization of target trajectories.
-	
+
 	"""
 	position = position.replace('\\','/')
 	if population.lower()=="target" or population.lower()=="targets":
@@ -1261,14 +1359,16 @@ def load_napari_data(position, prefix="Aligned", population="target", return_sta
 		properties = None
 		graph = None
 	if return_stack:
-		stack,labels = locate_stack_and_labels(position, prefix=prefix, population=population)
+		stack, labels = locate_stack_and_labels(position, prefix=prefix, population=population)
 	else:
-		labels=locate_labels(position,population=population)
+		labels = locate_labels(position, population=population)
 		stack = None
-	return data,properties,graph,labels,stack
+	return data, properties, graph, labels, stack
+
 
 from skimage.measure import label
 
+
 def auto_correct_masks(masks):
 
 	"""
@@ -1300,25 +1400,25 @@ def auto_correct_masks(masks):
 
 	"""
 
-	props = pd.DataFrame(regionprops_table(masks,properties=('label','area','area_bbox')))
+	props = pd.DataFrame(regionprops_table(masks, properties=('label', 'area', 'area_bbox')))
 	max_lbl = props['label'].max()
 	corrected_lbl = masks.copy().astype(int)
 
 	for cell in props['label'].unique():
 
-		bbox_area = props.loc[props['label']==cell, 'area_bbox'].values
-		area = props.loc[props['label']==cell, 'area'].values
+		bbox_area = props.loc[props['label'] == cell, 'area_bbox'].values
+		area = props.loc[props['label'] == cell, 'area'].values
 
-		if bbox_area > 1.75*area: #condition for anomaly
+		if bbox_area > 1.75 * area:  # condition for anomaly
 
-			lbl = masks==cell
+			lbl = masks == cell
 			lbl = lbl.astype(int)
 
-			relabelled = label(lbl,connectivity=2)
+			relabelled = label(lbl, connectivity=2)
 			relabelled += max_lbl
-			relabelled[np.where(lbl==0)] = 0
+			relabelled[np.where(lbl == 0)] = 0
 
-			corrected_lbl[np.where(relabelled != 0)] = relabelled[np.where(relabelled!=0)]
+			corrected_lbl[np.where(relabelled != 0)] = relabelled[np.where(relabelled != 0)]
 
 		max_lbl = np.amax(corrected_lbl)
 
@@ -1329,7 +1429,7 @@ def auto_correct_masks(masks):
 def control_segmentation_napari(position, prefix='Aligned', population="target", flush_memory=False):
 
 	"""
-	
+
 	Control the visualization of segmentation labels using the napari viewer.
 
 	Parameters
@@ -1355,22 +1455,22 @@ def control_segmentation_napari(position, prefix='Aligned', population="target",
 
 	def export_labels():
 		labels_layer = viewer.layers['segmentation'].data
-		for t,im in enumerate(tqdm(labels_layer)):
-			
+		for t, im in enumerate(tqdm(labels_layer)):
+
 			try:
 				im = auto_correct_masks(im)
 			except Exception as e:
 				print(e)
 
-			save_tiff_imagej_compatible(output_folder+f"{str(t).zfill(4)}.tif", im.astype(np.int16), axes='YX')
+			save_tiff_imagej_compatible(output_folder + f"{str(t).zfill(4)}.tif", im.astype(np.int16), axes='YX')
 		print("The labels have been successfully rewritten.")
 
 	def export_annotation():
-		
+
 		# Locate experiment config
 		parent1 = Path(position).parent
 		expfolder = parent1.parent
-		config = PurePath(expfolder,Path("config.ini"))
+		config = PurePath(expfolder, Path("config.ini"))
 		expfolder = str(expfolder)
 		exp_name = os.path.split(expfolder)[-1]
 		print(exp_name)
@@ -1392,7 +1492,7 @@ def control_segmentation_napari(position, prefix='Aligned', population="target",
 
 		print('exporting!')
 		t = viewer.dims.current_step[0]
-		labels_layer = viewer.layers['segmentation'].data[t] # at current time
+		labels_layer = viewer.layers['segmentation'].data[t]  # at current time
 
 		try:
 			labels_layer = auto_correct_masks(labels_layer)
@@ -1400,37 +1500,37 @@ def control_segmentation_napari(position, prefix='Aligned', population="target",
 			print(e)
 
 		fov_export = True
-		
+
 		if "Shapes" in viewer.layers:
 			squares = viewer.layers['Shapes'].data
-			test_in_frame = np.array([squares[i][0,0]==t and len(squares[i])==4 for i in range(len(squares))])
+			test_in_frame = np.array([squares[i][0, 0] == t and len(squares[i]) == 4 for i in range(len(squares))])
 			squares = np.array(squares)
 			squares = squares[test_in_frame]
 			nbr_squares = len(squares)
 			print(f"Found {nbr_squares} ROIS")
-			if nbr_squares>0:
+			if nbr_squares > 0:
 				# deactivate field of view mode
 				fov_export = False
 
-			for k,sq in enumerate(squares):
+			for k, sq in enumerate(squares):
 				print(f"ROI: {sq}")
-				xmin = int(sq[0,1])
-				xmax = int(sq[2,1])
-				if xmax<xmin:
-					xmax,xmin = xmin,xmax
-				ymin = int(sq[0,2])
-				ymax = int(sq[1,2])
-				if ymax<ymin:
-					ymax,ymin = ymin,ymax
+				xmin = int(sq[0, 1])
+				xmax = int(sq[2, 1])
+				if xmax < xmin:
+					xmax, xmin = xmin, xmax
+				ymin = int(sq[0, 2])
+				ymax = int(sq[1, 2])
+				if ymax < ymin:
+					ymax, ymin = ymin, ymax
 				print(f"{xmin=};{xmax=};{ymin=};{ymax=}")
-				frame = viewer.layers['Image'].data[t][xmin:xmax,ymin:ymax]
+				frame = viewer.layers['Image'].data[t][xmin:xmax, ymin:ymax]
 				if frame.shape[1] < 256 or frame.shape[0] < 256:
 					print("crop too small!")
 					continue
 				multichannel = [frame]
-				for i in range(len(channel_indices)-1):
+				for i in range(len(channel_indices) - 1):
 					try:
-						frame = viewer.layers[f'Image [{i+1}]'].data[t][xmin:xmax,ymin:ymax]
+						frame = viewer.layers[f'Image [{i + 1}]'].data[t][xmin:xmax, ymin:ymax]
 						multichannel.append(frame)
 					except:
 						pass
@@ -1441,13 +1541,13 @@ def control_segmentation_napari(position, prefix='Aligned', population="target",
 				info_name = annotation_folder + f"{exp_name}_{position.split(os.sep)[-2]}_{str(t).zfill(4)}_roi_{xmin}_{xmax}_{ymin}_{ymax}.json"
 				with open(info_name, 'w') as f:
 					json.dump(info, f, indent=4)
-		
+
 		if fov_export:
 			frame = viewer.layers['Image'].data[t]
 			multichannel = [frame]
-			for i in range(len(channel_indices)-1):
+			for i in range(len(channel_indices) - 1):
 				try:
-					frame = viewer.layers[f'Image [{i+1}]'].data[t]
+					frame = viewer.layers[f'Image [{i + 1}]'].data[t]
 					multichannel.append(frame)
 				except:
 					pass
@@ -1468,15 +1568,15 @@ def control_segmentation_napari(position, prefix='Aligned', population="target",
 	def export_widget():
 		return export_annotation()
 
-	stack,labels = locate_stack_and_labels(position, prefix=prefix, population=population)
+	stack, labels = locate_stack_and_labels(position, prefix=prefix, population=population)
 
 	if not population.endswith('s'):
-		population+='s'
-	output_folder = position+f'labels_{population}{os.sep}'
+		population += 's'
+	output_folder = position + f'labels_{population}{os.sep}'
 
 	viewer = napari.Viewer()
-	viewer.add_image(stack,channel_axis=-1,colormap=["gray"]*stack.shape[-1])
-	viewer.add_labels(labels.astype(int), name='segmentation',opacity=0.4)
+	viewer.add_image(stack, channel_axis=-1, colormap=["gray"] * stack.shape[-1])
+	viewer.add_labels(labels.astype(int), name='segmentation', opacity=0.4)
 	viewer.window.add_dock_widget(save_widget, area='right')
 	viewer.window.add_dock_widget(export_widget, area='right')
 	viewer.show(block=True)
@@ -1499,7 +1599,7 @@ def correct_annotation(filename):
 	"""
 	New function to reannotate an annotation image in post, using napari and save update inplace.
 	"""
-	
+
 	def export_labels():
 		labels_layer = viewer.layers['segmentation'].data
 		for t,im in enumerate(tqdm(labels_layer)):
@@ -1515,26 +1615,26 @@ def correct_annotation(filename):
 	@magicgui(call_button='Save the modified labels')
 	def save_widget():
 		return export_labels()
-	
-	img = imread(filename.replace('\\','/'))
+
+	img = imread(filename.replace('\\','/'),is_mmstack=False)
 	if img.ndim==3:
 		img = np.moveaxis(img, 0, -1)
 	elif img.ndim==2:
 		img = img[:,:,np.newaxis]
-		
+
 	existing_lbl = filename.replace('.tif','_labelled.tif')
 	if os.path.exists(existing_lbl):
 		labels = imread(existing_lbl)[np.newaxis,:,:].astype(int)
 	else:
 		labels = np.zeros_like(img[:,:,0]).astype(int)[np.newaxis,:,:]
-		
+
 	stack = img[np.newaxis,:,:,:]
-	
+
 	viewer = napari.Viewer()
 	viewer.add_image(stack,channel_axis=-1,colormap=["gray"]*stack.shape[-1])
 	viewer.add_labels(labels, name='segmentation',opacity=0.4)
 	viewer.window.add_dock_widget(save_widget, area='right')
-	viewer.show(block=True)    
+	viewer.show(block=True)
 
 	# temporary fix for slight napari memory leak
 	for i in range(100):
@@ -1582,23 +1682,24 @@ def _view_on_napari(tracks=None, stack=None, labels=None):
 	>>> labels = np.random.randint(0, 2, (100, 100))
 	>>> view_on_napari(tracks, stack=stack, labels=labels)
 	# Visualize tracks, stack, and labels using Napari.
-	
+
 	"""
 
 	viewer = napari.Viewer()
 	if stack is not None:
-		viewer.add_image(stack,channel_axis=-1,colormap=["gray"]*stack.shape[-1])
+		viewer.add_image(stack, channel_axis=-1, colormap=["gray"] * stack.shape[-1])
 	if labels is not None:
-		viewer.add_labels(labels, name='segmentation',opacity=0.4)
+		viewer.add_labels(labels, name='segmentation', opacity=0.4)
 	if tracks is not None:
 		viewer.add_tracks(tracks, name='tracks')
 	viewer.show(block=True)
 
-def control_tracking_table(position, calibration=1, prefix="Aligned", population="target",
-	column_labels={'track': "TRACK_ID", 'frame': 'FRAME', 'y': 'POSITION_Y', 'x': 'POSITION_X', 'label': 'class_id'}):
 
+def control_tracking_table(position, calibration=1, prefix="Aligned", population="target",
+						   column_labels={'track': "TRACK_ID", 'frame': 'FRAME', 'y': 'POSITION_Y', 'x': 'POSITION_X',
+										  'label': 'class_id'}):
 	"""
-	
+
 	Control the tracking table and visualize tracks using Napari.
 
 	Parameters
@@ -1633,27 +1734,33 @@ def control_tracking_table(position, calibration=1, prefix="Aligned", population
 
 	"""
 
-	position = position.replace('\\','/')
-	tracks,labels,stack = load_tracking_data(position, prefix=prefix, population=population)
-	tracks = tracks.loc[:, [column_labels['track'], column_labels['frame'], column_labels['y'], column_labels['x']]].to_numpy()
-	tracks[:,-2:] /= calibration
-	_view_on_napari(tracks,labels=labels, stack=stack)
+	position = position.replace('\\', '/')
+	tracks, labels, stack = load_tracking_data(position, prefix=prefix, population=population)
+	tracks = tracks.loc[:,
+			 [column_labels['track'], column_labels['frame'], column_labels['y'], column_labels['x']]].to_numpy()
+	tracks[:, -2:] /= calibration
+	_view_on_napari(tracks, labels=labels, stack=stack)
 
 
 def get_segmentation_models_list(mode='targets', return_path=False):
-	
-	if mode=='targets':
-		modelpath = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0],"celldetective", "models", "segmentation_targets", os.sep])
-		repository_models = get_zenodo_files(cat=os.sep.join(["models","segmentation_targets"]))
-	elif mode=='effectors':
-		modelpath = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0],"celldetective", "models", "segmentation_effectors", os.sep])
-		repository_models = get_zenodo_files(cat=os.sep.join(["models","segmentation_effectors"]))	
-	elif mode=='generic':
-		modelpath = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0],"celldetective", "models", "segmentation_generic", os.sep])		
-		repository_models = get_zenodo_files(cat=os.sep.join(["models","segmentation_generic"]))
-
-	available_models = natsorted(glob(modelpath+'*/'))
-	available_models = [m.replace('\\','/').split('/')[-2] for m in available_models]
+	if mode == 'targets':
+		modelpath = os.sep.join(
+			[os.path.split(os.path.dirname(os.path.realpath(__file__)))[0], "celldetective", "models",
+			 "segmentation_targets", os.sep])
+		repository_models = get_zenodo_files(cat=os.sep.join(["models", "segmentation_targets"]))
+	elif mode == 'effectors':
+		modelpath = os.sep.join(
+			[os.path.split(os.path.dirname(os.path.realpath(__file__)))[0], "celldetective", "models",
+			 "segmentation_effectors", os.sep])
+		repository_models = get_zenodo_files(cat=os.sep.join(["models", "segmentation_effectors"]))
+	elif mode == 'generic':
+		modelpath = os.sep.join(
+			[os.path.split(os.path.dirname(os.path.realpath(__file__)))[0], "celldetective", "models",
+			 "segmentation_generic", os.sep])
+		repository_models = get_zenodo_files(cat=os.sep.join(["models", "segmentation_generic"]))
+
+	available_models = natsorted(glob(modelpath + '*/'))
+	available_models = [m.replace('\\', '/').split('/')[-2] for m in available_models]
 	for rm in repository_models:
 		if rm not in available_models:
 			available_models.append(rm)
@@ -1663,16 +1770,17 @@ def get_segmentation_models_list(mode='targets', return_path=False):
 	else:
 		return available_models, modelpath
 
+
 def locate_segmentation_model(name):
 	
 	"""
-	Locates a specified segmentation model within the local 'celldetective' directory or 
+	Locates a specified segmentation model within the local 'celldetective' directory or
 	downloads it from Zenodo if not found locally.
 
-	This function attempts to find a segmentation model by name within a predefined directory 
-	structure starting from the 'celldetective/models/segmentation*' path. If the model is not 
-	found locally, it then tries to locate and download the model from Zenodo, placing it into 
-	the appropriate category directory within 'celldetective'. The function prints the search 
+	This function attempts to find a segmentation model by name within a predefined directory
+	structure starting from the 'celldetective/models/segmentation*' path. If the model is not
+	found locally, it then tries to locate and download the model from Zenodo, placing it into
+	the appropriate category directory within 'celldetective'. The function prints the search
 	directory path and returns the path to the found or downloaded model.
 
 	Parameters
@@ -1683,7 +1791,7 @@ def locate_segmentation_model(name):
 	Returns
 	-------
 	str or None
-		The full path to the located or downloaded segmentation model directory, or None if the 
+		The full path to the located or downloaded segmentation model directory, or None if the
 		model could not be found or downloaded.
 
 	Raises
@@ -1696,11 +1804,11 @@ def locate_segmentation_model(name):
 	main_dir = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0],"celldetective"])
 	modelpath = os.sep.join([main_dir, "models", "segmentation*"]) + os.sep
 	print(f'Looking for {name} in {modelpath}')
-	models = glob(modelpath+f'*{os.sep}')
+	models = glob(modelpath + f'*{os.sep}')
 
-	match=None
+	match = None
 	for m in models:
-		if name==m.replace('\\',os.sep).split(os.sep)[-2]:
+		if name == m.replace('\\', os.sep).split(os.sep)[-2]:
 			match = m
 			return match
 	# else no match, try zenodo
@@ -1709,42 +1817,42 @@ def locate_segmentation_model(name):
 		index = files.index(name)
 		cat = categories[index]
 		download_zenodo_file(name, os.sep.join([main_dir, cat]))
-		match = os.sep.join([main_dir, cat, name])+os.sep
+		match = os.sep.join([main_dir, cat, name]) + os.sep
 	return match
 
 
 def get_segmentation_datasets_list(return_path=False):
-	
 	"""
-	Retrieves a list of available segmentation datasets from both the local 'celldetective/datasets/segmentation_annotations' 
+	Retrieves a list of available segmentation datasets from both the local 'celldetective/datasets/segmentation_annotations'
 	directory and a Zenodo repository, optionally returning the path to the local datasets directory.
 
-	This function compiles a list of available segmentation datasets by first identifying datasets stored locally 
-	within a specified path related to the script's directory. It then extends this list with datasets available 
-	in a Zenodo repository, ensuring no duplicates are added. The function can return just the list of dataset 
+	This function compiles a list of available segmentation datasets by first identifying datasets stored locally
+	within a specified path related to the script's directory. It then extends this list with datasets available
+	in a Zenodo repository, ensuring no duplicates are added. The function can return just the list of dataset
 	names or, if specified, also return the path to the local datasets directory.
 
 	Parameters
 	----------
 	return_path : bool, optional
-		If True, the function returns a tuple containing the list of available dataset names and the path to the 
+		If True, the function returns a tuple containing the list of available dataset names and the path to the
 		local datasets directory. If False, only the list of dataset names is returned (default is False).
 
 	Returns
 	-------
 	list or (list, str)
-		If return_path is False, returns a list of strings, each string being the name of an available dataset. 
-		If return_path is True, returns a tuple where the first element is this list and the second element is a 
+		If return_path is False, returns a list of strings, each string being the name of an available dataset.
+		If return_path is True, returns a tuple where the first element is this list and the second element is a
 		string representing the path to the local datasets directory.
-	
+
 	"""
 
-	
-	datasets_path = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0],"celldetective", "datasets", "segmentation_annotations", os.sep])
-	repository_datasets = get_zenodo_files(cat=os.sep.join(["datasets","segmentation_annotations"]))
+	datasets_path = os.sep.join(
+		[os.path.split(os.path.dirname(os.path.realpath(__file__)))[0], "celldetective", "datasets",
+		 "segmentation_annotations", os.sep])
+	repository_datasets = get_zenodo_files(cat=os.sep.join(["datasets", "segmentation_annotations"]))
 
-	available_datasets = natsorted(glob(datasets_path+'*/'))
-	available_datasets = [m.replace('\\','/').split('/')[-2] for m in available_datasets]
+	available_datasets = natsorted(glob(datasets_path + '*/'))
+	available_datasets = [m.replace('\\', '/').split('/')[-2] for m in available_datasets]
 	for rm in repository_datasets:
 		if rm not in available_datasets:
 			available_datasets.append(rm)
@@ -1759,12 +1867,12 @@ def get_segmentation_datasets_list(return_path=False):
 def locate_segmentation_dataset(name):
 	
 	"""
-	Locates a specified segmentation dataset within the local 'celldetective/datasets/segmentation_annotations' directory 
+	Locates a specified segmentation dataset within the local 'celldetective/datasets/segmentation_annotations' directory
 	or downloads it from Zenodo if not found locally.
 
-	This function attempts to find a segmentation dataset by name within a predefined directory structure. If the dataset 
-	is not found locally, it then tries to locate and download the dataset from Zenodo, placing it into the appropriate 
-	category directory within 'celldetective'. The function prints the search directory path and returns the path to the 
+	This function attempts to find a segmentation dataset by name within a predefined directory structure. If the dataset
+	is not found locally, it then tries to locate and download the dataset from Zenodo, placing it into the appropriate
+	category directory within 'celldetective'. The function prints the search directory path and returns the path to the
 	found or downloaded dataset.
 
 	Parameters
@@ -1775,24 +1883,24 @@ def locate_segmentation_dataset(name):
 	Returns
 	-------
 	str or None
-		The full path to the located or downloaded segmentation dataset directory, or None if the dataset could not be 
+		The full path to the located or downloaded segmentation dataset directory, or None if the dataset could not be
 		found or downloaded.
 
 	Raises
 	------
 	FileNotFoundError
 		If the dataset cannot be found locally and also cannot be found or downloaded from Zenodo.
-	
+
 	"""
 
-	main_dir = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0],"celldetective"])
+	main_dir = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0], "celldetective"])
 	modelpath = os.sep.join([main_dir, "datasets", "segmentation_annotations", os.sep])
 	print(f'Looking for {name} in {modelpath}')
-	models = glob(modelpath+f'*{os.sep}')
+	models = glob(modelpath + f'*{os.sep}')
 
-	match=None
+	match = None
 	for m in models:
-		if name==m.replace('\\',os.sep).split(os.sep)[-2]:
+		if name == m.replace('\\', os.sep).split(os.sep)[-2]:
 			match = m
 			return match
 	# else no match, try zenodo
@@ -1801,41 +1909,43 @@ def locate_segmentation_dataset(name):
 		index = files.index(name)
 		cat = categories[index]
 		download_zenodo_file(name, os.sep.join([main_dir, cat]))
-		match = os.sep.join([main_dir, cat, name])+os.sep
+		match = os.sep.join([main_dir, cat, name]) + os.sep
 	return match
 
 
 def get_signal_datasets_list(return_path=False):
 
 	"""
-	Retrieves a list of available signal datasets from both the local 'celldetective/datasets/signal_annotations' directory 
+	Retrieves a list of available signal datasets from both the local 'celldetective/datasets/signal_annotations' directory
 	and a Zenodo repository, optionally returning the path to the local datasets directory.
 
-	This function compiles a list of available signal datasets by first identifying datasets stored locally within a specified 
-	path related to the script's directory. It then extends this list with datasets available in a Zenodo repository, ensuring 
-	no duplicates are added. The function can return just the list of dataset names or, if specified, also return the path to 
+	This function compiles a list of available signal datasets by first identifying datasets stored locally within a specified
+	path related to the script's directory. It then extends this list with datasets available in a Zenodo repository, ensuring
+	no duplicates are added. The function can return just the list of dataset names or, if specified, also return the path to
 	the local datasets directory.
 
 	Parameters
 	----------
 	return_path : bool, optional
-		If True, the function returns a tuple containing the list of available dataset names and the path to the local datasets 
+		If True, the function returns a tuple containing the list of available dataset names and the path to the local datasets
 		directory. If False, only the list of dataset names is returned (default is False).
 
 	Returns
 	-------
 	list or (list, str)
-		If return_path is False, returns a list of strings, each string being the name of an available dataset. If return_path 
-		is True, returns a tuple where the first element is this list and the second element is a string representing the path 
+		If return_path is False, returns a list of strings, each string being the name of an available dataset. If return_path
+		is True, returns a tuple where the first element is this list and the second element is a string representing the path
 		to the local datasets directory.
 
-	"""	
+	"""
 
-	datasets_path = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0],"celldetective", "datasets", "signal_annotations", os.sep])
-	repository_datasets = get_zenodo_files(cat=os.sep.join(["datasets","signal_annotations"]))
+	datasets_path = os.sep.join(
+		[os.path.split(os.path.dirname(os.path.realpath(__file__)))[0], "celldetective", "datasets",
+		 "signal_annotations", os.sep])
+	repository_datasets = get_zenodo_files(cat=os.sep.join(["datasets", "signal_annotations"]))
 
-	available_datasets = natsorted(glob(datasets_path+'*/'))
-	available_datasets = [m.replace('\\','/').split('/')[-2] for m in available_datasets]
+	available_datasets = natsorted(glob(datasets_path + '*/'))
+	available_datasets = [m.replace('\\', '/').split('/')[-2] for m in available_datasets]
 	for rm in repository_datasets:
 		if rm not in available_datasets:
 			available_datasets.append(rm)
@@ -1845,15 +1955,16 @@ def get_signal_datasets_list(return_path=False):
 	else:
 		return available_datasets, datasets_path
 
+
 def locate_signal_dataset(name):
 	
 	"""
-	Locates a specified signal dataset within the local 'celldetective/datasets/signal_annotations' directory or downloads 
+	Locates a specified signal dataset within the local 'celldetective/datasets/signal_annotations' directory or downloads
 	it from Zenodo if not found locally.
 
-	This function attempts to find a signal dataset by name within a predefined directory structure. If the dataset is not 
-	found locally, it then tries to locate and download the dataset from Zenodo, placing it into the appropriate category 
-	directory within 'celldetective'. The function prints the search directory path and returns the path to the found or 
+	This function attempts to find a signal dataset by name within a predefined directory structure. If the dataset is not
+	found locally, it then tries to locate and download the dataset from Zenodo, placing it into the appropriate category
+	directory within 'celldetective'. The function prints the search directory path and returns the path to the found or
 	downloaded dataset.
 
 	Parameters
@@ -1864,7 +1975,7 @@ def locate_signal_dataset(name):
 	Returns
 	-------
 	str or None
-		The full path to the located or downloaded signal dataset directory, or None if the dataset could not be found or 
+		The full path to the located or downloaded signal dataset directory, or None if the dataset could not be found or
 		downloaded.
 
 	Raises
@@ -1874,14 +1985,14 @@ def locate_signal_dataset(name):
 
 	"""
 
-	main_dir = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0],"celldetective"])
+	main_dir = os.sep.join([os.path.split(os.path.dirname(os.path.realpath(__file__)))[0], "celldetective"])
 	modelpath = os.sep.join([main_dir, "datasets", "signal_annotations", os.sep])
 	print(f'Looking for {name} in {modelpath}')
-	models = glob(modelpath+f'*{os.sep}')
+	models = glob(modelpath + f'*{os.sep}')
 
-	match=None
+	match = None
 	for m in models:
-		if name==m.replace('\\',os.sep).split(os.sep)[-2]:
+		if name == m.replace('\\', os.sep).split(os.sep)[-2]:
 			match = m
 			return match
 	# else no match, try zenodo
@@ -1890,13 +2001,13 @@ def locate_signal_dataset(name):
 		index = files.index(name)
 		cat = categories[index]
 		download_zenodo_file(name, os.sep.join([main_dir, cat]))
-		match = os.sep.join([main_dir, cat, name])+os.sep
+		match = os.sep.join([main_dir, cat, name]) + os.sep
 	return match
 
 def normalize(frame, percentiles=(0.0,99.99), values=None, ignore_gray_value=0., clip=False, amplification=None, dtype=float):
 
 	"""
-	
+
 	Normalize the intensity values of a frame.
 
 	Parameters
@@ -1946,15 +2057,16 @@ def normalize(frame, percentiles=(0.0,99.99), values=None, ignore_gray_value=0.,
 	frame = frame.astype(float)
 
 	if ignore_gray_value is not None:
-		subframe = frame[frame!=ignore_gray_value]
+		subframe = frame[frame != ignore_gray_value]
 	else:
 		subframe = frame.copy()
 
 	if values is not None:
-		mi = values[0]; ma = values[1]
+		mi = values[0];
+		ma = values[1]
 	else:
-		mi = np.nanpercentile(subframe.flatten(),percentiles[0],keepdims=True)
-		ma = np.nanpercentile(subframe.flatten(),percentiles[1],keepdims=True)
+		mi = np.nanpercentile(subframe.flatten(), percentiles[0], keepdims=True)
+		ma = np.nanpercentile(subframe.flatten(), percentiles[1], keepdims=True)
 
 	frame0 = frame.copy()
 	frame = normalize_mi_ma(frame0, mi, ma, clip=False, eps=1e-20, dtype=np.float32)
@@ -1963,41 +2075,42 @@ def normalize(frame, percentiles=(0.0,99.99), values=None, ignore_gray_value=0.,
 	if clip:
 		if amplification is None:
 			amplification = 1.
-		frame[frame>=amplification] = amplification
-		frame[frame<=0.] = 0.
+		frame[frame >= amplification] = amplification
+		frame[frame <= 0.] = 0.
 	if ignore_gray_value is not None:
-		frame[np.where(frame0)==ignore_gray_value] = ignore_gray_value
+		frame[np.where(frame0) == ignore_gray_value] = ignore_gray_value
 
 	return frame.copy().astype(dtype)
 
+
 def normalize_multichannel(multichannel_frame, percentiles=None,
 						   values=None, ignore_gray_value=0., clip=False,
 						   amplification=None, dtype=float):
 	
 	"""
-	Normalizes a multichannel frame by adjusting the intensity values of each channel based on specified percentiles, 
+	Normalizes a multichannel frame by adjusting the intensity values of each channel based on specified percentiles,
 	direct value ranges, or amplification factors, with options to ignore a specific gray value and to clip the output.
 
 	Parameters
 	----------
 	multichannel_frame : ndarray
-		The input multichannel image frame to be normalized, expected to be a 3-dimensional array where the last dimension 
+		The input multichannel image frame to be normalized, expected to be a 3-dimensional array where the last dimension
 		represents the channels.
 	percentiles : list of tuples or tuple, optional
-		Percentile ranges (low, high) for each channel used to scale the intensity values. If a single tuple is provided, 
+		Percentile ranges (low, high) for each channel used to scale the intensity values. If a single tuple is provided,
 		it is applied to all channels. If None, the default percentile range of (0., 99.99) is used for each channel.
 	values : list of tuples or tuple, optional
-		Direct value ranges (min, max) for each channel to scale the intensity values. If a single tuple is provided, it 
+		Direct value ranges (min, max) for each channel to scale the intensity values. If a single tuple is provided, it
 		is applied to all channels. This parameter overrides `percentiles` if provided.
 	ignore_gray_value : float, optional
 		A specific gray value to ignore during normalization (default is 0.).
 	clip : bool, optional
-		If True, clips the output values to the range [0, 1] or the specified `dtype` range if `dtype` is not float 
+		If True, clips the output values to the range [0, 1] or the specified `dtype` range if `dtype` is not float
 		(default is False).
 	amplification : float, optional
 		A factor by which to amplify the intensity values after normalization. If None, no amplification is applied.
 	dtype : data-type, optional
-		The desired data-type for the output normalized frame. The default is float, but other types can be specified 
+		The desired data-type for the output normalized frame. The default is float, but other types can be specified
 		to change the range of the output values.
 
 	Returns
@@ -2008,12 +2121,12 @@ def normalize_multichannel(multichannel_frame, percentiles=None,
 	Raises
 	------
 	AssertionError
-		If the input `multichannel_frame` does not have 3 dimensions, or if the length of `values` does not match the 
+		If the input `multichannel_frame` does not have 3 dimensions, or if the length of `values` does not match the
 		number of channels in `multichannel_frame`.
 
 	Notes
 	-----
-	- This function provides flexibility in normalization by allowing the use of percentile ranges, direct value ranges, 
+	- This function provides flexibility in normalization by allowing the use of percentile ranges, direct value ranges,
 	  or amplification factors.
 	- The function makes a copy of the input frame to avoid altering the original data.
 	- When both `percentiles` and `values` are provided, `values` takes precedence for normalization.
@@ -2023,21 +2136,22 @@ def normalize_multichannel(multichannel_frame, percentiles=None,
 	>>> multichannel_frame = np.random.rand(100, 100, 3)  # Example multichannel frame
 	>>> normalized_frame = normalize_multichannel(multichannel_frame, percentiles=((1, 99), (2, 98), (0, 100)))
 	# Normalizes each channel of the frame using specified percentile ranges.
-	
+
 	"""
 
 
 
 	mf = multichannel_frame.copy().astype(float)
-	assert mf.ndim==3,f'Wrong shape for the multichannel frame: {mf.shape}.'
+	assert mf.ndim == 3, f'Wrong shape for the multichannel frame: {mf.shape}.'
 	if percentiles is None:
-		percentiles = [(0.,99.99)]*mf.shape[-1]
-	elif isinstance(percentiles,tuple):
-		percentiles = [percentiles]*mf.shape[-1]
+		percentiles = [(0., 99.99)] * mf.shape[-1]
+	elif isinstance(percentiles, tuple):
+		percentiles = [percentiles] * mf.shape[-1]
 	if values is not None:
 		if isinstance(values, tuple):
-			values = [values]*mf.shape[-1]
-		assert len(values)==mf.shape[-1],'Mismatch between the normalization values provided and the number of channels.'
+			values = [values] * mf.shape[-1]
+		assert len(values) == mf.shape[
+			-1], 'Mismatch between the normalization values provided and the number of channels.'
 
 	mf_new = []
 	for c in range(mf.shape[-1]):
@@ -2066,9 +2180,9 @@ def load_frames(img_nums, stack_path, scale=None, normalize_input=True, dtype=fl
 	"""
 	Loads and optionally normalizes and rescales specified frames from a stack located at a given path.
 
-	This function reads specified frames from a stack file, applying systematic adjustments to ensure 
-	the channel axis is last. It supports optional normalization of the input frames and rescaling. An 
-	artificial pixel modification is applied to frames with uniform values to prevent errors during 
+	This function reads specified frames from a stack file, applying systematic adjustments to ensure
+	the channel axis is last. It supports optional normalization of the input frames and rescaling. An
+	artificial pixel modification is applied to frames with uniform values to prevent errors during
 	normalization.
 
 	Parameters
@@ -2080,7 +2194,7 @@ def load_frames(img_nums, stack_path, scale=None, normalize_input=True, dtype=fl
 	scale : float, optional
 		The scaling factor to apply to the frames. If None, no scaling is applied (default is None).
 	normalize_input : bool, optional
-		Whether to normalize the loaded frames. If True, normalization is applied according to 
+		Whether to normalize the loaded frames. If True, normalization is applied according to
 		`normalize_kwargs` (default is True).
 	dtype : data-type, optional
 		The desired data-type for the output frames (default is float).
@@ -2096,38 +2210,39 @@ def load_frames(img_nums, stack_path, scale=None, normalize_input=True, dtype=fl
 	Raises
 	------
 	Exception
-		Prints an error message if the specified frames cannot be loaded or if there is a mismatch between 
+		Prints an error message if the specified frames cannot be loaded or if there is a mismatch between
 		the provided experiment channel information and the stack format.
 
 	Notes
 	-----
 	- The function uses scikit-image for reading frames and supports multi-frame TIFF stacks.
 	- Normalization and scaling are optional and can be customized through function parameters.
-	- A workaround is implemented for frames with uniform pixel values to prevent normalization errors by 
+	- A workaround is implemented for frames with uniform pixel values to prevent normalization errors by
 	  adding a 'fake' pixel.
 
 	Examples
 	--------
 	>>> frames = load_frames([0, 1, 2], '/path/to/stack.tif', scale=0.5, normalize_input=True, dtype=np.uint8)
-	# Loads the first three frames from '/path/to/stack.tif', normalizes them, rescales by a factor of 0.5, 
+	# Loads the first three frames from '/path/to/stack.tif', normalizes them, rescales by a factor of 0.5,
 	# and converts them to uint8 data type.
-	
+
 	"""
 
 	try:
 		frames = skio.imread(stack_path, key=img_nums, plugin="tifffile")
 	except Exception as e:
-		print(f'Error in loading the frame {img_nums} {e}. Please check that the experiment channel information is consistent with the movie being read.')
+		print(
+			f'Error in loading the frame {img_nums} {e}. Please check that the experiment channel information is consistent with the movie being read.')
 		return None
 
-	if frames.ndim==3:
+	if frames.ndim == 3:
 		# Systematically move channel axis to the end
 		channel_axis = np.argmin(frames.shape)
 		frames = np.moveaxis(frames, channel_axis, -1)
 
 	if frames.ndim==2:
 		frames = frames[:,:,np.newaxis].astype(float)
-	
+
 	if normalize_input:
 		frames = normalize_multichannel(frames, **normalize_kwargs)
 
@@ -2138,9 +2253,9 @@ def load_frames(img_nums, stack_path, scale=None, normalize_input=True, dtype=fl
 	# add a fake pixel to prevent auto normalization errors on images that are uniform
 	# to revisit
 	for k in range(frames.shape[2]):
-		unique_values = np.unique(frames[:,:,k])
-		if len(unique_values)==1:
-			frames[0,0,k] += 1
+		unique_values = np.unique(frames[:, :, k])
+		if len(unique_values) == 1:
+			frames[0, 0, k] += 1
 
 	return frames.astype(dtype)
 
@@ -2150,9 +2265,9 @@ def get_stack_normalization_values(stack, percentiles=None, ignore_gray_value=0.
 	"""
 	Computes the normalization value ranges (minimum and maximum) for each channel in a 4D stack based on specified percentiles.
 
-	This function calculates the value ranges for normalizing each channel within a 4-dimensional stack, with dimensions 
-	expected to be in the order of Time (T), Y (height), X (width), and Channels (C). The normalization values are determined 
-	by the specified percentiles for each channel. An option to ignore a specific gray value during computation is provided, 
+	This function calculates the value ranges for normalizing each channel within a 4-dimensional stack, with dimensions
+	expected to be in the order of Time (T), Y (height), X (width), and Channels (C). The normalization values are determined
+	by the specified percentiles for each channel. An option to ignore a specific gray value during computation is provided,
 	though its effect is not implemented in this snippet.
 
 	Parameters
@@ -2160,30 +2275,30 @@ def get_stack_normalization_values(stack, percentiles=None, ignore_gray_value=0.
 	stack : ndarray
 		The input 4D stack with dimensions TYXC from which to calculate normalization values.
 	percentiles : tuple, list of tuples, optional
-		The percentile values (low, high) used to calculate the normalization ranges for each channel. If a single tuple 
-		is provided, it is applied to all channels. If a list of tuples is provided, each tuple is applied to the 
+		The percentile values (low, high) used to calculate the normalization ranges for each channel. If a single tuple
+		is provided, it is applied to all channels. If a list of tuples is provided, each tuple is applied to the
 		corresponding channel. If None, defaults to (0., 99.99) for each channel.
 	ignore_gray_value : float, optional
-		A gray value to potentially ignore during the calculation. This parameter is provided for interface consistency 
+		A gray value to potentially ignore during the calculation. This parameter is provided for interface consistency
 		but is not utilized in the current implementation (default is 0.).
 
 	Returns
 	-------
 	list of tuples
-		A list where each tuple contains the (minimum, maximum) values for normalizing each channel based on the specified 
+		A list where each tuple contains the (minimum, maximum) values for normalizing each channel based on the specified
 		percentiles.
 
 	Raises
 	------
 	AssertionError
-		If the input stack does not have 4 dimensions, or if the length of the `percentiles` list does not match the number 
+		If the input stack does not have 4 dimensions, or if the length of the `percentiles` list does not match the number
 		of channels in the stack.
 
 	Notes
 	-----
-	- The function assumes the input stack is in TYXC format, where T is the time dimension, Y and X are spatial dimensions, 
+	- The function assumes the input stack is in TYXC format, where T is the time dimension, Y and X are spatial dimensions,
 	  and C is the channel dimension.
-	- Memory management via `gc.collect()` is employed after calculating normalization values for each channel to mitigate 
+	- Memory management via `gc.collect()` is employed after calculating normalization values for each channel to mitigate
 	  potential memory issues with large datasets.
 
 	Examples
@@ -2191,23 +2306,24 @@ def get_stack_normalization_values(stack, percentiles=None, ignore_gray_value=0.
 	>>> stack = np.random.rand(5, 100, 100, 3)  # Example 4D stack with 3 channels
 	>>> normalization_values = get_stack_normalization_values(stack, percentiles=((1, 99), (2, 98), (0, 100)))
 	# Calculates normalization ranges for each channel using the specified percentiles.
-	
+
 	"""
 
-	assert stack.ndim==4,f'Wrong number of dimensions for the stack, expect TYXC (4) got {stack.ndim}.'
+	assert stack.ndim == 4, f'Wrong number of dimensions for the stack, expect TYXC (4) got {stack.ndim}.'
 	if percentiles is None:
-		percentiles = [(0.,99.99)]*stack.shape[-1]
-	elif isinstance(percentiles,tuple):
-		percentiles = [percentiles]*stack.shape[-1]
-	elif isinstance(percentiles,list):
-		assert len(percentiles)==stack.shape[-1],f'Mismatch between the provided percentiles and the number of channels {stack.shape[-1]}. If you meant to apply the same percentiles to all channels, please provide a single tuple.'
+		percentiles = [(0., 99.99)] * stack.shape[-1]
+	elif isinstance(percentiles, tuple):
+		percentiles = [percentiles] * stack.shape[-1]
+	elif isinstance(percentiles, list):
+		assert len(percentiles) == stack.shape[
+			-1], f'Mismatch between the provided percentiles and the number of channels {stack.shape[-1]}. If you meant to apply the same percentiles to all channels, please provide a single tuple.'
 
 	values = []
 	for c in range(stack.shape[-1]):
 		perc = percentiles[c]
-		mi = np.nanpercentile(stack[:,:,:,c].flatten(),perc[0],keepdims=True)[0]
-		ma = np.nanpercentile(stack[:,:,:,c].flatten(),perc[1],keepdims=True)[0]
-		values.append(tuple((mi,ma)))
+		mi = np.nanpercentile(stack[:, :, :, c].flatten(), perc[0], keepdims=True)[0]
+		ma = np.nanpercentile(stack[:, :, :, c].flatten(), perc[1], keepdims=True)[0]
+		values.append(tuple((mi, ma)))
 		gc.collect()
 
 	return values
@@ -2216,15 +2332,15 @@ def get_stack_normalization_values(stack, percentiles=None, ignore_gray_value=0.
 def get_positions_in_well(well):
 	
 	"""
-	Retrieves the list of position directories within a specified well directory, 
+	Retrieves the list of position directories within a specified well directory,
 	formatted as a NumPy array of strings.
 
-	This function identifies position directories based on their naming convention, 
-	which must include a numeric identifier following the well's name. The well's name 
-	is expected to start with 'W' (e.g., 'W1'), followed by a numeric identifier. Position 
-	directories are assumed to be named with this numeric identifier directly after the well 
-	identifier, without the 'W'. For example, positions within well 'W1' might be named 
-	'101', '102', etc. This function will glob these directories and return their full 
+	This function identifies position directories based on their naming convention,
+	which must include a numeric identifier following the well's name. The well's name
+	is expected to start with 'W' (e.g., 'W1'), followed by a numeric identifier. Position
+	directories are assumed to be named with this numeric identifier directly after the well
+	identifier, without the 'W'. For example, positions within well 'W1' might be named
+	'101', '102', etc. This function will glob these directories and return their full
 	paths as a NumPy array.
 
 	Parameters
@@ -2235,13 +2351,13 @@ def get_positions_in_well(well):
 	Returns
 	-------
 	np.ndarray
-		An array of strings, each representing the full path to a position directory within 
+		An array of strings, each representing the full path to a position directory within
 		the specified well. The array is empty if no position directories are found.
 
 	Notes
 	-----
 	- This function relies on a specific naming convention for wells and positions. It assumes
-	  that each well directory is prefixed with 'W' followed by a numeric identifier, and 
+	  that each well directory is prefixed with 'W' followed by a numeric identifier, and
 	  position directories are named starting with this numeric identifier directly.
 
 	Examples
@@ -2249,54 +2365,54 @@ def get_positions_in_well(well):
 	>>> get_positions_in_well('/path/to/experiment/W1')
 	# This might return an array like array(['/path/to/experiment/W1/101', '/path/to/experiment/W1/102'])
 	if position directories '101' and '102' exist within the well 'W1' directory.
-	
+
 	"""
 
 	if well.endswith(os.sep):
 		well = well[:-1]
 
-	w_numeric = os.path.split(well)[-1].replace('W','')
-	positions = natsorted(glob(os.sep.join([well,f'{w_numeric}*{os.sep}'])))
+	w_numeric = os.path.split(well)[-1].replace('W', '')
+	positions = natsorted(glob(os.sep.join([well, f'{w_numeric}*{os.sep}'])))
 
-	return np.array(positions,dtype=str)
+	return np.array(positions, dtype=str)
 
 
 def extract_experiment_folder_output(experiment_folder, destination_folder):
 	
 	"""
-	Copies the output subfolder and associated tables from an experiment folder to a new location, 
+	Copies the output subfolder and associated tables from an experiment folder to a new location,
 	making the experiment folder much lighter by only keeping essential data.
-	
-	This function takes the path to an experiment folder and a destination folder as input. 
-	It creates a copy of the experiment folder at the destination, but only includes the output subfolders 
-	and their associated tables for each well and position within the experiment. 
-	This operation significantly reduces the size of the experiment data by excluding non-essential files. 
-	
-	The structure of the copied experiment folder is preserved, including the configuration file, 
-	well directories, and position directories within each well. 
+
+	This function takes the path to an experiment folder and a destination folder as input.
+	It creates a copy of the experiment folder at the destination, but only includes the output subfolders
+	and their associated tables for each well and position within the experiment.
+	This operation significantly reduces the size of the experiment data by excluding non-essential files.
+
+	The structure of the copied experiment folder is preserved, including the configuration file,
+	well directories, and position directories within each well.
 	Only the 'output' subfolder and its 'tables' subdirectory are copied for each position.
-	
+
 	Parameters
 	----------
 	experiment_folder : str
-		The path to the source experiment folder from which to extract data. 		
+		The path to the source experiment folder from which to extract data.
 	destination_folder : str
-		The path to the destination folder where the reduced copy of the experiment 
+		The path to the destination folder where the reduced copy of the experiment
 		will be created.
-	
+
 	Notes
 	-----
-	- This function assumes that the structure of the experiment folder is consistent, 
-	  with wells organized in subdirectories and each containing a position subdirectory. 
+	- This function assumes that the structure of the experiment folder is consistent,
+	  with wells organized in subdirectories and each containing a position subdirectory.
 	  Each position subdirectory should have an 'output' folder and a 'tables' subfolder within it.
-	  
-	- The function also assumes the existence of a configuration file in the root of the 
+
+	- The function also assumes the existence of a configuration file in the root of the
 	  experiment folder, which is copied to the root of the destination experiment folder.
-	  
+
 	Examples
 	--------
 	>>> extract_experiment_folder_output('/path/to/experiment_folder', '/path/to/destination_folder')
-	# This will copy the 'experiment_folder' to 'destination_folder', including only 
+	# This will copy the 'experiment_folder' to 'destination_folder', including only
 	# the output subfolders and their tables for each well and position.
 	
 	"""
@@ -2306,21 +2422,21 @@ def extract_experiment_folder_output(experiment_folder, destination_folder):
 		experiment_folder = experiment_folder[:-1]
 	if destination_folder.endswith(os.sep):
 		destination_folder = destination_folder[:-1]
-	
+
 	exp_name = experiment_folder.split(os.sep)[-1]
 	output_path = os.sep.join([destination_folder, exp_name])
 	if not os.path.exists(output_path):
 		os.mkdir(output_path)
 
 	config = get_config(experiment_folder)
-	copyfile(config,os.sep.join([output_path,os.path.split(config)[-1]]))
-	
+	copyfile(config, os.sep.join([output_path, os.path.split(config)[-1]]))
+
 	wells_src = get_experiment_wells(experiment_folder)
 	wells = [w.split(os.sep)[-2] for w in wells_src]
 
-	for k,w in enumerate(wells):
-		
-		well_output_path = os.sep.join([output_path,w])
+	for k, w in enumerate(wells):
+
+		well_output_path = os.sep.join([output_path, w])
 		if not os.path.exists(well_output_path):
 			os.mkdir(well_output_path)
 
@@ -2336,16 +2452,16 @@ def extract_experiment_folder_output(experiment_folder, destination_folder):
 
 			if not os.path.exists(output_folder):
 				os.mkdir(output_folder)
-			
+
 			if not os.path.exists(output_tables_folder):
-				os.mkdir(output_tables_folder)  
+				os.mkdir(output_tables_folder)
 
-			tab_path = glob(pos+os.sep.join(['output','tables',f'*']))
-			
-			for t in tab_path:
-				copyfile(t,os.sep.join([output_tables_folder,os.path.split(t)[-1]]))
+			tab_path = glob(pos + os.sep.join(['output', 'tables', f'*']))
 
+			for t in tab_path:
+				copyfile(t, os.sep.join([output_tables_folder, os.path.split(t)[-1]]))
 
 
 if __name__ == '__main__':
-	control_segmentation_napari("/home/limozin/Documents/Experiments/MinimumJan/W4/401/", prefix='Aligned', population="target", flush_memory=False)
+	control_segmentation_napari("/home/limozin/Documents/Experiments/MinimumJan/W4/401/", prefix='Aligned',
+								population="target", flush_memory=False)