How to guide: Getting started

How to guide: Getting started

Welcome to CODI! This article explains how to navigate into CODI 

CODI home page

The CODI home page will by default open into the All dataset (public and private) which is represented by a globe on the quick access toolbar on the left side.



   The second icon allows you to go into your datasets. Meaning any acquisition that you have taken and uploaded into CODI. 

  The third icon allows you to go into shared datasets. Meaning acquisition taken by someone but shared with you. 

  The fourth icon allows you to go into the Collaborations. Those are like folders of acquisitions that can be shared with others or where batch analysis can be ran. 

  That tool allows the user to change the call of thumbnails by making them bigger or smaller. 

  The question mark tools is leading to the Service Desk, support, archived data and also keyboard shortcut. 

. The last icon is simply to hide all the tools from the user interface. This can be useful for taking screenshot. 


Uploading a dataset

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


CODI will not upload the full Tiff (or Tif) images, meaning that it is unnecessary and an avoidable delay not to include the Tiff in the first place.  

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.

Note that if the purple arrow is clicked before optimisation is complete, then the dataset information page may show a warning complaining about a missing .pointCloud file. This is a known issue and the warning can be safely ignored as an optimisation is already running.

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 are 9 boxes separated into multiple columns. It is usually necessary to scroll each columns to see all the boxes. From the first on the top left, those are: 

  • The saved views of the dataset

  • All the uploaded files 

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

  • Executions run on the dataset

  • Comments

  • The ownership of the data

  • Channel names (editable for dataset owners)

  • Acquisition metadata

  • The rating star for the dataset

For more information on all those boxes, please read our Dataset homepage article. 

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 Analysis icon in the left side menu to get into the analysis options.  




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