You will learn how to:


Create and edit vector layers


To prevent potential inconsistency between local and cloud project's versions shapes created in the project locally are not accessible in the cloud while the vector layers created in the cloud are not accessible locally because both objects are editable.


Create vector layer


To create a new vector layer left-click on the Add button in the Workspace pane on the left.


Edit vector layer


To select the layer left-click on it's name in the Workspace pane  on the left.


To change a vector layer name select it in the Workspace pane on the left, open Properties pane on the right and edit the name.

 

To change vector layer children geometries default color select it in the Workspace pane on the left, open Properties pane on the right and select the color. Note that when changing the vector layer color it will be applied to all children geometries.

 

To delete a vector layer select it in the  Workspace pane on the left then left-click on the Delete button next to its label  or press Delete key on the keyboard. Alternatively open the Properties pane on the right and left-click on the Delete button in the top right corner.


To undo vector layer deletion left-click on the Undo button appear on the bottom left side of the window.


Export vector layer


Geometries and its properties are saved in the vector layer, in case you need to use it in a third party application download the vector layer as .geojson file.


To download vector layer as .geojson file select it in the Workspace pane on the left, open Properties pane on the right and left-click on the Download button in the top right corner.


Draw points and measure positions


Draw point


To create a new point activate the Point tool by left-clicking on it's icon in the top right corner of the window and then click on the point of your interest in a 3D scene. When Point tool is activated, it is available to draw new points. To deactivate the Point tool left-click on it's icon in the top right corner of the user interface 


Edit point geometry and appearance


To select the point left-click on it's name in the Workspace pane on the left or left-click on it in a 3D scene.


To change a point name select it in the Workspace pane on the left or in a 3D scene, open Properties pane on the right and edit the name. Alternatively, double click on the point's name in the Workspace pane on the left and edit it's name.


To change point color select it in the Workspace pane on the left or in a 3D scene, open Properties pane on the right and select the desired color.


To change point position select it and drag in a 3D scene. 

 

To delete a point select it in the Workspace pane on the left or in a 3D scene and left-click on the Delete button or press Delete key on the keyboard. Alternatively select the point, open Properties pane on the right and left-click on the Delete button. 


To undo point deletion left-click on the Undo button appear on the bottom left side of the window.


To create a new property click on the empty property Name filed in the Additional properties block of the Properties pane on the right and input the property name, click on the property Value filed next to the Name field and input the property value, to save the property press Enter key on the keyboard or click on the checkmark icon, next to property Value field.


To edit the existing property, select the property's Name or Value field and edit it, changes are being saved automatically. 


To delete the property, left-click on the Delete button next to the property. To undo property deletion, left-click on the Undo button appear on the bottom left side of the window. 


Measure position


A WGS84 (EPSG::4326) coordinates of current mouse cursor position are available in Coordinates pane on the bottom of the page. 


In case you need to perform precise position measurement - activate the Point tool, draw the desired point and inspect it's WGS84 (EPSG::4326) coordinates in the General properties block of a Properties pane on the right.  Each time you change point position it's coordinates are re-calculated.


Point coordinates are saved in it's properties, in case you need to use them in a third party application you can copy them or download point as .geojson feature.


Export point


To copy point coordinates click on the Copy button on the top right corner of General properties block of the Properties pane on the right.


To download single point as .geojson file select it in the Workspace pane on the left or in a 3D scene, open Properties pane on the right and left-click on the Download button.




Draw polylines and measure length, horizontal length, slope and elevation difference.


Draw polyline


To create a new polyline activate the Polyline tool by left-clicking on it's icon in the top right corner of the user interface, then left-click in a 3D scene to draw polyline.  Right-click or press ESC to cancel drawing the polyline.  Left-click on the last vertex of polyline to finish drawing 


When the Polyline tool is active it is available to draw new polyline immediately after finishing the previous.


To deactivate the tool and stop drawing - left-click on the tool icon in the top right corner of the window.


Edit polylines


To select the polyline left-click on it's name in the Workspace pane on the left or left-click on it in a 3D scene. 


To change a polyline name select it in the Workspace pane on the left or in a 3D scene, open Properties pane on the right and edit the name. Alternatively, double click on the polyline's name in the Workspace pane on the left and edit it's name.


To change polyline color select it in the Workspace pane on the left or in a 3D scene, open Properties pane on the right and select the desired color.


To change polyline vertex position select it in a 3D scene and drag to desired position. 

 

To delete a polyline select it in the Workspace pane on the left or in a 3D scene and left-click on the Delete button  or press Delete key on the keyboard. Alternatively select the polyline, open Properties pane on the right and left-click on the Delete button. 


To undo polyline deletion left-click on the Undo button appear on the bottom left side of the window. 


To create a new property click on the empty property Name filed in the Additional properties block of the Properties pane on the right and input the property name, click on the property Value filed next to the Name field and input the property value, to save the property press Enter key on the keyboard or click on the checkmark icon, next to property Value field.


To edit the existing property, select the property's Name or Value field and edit it, changes are being saved automatically. 


To delete the property, left-click on the Delete button next to the property. To undo property deletion, left-click on the Undo button appear on the bottom left side of the window.


Measure length, horizontal length, slope and elevation difference


Each time you create a new polyline or change existing polyline vertices positions it's properties are calculated.  


Polyline properties:

  • Length - a sum of polyline edges length in a 3D space.
  • Horizontal length - a sum of polyline edges length projected onto the plane tangent to ellipsoid in a centroid of polyline vertices.
  • Slope - a slope in percentage between the first vertex and the last vertex of polyline, calculated as an elevation difference between the first vertex and the last vertex of the polyline divided by the horizontal distance first vertex and the last vertex of the polyline, multiplied by 100.   Wikipedia article for reference.
  • Elevation difference - a difference between elevation of the start point and the end point of polyline.


In case you only need to perform measurements but not to save the polyline - activate the Polyline tool, draw the desired polyline, inspect measurement results in the General properties block of a Properties pane on the right, and then right-click or press ESC instead of finishing drawing - the temporary polyline will not be saved into the vector layer.


Export polyline


To copy polyline properties click on the Copy button on the top right corner of the General properties block of Properties pane on the right.


To download single polyline as .geojson file select it in the Workspace pane on the left, open Properties pane on the right and left-click on the Download button. 



Draw polygons and measure area and perimeter

Draw polygon


To create a new polygon activate the Polygon tool by left-clicking on it's icon in the top right corner of the window, then  left-click in a 3D scene to draw polygon. Right-click or press ESC to cancel drawing the polygon. Left-click on the first vertex of polygon to finish drawing. 


When the Polygon  tool is active it is available to create draw new polygon immediately after finishing the previous.


To deactivate the Polygon tool  - deactivate the tool by left-clicking on it's icon in the top right corner of the window.


Edit polygon


To select the polygon left-click on it's name in the Workspace pane on the left or left-click on it in a 3D scene. 


To change a polygon name select it in the Workspace pane on the left or in a 3D scene, open Properties pane on the right and edit the name. Alternatively, double click on the polyline's name in the Workspace pane on the left and edit it's name.


To change polygon color select it in the Workspace pane on the left or in a 3D scene, open Properties pane on the right and select the desired color.


To change a polygon vertex position select it and drag in a 3D scene. 

 

To delete a polygon select it and left-click on the Delete button next to polygon label in the Workspace pane  or press Delete key on the keyboard. Alternatively select the polygon, open Properties pane on the right and left-click on the Delete button in the top right corner.


To undo polygon deletion left-click on the Undo button appear on the bottom left side in the user interface. 


To download single polygon as .geojson file select it in the Workspace pane on the left or in a 3D scene , open Properties pane on the right and left-click on the Download button in the top right corner. 


To create a new property click on the empty property Name filed in the Additional properties block of the Properties pane on the right and input the property name, click on the property Value filed next to the Name field and input the property value, to save the property press Enter key on the keyboard or click on the checkmark icon, next to property Value field.


To edit the existing property, select the property's Name or Value field and edit it, changes are being saved automatically. 


To delete the property, left-click on the Delete button next to the property. To undo property deletion, left-click on the Undo button appear on the bottom left side of the window.


Measure area and perimeter


Each time you create a new polygon or change existing polygon vertices positions its properties are calculated.  


Polygon properties:

  • Area 2D the area of polygon projected onto the plane tangent to ellipsoid in a centroid of polygon vertices. Most suitable to measure  an area of a land plots.
  • Areathe area of the polygon projected onto the plane best fitting the polygons vertices 3d positions. Most suitable  to measure an area of oblique surfaces like walls and roofs.
  • Perimeter 2D - a sum of polygon edges length projected onto the plane tangent to ellipsoid in a centroid of polygon  vertices. 
  • Perimeter 3D - a sum of polygon edges length in a 3D space .


In case you only need to perform measurements but not to save the polygon - activate the Polygon tool, draw the desired polygon, inspect measurement results in the General properties block of a Properties pane on the right, and then right-click or press ESC instead of finishing drawing - the temporary polygon will not be saved into the vector layer.


Export polygon


To copy polygon properties click on the Copy button on the top right corner of the General properties block of Properties pane on the right.


To download single polygon as .geojson file select it in the Workspace pane on the left, open Properties pane on the right and left-click on the Download button.



Measure stockpile & trench volume


Measure volume


Volume is calculated with a grid method based on terrain without taking into account point clouds and models. In case there are no digital elevation models in the project, the volume of global terrain bounded by the selected polygon is calculated. 


To measure stockpile or trench volume:

  1. Select existing polygon in the Workspace pane or in a 3D scene, or draw a new polygon bounding the stockpile or trench;
  2. Open Properties pane on the right and left click on the Add button next to the Volume block header;
  3. In the Volume widget select base plane and input cell side size value, in case of selecting Custom level as a base plane option, input the base level value.
  4. Click on the check mark on the bottom right corner of the Volume widget to start the calculation.


To get the most precise results set the cell side size value equal to the digital elevation model ground sample distance value.


Volume measurement results are being saved in the polygon's properties and may be exported as .geojson for further usage and analysis in a third party GIS or CAD applications.


In case the polygon's geometry is changed, volume measurement results are reseted and have to be recalculated in order to prevent misinterprentation.




Remeasure volume


To remeasure stockpile or trench volume with different parameters:

  1. Select polygon for which the volume has been calculated in the Workpsace pane or in a 3D scene;
  2. Open Properties pane on the right and left click on the Edit button next to the Volume block header;
  3. In the Volume widget change the base plane and cell side size value, in case of selecting Custom level as a base plane option, input the base level value.
  4. Click on the check mark on the bottom right corner of the Volume widget to start the calculation.


Select proper base plane


Five types of base planes for different cases are availalbe for volume calculation:


Best fit plane - a plane best fitting the polygon's vertices, plane is not parallel to the local east north plane. Best for measuring the volumes of stockpiles and trenches on non-flat ground;


Mean level - a plane parallel to the local east north plane located  on the altitude equal to the mean of polygon vertices altitudes. Best for measuring the volumes of stockpiles and trenches on the flat ground; 


Max level - a plane parallel to the local east north plane located on the altitude equal to the maximum of polygon vertices altitudes. Best for measuring volumes of trenches  on the flat ground up against a walls.   


Min level - a plane parallel to the local east north plane located on the altitude equal to the minimum of polygon vertices altitudes. Best for measuring volumes of stockpiles on the flat ground up against a walls. 


Custom level - a plane parallel to the local east north plane located on the altitude defined by user. Best for measuring volumes of stockpiles and trenches on flat ground when design level is known.


Understand the measurement algorithm


Volume is measured with the grid method. Three types of volume are calculated: volume above the base plane, volume below the base plane and total volume.


Volume above the base plane is a sum of volumes of grid cells where the terrain is above the base plane. 


Volume below the base plane is a sum of volumes of  grid cells where the terrain is below the base plane.


Total volume value is a difference betwen the above and below volumes.


For each cell of the grid, its volume is given by:


 


Where:


 - cell area;


 - cell height;


The area of the cell is given by:



Where:


- side of the cell;


The height of the cell is given by:


 


Where:


  - altitude of the cell center projected onto the most detailed terrain tile;


- altitude of the cell center projected onto the base plane; 


In case the height of the cell is positive its volume is added to the volume bellow the base plane.

Therefore, the volume above the base plane is given by:


 


In case the height of the cell is negative its volume absolute value is added to the volume below the base plane.

Therefore, the volume below the base plane is given by: 


 


Total volume is a difference of the volume above the base plane and the volume below the base plane.



Build elevation profile


Build profile


Elevation profile is built based on terrain without taking into account point clouds and models. In case there are no digital elevation modesl in the project, the elevation profile is built based on global terrain.


To build elevation profile:


  1. Select existing polyline in the Workpsace pane or in a 3D scene, or draw a new polyline;
  2. Open Properties pane on the right and left click on the Add button next to the Elevation Profile block header;
  3. In the Elevation Profile widget input the profile step value.
  4. Click on the check mark on the bottom right corner of the Elevation Profile widget to start the profile generation.


Generated profile is dispalyed in the polyline's properteis pane on the right, in order to open large profile pane click on the Expand button next to the Elevation profile block header. 


In case the polyline's geometry is changed, profiile is reseted  and have to be rebuilt in order to prevent misinterprentation.


Elevation profile is not saved between sessions of working with the project.


Rebuild profile


To rebuild elevation profile:

  1. Select polyline for which the profile has been generated in the Workpsace pane or in a 3D scene;
  2. Open Properties pane on the right and left click on the Edit button next to the Elevation Profile block header;
  3. In the Elevation Profile widget chnage the new profile step value.
  4. Click on the check mark on the bottom right corner of the Elevation Profile widget to start the profile regeneration.


Export profile


To export profile data:


  1. Select polyline for which the profile has been generated in the Workpsace pane or in a 3D scene;
  2. Open Properties pane on the right and left click on Export button.


Elevation profile data is exported as .csv file formated as:


Latitude    Longitude    Height    Distance from origin (meters)



Upload vector layer

Limitations


Currently only POINT, LINESTRING and POLYGON geojson features are supported. In case there are features: POSITION, MULTYPOINT, MULTYLINESTRING and MULTYPOLYGON in the .geojson file, those features will be uploaded into the cloud but not rendered in a 3D scene. When downloading a vector layer as a .geojson file, those features will be saved.


Upload tutorial


To upload a vector layer into the project left-click on the Upload button in the Workspace pane on the left - Upload dataset pop-up will appear.


In the Upload dataset pop-up click on the Browse button and select the .geojson file from your device file system, uploading will be started. 


In case your .geojson contains 2D geometries, it may take a while to upload and process the file because height values need to be sampled from terrain in order to display features properly. The restriction on single geometry size is equal to 256KB.


To cancel upload procedure, left click on the cross icon next to the layer name in the Workspace pane or select the layer in the Workspace pane, and click on the cross icon in the Properties pane on the right


When upload is finished, the vector layer will be saved in the project and available for viewing and editing.




Sample project


Here is an example of a project where you can try out all the features described in the article.




Next steps


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