Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
en:help:v2:orientation [2016/05/22 12:04] alpinequesten:help:v2:orientation [2018/03/06 20:57] alpinequest
Line 1: Line 1:
-<sub>[[en:help|Online Help]] > [[en:help:v2|AlpineQuest 2.x]]</sub>+<sub>[[en:help|Online Help]] > [[en:help:v2|AlpineQuest 2.x]] > Orientation & Compass</sub> 
 ====== Orientation & Compass ====== ====== Orientation & Compass ======
 +\\
 +The compass feature uses the magnetic sensor of your device (if available) to give you orientation information.
  
-The compass feature uses the magnetic sensor of your device (if available) to give you helpful orientation information.+To turn on the compass, you can either: 
 +  * Long-press the ''"**Compass**"'' {{:icon_01.png?nolink}} menu icon; 
 +  * Tap the sub-menu toggle {{:icon_03.png?nolink}}.
  
-This feature is composed of a sub-menu providing a fast access to few controls and settings, and a dedicated window with more details and information.+{{ :en:help:v2:orientation:submenu.jpg?nolink}}
  
-{{ :en:help:1.4:orientation:submenu.jpg?nolink}}+The ''"**Compass**"'' {{:icon_01.png?nolink}} menu icon color lets you know the current state: 
 +  * When the icon is white, the ''"**Compass**"'' is turned off. Long-press the button to turn it on; 
 +  * When the icon is green, the ''"**Compass**"'' is turned on. Long-press the button to turn it off.
  
-To turn on the compass feature, you can either: +\\
-  * Long-press the "**''Compass''**" menu button {{:icon_01.png?nolink}}; +
-  * Click on the sub-menu toggle {{:icon_03.png?nolink}}.+
  
 +===== The compass menu =====
 +\\
 +Tap on the "''**Compass**''" {{:icon_01.png?nolink}} menu button to display the compass menu, containing the following items:
 +  * The "''**Compass**''" {{:icon_02.png?nolink}} button opens the compass details window;
 +  * The "''**Compass toggle**''" {{:icon_03.png?nolink}} lets you turn on or off the compass easily;
 +  * The "''**Rotate the map (using compass)**''" {{:icon_04.png?nolink}} check-box controls either or not to rotate the map based on the compass north to match the real direction you are looking at;
 +  * The "''**Display compass on the map**''" {{:icon_05.png?nolink}} check-box controls either or not to display a compass {{:icon_08.png?nolink}} on the map;
 +  * The "''**Current heading**''" {{:icon_06.png?nolink}} check-box controls either or not to display an information box {{:icon_07.png?nolink}} on the map with your current heading.
  
-===== The sub-menu =====+{{:icon_help.png?nolink}} You can un-check both "''**Rotate the map (using compass)**''" {{:icon_04.png?nolink}} and "''**Display compass on the map**''" {{:icon_05.png?nolink}} check-boxes to display a small current heading arrow {{:icon_09.png?nolink}}.
  
-Click on the "''**Compass**''" {{:icon_01.png?nolink}} menu button to display the sub-menu, composed of the following items: +{{ :en:help:v2:orientation:on-map-orientation.jpg?nolink }}
-  * The "**''Compass details''**" {{:icon_02.png?nolink}} button opens the compass details window; +
-  * The "**''Compass toggle''**" {{:icon_03.png?nolink}} lets you turn on or off the compass feature easily; +
-  * The "**''Display compass''**" {{:icon_04.png?nolink}} check-box controls either or not to display a compass {{:icon_08.png?nolink}} on the map; +
-  * The "**''Rotate the map''**" {{:icon_05.png?nolink}} check-box controls either or not to rotate the map based on the compass north to match the real direction you are looking at; +
-  * The "**''Current heading''**" {{:icon_06.png?nolink}} check-box controls either or not to display an information box {{:icon_07.png?nolink}} on the map with your current heading.+
  
-{{:icon_help.png?nolink}} You can un-check both "**''Display compass''**" and "**''Rotate the map''**" check-boxes to display a small current heading arrow {{:icon_09.png?nolink}}.+\\
  
-{{ :en:help:1.4:orientation:on-map-items.jpg?nolink }}+===== The compass view ===== 
 +{{ :en:help:v2:orientation:compass-view.jpg?nolink}} 
 +\\ 
 +The ''"**compass view**"'' gives you the following information: 
 +  * The ''"**direction to the north**"'', pointed by a red arrow {{:icon_01.png?nolink}}. 
 +  * The ''"**precise heading**"'' arrow {{:icon_02.png?nolink}}, when this one is between -20° and +20°, including mils graduation; 
 +  * A ''"**pitch and roll**"'' level {{:icon_03.png?nolink}}, helping you to keep the device flat; 
 +  * The ''"**magnetic declination**"'' at your current location {{:icon_04.png?nolink}}, see below for more details; 
 +  * The ''"**direction to the target**"'', pointed by a green arrow {{:icon_05.png?nolink}}, if a location is set as target.
  
 +\\
  
-===== The menu icon =====+==== Magnetic declination ==== 
 +\\ 
 +A magnetic compass points the ''"**magnetic north**"'' (the top direction of the magnetic field) which is different from the ''"**true north**"'' (the top direction of the map, also called ''"**geographic north**"'' or ''"**map north**"'').
  
-The "''**Compass**''" menu button {{:icon_01.png?nolink}} color lets you know the current state:+In order to give you the direction of the true north, the application tries to compute the ''"**magnetic declination**"'' {{:icon_04.png?nolink}} (also called ''"**magnetic variation**"''), which is the angle difference between the magnetic north and the true north, at your current location. It's usually just a few degrees, but may be more if you're close from a pole.
  
-{{:en:help:1.4:orientation:menu-off.jpg?nolink}} When the icon is white, the "''**Compass**''" is turned offLong-press the button to turn it on.+To compute this value, the application needs to know your physical locationIt will first try to use the GPS location or the network based location if availableotherwise it will use the location displayed at the center of the mapWhen turning on the compass, be sure to points the map over your approximate current location to get a correct declination, in case your GPS location is not known.
  
-{{:en:help:1.4:orientation:menu-on.jpg?nolink}} When the icon is green, the "''**Compass**''" is turned on. Long-press the button to turn it off.+\\
  
 +===== The compass settings =====
 +\\
 +By default, the compass has a moving rose and graduations (the ''"**Topochaix**"'' style). You can change it to a moving needle with still graduations {{:icon_04.png?nolink}}:
 +  * Tap on the ''"**Settings**"'' {{:icon_01.png?nolink}} icon to open the settings dialog;
 +  * Tap on the style list {{:icon_02.png?nolink}} and select ''"**Standard**"'';
 +  * Tap on ''"**Ok**"'' {{:icon_03.png?nolink}}.
  
-===== The details window =====+If you need the magnetic north direction instead of the true north, or if you believe that your device already applies the declination offset {{:icon_05.png?nolink}}, you can turn this computation off: 
 +  * Tap on the ''"**Settings**"'' {{:icon_01.png?nolink}} icon to open the settings dialog; 
 +  * Un-check ''"**Compute declination to get true north**"'' {{:icon_06.png?nolink}}; 
 +  * Tap on ''"**Ok**"'' {{:icon_03.png?nolink}}.
  
-{{ :en:help:1.4:orientation:compass_view.jpg?nolink}}+{{ :en:help:v2:orientation:settings.jpg?nolink }}
  
 +\\
  
-==== Compass view ====+===== Problems with the compass =====
  
-The "**''compass view''**" {{:icon_01.png?nolink}} is graphical representation of the true (geographic) north direction, pointed by the red arrow.+==== Compass won't turn on ==== 
 +{{ :en:help:v2:orientation:sensor-error.jpg?nolink}} 
 +\\ 
 +If you can't turn the compass on, it means that your device doesn't have magnetic sensor built in, which is required to get the direction of the north. Recent versions confirm it by displaying this message when trying to turn on the compass:
  
-It also gives you the following information: +Note that you can still use the map rotation using the GPS (if available), from the GPS Location menu.
-  * The **precise heading** arrow {{:icon_02.png?nolink}}, when this one is between -20° and +20°, including mils graduation; +
-  * The **heading** value {{:icon_03.png?nolink}}, which is the angle between the geographic north and the current direction you are looking at (the direction of your device)+
-  * A **pitch and roll** level {{:icon_04.png?nolink}}helping you to keep the device flat; +
-  * The **magnetic declination** at your current location {{:icon_05.png?nolink}}, which is the difference between the magnetic north and the geographic north. The application uses either the last known location of your device if any, or the screen center location. This value is computed each time you activate the compass.+
  
 +\\
  
-==== Target and navigation ====+==== Compass gives incorrect direction ==== 
 +\\ 
 +When using the application compass (just like with mechanical compass), be sure to handle your device in the horizontal position, the screen looking up.
  
-When a location is set as target, the compass view can be used as a navigation tool, and the following information is given:+\\
  
-  * The **name** {{:icon_01.png?nolink}} of the targetif any; +=== Compass need to be calibrated === 
-  * The **direction** {{:icon_02.png?nolink}} of the target, from your current location, pointed by a green arrow+\\ 
-  * The **absolute bearing** {{:icon_03.png?nolink}} of the target, which is the angle between the geographic north and the target, at your current location+When you get wrong directions from the compassyou usually just need to calibrate the magnetic sensor. This is fast and easy: 
-  * The **distance** {{:icon_04.png?nolink}} of the target, from your current location.+  * Turn on the compass
 +  * Turn your device in the air in all directions
 +  * Done! 
 +{{ :en:help:v2:orientation:problems-declination.jpg?nolink}} 
 +\\
  
-{{:icon_help.png?nolink}} All these figures are computed from the map center location. Be sure that it's correctly located on your current location, either by moving the map manually or by locking the GPS location on it.+=== Wrong magnetic declination === 
 +\\ 
 +If calibrating the compass doesn't help, or if you see a strange constant offset in the direction, check the magnetic declination {{:icon_01.png?nolink}}. As explained above, the application needs to know your approximate current location to compute a valid magnetic declinationMost of the time you just need to be sure that the map points your current location to fix your problem.
  
-When you move towards one direction, be sure to orientate your device correctly so that the **lubber line** {{:icon_05.png?nolink}} matches your forward direction. In this case: +If you still believe the computed declination is incorrect or already applied by your deviceyou can turn off this computation as explained in the settings sections.
-  * The azimuth value displayed under the lubber line is your **heading** {{:icon_06.png?nolink}}; +
-  * The **relative bearing** {{:icon_07.png?nolink}} of the target is displayedwhich is the angle between your heading and the bearing of the target, at your current location.+
  
-{{ :en:help:1.4:orientation:compass_target.jpg?nolink }}+\\
  
 +=== Inverted poles ===
 +\\
 +On some devices, when changing the screen orientation of 180° (jumping to the opposite screen orientation, ie landscape right to landscape left without the intermediate portrait orientation), the compass direction is inverted. Be sure to always select the portrait orientation, even temporarily.
  
-==== Compass settings ====+\\
  
-Click on the compass "**''Settings''**" {{:icon_01.png?nolink}} button to open the settings dialog.+=== Sensor issues === 
 +\\ 
 +In addition to the magnetic sensor, your device may use other sensors to compute a precise and noiseless north direction. Some sensors may not work or may not be as reliable as expected on some devices and some may be wrongly reported as available. In some cases, changing the default orientation computation method may provide a better accuracy.
  
-If desired+To do so
-  * Click on the "**''Sensor''**" {{:icon_02.png?nolink}} list to request orientation updates from another sensor, if your devices has various sensors. Depending on the device, each sensor can be more or less precise, responsible and noisy+  * Click on the ''"**Settings**"'' {{:icon_01.png?nolink}} icon to open the settings dialog
-  * Un-check the "**''Moving rose and graduations''**" {{:icon_03.png?nolink}} check-box to display the compass with a fixed background rose and moving needle {{:icon_04.png?nolink}}.+  * Click on ''"**More**"'' {{:icon_02.png?nolink}}; 
 +  * Click on the currently used ''"**Sensor**"'' {{:icon_03.png?nolink}} and choose another one; 
 +  * Click on ''"**Ok**"'' {{:icon_04.png?nolink}}.
  
-{{ :en:help:1.4:orientation:compass_settings.jpg?nolink }}+The list of available sensors depends on the device and system version, but usually contains: 
 +  * ''"**ROTATION_VECTOR**"'' which uses the ''"**magnetometer**"'', the ''"**accelerometer**"'' and the ''"**gyroscope**"'' sensorsWhen available, it usually provides the more precise value; 
 +  * ''"**MAGNETIC_FIELD**"'' which uses the ''"**magnetometer**"'' and the ''"**accelerometer**"'' sensors; 
 +  * ''"**ORIENTATION**"'' which uses a device-dependent internal computation.
  
 +{{ :en:help:v2:orientation:problems-sensor.jpg?nolink }}