This commit is contained in:
v-tea@microsoft.com 2019-09-16 12:36:15 -07:00 committed by GitHub
parent 2496434b32
commit 9eb199d21e
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -1,40 +1,38 @@
--- ---
title: Use HoloLens in New Spaces title: Mapping physical spaces with HoloLens
description: HoloLens learns what a space looks like over time. Users can facilitate this process by moving the HoloLens in certain ways through the space. description: HoloLens learns what a space looks like over time. Users can facilitate this process by moving the HoloLens in certain ways through the space.
ms.assetid: bd55ecd1-697a-4b09-8274-48d1499fcb0b ms.assetid: bd55ecd1-697a-4b09-8274-48d1499fcb0b
author: dorreneb author: dorreneb
ms.author: dobrown ms.author: dobrown
ms.date: 08/16/2019 ms.date: 09/16/2019
keywords: hololens, Windows Mixed Reality, design, spatial mapping, HoloLens, surface reconstruction, mesh, head tracking, mapping keywords: hololens, Windows Mixed Reality, design, spatial mapping, HoloLens, surface reconstruction, mesh, head tracking, mapping
ms.prod: hololens ms.prod: hololens
ms.sitesec: library ms.sitesec: library
ms.topic: article ms.topic: article
ms.localizationpriority: medium ms.localizationpriority: medium
appliesto: appliesto:
- HoloLens 1 - HoloLens 1 (1st gen)
- HoloLens 2 - HoloLens 2
--- ---
# Mapping physical spaces with HoloLens # Mapping physical spaces with HoloLens
HoloLens blends holograms with your physical world. To do that, HoloLens needs to learn about the physical world around you and remember where you place holograms within that space. HoloLens blends holograms with your physical world. To do that, HoloLens has to learn about the physical world around you and remember where you place holograms within that space.
Over time, the HoloLens builds up a *spatial map* of the environment that it has seen. HoloLens updates the map as the environment changes. Over time, the HoloLens builds up a *spatial map* of the environment that it has seen. HoloLens updates the map as the environment changes. As long as you are logged in and the device is turned on, HoloLens creates and updates your spatial maps. If you hold or wear the device with the cameras pointed at a space, the HoloLens tries to map the area. While the HoloLens learns a space naturally over time, there are ways in which you can help HoloLens map your space more quickly and efficiently.
HoloLens will create and update your spatial maps as long as the device is on and a user is logged in. If you hold or wear the device with the cameras pointed at a space, the device will try to map the area. While the HoloLens will learn a space naturally over time, there are tips and tricks available to map the space faster and more efficiently.
> [!NOTE] > [!NOTE]
> If your HoloLens cant map your space or is out of calibration, you may enter Limited mode. In Limited mode, you wont be able to place holograms in your surroundings. > If your HoloLens cant map your space or is out of calibration, HoloLens may enter Limited mode. In Limited mode, you wont be able to place holograms in your surroundings.
This article explains how HoloLens maps spaces, how to improve spatial mapping, and how to manage the spatial data HoloLens collects. This article explains how HoloLens maps spaces, how to improve spatial mapping, and how to manage the spatial data that HoloLens collects.
## Setting up and choosing your space ## Choosing and setting up and your space
Features in an environment can make it difficult for the HoloLens to interpret a space. Light levels, materials in the space, the layout of objects, and more can all affect how HoloLens maps an area. Features in your environment can make it difficult for the HoloLens to interpret a space. Light levels, materials in the space, the layout of objects, and more can all affect how HoloLens maps an area.
HoloLens works best in certain kinds of environments. For the best spatial map, choose a room with adequate light and plenty of space. Avoid dark spaces and rooms with a lot of dark, shiny, or translucent surfaces (for instance, mirrors or gauzy curtains). HoloLens works best in certain kinds of environments. To produce the best spatial map, choose a room that has adequate light and plenty of space. Avoid dark spaces and rooms that have a lot of dark, shiny, or translucent surfaces (for instance, mirrors or gauzy curtains).
HoloLens is optimized for indoor use. Spatial mapping also works best when Wi-Fi is turned on, though it doesn't have to be connected to a network. Wi-Fi access points are obtained without being connected or authenticated. It does not change functionality if the access points are internet connected or intranet/local only. HoloLens is optimized for indoor use. Spatial mapping also works best when Wi-Fi is turned on, although it doesn't have to be connected to a network. HoloLens can obtain Wi-Fi access points even if it is not connected or authenticated. HoloLens functionality does not change whether the access points are internet-connected or intranet/local only.
Only use HoloLens in safe places with no tripping hazards. [More on safety](https://support.microsoft.com/help/4023454/safety-information). Only use HoloLens in safe places with no tripping hazards. [More on safety](https://support.microsoft.com/help/4023454/safety-information).
@ -46,9 +44,7 @@ Here are guidelines for building a great spatial map.
### Understand the scenarios for the area ### Understand the scenarios for the area
It is important to spend the most time where you will be using the HoloLens so that the map is relevant and complete. It is important to spend the most time where you will be using the HoloLens, so that the map is relevant and complete. For example, if a user scenario for HoloLens involves moving from Point A to Point B, walk that path two to three times, looking in all directions as you move.
For example, if a user scenario for HoloLens involves moving from Point A to Point B, walk that path two to three times, looking in all directions as you move.
### Walk slowly around the space ### Walk slowly around the space
@ -66,7 +62,7 @@ Don't forget to look down at the floor as you map the space.
### Cover key areas multiple times ### Cover key areas multiple times
Moving through an area multiple times will help pick up features you may have missed on the first walkthrough. Try traversing an area two to three times to build an ideal map. Moving through an area multiple times will help pick up features you may have missed on the first walkthrough. To build an ideal map, try traversing an area two to three times.
If possible, while repeating these movements, spend time walking through an area in one direction, then turn around and walk back the way you came. If possible, while repeating these movements, spend time walking through an area in one direction, then turn around and walk back the way you came.
@ -83,37 +79,35 @@ Errors in spatial mapping data fall into one of three categories:
- *Wormholes*: HoloLens 'loses' part of the spatial map by thinking it is in a different part of the map than it actually is. - *Wormholes*: HoloLens 'loses' part of the spatial map by thinking it is in a different part of the map than it actually is.
- *Bias*: Surfaces in the spatial mapping data are imperfectly aligned with real-world surfaces, either pushed in or pulled out. - *Bias*: Surfaces in the spatial mapping data are imperfectly aligned with real-world surfaces, either pushed in or pulled out.
If you see any of these errors please file feedback via [FeedbackHub](hololens-feedback.md). If you see any of these errors please use the [FeedbackHub](hololens-feedback.md) to send feedback.
## Security and storage for spatial data ## Security and storage for spatial data
Windows 10 version 1803 update for Microsoft HoloLens and later store mapping data in a local (on-device) database. Windows 10 version 1803 update for Microsoft HoloLens and later stores mapping data in a local (on-device) database.
The map database is not exposed to a user of the device, even when plugged into a PC or when using the File Explorer app. When BitLocker is enabled, the stored map data is also encrypted with the entire volume. HoloLens users cannot directly access the map database, even when the device is plugged into a PC or when using the File Explorer app. When BitLocker is enabled on HoloLens, the stored map data is also encrypted along with the entire volume.
Holograms that are anchored within the same map section are considered to be “nearby” in the current space.
### Remove map data and known spaces from HoloLens ### Remove map data and known spaces from HoloLens
There are two options for deleting map data in **Settings > System > Holograms**: There are two options for deleting map data in **Settings > System > Holograms**:
- Select **Remove nearby holograms** to delete nearby holograms, clearing the map data and anchored holograms for the current space. A brand new map section would be created and stored in the database for that location while the device is used there. This option can be used to clear the map data for work without affecting any map data from home, for example. - To delete nearby holograms, select **Remove nearby holograms**. This command clears the map data and anchored holograms for the current space. If you continue to use the device in the same space, it creates and stores a brand new map section to replace the deleted information.
- Select **Remove all holograms** to delete all holograms, clearing all locally stored map data and anchored holograms. No holograms will be rediscovered and any holograms need to be newly placed.
> [!NOTE] > [!NOTE]
> When you remove nearby or all holograms, HoloLens immediately starts scanning and mapping the current space. > "Nearby" holograms are holograms that are anchored within the same map section in the current space.
For example, you can use this option to clear work-related map data without affecting any home-related map data.
- To delete all holograms, select **Remove all holograms**. This command clears all map data that is stored on the device as well as all anchored holograms. You will need to explicitly place any holograms. You will not be able to rediscover the previously-placed holograms.
> [!NOTE]
> After you remove nearby or all holograms, HoloLens immediately starts scanning and mapping the current space.
### Wi-Fi data in spatial maps ### Wi-Fi data in spatial maps
As long as Wi-Fi is enabled, map data will be correlated with nearby Wi-Fi access points. There is no difference in behavior if a network is connected or just nearby. Network characteristics are not sent to Microsoft, and all Wi-Fi references are kept local on the HoloLens. HoloLens stores Wi-Fi characteristics to help correlate hologram locations and map sections that are stored within the HoloLens database of known spaces. Information about Wi-Fi characteristics is not accessible to users, and not sent to Microsoft using the cloud or using telemetry.
Wi-Fi characteristics are stored locally to help correlate hologram locations and map sections stored within HoloLens database of known spaces. Its inaccessible to users, and not sent to Microsoft via the cloud or via telemetry. As long as Wi-Fi is enabled, HoloLens correlates map data with nearby Wi-Fi access points. There is no difference in behavior whether a network is connected or just detected nearby. If Wi-Fi is disabled, HoloLens still searches the space. However, HoloLens has to search more of the map data within the spaces database, and may need more time to find holograms. Without the Wi-Fi info, the HoloLens has to compare active scans to all hologram anchors and map sections that are stored on the device in order to locate the correct portion of the map.
If Wi-Fi is disabled, the space search can still happen; HoloLens will need to search more of the map data within the spaces database, and finding holograms can take longer.
HoloLens will sense and remember spaces even when Wi-Fi is disabled, by securely storing the sensor data when holograms are placed. Without the Wi-Fi info, the space and holograms may be slower to recognize at a later time, as the HoloLens needs to compare active scans to all hologram anchors and map sections stored on the device in order to locate the correct portion of the map.
HoloLens will visually compare the current scanning data from the sensors to locally stored map sections in the entire spaces database. It will locate holograms faster if the Wi-Fi characteristics can be found, to narrow down the number of spaces to compare.
## Related topics ## Related topics