Welcome to CODI! This article explains how to make an account and upload a dataset.
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.
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.
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.
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.
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.
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