Welcome to CODI! This article explains how to make an account and upload a dataset.

CODI home page

The CODI home page shows a gallery of datasets. At any point, it is possible to return to this page by clicking on the CODI logo in the top left of the page.

Creating an account

To create a new account, start by clicking on the user icon in the top right corner.

A popup window will appear which handles the log in.

Here either use a google account to log in or click on 'Create an ONI account'.

Now enter user details,

and choose a password.

Check the relevant email inbox for a confirmation from ONI for this newly created account.

When it arrives, click on the link to confirm the email address.

A new popup should display.

At this point click on the ‘I’ve confirmed my email address’ button in the previous popup window. This account is now activated and available for logging in.

Logging in

Click on the user icon in the top right corner and enter login details.

If all goes well the popup should disappear and the user icon should now be colored and show the user initials.

A new upload button should appear alongside the user icon, this will come in handy for the next steps.

Logged in users can upload datasets, click on the upload icon in the top right corner.

This will open the upload page.

To upload a dataset named ‘example’ the files would be:

• example.locb

• example_map.nim

• example_acq.nim

• optionally any other files with the same prefix e.g. example.txt

(users can ignore the .pointCloud option, this is currently an internal file type)

To add these files, either drag and drop or click on the folder icon to navigate and select files from the local file system. Once added the upload page should look like this:

At this point a few options are available (note that any options on the left hand side can be adjusted after uploading too):

• Adjust the dataset title for CODI

• Add a description

• Add tags to the dataset

• Choose to make the dataset public on upload (datasets default to private)

• View a list of files ready to upload

• Remove all files from the upload list

• Add more files to be uploaded to this dataset

Once these options are set, click the ‘Upload all’ button to upload and create a dataset.

Upload progress is displayed in percentages for each file.

Once uploaded the dataset will need to be optimised for the cloud, this process can take a minute or two. After this, the dataset will be ready to view and analyse by clicking on the purple arrow button.

Opening a dataset

When clicking through to a newly uploaded dataset, or opening a dataset from the home page, CODI will navigate to the dataset’s information page. On this page there is a summary of the dataset including:

• A dataset menu bar along the left edge

• Saved views of the dataset

• Dataset details including title, tags and description (editable for dataset owners)

• Comments

• Executions run on the dataset

• The rating star for the dataset

• Acquisition metadata

• Channel names (editable for dataset owners)

Dataset owners can also see files in the dataset further down the information page

The additional files shown here are generated during the cloud optimisation process.

Visualising a dataset

To visualise a dataset click on a dataset view to be taken to that snapshot in the viewer, or click on the STORM icon in the left side menu.

If clicking on the STORM icon CODI will open the online viewer with the localisation filtering tool opened by default.

This is the CODI viewer! Users can explore datasets using navigation similar to viewing maps online, for example:

• pinch/scroll to zoom in and out

• click and drag to pan

• right click and drag to rotate