2017 © geoscan version 1tutorial 2. exporting the tiled model from photoscan 11 tutorial 3....

2017 © GeoscanVersion 1.2

User manualSputnik GIS 1.2

2017 © Geoscanwww.geoscan.aero

Table of ContentsOverview 4

Operating system and hardware requirements 5

Installation 5

Interface 6

Navigation 7

Hotkeys 7

License key activation 8

Tutorials 9

Tutorial 1. Exporting the ortophoto and DEM 9

Tutorial 2. Exporting the tiled Model from PhotoScan 11

Tutorial 3. Creating a new project and importing the data 12

Tutorial 4. Exporting a tiled Model to Sputnik GIS 15

Tutorial 5. Basic measurement tools 16

Tutorial 6. Measuring volume and volume difference 18

Tutorial 7. Contours, cross sections and slope maps 23

Tutorial 8. Kriging interpolation 32

Tutorial 9.1 Basic KML geometry editing 35

Tutorial 9.2 Advanced KML geometry editing 40

Tutorial 10. Load WMS data layers 42

Tutorial 11. Exporting the PhotoScan project 44

Tutorial 12. Creating high resolution screenshots 46

Tutorial 13. Interaction of multiple tools 47

Troubleshooting 52

Installation errors 52

Startup errors 52

Runtime errors 53

If you have any comments and recommendations on Sputnik GIS please e-mail us:[email protected]

Sputnik GIS is a multidimensional spatial data visualization system. Orthophotos and digital elevation models created with Agisoft PhotoScan Professional can be imported into Sputnik GIS for further analysis using wide range of tools: length, height and volume measurements, cross sections generation and kriging interpolation.

Using Sputnik GIS you can import orthophoto and DEM without any limitations of the file size, coverage area, etc. The Basic Landsat, OpenStreetMap, Bing and SRTM coverage provide unified working space for all users’ datasets. The support of OGC standards such as WMS, WFS and KML allows to link Sputnik GIS to the external GIS servers.

KML is the most often used Sputnik GIS data format. It is possible to virtually load any data, including 3D models, spherical panoramas and various real time sensors data into Sputnik GIS using KML.

This manual contains instructions on software installation and startup, description of application interface and basic tutorials on common workflows.

Overview

4

mailto:sputnik%40geoscan.aero?subject=Sputnik%20GIS%20TechSupport

Installation

— Windows 7, 8, 10 (64-bit)

— CPU: Intel Core i3/i5/i7 and better

— 1 Gb free HDD space

— 4 Gb RAM

— Graphic card: Nvidia, AMD, Intel HD 4000 and newer, 1 Gb VRAM, OpenGL 2.1 support

Operating system and hardware requirements

5

— Run Sputnik GIS installation package (administrator privileges are required)

— Follow the onscreen intructions to complete the setup

— After installation is finished, KML, KMZ and TLS files will be associated with Sputnik GIS

— To start the application choose Start > Sputnik

In case any errors appear during installation or startup of Sputink GIS, move to «Troubleshooting» section.

InterfaceUser menu

Toolbar

Search and Basemap

Layers and Objects

Properties 3D Map

Default basemap used in Sputnik GIS is Landsat imagery combined with SRTM elevation model

6

NavigationScaling (zoom in/zoom out)

Moving (globe rotation around its center)

Clockwise / Counterclockwise rotation (globe rotation around the point on its surface)

Changing the vertical angle of the view (globe rotation around the point on its surface)

Reset view to north- up

Reset angle to top-down view and rotate map to north-up view

Hotkeys

7

License key activation

Online activation is required for the purchased Sputnik GIS license key.

Sputnik GIS sends an automated request to the license server to activate the licence key. If the activation is successfull, the confirmation message appears - «Permanent licence activated»

In case an error message appears or the PC has no internet connection, Offline Activation is required (see Administrator manual).

- Check whether the internet connection is working properly

- Launch Sputnik GIS, select Help - Activation...

- Paste the license key and press «Activate»

8

Open the project file: PSZ for Agisoft PhotoScan 1.1.9 and older, PSX for version 1.2.0 and newer. Run File > Export orthomosaic > Export Google KMZ...

By default, all the parameters are set to create the highest resolution orthomosaic, but you can replace it with lower values if needed. After you have set the parameters, press «Export...»

Tutorial 1. Exporting the ortophoto and DEM

Orthomosaic can be viewed in geobrowsers that support KML data, for instance Google Earth.

Tutorials

9

Download example dataset https://geoscan.aero/datasets

Or use your own data

Next select File > Export DEM > Export Sputnik KMZ...

Set export parameters and press «Export...» button

Starting with version 1.2.0, Agisoft PhotoScan can export GeoTIFF with internal image pyramids for optimal software performance.

10

Open the PhotoScan project file. Select File > Export Tiled Model...

Tiled model is a special data format, supported by Sputnik GIS. This data format helps to achieve the best performance for cities and stand-alone buildings visualization.

Level of details increases as the camera approaches an object, so the performance stays optimal both for PC and mobile devices.

It is possible to view TLS either in Sputnik GIS or using Sputnik Web service.

Tutorial 2. Exporting the tiled Model from PhotoScan

Select a path to save TLS file in the dialog box that appeared

11

Download example datasethttps://geoscan.aero/datasets


https://sputnik.geoscan.aero/

Use the data created in Tutorial 1

Or download example datasethttps://geoscan.aero/datasets


Tutorial 3. Creating a new project and importing the data

12

Working with different datasets can be simplified by switching between Sputnik GIS projects. Every project automatically stores a set of parameters:

- A list of maps and drawings, loaded by the user;

- Last position of the 3D Map window camera;

- Location, visibility and size of UI objects.

Only one project can be opened at a time. Settings switch when a new project is opened.

Select File - New - Project... to create a new project, then enter a name in the dialog box that appears.

Select File - Open - Project... to open a project or choose one of the recent projects using File - Recent projects

To add orthomosaic to Sputnik GIS project select File > Open > File…

Orthomosaic is aligned with default SRTM elevation model. SRTM terrain data has 90 m spatial resolution and vertical accuracy about 1 m. Level of details can be increased by loading а local DEM.

Use checkboxes in the «Layers and Objects» list to turn layers visibility on and off.

Load the DEM the same way you have loaded the orthomosaic

Now you may see the model from above or from the ground level and analyze it using the tools of Sputnik GIS

13

«avtodor_dem1» is displayed in the 3D Map window. To see «avtodor_dem0» you need to move «avtodor_dem1» above by one level.

Now you can see «avtodor_dem0», because its position in the list is lower than «avtodor_dem1».

DEM and orthomosaics at the bottom of the «Layers and Objects» list display above the layers at top.

14




It is posssible to optimize default elevation alignment using «Hide elevation model under the map» option

Tiled Model is aligned with default SRTM elevation model

To open Tiled Model (TLS data format) select File > Open > File…

Tutorial 4. Exporting a tiled Model to Sputnik GIS

15

Tutorial 5. Basic measurement tools

Activate the tool, then select two points on the surface to measure the distance between them.

«Corner ruler» tool displays slope, horizontal distance, actual distance and elevation between two points located on an orthomosaic / DEM / tiled model.

It is possible to change the position of the selected point. Click once at a point, then move it by the surface.

To use «Corner ruler» select two points on the surface of the model.

«Ruler» tool displays distance between two points located on an orthomosaic / DEM / Tiled Model.

16




«Area» tool displays surface area of a polygon, located on the orthomosaic / DEM / tiled model.

Launch tool, then select three or more points on the surface

It is possible to save the polygon to KML file and load it again to get the measured value of an area. Click on the Default.kml item from the «Layers and Objects» list using the right mouse button and select «Save as…».

Depending on the area measured, the result can be displayed in square meters, hectares or square kilometers. Area can be calculated on a plane or DEM surface.

Next, after the KML file opens, use «Information» tool to display the area value.

17

Tutorial 6. Measuring volume and volume difference

«Volume» tool calculates the volume of an area of DEM.

Start «Volume» tool, by clicking «Volume» button, and select a polygon to measure the volume.

In case there is only one DEM in the «Layers and Objects» list, Sputnik GIS use that DEM for measurements. Otherwise it is necessary to drag and drop selected DEM from «Maps» folder to «Measurements» - «Volume» object

18




If the reference level is known, select «from level» option and enter the value. Otherwise select «from perimeter triangulation».

To reset measurement results delete all data of Default.kml and close it, then remove «Fill / Cut» from «Measurements» folder of «Layers and Objects» list.

Press «Calculate» button. After the calculation is finished, Fill and Cut volumes appear in the corresponding fields.

19

The «Volume difference» tool calculates the difference between two DEMs of the similar area, captured with a time interval. It is possible to calculate cut and fill volumes and highlight the areas that have changed.

Run the tool by pressing the button on the toolbar and then select a polygon to measure the volume difference. Select Initial DEM by moving it from «Maps» folder to «Measurements - Volume difference»

Select the Final DEM the same way

20

Press «Calculate» button when setup is finished.

Some parameters can be set before the calculation begins.

- Difference threshold (altitude difference between one point of two different DEMs to be included into calculation);

- Set calculation step or turn «best» on;

The less the values of the calculation step and the difference theshold, the more time needed to finish the calculation.

21

After calculation is finished you can see the result in the «Fill» and «Cut» fields.

To reset measurement results delete all data of Default.kml and delta.kml and close it, then remove «Volume difference» from «Measurements» folder of «Layers and Objects» list.

In case you have checked «Compute polygons», cut (blue) and fill (red) areas is highlighted

22

Tutorial 7. Contours, cross sections and slope maps

Select Tools > Contour lines. Create the polygon to build contour lines within it. Set a value of contour interval (elevation between neighbor contour lines) and DEM resolution (distance between neighbor points in a contour line).

«Contour lines» tool displays lines, which connect points with similar elevation values.

Performance tip: the greater the surface area you have selected, the greater the values of contour interval and DEM resolution should be to keep optimal calculation performance

23




It is possible to save calculated contour lines to KML file and display them again. Click the right mouse button at the Default.kml item of «Layers and Objects» list and select «Save As…».

To reset measurement results delete all data of Default.kml and close it, then remove «Contour lines» from «Measurements» folder of «Layers and Objects» list.

24

Select Tools > Sections > Cross section. Define the base line of the cross section by clicking on the surface.

Press the «Calculate» button to start the cross section generation. Select the folder and the filename in the appeared window.DXF file opens automatically in a new window.

«Cross section» tool generates a DXF drawing suitable for cross profiles analysis.

The smaller the calculation step, the greater amount of time needed to complete calculation

It is possible to change position and zoom of the drawing within the window.

25

Select Tools > Sections > Cross sections. Define the base line, the cross sections are generated perpendicular to it.

Set calculation step (minimal distance between neighbor points of a profile line), distance between the sections and section width, then press «Calculate» to start the cross sections generation.

«Cross sections» tool generates custom sets of DXF drawings, aligned along a line.

Each section aligns to the left and to the right of the baseline by half of the section width value

26

Select the folder and the filename mask in the appeared window.

All the cross section appears in the Files folder (Layers and Objects pane). To view the DXF drawings, double click any DXF element in the Files folder.

It is possible to change position and zoom of the drawing within the window.

27

Select Tools > Sections > Compare sections. Select two or more points on the surface of the DEM.

«Сompare sections» tool generates a DXF drawing for cross profiles comparsion.

After calculation is completed, DXF file opens automatically in a new window

28

Set calculation step (minimal distance between neighbor points of a profile line), then press «Calculate» to start the cross sections generation.

Select Tools > Sections > Compare cross sections. Define the base line, the cross sections are generated perpendicular to it.

Set calculation step (minimal distance between neighbor points of a profile line), distance between the sections and section width, then press «Calculate» to start the cross sections generation.

Select two or more DEMs and the path for saving DXF files in the dialog box that appears.

«Сompare cross sections» tool generates series of DXF drawings of two or more DEMs located in the same area.

To view the DXF drawings, double click any DXF element in the Files folder

29

«Calculate slope map» tool creates a slope map for the selected area of the DEM.

30

It is possible to add slope values and select the colors using the editor in the Properties window

Select Tools - Calculate slope map. Select two or more points on the surface of the DEM. Color scheme should be selected before catculation starts.

After settings are finished press Calculate. Select DEM for calculation, output data type (KML and/or TIF) and the path to save files in the dialog box that appears.

Slope maps display in the 3D Map window after calculation is finished

31

Tutorial 8. Kriging interpolation

«Kriging interpolation» tool performs transformation of digital surface models into digital terrain models.

Select File > New > KML... and place the points using «Create Point» button, which is showed automatically after a new KML file is created. Build a dense grid of points near to a pile, but do not include the pile itself.

In this example kriging interpolation is used for calculation of estimated elevation values under a pile

32




Drag KML file with a grid of points from «Maps» folder to the «Kriging» object of the «Measurements» layer

Select Tools > Kriging interpolation. Create a polygon to perform kriging interpolation within it.

Next, you can setup Kriging parameters and select DSM to transform its selected area into DTM.

33

Save dialog box appears for the TIF file after you press «Calculate» button. This file contains a GeoTIFF DTM for an area you have selected. Choose a path and press «Save».

After calculation is completed, DTM automatically appears in the “Map” window and “Layers and Objects” list

To reset measurement results delete all data of Default.kml and close it, then remove «Kriging» from «Measurements» folder of «Layers and Objects» list and close GeoTIFF file.

34

Sputnik GIS allows to perform basic edit operations for KML/KMZ files.

Select File > New > KML... to create a new KML file. A set of specific tools appears.

Create Polygon

Create Ring

Create Line

Create Point

Tutorial 9.1 Basic KML geometry editing

Default Polygon and Line styles are automatically created during the first geometry element creation.

35

Cut holes in the polygon

To edit geometry objects:

- Click once at a vertex or point (the vertex color changes from blue to orange)

- Move it while holding the left mouse button down.

- Open the file

- Click the right mouse button on its name in the «Layers and Objects» list

- Select «Edit coordinates»

To edit the KML file you have created:

36

- Change coordinates values for points and vertices

- Change altitude values for all points simultaneously

- Switch coordinates appearance: WGS84 (degrees), WGS84 (deg. min., sec.) and SK42 (Pulkovo 1942, metres).

Using coordinate editor you can:

Shapes can either be attached to the surface or be above it.

Sputnik GIS tools allow to draw 2D and 3D geomerty objects.

clampToGround / clampToSeaFloor – points are attached to the surface, altitude values are ignored.

relativeToGround / relativeToSeaFloor – altitude values are relative to the surface elevation.

absolute – altitude values are elevation above sea level.37

Switch altitudeMode to relativeToGround mode and press Enter

Now all points have altitude values equal to 10 m, they are shown at a relative altitude above the ground.

Default mode is clampToGround

Altitude values are relative to the surface in this mode

38

Next, switch altitudeMode to absolute mode and press Enter

To create 3D geometry objects (only available in absolute or relativeToGround mode) switch extrude mode to true

Altitudes are now absolute, or, in other words, relative to sea level

2D polygon become 3D shape

39

Tutorial 9.2 Advanced KML geometry editing

Sputnik GIS has a wide range of tools to convert between different types of geometry and perform boolean operations on two or more polygons.

Select two or more polygons in the «Layers and Objects» window or in the 3D map window, then call the context menu by clicking right mouse button. You can perform the following operations:

Union – polygons dissolve into one polygon or, if there are no common points, become a multigeometry feature.

Intersect - only the common points are copied to the resulting polygon(s).

Difference – the common points of the polygon(s) are subtracted from the first selected polygon.

Symmetrical difference – only the non-common points are copied to the resulting polygon(s).40

It is possible to transform geometry objects from one type to another:

Select two or more objects in the «Layers and Objects» window or in the 3D map window, then press the right mouse button. All available transformation options are displayed.

from points from line from ring from polygon

Create points • + + +

Create line + • - -

Create ring + + • +

Create polygon + + + •

41

Tutorial 10. Load WMS data layers

Sputnik GIS, in addition to Landsat, Bing and OpenStreetMap coverage, can load number of free available maps using WMS. It is necessary to connect to the internet before you start the tutorial.

Run File> Import >WMS... Select appopriate WMS server, for instance: http://geoint.lmic.state.mn.us/cgi-bin/wmsll

42

Press «Next»:

Select a layer in the left pane. You can select two or more layers by pressing Ctrl button while clicking. Press «>» button to move layers to Selected Layers, then press «Finish».

Finally you can see the selected layers in the “Layers and Objects” pane and 3D Map window.

43

Tutorial 11. Exporting the PhotoScan project

It is possible to view and analize UAV telemetry files and convert them to Agisoft PhotoScan projects using Sputnik GIS.

Select File > Open > File..., then choose *.txt, *.tel file format in the scroll pane of the window, then select the file.

Run «Rectangular selection» tool and select photos you are planning to include in the project.

44

Download example datasethttps://geoscan.aero/datasets


Run «Create PhotoScan project» tool. Finally, select a path to save the PhotoScan PSZ project. It is also possible to immediately open the project using PhotoScan after the file is saved.

45

46

Tutorial 12. Creating high resolution screenshots

Sputnik GIS has a tool to generate high resolution screenshots of 3D Map window, perfect for high-quality printing.

Select View > Screenshot. Use predefined options or select «Custom size»

Press «Take screenshot» to launch the tool and select a path to save the image.

Preset you have created can be launched via Screenshot menu again.

Tutorial 13. Interaction of multiple tools

This example shows successive interaction of multiple tools in GIS Sputnik. As a result the text file with coordinates XYZ will be transformed to a TIN DXF model.

Open the file Quarry-Ortho.kmz from the data set. Create a new KML file by selecting File-Create-KML..

Activate the tool “Create line”. In the KML window click on the created line using the right mouse button and select “Change coordinates”. Open the file pointsKr.xyz from the data set and copy the coordinates value to the coordinate Editor.

47

Download example dataset:https://geoscan.aero/datasets


Finish creating the line by clicking the bottom “Create Line” and close the KML editor.

For using the line in Kriging interpolation you should split it in periods. In the “Layers and Objects” window click the object LineString using the right mouse button and select “Split in periods” option from the menu.

Close the coordinates Editor and change the altitude mode to absolute: altitudeMode – absolute.

48

In the appeared window switch off the function “Add to current file” and choose a path to the new KLM file. After the conversion is completed close the KML file with the line.

Select “Kriging interpolation” from the “Tools” menu and create area by selecting points on the surface. Than drag the KML file containing the points from the “Maps” window in “Measurements – Kriging” into the “Layers and Objects” window.

Set the size of the output cell (resolution created by DEM) and click “Calculate”.

49

An alternative way of using Kriging interpolation – transforming the digital surface model (DSM) into a digital elevation model (DEM) described in Tutorial 8.

DEM in GeoTIFF or Sputnik KMZ format could be converted into a TIN (Triangulated Irregular Network) model and exported in DXF format, which is compatible with the majority of CAD software.

In the “Tools” menu select “Calculate TIN model”. In the “Layers and Objects” window drag the area, that was created in the first stage of the Kriging interpolation from the file Default.kml from “Maps – Measurements – Tin Model”. In the “Properties” window select DEM or drag it from “Maps”. Select the allowed level of accuracy for simplification of the model and click “Create”.

The created DEM is suitable for working with the following tools in GIS Sputnik: measurement of distance, altitude, area, volume, creating profiles.

50

In the appeared window select a path to the DXF file, where the calculation results will be stored.

After the calculation is completed the TIN model is can be seen in a separate window.

51

Installation errors

In case the error appears:

- Abort the installation

- Check whether you have sufficient level of administrator privileges

- Run installation again

The most probable cause of errors that appear during Sputnik GIS installation is a lack of administrator privileges.

Troubleshooting

Startup errors occur because of licencing issues.

Startup errors

- Check whether hardware key (USB dongle) is installed properly on the local PC or on the Licence Server

- If a software key is used, check if the HASP driver is installed properly.

52

Runtime errors

Two types of errors can occur during runtime:

Check the validity of the data you have entered and run the process again.

In this case please write a short message to describe a sequence of actions performed before the error has appeared.

- Handled exceptons appear in the bottom right part of 3D Map window.

- Unhandled exceptions appear in a separate window

53

Select Help > About...

Press «Logs» button. Find the «.log» file in the folder. Send us the file and the message you have written before to the e-mail [email protected]

It will take some time to analize your report and to update Sputnik GIS.

We appreciate your help. You are helping us to make Sputnik GIS perfect!

54

mailto:sputnik%40geoscan.aero?subject=Sputnik%20GIS%20Tech%20Support

2017 © geoscan version 1tutorial 2. exporting the tiled model from photoscan 11 tutorial 3....

Documents