pixel-patrol 0.1.0__tar.gz

pixel_patrol-0.1.0/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: pixel-patrol
+Version: 0.1.0
+Summary: Add your description here
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: bs4>=0.0.2
+Requires-Dist: imageio
+Requires-Dist: scikit-image
+Requires-Dist: matplotlib>=3.10.0
+Requires-Dist: pandas>=2.2.3
+Requires-Dist: ray>=2.40.0
+Requires-Dist: streamlit>=1.41.1
+Requires-Dist: altair>=5.5.0
+Requires-Dist: numpy<2.0.0,>=1.21.0
+Requires-Dist: image>=1.5.33
+Requires-Dist: tifffile<2025.2.18,>=2024.12.12
+Requires-Dist: plotly>=5.24.1
+Requires-Dist: plotly-express>=0.4.1
+Requires-Dist: tk>=0.1.0
+Requires-Dist: bioio==1.0.2
+Requires-Dist: bioio-czi>=1.0.2
+Requires-Dist: bioio-lif>=1.0.0
+Requires-Dist: bioio-nd2>=1.0.0
+Requires-Dist: bioio-tifffile>=1.0.0
+Requires-Dist: bioio-ome-zarr>=1.1.0
+Requires-Dist: bioio-ome-tiff>=1.0.1
+Requires-Dist: bioio-dv>=1.0.0
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: polars>=1.22.0
+Requires-Dist: streamlit-extras>=0.5.0
+Requires-Dist: tensorboard>=2.18.0
+Requires-Dist: tensorflow>=2.18.0
+Requires-Dist: pywavelets>=1.8.0
+Requires-Dist: opencv-python-headless>=4.11.0.86
+
+# Pixel Patrol
+
+## How to use
+
+1. Clone repository
+2. Install `uv`
+3. `uv pip install -e .`
+4. `uv run streamlit_main.py`
+
+If you get an error when adding a folder path - install tkinter/python-tk:   
+Ubuntu: `sudo apt-get install python3-tk`  
+Mac: `brew install python-tk`  
+
+## How to add widget
+
+Widgets can be added in this repository or in separate packages.
+
+### Write Widget
+
+```
+# my/widgets/test_widget.py
+
+import streamlit as st
+from pixel_patrol.widgets.widget_interface import ImagePrevalidationWidget
+
+
+class TestWidget(ImagePrevalidationWidget):
+
+    @property
+    def tab(self) -> str:
+        return "Other"
+
+    def run(self, selected_files_df):
+        with st.expander("Test widget", expanded=False):
+            st.text("Hi!")
+```
+
+### Add Widget to `entry-points` of the package
+
+```
+# pyproject.toml
+
+[project]
+...
+[project.entry-points."pixel_patrol.widgets"]
+test_widget = "my.widgets.test_widget:TestWidget"
+
+```

pixel_patrol-0.1.0/README.md

@@ -0,0 +1,48 @@
+# Pixel Patrol
+
+## How to use
+
+1. Clone repository
+2. Install `uv`
+3. `uv pip install -e .`
+4. `uv run streamlit_main.py`
+
+If you get an error when adding a folder path - install tkinter/python-tk:   
+Ubuntu: `sudo apt-get install python3-tk`  
+Mac: `brew install python-tk`  
+
+## How to add widget
+
+Widgets can be added in this repository or in separate packages.
+
+### Write Widget
+
+```
+# my/widgets/test_widget.py
+
+import streamlit as st
+from pixel_patrol.widgets.widget_interface import ImagePrevalidationWidget
+
+
+class TestWidget(ImagePrevalidationWidget):
+
+    @property
+    def tab(self) -> str:
+        return "Other"
+
+    def run(self, selected_files_df):
+        with st.expander("Test widget", expanded=False):
+            st.text("Hi!")
+```
+
+### Add Widget to `entry-points` of the package
+
+```
+# pyproject.toml
+
+[project]
+...
+[project.entry-points."pixel_patrol.widgets"]
+test_widget = "my.widgets.test_widget:TestWidget"
+
+```

pixel_patrol-0.1.0/pixel_patrol/default_tabs.py

@@ -0,0 +1,12 @@
+
+from enum import Enum
+
+class DefaultTabs(Enum):
+    SUMMARY = "Summary"
+    FILE_STATS = "File Stats"
+    METADATA = "Metadata"
+    VISUALIZATION = "Visualization"
+    NOISE = "Noise"
+    OTHER = "Other Widgets"
+    DATASET_STATS = "Dataset Stats"
+    

pixel_patrol-0.1.0/pixel_patrol/default_values.py

@@ -0,0 +1,11 @@
+import os
+from pathlib import Path
+import tempfile
+
+BASE_CACHE_PATH_ENV_VAR = "IMAGE_PREVALIDATION_BASE_CACHE_PATH"
+BASE_CACHE_PATH = os.getenv(BASE_CACHE_PATH_ENV_VAR, str(Path.home().joinpath(".pixel_patrol")))
+
+TEMP_DIR = tempfile.TemporaryDirectory()
+
+def get_named_temp_file():
+    return tempfile.NamedTemporaryFile(delete=False)

pixel_patrol-0.1.0/pixel_patrol/main.py

@@ -0,0 +1,289 @@
+from pathlib import Path
+
+import polars as pl
+import streamlit as st
+import yaml
+
+from pixel_patrol.project import Project
+from pixel_patrol.utils.session import (
+    get_project, initialize_session_state, PrevalidationStep, get_current_step, set_current_step,
+    is_debug_mode, KEY_TEST_DATA_DIR, get_all_widgets
+)
+from pixel_patrol.utils.ui import (
+    choose_matplotlib_colormap, configure_layout, create_sidebar,
+    create_add_folder_button, choose_widgets,
+    add_new_path_with_subpath_check, display_imported_dirs_info,
+    display_widgets_as_report, display_widgets_as_tab, step_is_disabled
+)
+from pixel_patrol.utils.utils import (
+    preprocess_files, process_files,
+    get_cache_dir, aggregate_folder_dataframes, count_file_extensions, load_dataframe_images,
+    store_all_dataframe_images_to_cache, set_colors, cache_all_project_path_structures, add_new_path,
+    file_structure_cache_missing
+)
+from pixel_patrol.utils.widget import (
+    get_required_columns, load_or_get_project_widgets, organize_widgets_by_tab
+)
+
+
+def load_config(config_path: str = "../config.yaml"):
+    config = {}
+    config_file = Path(__file__).parent / config_path
+    if config_file.exists():
+        try:
+            with open(config_file, "r") as f:
+                config = yaml.safe_load(f)
+        except yaml.YAMLError as e:
+            st.error(f"Error parsing YAML file: {e}")
+    else:
+        st.error(f"Configuration file `{config_path}` not found.")
+    return config
+
+
+def select_project(project):
+    # Check if a project name is provided in the URL query parameters
+    placeholder = st.empty()
+    with placeholder.container():
+        projects_dir = get_cache_dir() / "projects"
+        projects_dir.mkdir(exist_ok=True)
+        existing_projects = [p.stem for p in projects_dir.glob("*.yml")]
+        options = ["New Project"] + existing_projects
+        selected = st.selectbox("Select Project", options, key="project_select")
+
+        if selected == "New Project":
+            new_project_name = st.text_input("Enter New Project Name", key="new_project_name")
+            if new_project_name and st.button("Confirm", key="confirm_new"):
+                if new_project_name in existing_projects:
+                    st.error("Project already exists. Choose a different name.")
+                else:
+                    project.name = new_project_name
+                    project.selected_widgets = [w.name for w in load_or_get_project_widgets(project)]
+                    st.query_params["project"] = project.name
+                    placeholder.empty()
+        else:
+            if st.button("Confirm", key="confirm_existing"):
+                set_active_project(project, selected)
+                st.rerun()
+
+    return project
+
+
+def set_active_project(project, project_name):
+    if project is not None and project.name == project_name:
+        # project is in session, do not load from disk
+        return
+    project.name = project_name
+    if project.exists():
+        project.load_project_from_yml(project_name)
+    for path in project.paths:
+        add_new_path(path, project)
+    project.selected_widgets = [w.name for w in load_or_get_project_widgets(project)]
+    load_dataframe_images(project)
+    st.query_params["project"] = project_name
+
+
+def reset_project_selection():
+    st.session_state.project.reset()
+    st.query_params.clear()
+    set_current_step(PrevalidationStep.DEFINE_PROJECT)
+    st.rerun()
+
+
+def get_test_data_dir(config):
+    test_data_dir = config.get(KEY_TEST_DATA_DIR, "test_data")
+    return Path(__file__).parent / test_data_dir
+
+
+def load_test_data(test_data_dir, project):
+    """Load all datasets from the test_data directory."""
+    if not test_data_dir.exists():
+        st.error(f"Test data directory `{test_data_dir}` does not exist.")
+        return
+
+    # Iterate over each dataset directory in test_data
+    for dataset_dir in test_data_dir.iterdir():
+        if dataset_dir.is_dir():
+            # Check if the dataset is already loaded to prevent duplication
+            if not any(d['path'] == str(dataset_dir) for d in st.session_state.project.paths):
+                add_new_path_with_subpath_check(str(dataset_dir), project)
+    st.success(f"Test data loaded from `{test_data_dir}`.")
+
+
+def create_dataframe_images_from_file_structure(project):
+    # project.paths is now a dict[path: df_structure]
+    dataframe_images = aggregate_folder_dataframes(project.paths)
+    dataframe_images = dataframe_images.filter(pl.col("type").eq("file"))
+
+    selected_file_types = project.settings.get("selected_file_extensions", [])
+    if selected_file_types:
+        # Convert selected_file_types to lowercase for case-insensitive comparison
+        selected_file_types = [ft.lower() for ft in selected_file_types]
+        dataframe_images = dataframe_images.filter(
+            pl.col("file_extension").is_in(selected_file_types)
+        )
+
+    dataframe_images = preprocess_files(dataframe_images)
+    return dataframe_images
+
+
+def display_project_settings(config, project):
+    st.header("Project Settings")
+
+    preselected_file_extensions = [
+        ft.lower() for ft in
+        (project.settings.get("selected_file_extensions") or config.get('preselected_file_extensions', []))
+    ]
+
+    extension_info = count_file_extensions(project.paths)
+    if not extension_info:
+        if "all_files" in extension_info and extension_info["all_files"] == 0:
+            st.warning("No files found in any imported directories.")
+        else:
+            st.warning("No files with valid extensions found in these directories.")
+        return
+
+    total_file_count = extension_info.pop("all_files", 0)
+    if not extension_info:
+        st.warning("No valid file extensions found in these directories.")
+        return
+
+    st.subheader("Choose Which File Extensions to Include:")
+    options = [f".{ext} ({extension_info[ext]})" for ext in sorted(extension_info.keys())]
+    default = [f".{ext} ({extension_info[ext]})" for ext in preselected_file_extensions if ext in extension_info]
+    selected_options = st.multiselect("Select file extensions:", options, default=default)
+
+    # Extract the selected extensions (remove the count from the label)
+    selected_file_extensions = [opt.split(" ")[0][1:] for opt in selected_options]
+
+    project.settings["selected_file_extensions"] = selected_file_extensions
+
+    chosen_count = sum(extension_info[ext] for ext in selected_file_extensions)
+    st.info(f"Chosen {chosen_count} out of {total_file_count} total files.")
+
+    # display_fast_mode(project)
+
+    cmap = project.settings.get("cmap", 'rainbow')
+    cmap = choose_matplotlib_colormap(cmap)
+    project.settings["cmap"] = cmap
+
+    example_images = st.slider("Number of example images", min_value=1, max_value=15, value=9)
+    project.settings["example_images"] = example_images
+    st.write(f"Number of example images: {example_images}")
+
+    if st.button("Confirm Settings and Process Files"):
+        with st.spinner("Processing ongoing..."):
+
+            if project.has_project_config_changed() or file_structure_cache_missing(project):
+                project.save_project_to_yml()
+                st.info("Project configuration has changed. All caches will be updated.")
+                cache_all_project_path_structures(project)
+
+            to_be_processed_files = load_dataframe_images(project)
+            if to_be_processed_files is None:
+                # If no cache was available, create from scratch
+                to_be_processed_files = create_dataframe_images_from_file_structure(project)
+
+            to_be_processed_files = set_colors(to_be_processed_files, project)
+            widgets = load_or_get_project_widgets(project)
+            columns = get_required_columns(widgets)
+            processed_files = process_files(to_be_processed_files, columns)
+
+            project.df_images = processed_files
+            store_all_dataframe_images_to_cache(processed_files)
+
+        st.balloons()
+        set_current_step(PrevalidationStep.REPORT)
+        st.rerun()
+
+
+def create_main_section(config, project: Project, current_step: PrevalidationStep):
+
+    if step_is_disabled(project, current_step):
+        set_current_step(PrevalidationStep.DEFINE_PROJECT)
+        st.rerun()
+
+    match current_step:
+        case PrevalidationStep.DEFINE_PROJECT:
+            if project.name is None:
+                st.header("Define Project")
+                project = select_project(project)
+            if project.name is None:
+                return
+
+            st.header(f"Project: {project.name}")
+
+            if st.button("Select a different project", key="reset_project_main"):
+                reset_project_selection()
+
+            st.subheader("Directory Selection")
+            if project.paths:
+                for directory in project.paths:
+                    add_new_path_with_subpath_check(directory, project, show_success=False, suppress_warning=True)
+                st.success("Project directories loaded from configuration.")
+
+            select_directories(config, project)
+            if st.button("Confirm Directory Selection", key="confirm_dirs"):
+                if not project.paths:
+                    st.warning("Please add at least one valid directory with files or folders.")
+                else:
+                    set_current_step(PrevalidationStep.SELECT_WIDGETS)
+                    st.rerun()
+
+        case PrevalidationStep.SELECT_WIDGETS:
+            choose_widgets(project)
+
+        case PrevalidationStep.SETTINGS:
+            display_project_settings(config, project)
+
+        case PrevalidationStep.REPORT:
+            project = st.session_state.project
+            st.toggle(
+                "Print Mode",
+                value=project.is_report_mode,
+                on_change=lambda: setattr(project, "is_report_mode", not project.is_report_mode)
+            )
+            enabled_widgets = [w for w in get_all_widgets() if w.name in project.selected_widgets]
+            tabbed_widgets = organize_widgets_by_tab(enabled_widgets)
+
+            if project.is_report_mode:
+                display_widgets_as_report(tabbed_widgets, project.df_images.filter(pl.col("type") == "file"))
+            else:
+                display_widgets_as_tab(tabbed_widgets, project.df_images.filter(pl.col("type") == "file"))
+
+
+def select_directories(config, project):
+    if is_debug_mode():
+        test_data_dir = get_test_data_dir(config)
+        load_test_data(test_data_dir, project)
+        st.header("Debug Mode Enabled")
+        st.write(f"Using test data from `{test_data_dir}`")
+    else:
+        create_add_folder_button(project)
+        display_imported_dirs_info(project)
+
+
+def process_query(project):
+    query_params = st.query_params
+    if "project" in query_params and query_params["project"]:
+        set_active_project(project, query_params["project"])
+    if "view" in query_params and query_params["view"]:
+        view = query_params["view"]
+        view_step = PrevalidationStep[view]
+        if view_step:
+            set_current_step(view_step)
+
+
+def main():
+    config = load_config()
+    initialize_session_state(config)
+    project = get_project()
+    configure_layout(project)
+    process_query(project)
+    current_step = get_current_step()
+    if not project.is_report_mode:
+        create_sidebar(project, current_step)
+    create_main_section(config, project, current_step)
+
+
+if __name__ == "__main__":
+    main()

pixel_patrol-0.1.0/pixel_patrol/project.py

@@ -0,0 +1,190 @@
+from typing import Dict, List, Optional, Any
+
+import polars as pl
+import streamlit as st
+import yaml
+
+from pixel_patrol.utils.utils import hash_file_path, get_projects_dir
+
+
+class Project:
+    def __init__(self):
+        # Session state keys
+        self._session_keys = {
+            "name": "project_name",
+            "yml": "project_yml",
+            "paths": "imported_paths",
+            "path_summaries": "path_summaries",
+            "df_images": "df_images",
+            "selected_widgets": "selected_widgets",
+            "settings": "project_settings",
+            "is_report_mode": "is_report_mode",
+        }
+
+    # --- Properties for saved state (yml) ---
+    @property
+    def yml(self) -> Dict[str, Any]:
+        """The saved state of the project (from the YAML file)."""
+        return st.session_state.get(self._session_keys["yml"], {})
+
+    @yml.setter
+    def yml(self, value: Dict[str, Any]):
+        """Update the saved state of the project."""
+        st.session_state[self._session_keys["yml"]] = value
+
+    # --- Properties for runtime state ---
+    @property
+    def name(self) -> Optional[str]:
+        """The runtime state of the project name."""
+        return st.session_state.get(self._session_keys["name"])
+
+    @name.setter
+    def name(self, value: Optional[str]):
+        """Update the runtime state of the project name."""
+        st.session_state[self._session_keys["name"]] = value
+
+    @property
+    def paths(self) -> Dict[str, pl.DataFrame]:
+        """The runtime state of imported paths (full structure dfs)."""
+        return st.session_state.get(self._session_keys["paths"], {})
+
+    @paths.setter
+    def paths(self, value: Dict[str, pl.DataFrame]):
+        """Update the runtime state of imported paths."""
+        st.session_state[self._session_keys["paths"]] = value
+
+    @property
+    def path_summaries(self) -> Dict[str, pl.DataFrame]:
+        return st.session_state.get("path_summaries", {})
+
+    @path_summaries.setter
+    def path_summaries(self, value: Dict[str, pl.DataFrame]):
+        st.session_state["path_summaries"] = value
+
+    @property
+    def df_images(self) -> pl.DataFrame:
+        """The runtime state of the dataframe for images."""
+        return st.session_state.get(self._session_keys["df_images"], pl.DataFrame())
+
+    @df_images.setter
+    def df_images(self, value: pl.DataFrame):
+        """Update the runtime state of the dataframe for images."""
+        st.session_state[self._session_keys["df_images"]] = value
+
+    @property
+    def selected_widgets(self) -> Optional[List[Any]]:
+        """The runtime state of selected widgets."""
+        return st.session_state.get(self._session_keys["selected_widgets"])
+
+    @selected_widgets.setter
+    def selected_widgets(self, value: Optional[List[Any]]):
+        """Update the runtime state of selected widgets."""
+        st.session_state[self._session_keys["selected_widgets"]] = value
+
+    @property
+    def settings(self) -> Dict[str, Any]:
+        """The runtime state of project settings."""
+        return st.session_state.get(self._session_keys["settings"], {})
+
+    @settings.setter
+    def settings(self, value: Dict[str, Any]):
+        """Update the runtime state of project settings."""
+        st.session_state[self._session_keys["settings"]] = value
+
+    @property
+    def is_report_mode(self) -> bool:
+        """The runtime state of report mode."""
+        return st.session_state.get(self._session_keys["is_report_mode"], False)
+
+    @is_report_mode.setter
+    def is_report_mode(self, value: bool):
+        """Update the runtime state of report mode."""
+        st.session_state[self._session_keys["is_report_mode"]] = value
+
+    # --- Helper Methods ---
+    def reset(self):
+        """Reset the project to its initial state."""
+        self.name = None
+        self.yml = {}
+        self.paths = {}
+        self.path_summaries = {}
+        self.df_images = pl.DataFrame()
+        self.selected_widgets = None
+        self.settings = {}
+        self.is_report_mode = False
+
+    def load_project_from_yml(self, project_name: str):
+        """Load a project from its YAML file and initialize the runtime state."""
+        self.yml = self._read_yml(project_name)
+        self.name = self.yml.get("name")
+        self.paths = self.yml.get("paths", [])
+        self.selected_widgets = self.yml.get("selected_widgets")
+        self.settings = self.yml.get("settings", {})
+
+    def exists(self):
+        return Project.get_project_filepath(self.name).exists()
+
+    def save_project_to_yml(self):
+        if self.name:
+            paths_hashed = {path: hash_file_path(path) for path in self.paths.keys()}
+            widget_names = [w for w in (self.selected_widgets or [])]
+            self.yml = {
+                "name": self.name,
+                "paths": paths_hashed,
+                "selected_widgets": widget_names,
+                "settings": self.settings,
+            }
+            self._write_yml()
+
+    def _write_yml(self):
+        """Save the yml to a YAML file."""
+        projects_dir = get_projects_dir()
+        projects_dir.mkdir(exist_ok=True)
+        filepath = projects_dir / f"{self.name}.yml"
+        with open(filepath, "w") as f:
+            yaml.safe_dump(self.yml, f)
+
+    @staticmethod
+    def _read_yml(project_name: str) -> Dict[str, Any]:
+        """Load the yml from a YAML file."""
+        filepath = Project.get_project_filepath(project_name)
+        if filepath.exists():
+            with open(filepath, "r") as f:
+                return yaml.safe_load(f)
+        return {}
+
+    @staticmethod
+    def get_project_filepath(project_name):
+        projects_dir = get_projects_dir()
+        filepath = projects_dir / f"{project_name}.yml"
+        return filepath
+
+    def has_project_config_changed(self) -> bool:
+        """
+        Check if the project configuration has changed compared to the saved YAML.
+        Compares:
+        - Paths: Only the keys (directory paths).
+        - Selected Widgets: The list of selected widgets.
+        - Settings: Only the `selected_file_extensions` list.
+        """
+        saved_yml = self.yml
+
+        # Compare paths (only keys)
+        saved_paths = set(saved_yml.get("paths", {}).keys())
+        current_paths = set(self.paths.keys())
+        if saved_paths != current_paths:
+            return True
+
+        # Compare selected widgets
+        saved_widgets = set(saved_yml.get("selected_widgets", []))
+        current_widgets = set(self.selected_widgets or [])
+        if saved_widgets != current_widgets:
+            return True
+
+        # Compare selected file extensions in settings
+        saved_settings = saved_yml.get("settings", {})
+        current_settings = self.settings
+        if saved_settings != current_settings:
+            return True
+
+        return False

pixel_patrol-0.1.0/pixel_patrol/widget_interface.py

@@ -0,0 +1,23 @@
+from abc import ABC, abstractmethod
+from typing import List
+
+
+class ImagePrevalidationWidget(ABC):
+    @property
+    @abstractmethod
+    def tab(self) -> str:
+        """Return the name of the tab this widget belongs to."""
+        pass
+
+    @property
+    def name(self) -> str:
+        return type(self).__name__
+
+    def required_columns(self) -> List[str]:
+        """Returns required data column names"""
+        return []
+
+    @abstractmethod
+    def run(self, *args, **kwargs):
+        """Execute the widget's functionality."""
+        pass

pixel_patrol-0.1.0/pixel_patrol.egg-info/PKG-INFO

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: pixel-patrol
+Version: 0.1.0
+Summary: Add your description here
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: bs4>=0.0.2
+Requires-Dist: imageio
+Requires-Dist: scikit-image
+Requires-Dist: matplotlib>=3.10.0
+Requires-Dist: pandas>=2.2.3
+Requires-Dist: ray>=2.40.0
+Requires-Dist: streamlit>=1.41.1
+Requires-Dist: altair>=5.5.0
+Requires-Dist: numpy<2.0.0,>=1.21.0
+Requires-Dist: image>=1.5.33
+Requires-Dist: tifffile<2025.2.18,>=2024.12.12
+Requires-Dist: plotly>=5.24.1
+Requires-Dist: plotly-express>=0.4.1
+Requires-Dist: tk>=0.1.0
+Requires-Dist: bioio==1.0.2
+Requires-Dist: bioio-czi>=1.0.2
+Requires-Dist: bioio-lif>=1.0.0
+Requires-Dist: bioio-nd2>=1.0.0
+Requires-Dist: bioio-tifffile>=1.0.0
+Requires-Dist: bioio-ome-zarr>=1.1.0
+Requires-Dist: bioio-ome-tiff>=1.0.1
+Requires-Dist: bioio-dv>=1.0.0
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: polars>=1.22.0
+Requires-Dist: streamlit-extras>=0.5.0
+Requires-Dist: tensorboard>=2.18.0
+Requires-Dist: tensorflow>=2.18.0
+Requires-Dist: pywavelets>=1.8.0
+Requires-Dist: opencv-python-headless>=4.11.0.86
+
+# Pixel Patrol
+
+## How to use
+
+1. Clone repository
+2. Install `uv`
+3. `uv pip install -e .`
+4. `uv run streamlit_main.py`
+
+If you get an error when adding a folder path - install tkinter/python-tk:   
+Ubuntu: `sudo apt-get install python3-tk`  
+Mac: `brew install python-tk`  
+
+## How to add widget
+
+Widgets can be added in this repository or in separate packages.
+
+### Write Widget
+
+```
+# my/widgets/test_widget.py
+
+import streamlit as st
+from pixel_patrol.widgets.widget_interface import ImagePrevalidationWidget
+
+
+class TestWidget(ImagePrevalidationWidget):
+
+    @property
+    def tab(self) -> str:
+        return "Other"
+
+    def run(self, selected_files_df):
+        with st.expander("Test widget", expanded=False):
+            st.text("Hi!")
+```
+
+### Add Widget to `entry-points` of the package
+
+```
+# pyproject.toml
+
+[project]
+...
+[project.entry-points."pixel_patrol.widgets"]
+test_widget = "my.widgets.test_widget:TestWidget"
+
+```

pixel_patrol-0.1.0/pixel_patrol.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+README.md
+pyproject.toml
+pixel_patrol/__init__.py
+pixel_patrol/default_tabs.py
+pixel_patrol/default_values.py
+pixel_patrol/main.py
+pixel_patrol/project.py
+pixel_patrol/widget_interface.py
+pixel_patrol.egg-info/PKG-INFO
+pixel_patrol.egg-info/SOURCES.txt
+pixel_patrol.egg-info/dependency_links.txt
+pixel_patrol.egg-info/entry_points.txt
+pixel_patrol.egg-info/requires.txt
+pixel_patrol.egg-info/top_level.txt

pixel_patrol-0.1.0/pixel_patrol.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pixel_patrol-0.1.0/pixel_patrol.egg-info/entry_points.txt

@@ -0,0 +1,13 @@
+[pixel_patrol.widgets]
+data_type = pixel_patrol.widgets.metadata.data_type:DataTypeWidget
+dataframe = pixel_patrol.widgets.summary.dataframe:DataFrameWidget
+dataset_stats = pixel_patrol.widgets.dataset_stats.dataset_stats:DatasetStatsWidget
+dim_order = pixel_patrol.widgets.metadata.dim_order:DimOrderWidget
+dim_size = pixel_patrol.widgets.metadata.dim_size:DimSizeWidget
+embedding_projector = pixel_patrol.widgets.visualization.embedding_projector:EmbeddingProjectorWidget
+file_extension = pixel_patrol.widgets.file_stats.file_extension:FileExtensionWidget
+file_size = pixel_patrol.widgets.file_stats.file_size:FileSizeWidget
+file_timestamp = pixel_patrol.widgets.file_stats.file_timestamp:FileTimestampWidget
+image_mosaik = pixel_patrol.widgets.visualization.image_mosaik:ImageMosaikWidget
+image_quality = pixel_patrol.widgets.dataset_stats.image_quality:ImageQualityWidget
+summary = pixel_patrol.widgets.summary.summary:SummaryWidget

pixel_patrol-0.1.0/pixel_patrol.egg-info/requires.txt

@@ -0,0 +1,29 @@
+bs4>=0.0.2
+imageio
+scikit-image
+matplotlib>=3.10.0
+pandas>=2.2.3
+ray>=2.40.0
+streamlit>=1.41.1
+altair>=5.5.0
+numpy<2.0.0,>=1.21.0
+image>=1.5.33
+tifffile<2025.2.18,>=2024.12.12
+plotly>=5.24.1
+plotly-express>=0.4.1
+tk>=0.1.0
+bioio==1.0.2
+bioio-czi>=1.0.2
+bioio-lif>=1.0.0
+bioio-nd2>=1.0.0
+bioio-tifffile>=1.0.0
+bioio-ome-zarr>=1.1.0
+bioio-ome-tiff>=1.0.1
+bioio-dv>=1.0.0
+pyyaml>=6.0.2
+polars>=1.22.0
+streamlit-extras>=0.5.0
+tensorboard>=2.18.0
+tensorflow>=2.18.0
+pywavelets>=1.8.0
+opencv-python-headless>=4.11.0.86

pixel_patrol-0.1.0/pixel_patrol.egg-info/top_level.txt

@@ -0,0 +1 @@
+pixel_patrol

pixel_patrol-0.1.0/pyproject.toml

@@ -0,0 +1,59 @@
+[project]
+name = "pixel-patrol"  # This is the PyPI name (with hyphen)
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "bs4>=0.0.2",
+    "imageio",
+    "scikit-image",
+    "matplotlib>=3.10.0",
+    "pandas>=2.2.3",
+    "ray>=2.40.0",
+    "streamlit>=1.41.1",
+    "altair>=5.5.0",
+    "numpy>=1.21.0,<2.0.0",
+    "image>=1.5.33",
+    "tifffile>=2024.12.12,<2025.2.18",
+    "plotly>=5.24.1",
+    "plotly-express>=0.4.1",
+    "tk>=0.1.0",
+    "bioio==1.0.2",
+    "bioio-czi>=1.0.2",
+    "bioio-lif>=1.0.0",
+    "bioio-nd2>=1.0.0",
+    "bioio-tifffile>=1.0.0",
+    "bioio-ome-zarr>=1.1.0",
+    "bioio-ome-tiff>=1.0.1",
+    "bioio-dv>=1.0.0",
+    "pyyaml>=6.0.2",
+    "polars>=1.22.0",
+    "streamlit-extras>=0.5.0",
+    "tensorboard>=2.18.0",
+    "tensorflow>=2.18.0",
+    "pywavelets>=1.8.0",
+    "opencv-python-headless>=4.11.0.86",
+]
+
+[dependency-groups]
+dev = [
+    "pytest>=8.3.4",
+]
+
+[tool.setuptools]
+packages = ["pixel_patrol"]  # This is the Python package name (with underscore)
+
+[project.entry-points."pixel_patrol.widgets"]  # Changed from image_prevalidation.widgets
+file_timestamp = "pixel_patrol.widgets.file_stats.file_timestamp:FileTimestampWidget"
+file_size = "pixel_patrol.widgets.file_stats.file_size:FileSizeWidget"
+file_extension = "pixel_patrol.widgets.file_stats.file_extension:FileExtensionWidget"
+data_type = "pixel_patrol.widgets.metadata.data_type:DataTypeWidget"
+dim_order = "pixel_patrol.widgets.metadata.dim_order:DimOrderWidget"
+dim_size = "pixel_patrol.widgets.metadata.dim_size:DimSizeWidget"
+image_mosaik = "pixel_patrol.widgets.visualization.image_mosaik:ImageMosaikWidget"
+dataset_stats = "pixel_patrol.widgets.dataset_stats.dataset_stats:DatasetStatsWidget"
+embedding_projector = "pixel_patrol.widgets.visualization.embedding_projector:EmbeddingProjectorWidget"
+image_quality = "pixel_patrol.widgets.dataset_stats.image_quality:ImageQualityWidget"
+summary = "pixel_patrol.widgets.summary.summary:SummaryWidget"
+dataframe = "pixel_patrol.widgets.summary.dataframe:DataFrameWidget"

pixel_patrol-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+