For making projects on your local file system, you can use the MoBIE Project Creator within Fiji. See also here for details about the project specification and structure. Note: if your images are particularly large, or you want more control over your project, you can create your project with our python library (see below for details).
Type MoBIE in the search bar, and select the Create new MoBIE Project command.
Navigate to a folder, and provide a project name. This will create a new project, and open the Edit MoBIE Project dialog.
Note: you can open this at any time by typing MoBIE in the search bar and selecting Edit MoBIE Project.
This has 4 rows showing the contents of your project: ‘dataset’ (datasets in your project), ‘source’ (images in each dataset), ‘group’ (the dropdown menu names for this dataset) and ‘view’ (the individual views in each group).
A dataset is a combination of images that can be displayed in the same physical coordinate system e.g. you might make this images from different samples, or timepoints, or separate experiments.
Click Add on the dataset row, and provide a name for your dataset.
Also, select if you want to Limit images and display to only 2D. If
you check this box, you will only be able to add 2D images to your dataset,
and when you open them in MoBIE they will be displayed only in 2D.
Uncheck this if you need 3D images, or you want to arrange your 2D images
in 3D space e.g. stacking 2D slices into a 3D stack.
Clicking OK will create the dataset, and add it to the dataset dropdown.
The first dataset you create will automatically become the default i.e. the one you see when you first open that MoBIE Project. To make another dataset the default, select it in the dataset dropdown, then click Edit, and tick the checkbox next to Make default dataset.
This Edit menu also allows you to rename datasets.
To add an image to a dataset, make sure the chosen dataset is selected in the dataset dropdown. Then follow the directions below for either open current image (to add images open in imageJ) or bdv format image (if your image is already in n5 or ome-zarr format).
For all images, make sure your unit and voxel size are set correctly! The project creator only allows images with the same unit to be added to the same project (e.g. all micrometre or all nanometre etc…)
Note: if your images are particularly large, it will be more efficient to convert your images outside of imageJ. e.g. using our python library
Once confirmed, you’ll be asked to give a ‘ui selection group name’ - see Ui selection group below for details.
The image will then be converted to your chosen image format and saved to the project with the appropriate metadata. If the image was a segmentation, it will also calculate a corresponding table. This can take some time, especially for large images. The image will appear in the source/view dropdowns.
Once confirmed, Select the xml file (if n5), or .ome.zarr directory (if ome-zarr)
Then, you’ll be asked to give a ‘ui selection group name’ - see Ui selection group below for details.
The image will be added to the project, and appear in the source/view dropdowns. If the image was a segmentation, it will also calculate a corresponding table. This can take some time, especially for large images.
For the add method:
copy is the best option in most cases (and will make it easy to upload the project to S3 later).
Ui selection groups are the names of the dropdown menus inside MoBIE. You can use them to sort your images into different categories - for example, light microscopy and electron microscopy.
If it’s not the first image added, you’ll have the option to select an existing group, or create a new one.
To open your new project, click the ‘Open in MoBIE’ button in the bottom right of the project creator.
Once the project is open in MoBIE, you can change how the images are displayed by default in your views.
Select the relevant view in the drop down menus and click ‘view’. Then setup the view as you like by moving in the MoBIE viewer / changing the colour, brightness etc…
To save these changes you can then right click in the viewer and select ‘Save Current View’, and select ‘Overwrite existing view’ and ‘Project’.
The following dialog has all the same settings as here, with one additional one ‘Save location’. Select ‘dataset.json’ for this.
If you need more complex changes to your views, you will need to manually edit the ‘.json’ files in the project - see here for details of project structure.
To make a project available to anyone remotely, it will need to be uploaded to an AWS S3 compatible object store.
First, you must add some metadata to the project by clicking on the ‘Add/update remote’ button in the bottom right of the project creator.
Once complete, you can upload the entire project into the specified bucket. Others can then open this, by giving the s3 location (including the bucket) in the ‘Open MoBIE Project…’ command. For example, try opening the example plankton dataset with this location: https://s3.embl.de/plankton-fibsem
Optionally, if you would like your project metadata to be under version control you can upload it to github - make sure you exclude your image files!! Others can then open the project, by giving the github repository as the location. For example, try opening the example platynereis dataset with this location: https://github.com/mobie/platybrowser-project
Upload the contents of the ‘data’ directory (the directory containing the project.json file) to the s3 bucket. There are several tools available to achieve this, for example aws s3 sync (https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html). The sync command would look something like this:
$ aws s3 sync /path/to/my/project/data https://s3.embl.de/my-bucket
Note that this is optional! It is useful especially for larger projects, with many metadata files, that would benefit from version control.
$ git init
$ git remote add origin https://github.com/USERNAME/my-mobie-project
$ git add .
$ git push origin master
The MoBIE python library offers better support for large images, more control and support for all features of the spec, including grid transformations, region displays and spot sources. You can learn how to uses based on our example notebooks: