Projects

Projects on Sundog do two jobs.

• they organise groups of experiments into a larger data structure, making it easy to collect related work.
• they allow you to control more fine-grained access to experiments within them.

A Sundog project maps well to a real-world project.

Why would an experiment be in more than one project?

Sundog Projects work a bit like a photo album on your phone. A photograph might belong to both “Summer 2025 France Trip” and “My Favourite Pictures”. Neither contradicts the other; they’re just different categorisations. And you might use them to decide who gets to see them - the full holiday album might be private to your family, but you might share all your favourites publicly.

In the same way, a Sundog experiment might belong to its main project, before being added to a “for publication” project, or a “best lab pictures 2026” project.

To begin with, we recommend trying to minimise the number of projects an experiment is in.

The lab’s project page lists all the projects in a lab, and the button top right lets you make a new one.

An individual project page shows a description of the project, latest experiments and activity within the project, plus the users who have access to the project. It’s very similar to the lab page.

The projects sub-menu throughout links to pages listing experiments and users in the project. Any project owners can also manage the experiments in the project, and users with access to it, from this page.

Creating a project

Anyone can create a project: they’re as useful for managing your own private work as for collaborating in a lab.

From the project creation form, you can name the project and write a description. The slug - used in the URL - will be auto-generated from the name, but you have an opportunity to edit it at creation if you’d like.

Finally, you can choose the base level for the project. This sets the default access level for anybody in the lab.

Project access levels

Access to a project is controlled via levels. Your level on a project determines what you can do and see within it. There are five levels of access:

Label	Description
Owner	Owns the project. Can add/remove people to/from the project and change their access levels. Can add/remove experiments from the project. Full access to experiments in the project. Can alter the project itself, including deleting it. The project creator is its owner by default, but other users can be given this permission.
Experimenter	Full access to experiments to the project, including creating/adding them, making stacks and uploads, etc - but no rights to alter the project or its users.
Commenter	No rights to add/create experiments in the project, but can see experiments in the project and comment/annotate stacks.
Viewer	Can see experiments and stacks in the project, but cannot comment/annotate
None	Cannot see the project at all.

Other users can be granted explicit permission to access the project, with a specific level.

A project must have at least one owner.

Using the base level

The base level of a project specifies what every lab member can do on it. This is an easy way to establish a “default” level of access to the project, and it can be changed at any time. For instance:

• to keep a project private, set the base level to none. This will mean that only you can see a project and its contents. To let users see experiments, comment on them, or add them, add them manually on the Users page.
• to allow everyone in the lab to see and comment on the project, but not alter its experimenters, set the base level to commenter, and give specific experimenters the experimenter role.
• to a colleague administrative control over a project, make them another owner. This is also useful if you want to hand management of the project over to them, and get yourself demoted/removed.
• set a base level of experimenter to allow any lab member to add and manipulate experiments in the project.

Projects → Experiments

The experiments page in a project lists and paginates all the experiments in a project. The buttons top right give you a shortcut to creating a new experiment in this project, and to the experiment manager for the project.

The experiment manager lists all experiments in the lab, and lets you add / remove experiments to the project. The bulk add/remove functionality is enabled by selecting rows with checkboxes. The filter textbox will search the lab for specific experiments.

When you remove a project from an experiment, you’ll be asked to confirm your action before it is remove. If doing so will make the experiment visible to more people than it previously was, you will be warned of this.

Experiments gaining visibility on removal

How can an experiment grow in visibility when removed from a project?

Labs have a “default level” of access for experiments not in any project. For instance, set to experimenter, this would mean anyone can add/remove stacks/uploads/comments to an experiment not in a project. Or set to commenter, would mean that anyone can comment on experiments not in a project.

If the act of removing this experiment from a project would leave it in no projects, and if the default level of the lab is “viewer” or up, then that experiment would now become visible by anyone in the lab. That means something that may have been private to people with permissions on the project would now be less private. And so Sundog warns you of this fact.

In general, we recommend organising work in projects, and trying to avoid having experiments outside them - but Sundog is flexible enough to let your organise your work how you’d like.

Projects → Users

The users page for a project lists everyone with access to a project: first, anyone with an explicit permission on the project, and then anyone else in the lab who has access via the base level if there is one.

Click change level to alter the level of an explicit permission, or to create an explicit permission for someone with a base level.

Click remove to remove an explicit permission from a user. You can’t remove base level access here: a project owner must alter the project to change the base level. You cannot remove your own permission.

Click “add permission” to add someone in the lab to the project.

The “user” field autocompletes by username or display name - search for the user you’d like and select them by clicking on them. Then, specify the access level you’d like them to have.