.. include:: .special.rst Maps ---- When selecting the Maps Processing, a list of maps is shown as in :numref:`maps-list`. To start building a map, one can select the “New Map” option (the green button on the top right corner). This will create RGB or Multispectral pages to upload the due camera images, as shown in :numref:`rgb-page` and :numref:`multispectral-page`. .. figure:: ../_static/images/bexstream/maps.avif :name: maps-list :align: center :width: 50% List of maps page .. figure:: ../_static/images/bexstream/Imagem29.webp :name: rgb-page :align: center :width: 50% RGB page created .. figure:: ../_static/images/bexstream/Imagem30.webp :name: multispectral-page :align: center :width: 50% Multispectral page created In the next few steps, the option of creating an RGB map will be described: when RGB images are uploaded, 3 options available for the RGB page. These will appear on the right-hand side: 1. Select all to select all the next options (RGB and 3D options); 2. RGB to make the RGB map; 3. 3D option to create a 3D map. .. figure:: ../_static/images/bexstream/Imagem31.jpg :name: rgb-maps :align: center :width: 50% RGB page – map type selection process Pressing “Select all” option and clicking “Start Map” will start building the 2D and 3D RGB map. A progress bar informs the user about the status of the map creation. :numref:`rgb-done` shows the progress bar with a button to stop the current mapping process.. .. figure:: ../_static/images/bexstream/Imagem32.jpg :name: rgb-done :align: center :width: 50% Building an RGB map When the progress bar reaches 100%, it will show the results. This can be seen in :numref:`rgb-donee`. .. figure:: ../_static/images/bexstream/Imagem33.jpg :name: rgb-donee :align: center :width: 50% End of building map Back to the list of maps page, when maps are already created, four options are shown: .. figure:: ../_static/images/bexstream/Imagem34.webp :name: maps-list-id :align: center :width: 50% Map list page with zoom on a specific map id 1. Visualize the 2D map; 2. Download the results map images; 3. Edit the RGB or Multispectral page; 4. Delete the map id. When the first option is clicked, the 2D map indexes page is shown (:numref:`2d-map-indexes`). This page shows a timeline on the left-hand side with the list of all maps created nearby, chronologically ordered. It is possible to select more than one map to compare various indexes between different maps. .. figure:: ../_static/images/bexstream/2d_map.jpg :name: 2d-map-indexes :align: center :width: 50% 2D map indexes page The right-hand side displays a set of sliders, which allow the user to change the opacity of each index with the real-world map always in the background. There are also two buttons available in the bottom right corner of the page. When the button on the left is toggled, it’s possible to measure areas as shown in :numref:`2d-area`, just by clicking on the points that create the limits of the selected area. By clicking this button again, one can draw a new area, without discarding the previous one. .. figure:: ../_static/images/bexstream/2d_area_measurement.jpg :name: 2d-area :align: center :width: 50% 2D area measurement When selecting only one map on the left-hand side timeline, the user can enter the 3D view, by pressing the button on the right (bottom right side of the screen) and access the interface shown in :numref:`3d-map`. .. figure:: ../_static/images/bexstream/3d_map_page.jpg :name: 3d-map :align: center :width: 50% 3D map page In this page the user is shown an approximate 3D view of the map. It is also possible to measure areas and volumes as shown in :numref:`volume`. .. figure:: ../_static/images/bexstream/volume_map.webp :name: volume :align: center :width: 50% Volume measurement Working on 3D ============= Measurements ____________ From 3D pointclouds is possible to extract some measurements of distances and volumes, among others. From the left sidebar, within the menu `Tools`, there are some icons for `Measurement`. .. figure:: ../_static/images/bexstream/tools_menu.webp :name: measurement-tools :align: center :width: 50% Measurement Tools Menu :numref:`measurement-tools` highlights the `Tools` that will be further discussed. **1** Distance Measurement .......................... This tool allows for distance measurement from one point to another. After selecting it, the points are picked using the letf-click. For quitting the point selection, use the mouse right-click. .. figure:: ../_static/images/bexstream/distance_measurement.webp :name: measurement-distance :align: center :width: 100% Distance Measurement After selecting one or more points, the distance between consecutive points will be shown on a label, as depicted in :numref:`measurement-distance`. **2** Height Measurement .......................... This tool allows for measuring height differences of two points. In this mode, it displays the height difference after selecting 2 points, as shown in :numref:`measurement-height`. .. figure:: ../_static/images/bexstream/height_measurement.webp :name: measurement-height :align: center :width: 100% Height Measurement **3** Volume Measurement ......................... **NOTE:** This feature is under development and shall be used with caution. The volume measurement is done by placing a box within the pointcloud area. After placing its center on a valid point, the rotation and dimensions of the box can be adjusted using the interface controls shown in :numref:`measurement-volume-control`. .. figure:: ../_static/images/bexstream/volume_controls.webp :name: measurement-volume-control :align: center :width: 100% Volume Measurement Controls The total volume is shown on a label within the box (see :numref:`measurement-volume`). .. figure:: ../_static/images/bexstream/volume_measurement.webp :name: measurement-volume :align: center :width: 100% Volume Measurement In terms of visualization, the user can also highlight, or show only the content inside/outside the box. For that the box has to be first converted into a `Clip Volume` (see :numref:`measurement-volume-clip`). This can be done under the `Scene` menu, selecting the `Object` **Volume** and then enable the ``make clip volume`` option. Then, the desired visualization behavior of that volume (*None*, *Highlight*, *Inside*, *Outside*) is selected under the `Tools/Clip Task` menu. .. figure:: ../_static/images/bexstream/volume_clip.webp :name: measurement-volume-clip :align: center :width: 100% Volume Measurement Clip Inside **4** Height Profile ......................... It is also possible to analyze the height profile of a corridor. After entering the profile selection, the user has to select two or more points in order to be possible the height analysis (see :numref:`measurement-profile`). The selection process is similar to the distance measurement's. .. figure:: ../_static/images/bexstream/profile_measurement.webp :name: measurement-profile :align: center :width: 100% Height Profile Selection Under the *Scene*, some additional configuration can be done. Selecting the **Profile**, it is possible to configure its ``width`` (value in meters). For a closer analysis, clicking on ``show 2d profile`` opens a new window containing a 2D perspective of the profile (:numref:`measurement-profile-analysis`), that can be downloaded either in LAS or CSV format (top-right corner). .. figure:: ../_static/images/bexstream/profile_analysis.webp :name: measurement-profile-analysis :align: center :width: 100% Height Profile 2D Analysis Coloring ________ The pointcloud coloring is made by the RGBA values of the correspondent camera pixels by default (:numref:`coloring-rgba`). .. figure:: ../_static/images/bexstream/coloring_rgba.webp :name: coloring-rgba :align: center :width: 100% Pointcloud Coloring RGBA However, when this information is not present, the coloring is done taking into account the elevation of the points (:numref:`coloring-elevation`). .. figure:: ../_static/images/bexstream/coloring_elevation.webp :name: coloring-elevation :align: center :width: 100% Pointcloud Coloring Elevation This change of coloring schemes can also be manually forced. Going into the *Scene* menu, select the desired pointcloud, and then select the *Attribute* for coloring. Filters ________ There are some filters available to how only important part of the pointcloud. Those filters can be based on the classification of the points or on their source. The point source corresponds to a small set of concatenated scans for a closer and independent analysis. This filter is controller through the **first slider** in the *Filters/Point Source ID* menu (:numref:`filter-pointsourceid`). .. figure:: ../_static/images/bexstream/filter_pointsourceid.webp :name: filter-pointsourceid :align: center :width: 40% Filtering by point source ID Positioning ________ Georeferenced pointclouds display their location and relative positioning in the top-left corner, next to the sidebar (see :numref:`positioning`). .. figure:: ../_static/images/bexstream/positioning.webp :name: positioning :align: center :width: 100% Pointcloud geolocation