Projects
The Projects area, accessible via the Projects icon on the left navigation sidebar, is the central home for all your scientific work. Projects bring together your raw data, analysis runs, virtual desktops, team members, and notebook entries into one unified view.
From the main Projects list, you can search projects by name, ID, or keyword, and filter them by Start Year, Role, and Contributors.
Navigating Inside a Project Workspace
Opening a project brings you into a dedicated workspace organized into three core tabs:
- Analysis: Track, filter, inspect, and launch all compute tasks—including analysis jobs and virtual desktops—associated with the project.
- Data: Access, manage, and upload raw datasets and output files within the project’s dedicated storage space.
- Lab notebook: Maintain shared notes, document protocols, and record experimental decisions alongside your data and analyses.
From the top-right corner of the project workspace, managers can select Project Settings to modify project metadata or click Invite + to quickly add new team members and assign roles.
The Analysis Tab
The Analysis tab serves as the centralized dashboard for all computational work connected to a project. The main table logs every job execution using the project's data, as well as every virtual desktop session launched with the project mounted by any collaborator.
Filtering the Analysis Table
Use the filter controls at the top of the table to narrow down entries by:
- Triggerer: Filter by the team member who launched the task.
- Analysis Type: Switch between Job runs and Virtual Desktop sessions.
- Status: Filter by state (Pending, Running, Completed, or Failed)
Table Actions
Inspect Details : Click the eye icon next to any entry to open its dedicated details page, where you can review execution logs, parameters, software versions, and visual previews.
Rerun : Click the run icon to launch or re-open a task with pre-configured settings:
- For Jobs: Re-opens the job configuration with original parameters, paths, and compute time pre-filled so you can tweak values before re-submitting.
- For Virtual Desktops: Re-connects you to an existing virtual desktop or lets you adjust its hardware (performance) allocation before launching.
Creating a New Analysis
Click the + NEW ANALYSIS button in the top right of the table to start a new task:
- Virtual Desktop: Opens the virtual desktop setup window with the current project already mounted.
- Jobs: Opens the job template library so you can select and configure an analysis pipeline.
The Data Tab
Access, manage, and browse your raw datasets, intermediate files, and processed output files within the project’s dedicated storage space.
How to upload data via the web browser
- From the Projects list, access your project folder by double-clicking or clicking on the eye symbol.
- From here go to the raw folder
- Use the upload button to upload data in the web browser.
The Lab Notebook Tab
Maintain shared notes, document experimental protocols, and record decisions alongside your data and analysis runs.
Sponsoring a Project: Personal vs. Lab Licenses
When creating a project, you must select a Sponsor License to cover storage capacity and compute allocations (analysis jobs and virtual desktops) for all collaborators working within that project.
- Personal License: Powered by your individual account allocations. The project creator automatically becomes the project Owner.
- Lab License: Powered by pooled compute resources provided by a Principal Investigator (PI). The lab owner (PI) is automatically assigned as the project Owner, keeping data, results, code, and IP securely anchored to the lab even as team members join or move on.
Collaboration Capabilities
Regardless of whether a project uses a Personal or Lab License, all projects include:
- Sponsored Compute for Collaborators: The project's sponsor license automatically covers compute resources used by any invited collaborator when running jobs or virtual desktops within that project.
- Shared Virtual Desktops: All collaborators on a project can view, access, and work inside virtual desktop sessions created within that project to troubleshoot, review results, and collaborate together.
The Project Entity & Attributes
A Project at DECTRIS D.LAB serves as a structured container for an entire research initiative.
- Key Project Attributes:
- Project ID: A unique identifier composed of a letter code, creation year, and a 5-digit tag (e.g.,
DCUSA:2026:62776). - Region: Specifies the data center location hosting your project data. Data remains isolated within the selected region to ensure compliance and low latency.
- Planned Start / Expected End Date: Timeline markers for tracking project duration.
- Title & Keywords: Custom titles and user-defined tags to improve searchability and filtering.
- Sponsor License: Indicates whether resources are billed to a personal license or a shared Lab License.
- Lab notebook: An integrated note-taking space accessible to all project managers and contributors.
How to Create a Project
- Click the Projects icon on the left navigation sidebar.
- Click the + NEW PROJECT button.
- Fill out the required project metadata (Title, Start/End Dates, Keywords).
- Select your Sponsor License (Personal License or Lab License). If choosing a Lab License, project ownership will automatically assign to your PI.
- Select a Region close to your physical location to ensure minimal latency during virtual desktop sessions and analysis runs.
- Click Create Project
Roles
Projects can be shared with four different roles. Each role includes everything the roles below it can do, plus additional permissions.
- Owner: Full control. Manages all roles and holds legal responsibility for the project data. There is exactly one Owner per project. The project creator becomes Owner by default but can transfer ownership.
- Manager: Operational management. Can add or remove Members, and request deletions of raw data.
- Member: Hands-on contribution. Can upload data, edit the logbook, perform analysis, and add Viewers. Best for PhD students, visiting scientists, and active collaborators.
- Viewer: Read-only access. Can view the uploaded and processed files in the project, but cannot access them in sessions and jobs. Best for passive collaborators or anyone who only needs visibility