New here? Take a look at the Quick start guide.

You will learn:


Projects dashboard


To access your projects dashboard open https://cloud.agisoft.com/  in a preferred web browser and sign in with your credentials.


On your projects dashboard you can:

  • access and manage your projects,
  • access projects that your were invited in by other users of the service,
  • view currently available in service resource,


My projects


On My projects page you can manage projects that are owned by you.


To open your project simply click on its name or thumbnail.



Shared with me


On the Shared with me page you can manage projects that were shared with you by other people.


To open the project that is shared with you simply click on its name or thumbnail. 


To refuse access to the project, open project context menu and click on the Remove button.



Project


The very basic entity in the cloud is a Project - it is a named collection of groups and datasets that can be viewed

and interacted online


Project that is created in the cloud web interface is only intended to organize a collection of ready to use geospatial datasets and not for photogrammetry processing. If you need to perform photogrammetry processing in the cloud jump to the Metashape Project paragraph.


Project optionally contains :

  • Groups - a name collection of datasets;
  • Datasets - geospatial datasets of supported types and formats uploaded into this project or added to this project from other projects in the cloud.


To open one of your projects simply click on its name or thumbnail on My Projects page. 


If the project is empty a Files page opens by default, where you can  manage the project's datasets and groups.


Otherwise a View page opens by default, where you can inspect the project's visualization, perform measurements and annotation.


Project files page


On the Files page of the Project there is one section called Datasets.   For the tutorial on how to upload new dataset or add one from the other refer to the Dataset paragraph.


To open the project's View page select the corresponding option from the drop-down list at the page header.


To get back to My projects page, click on the My projects button at the page header on the left.



Project view page


If there are some datasets in the project, a View page opens by default, where you can work with project visualization as well as manage project's datasets and groups.

 

For the tutorial on how to upload a new dataset, add one from another project in the cloud refer to the Dataset paragraph.


To open the project's Files page select the corresponding option from the drop-down list at the page header.


To get back to My projects page, click on the My projects button at the page header on the left.


On the project's View page you can perform measurements, add annotation and do other stuff, here are some useful links for further reading:



Create project


To create an empty project:

  1. On My project page click on the the Add+ button to create a new empty project
  2. In the pop-up appeared enter project's name and click on the Create button



When the project is created you automatically redirect to its files page, where you can upload new datasets or add ones from the other projects.


Share project


Each project by default is in private mode which means that only the owner of the project has access to view project visualization and access its datasets in the web interface . 


Share by link


When the share By link option is activated, each person who has the link will be able to view project visualization in web interface without need to sign in Agisoft Cloud.


To share the project by link:


  1. Click on the Share button on the project visualization page or select Share option in the project's menu on My Projects page. 
  2. In the Share pop-up turn on By link option, copy the link and send it to the recipient.
  3. To block the access by link, turn off By link option and close the pop-up.


Invite people


When share with invited people option is activated, invited users having an account on Agisoft Cloud will have access to view the project visualization and download datasets through the web interface. 

 

If someone having an account on Agisoft Cloud is invited to the project he/she will be notified via email and granted the access to view the project visualization and download datasets through the web interface. Shared projects will appear on the Share with me page of the invited user for easy access.

 

If someone not having an account on Agisoft Cloud is invited to the project he/she will be invited to create an account on Agisoft Cloud via email. After creating an account on Agisoft Cloud, a shared project will appear on the  invited user's personal Share with me page for easy access and the user will be able to view the project visualization and download datasets through the web interface.


To invite people to the project:


  1. Click the Share button on the project visualization page or select Share option in the project's menu on My Projects page.
  2. In the Share pop-up turn on With invited people option, enter the email of the person you want to invite and click the Invite button. 



To block the access to the project to all invited people: 

  1. Click the Share button on the project visualization page or select Share option in the project's menu on My Projects page
  2. In the Share pop-up turn off With invited people option and close the pop-up. Invited peoples will lose access to the project but their email addresses will not be deleted from the invited people list, so when you turn on the sharing with invited people option again, the access will be restored.


To block the access to the project to a certain person: 

  1. Click the Share button on the project View page or select Share option in the project's menu on My Projects page.
  2. In the Share pop-up click on the Invited People header to expand the list of invited people. Click on the Delete button represented as a cross icon right to the invited user email and close the pop-up.



Embed project


Embed code is a piece of an HTML code containing link to the project visualization and number of pre-configured parameters like frame size, embedding mode, autoplay and project's name appearance flags.


This code may be used to embed the project visualization into your personal or corporate web-site or any other web-resource supporting this feature.


There are two modes of project embedding available:

  • Presentation only - only project’s visualization and presentation will be available in the embedded project.
  • Full featured - project’s visualization , all tools and settings will be available in the embedded project. 


In both modes the project will appear with respect to the default point of view, workspace and scene settings, configured in the web-viewer. Later changes of those parameters change the way embedded projects appear.


To embed the project visualization into desired website:

  1. Select the Embed option in the project menu on My Projects page or in the top right corner of the project's visualization page.
  2. Configure the size, autoplay and project's name appearance settings.
  3. Copy the code corresponding to the desired embedding mode.
  4. Embed the code into the desired website.


Delete project


To delete the project:

  1. On My project page click open project's context menu
  2. In the project's context menu select Delete option
  3. In the pop-up appears confirm project deletion by clicking on the Delete button

Dataset


Dataset is a geospatial file of supported type and format, that is uploaded into the cloud.

 

When uploading a dataset into the cloud, its copy in a web optimized format called tileset is generated automatically so it can be viewed and interacted with in a web viewer.


Dataset consists of:

  • Source file - the file uploaded into the cloud,
  • Tileset - the file in a web optimized format generated automatically.


List of supported data types and formats:

  • LiDAR and photogrammetry point clouds in the following formats:
    • .obj,
    • .ply,
    • .las,
    • .laz, 
    • .e57,
    • .pts,
    • pts.gz,
    • .ptx,
    • .pcd, 
  • Orthomosaics, satellite imagery and any other raster maps in GeoTIFF format.
  • Digital elevation models in GeoTIFF format.
  • Vector layers in GeoJSON format.


Upload dataset


To upload a new dataset:

  1. Sign in to https://cloud.agisoft.com with your credentials
  2. Click on the project card on My projects page,
  3. On project visualization page click on the the Upload button 
  4. In the Upload dataset pop-up select datasets type and file on your device
  5. Select datasets coordinate system
  6. Click on the Upload button
  7. Wait until upload finish



When upload is finished, your dataset will be automatically published, which means that a copy of the file in a web optimized format called tileset will be generated for it in order to be able to work with it in a web viewer.


Create dataset


On the project View page you can create a vector layer for further digital mapping and annotations. Detailed tutorial on how to create and manage vector layers, as well as on how to make annotations with it can be found in the  "How to measure and annotate your projects" article.


Rename dataset

 

To rename the dataset on Files page:

  1. On projects Files page open dataset's context menu
  2. In the dataset's context menu select Rename option
  3. In the pop-up appears enter dataset's name and click on the Rename button

To rename the dataset on View page:

  1. On projects View page double click on the dataset in the Workspace pane on the left
  2. Enter dataset's name and press Enter key


Delete dataset

 

To delete the dataset on Files page:

  1. On projects Files page open dataset's context menu
  2. In the dataset's context menu select Delete option
  3. In the pop-up appears confirm dataset deletion


To delete the dataset on View page:

  1. On projects View page click on the dataset in the Workspace pane on the left
  2. Click on the Delete button
  3. In the pop-up appears confirm dataset deletion

Metashape Project


Metashape Project that is uploaded into the cloud is a special case of Project and besides being a collection of groups and datasets is also linked to PSX file, project files directory, photos, processing log and processing reports.


In case you need to add some context when analyzing photogrammetry processing results, it is also possible to upload or add a dataset to the Metashape project just like with Project that is created in the cloud web interface.


Metashape project necessarily contains:

  • PSX file 
  • Project files directory


Metashape Project optionally contains:

  • Project photos
  • Published processing results:
    • Chunks - a named collection of published processing results
    • Processing results - Cameras, Tie Points, Dense Cloud, DEM, Orthomosaic, 3D Model, Tiled Model, available for visualization and interaction online
  • Groups - a named collection of datasets;
  • Datasets - geospatial datasets of supported types and formats uploaded into this project or added to this project from other projects in the cloud.
  • Documents   - processing log and processing reports

Metashape project files page


If the project is not published and there are no datasets in the project, a Files page opens by default, where you can manage the project's datasets and groups.


On the Files page of the Metashape Project there are three section:


  • Published processing results 
  • Datasets 
  • Documents



Metashape project view page


If a project is published or has some datasets, a View page opens by default, where you can work with project visualization as well as manage project's datasets and groups.


When the project is published you can do a number of things, here are some useful links for further reading:



For the tutorial on how to upload new dataset or add one from the other refer to the Dataset paragraph.


Process Metashape project


Set up Metashape


First you have to configure Metashape for processing in the cloud, to do that:

  1. Start Metashape Professional
  2. Select Preferences option from the Tools menu

  3. In the Preferences pop-up open the Network tab

  4. In the Network tab opt-in the Enable network processing option and op-out Enable cloud processing option.

  5. Input account credentials in the Cloud section and click on the Ok button to finish configurations.



In case you are using a firewall please ensure that ports 443 and 8086 are opened through a firewall as well as https://api.agisoft.com:8086 and https://account.agisoft.com urls are whitelisted to allow Metashape to communicate with the cloud.


Start processing


When Metashape is set up for cloud processing, each time you start a processing operation or a batch of processing operation you are asked to process locally or in the cloud.


To start processing in the cloud:

  1. Start Metashape Professional
  2. Open an existing PSX project or create a new project, import the desired photoset and save it in PSX format.
  3. Configure and start desired processing operation or a batch of processing operations
  4. Confirm that this processing should be done in the cloud when asked


When initiating the processing in the cloud, synchronization procedure starts and the source imagery together with the project files directory are uploaded to the cloud. 


When project files and photos are uploaded processing starts and the project is blocked for local usage until processing completion and you can safely disconnect from the cloud and continue working with other projects locally.


Monitor progress


To monitor project status in Metashape simply open the corresponding PSX file in Metashape, current progress on the project, the time spent on processing and the estimation of time left to finish the processing will be displayed. 



To monitor project status in the web interface, sign it to https://cloud.agisoft.com with your credentials, on My Projects page current progress on the project processing and the estimation of time left to finish the processing will be displayed.


Get processing results


When processing is finished, you receive an email notification with information on how much of compute node operation time was spent on the processing and how much is still available on your account balance, as well as with errors details if any occurred.


To get a processed project from the cloud, open the corresponding PSX file in Metashape and the local project’s version will be automatically synchronized with the cloud one - which means that update project files will be automatically downloaded to your device.



Alternatively, in case the local project's version has been deleted from this device, on in case you need to download the project to other device:

  1. Start Metashape Professional
  2. Select Download project option from the Cloud submenu of the Files menu 

  3. In the Download project pop-up select desired project and click on the Ok button

  4. Select directory and optionally project's name and click on the Save button


If you also need to download project photos, do as follow:

  1. Start Metashape Professional
  2. Open an existing PSX project that has been previously uploaded into the cloud, for which you want to download photos
  3. In the Download photos pop-up select photos you need to download and download directory and click on the Ok button

  4. When downloaded, photos paths will be automatically updated.


Once the project is in the cloud you can run new processing operations in the cloud without need to reupload project photos and files. To start new processing in the cloud:

  1. Start Metashape Professional
  2. Open an existing PSX project that has been previously uploaded into the cloud
  3. Configure and start desired processing operation or a batch of processing operations
  4. Confirm that this processing should be done in the cloud when asked


Upload Metashape project


To upload the locally processed project into the cloud:

  1. Start Metashape Professional
  2. Select Upload project... option from the Cloud submenu of the Files menu 

  3. Confirm that this project is new and a new project will be created in the cloud when asked
  4. Wait until upload completion




When photos are not of need to work with online, you may remove them from the project before uploading to spare storage space in the cloud, upload the project and close the project without saving changes to prevent photos in the local p

Publish Metashape project


Processing results that are stored in Metashape project files directory are in internal formats that are not suitable for the purposes of visualization and interaction on the web.


In order to start working with the project processing results online it is required to generate in web optimized formats, those copies are called tilesets and the process is called publication.


To publish the project:

  1. On My project page open project's context menu
  2. In the project's context menu select Publish option



When publication is finished, you receive an email notification. To view the project's visualization, simply click on the project card on My Projects page at you data dashboard at https://cloud.agisoft.com when signed in with your credentials. 


If the project is published, its visualization will be automatically updated each time the new processing of this project in the cloud is done in case new processing results are being built.

Share Metashape project


Each project by default is in private mode which means that only the owner of the project has access to view project visualization and access its datasets in the web interface . 


Share by link


When the share By link option is activated, each person who has the link will be able to view project visualization in web viewer without need to sign in Agisoft Cloud.


To share the project by link:


  1. Click on the Share button on the project visualization page or select Share option in the project's menu on My Projects page. 
  2. In the Share pop-up turn on By link option, copy the link and send it to the recipient.
  3. To block the access by link, turn off By link option and close the pop-up.


Invite people


When share with invited people option is activated, invited users having an account on Agisoft Cloud will have access to view the project visualization and download datasets through the web interface. 

 

If someone having an account on Agisoft Cloud is invited to the project he/she will be notified via email and granted the access to view the project visualization and download datasets through the web interface. Shared projects will appear on the Share with me page of the invited user for easy access.

 

If someone not having an account on Agisoft Cloud is invited to the project he/she will be invited to create an account on Agisoft Cloud via email. After creating an account on Agisoft Cloud, a shared project will appear on the  invited user's personal Share with me page for easy access and the user will be able to view the project visualization and download datasets through the web interface.


To invite people to the project:


  1. Click the Share button on the project visualization page or select Share option in the project's menu on My Projects page.
  2. In the Share pop-up turn on With invited people option, enter the email of the person you want to invite and click the Invite button. 


To block the access to the project to invited people:

  1. Click the Share button on the project visualization page or select Share option in the project's menu on My Projects page
  2. In the Share pop-up turn off With invited people option and close the pop-up. Invited peoples will lose access to the project but their email addresses will not be deleted from the invited people list, so when you turn on the sharing with invited people option again, the access will be restored.


To block the access to the project to a certain person: 

  1. Click the Share button on the project View page or select Share option in the project's menu on My Projects page.
  2. In the Share pop-up click on the Invited People header to expand the list of invited people. Click on the Delete button represented as a cross icon right to the invited user email and close the pop-up.




Embed Metashape project


Embed code is a piece of an HTML code containing link to the project visualization and number of pre-configured parameters like frame size, embedding mode, autoplay and project's name appearance flags.


This code may be used to embed the project visualization into your personal or corporate web-site or any other web-resource supporting this feature.


There are two modes of project embedding available:

  • Presentation only - only project’s visualization and presentation will be available in the embedded project.
  • Full featured - project’s visualization , all tools and settings will be available in the embedded project. 


In both modes the project will appear with respect to the default point of view, workspace and scene settings, configured in the web-viewer. Later changes of those parameters change the way embedded projects appear.


To embed the project visualization into desired website:

  1. Select the Embed option in the project menu on My Projects page or in the top right corner of the project's visualization page.
  2. Configure the size, autoplay and project's name appearance settings.
  3. Copy the code corresponding to the desired embedding mode.
  4. Embed the code into the desired website.



Unpublish Metashape project


When you don't need to work with project visualization online, you may unpublish the project, so the tilesets for all processing results in the project will be deleted.


To unpublish the project:

  1. On My project page open project's context menu
  2. In the project's context menu select Unpublish option


Download Metashape project


To download Metashape project from the cloud:

  1. Start Metashape Professional
  2. Select Download project option from the Cloud submenu of the Files menu 

  3. In the Download project pop-up select desired project and click on the Ok button

  4. Select directory and optionally project's name and click on the Save button


If you also need to download project photos, do as follow:

  1. Start Metashape Professional
  2. Open an existing PSX project that has been previously uploaded into the cloud, for which you want to download photos
  3. In the Download photos pop-up select photos you need to download and download directory and click on the Ok button

  4. When downloaded, photos paths will be automatically updated.


Delete Metashape project

 

To delete the Metashape project from the cloud:

  1. On My project page open project's context menu
  2. In the project's context menu select Delete option
  3. In the pop-up appears confirm project deletion by clicking on the Delete button

Chunk


Chunk is a special case of a group, that is actually a named collection of published processing results, that inherits its name and content from the Metashape project.


In order to maintain the consistency between how you see the project in Metashape and in the cloud, renaming, reordering or unpublishing  of individual chunks is restricted.


Published processing result


Published processing result is a special case of dataset, and is actually a copy of particular processing result in a web optimized format that is called tileset.


In order to maintain the consistency between how you see the project in Metashape and in the cloud, renaming, reordering or unpublishing individual processing results is restricted.


List of processing results types:

  • Cameras
  • Tie Points
  • Dense Cloud 
  • DEM 
  • Orthomosaic 
  • 3D Model 
  • Tiled Model 


Document


Document is a processing log or a processing report, that is linked to the Metashape project processed in the cloud.


Processing log


Processing log is being generated during every processing in the cloud. Only the log for the last processing is stored in the cloud.


To download the processing log, click on the Download button located on the Processing log card on the project Files page.


Processing reports


Processing reports are being generated during every processing in the cloud for every chunk processed. 


To download the processing report, click on the Download button located on the Processing report card that you interested in on the project Files page.



Next steps


Subscribe to the official Agisoft Cloud channel in Telegram to get most recent news about the service: https://t.me/AgisoftCloud