Introduction

There are a several steps to follow to extract the dominant colour from images on the Imago Portal. In summary these are :

1. Create an Attribute Definition. 
2. Create an Action Definition.
3. Assign Attribute to an Imagery Type.
4. Assign Image Action to a Workspace.
5. Select One or more Collections.
6. Extract Dominant Colour from Images.
7. Export the Extracted Colour Attributes.
8. Import the Dominant Colour Attributes into Leapfrog.

If you are unfamiliar with the data hierarchy within Imago, click here.

Putting these steps together:

1. Create an Attribute Definition

1. In My Workspaces>Definitions>Attributes, click Attribute Definitions:

2. To create a new Attribute Definition, scroll to the bottom of the list of definitions and enter a name for the new definition:

3. Two Attribute Types have been defined for the Coreboxes Color Attribute (to add a new Attribute Type, provide a name in the highlighted location):

4. Both Attribute Types are set to Colour (Corebox Color Attribute Dry shown here):

These Attribute Types will hold the extracted Colour.

Before moving to the next step, copy the Attribute Type Name (Corebox Color Attribute Dry in the above). This will become clear in the next step.

2. Create an Action Definition

Now that an Attribute has been defined as a Colour Type an Action  needs to be created which will perform the dominant color extraction which and save this color to the attributes created earlier.

1. Click imagery Types: 

2. In this example, we will go inside the "Core Boxes" imagery Type (This is where the Attributes and Actions are going to be assigned):

then you will be able to assign the "color# attribute to the imagery type attributes: 

To create a new Action, scroll to the "Show Advanced" option above the attributes title.

3. Now, you will be able to select where to save the dominant color. In this example we are taking the Wet derived option and we are saving its dominant color in the attribute Wet option: 

3. Select One or more Collections

Imago needs to know which Collection(s) to process. To do this, return to Imagery page:

1. Toggle Editing On
2. Use the Workpace Browser to select a Dataset, Imagery Type and one or more Collections (AADD0141 in this example):

4. Extract Dominant Colour from Images

In the last Section, Wet was already selected. Next:

1. Return to the My Workspaces panel
2. Select Image Tools
3. Select Reprocess Images Actions from the drop-down list:

4. And complete as follows for Wet:

7. Repeat steps to extract the dominant color for Dry core (ensuring Dry is selected as described.

Depending on the number of images in a Collection, processing may take several minutes.

8. View the processed images for Wet by moving back to the Imagery page and select Corebox Color Attribute Wet:

9. The view for the colour images is NOT scaled to depth and the dominant colour is not displayed. Change the view to true depth by clicking the option as shown:

The dominant colour attribute now displays appropriately scaled next to the core boxes:

To display core trays to the right of the colour extracted images, unselect and select Wet in the Active Imagery Panel:

7. Export the Extracted Colour Attributes

To export the dominant colour extracted from the coreboxes, use the Export Attributes option in Imago Connect.

Open Imago Connect and filter if needed by Workspace, Dataset, collection or image type.  For this example, the export in this screen is set for CoreBox Color Attribute Wet. Finally click Download:

If you are unfamiliar with Imago Connect, make sure you read Imago Connect Overview and Export Attributes. The dominant colour Attribute can be reused.

8. Import the Dominant Colour Attributes into Leapfrog

After exporting the dominant colour (CSV and LFC files) using Imago Connect + Tools, this can be imported into a Leapfrog Project. View this demonstration : 

Back to top