Atlas Legacy Processing Guide

Note: Atlas processing will no longer be available after October 31st, 2017. Atlas will, however, remain an analytics platform. For pricing and plans see Atlas Pricing

Table of Contents

Introduction

Atlas is an intelligent analytics service designed to turn the multispectral data you collect into actionable information. Although Atlas no longer includes a cloud processing service, users can upload processed results from Pix4D to benefit from Atlas' unique analytical layers and cloud sharing tools. For more details, please see Getting Started in Atlas.

For legacy users, the Atlas processing service will continue until October 31st, 2017. Until the processing service expires, this guide will show you how to use Atlas and the Uploader application. 

Manage Farms and Fields

Atlas organizes your data in the form of Farms, with Fields located within those Farms. Farms are just a pinpoint specifying the general location of the area, while fields indicate exact regions in which to fly and collect data.

Creating a Farm

To create a Farm, go to the Farms tab and click on the +NEW button.  

Screen_Shot_2017-04-20_at_3.39.54_PM.png

Provide a name, a brief description, and then assign a location for your farm using the "Add Marker" button. Click on the map to indicate a location, typically near the geographical center of the farm or at the main facility or building. You can also use the map's search tool and type in a full address or the name of a nearby city, and pan around the map until you find your farm. Press the "Create Farm" button to complete the process and save your new farm.

Screen_Shot_2017-04-20_at_4.11.41_PM.png

You can add more farms here but first, let's add a field to the farm.

Creating a Field

Once you have created a farm, you can define fields within that farm. Click on the appropriate Farm and click on the +NEW button. Provide a name and a description for the field.

Screen_Shot_2017-04-20_at_4.20.52_PM.png

You can either draw a field on the map, or upload a KML or Shapefile to define a single field. If using a shapefile, note that only one field can be imported at a time, and only the first polygon in the file will be imported. If you wish to define multiple fields using a shapefile, click here for more information

Drawing a field

Press the "Draw Field" button. In the map view to the right, click and hold to pan around until you find the field you wish to define, then click on the map to specify the corners or endpoints of the field.

If you have or are creating multiple fields, please ensure that your fields do not overlap. For more information, see: How should I define my fields?

Click on the first point to close the field and finalize the input. Then, press the "Done" button.

Click the "Create" button to finish the process.

You can add more fields within the same Farm by clicking the +NEW button again. 

Creating Fields From Uploaded Data

You can also define a Field after data has been uploaded to Atlas. To do so, go to the DataHub tab. Select the image set that you wish to view as you create your field, then press the "Create New Field" or "Create Another Field" button.

Screen_Shot_2017-04-20_at_4.33.04_PM.png

Select the Farm that the field will belong to. Or, create a new farm by clicking on the PLUS button and typing in a name. Define a name for the new Field.

The locations of each image in the Upload are shown on the map. Now you can define your field as indicated above.

If you have or are creating multiple fields, please ensure that your fields do not overlap. For more information, see: How should I define my fields?

Upload Data

To upload your data to Atlas, download the MicaSense Uploader application. The installer can be downloaded from the Downloads tab.

Once installed, start the MicaSense Uploader application and log in using the same email address and password as used to log into the Atlas portal.

Data is added to Atlas in the form of an Image Set. An Image Set is a collection of data that belongs together. It can be comprised of data from a single flight or multiple flights, and can encompass a single field, or multiple fields. We will cover more details of how Atlas organizes data in Uploads in a separate article.

To create a new Image Set, click on the +NEW button.

Input a title and description for the image set. Provide relevant information in the description field, such as the altitude above ground level for the flight and other useful information. Click on the Plus (+) button to continue.

Next, press the "Add Files" button to add a folder of images to the image set. At this time you can not add individual images (only folders).

Select the directory where the data is stored. This will typically be a folder within an SD card. Make sure you include in the upload the folders that contain the camera’s log files – these will be the folders with the suffix “SET”.

The green checkbox will appear after adding imagery. If on, it means that the image set will be complete once all of the data has been uploaded. You can turn this off if you have more data to upload to the same image set later. You can add additional directories in the same way. 

NOTE: The recommended option is to complete the image set after the upload has completed.

uploader-icons.png

You can use the altitude/time graph to select and exclude/include images based on their altitude. 

exclude.gif

You can also select images on the map using the rectangle or polygon selection tool. 

select-on-map.gif

 

There are four options for selected images: include, exclude, deselect all, and invert. If you happen to select a panel image, you will be shown a warning and asked if you would like to include the panel image. Panel images are important for radiometric calibration and should always be included.

Screen_Shot_2017-03-03_at_8.42.27_AM.png

When you have selected all of the images/directories required for the job, press "Upload" to start the process. This may take some time depending on your internet speed and the number of files selected.

upload_button.png

If the upload is halted, failed, or canceled before completion, you can easily resume the process. To do so, re-start the MicaSense Uploader application if needed, select the same Image Set, choose the same folder containing the data, and click on Upload again. The application will determine which files are already in the Atlas server and will only upload the missing files. 

When the upload process has finished, a link will appear to view the image set in Atlas. There you can start processing or confirm that processing has started automatically.

Screen_Shot_2017-03-03_at_8.44.17_AM.png

Viewing the Data

Atlas will usually process data within 24 hours of an upload being completed. You will receive an email when the data is available for viewing.

For a more detailed overview of how to view and use the layers in Atlas, see Viewing Data in Atlas

 

Next Steps

Now that you are familiar with the basics of Atlas, take a look at these Best Practices for Collecting Data with MicaSense RedEdge and Parrot Sequoia. This guide contains essential knowledge for collecting good data with your multispectral sensor which will be easy to process and produce good results.

Have more questions? Submit a request