Upload an image collection

You can upload your own image collection (raster dataset) into Earth Blox to use in your projects. An image collection is a stack of images over the same location from different points in time, and can be used to create a time series.

See also: Uploading a feature collection

Add image collection

On the Assets page (https://app.earthblox.io/#/projects/assets), click New image collection

Add a name for your image collection, and optionally, add a description. 

Upload the first image

Start by uploading the first image to the image collection. This image is used to set the band structure for the image collection, and must finish uploading before other images can be added.

Click ‘Choose file’ and select your GeoTIFF file to upload, or drag and drop your file onto the file uploader.

Each image in a time series must be uploaded separately. You can upload images in any order, you do not have to start with the first in the time series.

Creating an image mosaic

To combine multiple GeoTIFFs to create an image mosaic, select multiple files to upload.

Select the Image type

Select whether the images in the image collection are either from a specific date, or represent a period of time. All images in a collection must be the same image type.

Image is from a specific date

If your image is from a specific date (for example, a satellite image) select the date that this image was taken.

Image represents a period of time

If the image represents a period of time, choose the cadence in the dropdown. The cadence can either be weekly, monthly, or yearly. 

Add the start date for the time period by typing in a date or using the date picker. 

The cadence is consistent across the image collection. E.g. If you select a yearly cadence, all images in the collection will have a yearly cadence.

Once the image has uploaded, view the Image Collection on the Assets page.

Add another image to the image collection

From the Assets page, select the image collection you would like to add an image to.

Click ‘Add image’

Choose the image to upload.

The image must have the same band structure as the other images in the image collection.

Change the date for an image

To change the date on an image, go to the Images tab on the image collection page.

Click on the image in the list that you want to edit, and change the date by typing or using the date picker pop up.

Click ‘Save changes’

Moving your Image collection to team assets

To make your image collection accessible to your team, select ‘Move to team’ in the extras menu.

Edit your image collection

Click on the dataset name

To edit the name of the image and add a short description, click on the title. Click on the tick to save your changes.

Edit image band information

Edit bands by clicking on the pencil icon that appears when you hover over the table cell

Changing a band from a numeric band to a thematic band

To change a numeric band into a thematic band, click on the extras menu icon

Select Change to thematic band

Confirm the changes

A new table for the thematic band will appear at the bottom of the page

Adding and editing classes in a thematic band

To add a class to a thematic band, click ‘Add new class’ at the bottom of the table. 

Add a value and description, and customise the colour value then click save.

To edit a field, click on the pencil icon that appears when you hover over the table cell.

Changing a band from a thematic band to a numeric band

To change a thematic band to a numeric band, click on the extras menu icon at the top of the table

Click ‘Change to numeric band’

Confirm the changes 

Any classes will be lost and won’t be available if you decide to change the band back to a thematic band.

Using your image in workflows

In your project, drag and drop an Insert dataset block from the toolbox.

Click on Search datasets to open the dataset finder.

Go to the Assets tab and select your dataset