Skip to content

Projects Tab

Overview

The Projects tab (ProjectsPage.qml, route Projects) is the entry point of DeepHistoImageAI Desktop. A project binds a local directory on disk (managed under your configured Projects folder) with a per-project SQLite database tracking whole-slide image references, annotations, datasets, and local model associations.

Projects Overview header buttons (New Project, Import Project, Import QuPath Project) above the searchable project table.

Availability & Prerequisites

  • Active Project Required: None (this is where you create or open a project).
  • Folder Requirement: Creating a new project or importing a QuPath project requires a configured Projects folder in Admin → Settings. Otherwise, the noPathDialog prompts you to configure one first.

Step-by-Step User Workflows

1. Create a New Project

  1. Click New Project in the top-right header.
  2. In Create New Project (createProjectDialog), verify the Projects folder parent directory (click Browse if you want to override it for this project).
  3. Enter a Project name. Notice the live preview banner confirming the exact folder path (<Projects folder>/<Project name>).
  4. Click Create. Once created, the toast confirms readiness and the project appears in the table.

2. Open, Rename, or Delete a Project

  • Open project: Click the Play (▶) action button on a project row. Opening a project activates it globally across the desktop and automatically navigates to the Viewer tab.
  • Rename project: Click the Pencil icon (Rename project) to open renameProjectDialog, edit the name, and confirm.
  • Delete project: Click the Trash icon to open deleteProjectConfirmDialog. Optionally choose whether to remove only the project list entry or delete files from disk before confirming.

3. Import a QuPath Project

  1. Click Import QuPath Project.
  2. Select the source QuPath project directory (.qpproj) in the qupathProjectDialog workflow and choose the destination project settings.
  3. Imported slide references and supported annotations are converted into a DeepHistoImageAI project ready for inspection in Viewer.
flowchart LR
    Empty["No active project"] --> NewProj["New Project / Import QuPath Project"]
    Empty --> OpenProj["Click Open (Play icon) on existing row"]
    NewProj --> Active["Project Active in SQLite"]
    OpenProj --> Active
    Active --> Viewer["Auto-navigate to Viewer tab"]

UI Controls & Table Columns Reference

Header Actions

Control Object Name / Label State Behavior Action
New Project newProjectButton (New Project) Disabled while projectViewModel.busy is true Opens createProjectDialog (or noPathDialog if no root projects folder exists)
Import Project importProjectButton (Import Project) Currently disabled (disabled: true in UI) Reserved for importing an existing DeepHistoImageAI project folder
Import QuPath Project importQuPathProjectButton (Import QuPath Project) Disabled while projectViewModel.busy or quPathImportViewModel.busy Opens QuPath project import flow

Projects Table (projectsDataTableSection)

Column Key Header Label Width / Display Description
name Name Fixed 180px, colored via nameColor Project display name
root_path Path Flex fill, monospace font Filesystem directory path containing the project database and artifacts
actions Actions Row action icons Open project (play), Rename project (pencil), Delete (trash-2)

Additional table controls:

  • Search bar: "Search projects..." filters rows incrementally by name or path.
  • Summary text: "Showing <count> projects".
  • Empty state: Displays "No projects yet — Create a new project to get started with WSI analysis" when projectCount === 0.

Dialogs & Modals

Dialog Trigger Key Inputs / Confirmations
createProjectDialog New Project Parent folder (Browse), live target path preview, Project name input
renameProjectDialog Row pencil action Editable pre-selected project name field
deleteProjectConfirmDialog Row trash-2 action Explicit toggle (deleteFilesFromDisk, default false) controlling whether on-disk files are deleted
qupathProjectDialog Import QuPath Project Source .qpproj selection and import mapping summary
noPathDialog Create/Import without Projects folder Quick action button navigating to Settings

Technical Reference

  • Persistence: Each project stores its metadata in a per-project SQLite database inside its root_path; WSI slide binaries are referenced by filesystem path rather than copied unnecessarily.
  • Toast Feedback Signals: onProjectCreated, onProjectOpened, onProjectRenamed, onProjectDeletionStarted, onProjectDeleted, and onValidationErrorOccurred.