Differences

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

--- en:help:orientation [2014/07/05 00:46] – psyberia
+++ en:help:orientation [2019/05/08 01:44] – alpinequest
@@ Line 1: / Line 1: @@
 <sub>[[en:help|Online Help]] > [[en:help:orientation|Compass]]</sub>
-====== Compass ======
-The Compass feature uses the magnetic sensor of your device (if available) to give you helpful orientation information.
+====== Orientation & Compass ======
+\\
+The compass feature uses the magnetic sensor of your device (if available) to give you orientation information.
-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.
+To turn on the compass, you can either:
+  * Long-press the "**''Compass''**" menu button {{:icon_01.png?nolink}};
-{{:icon_help.png?nolink}} To turn on the compass feature, you can either:
-  * Long-press the "**''Compass''**" menu item {{:icon_01.png?nolink}};
   * Click on the sub-menu toggle {{:icon_03.png?nolink}}.
-{{ :en:help:orientation:submenu.jpg?nolink}}
+The "''**Compass**''" menu button {{:icon_01.png?nolink}} 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.
+{{ :en:help:orientation:compass-submenu.jpg?nolink}}
+\\
+===== The compass menu =====
+\\
+Click on the "''**Compass**''" {{:icon_01.png?nolink}} menu button to display the compass menu, composed of 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 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}}.
-===== The compass sub-menu =====
+{{ :en:help:orientation:compass-on-map-items.jpg?nolink }}
-Click on the "**''Compass''**" {{:icon_01.png?nolink}} menu item to display the sub-menu. This sub-menu is composed of the following items:
+\\
-  * The "**''Compass details''**" {{:icon_02.png?nolink}} item opens the compass details window;
+===== The compass view =====
-  * The "**''Compass toggle''**" {{:icon_03.png?nolink}} let you turn on or off the compass feature easily;
+{{ :en:help:orientation:compass-view.jpg?nolink}}
-  * The "**''Display compass''**" {{:icon_04.png?nolink}} check-box control either or not to display a compass on the map;
+\\
-  * The "**''Rotate the map''**" {{:icon_05.png?nolink}} check-box control either or not to rotate the map based on the compass north to match the real direction you are looking at;
+The "**''compass view''**" gives you the following information:
-  * The "**''Current azimuth''**" {{:icon_06.png?nolink}} check-box control either or not to display an information box {{:icon_07.png?nolink}} on the map with the current heading.
+  * The true (geographic) north direction, pointed by the 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}}, which is the difference between the magnetic north and the geographic (map) 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;
+  * The **direction** {{:icon_05.png?nolink}} to the target, if a location is set as target.
-===== The Compass Details Window =====
+\\
-==== The compass view ====
+===== The compass settings =====
+\\
+By default, the compass has a moving rose and graduations (the "**''Topochaix''**" style). You can change it to a moving needle and still graduations {{:icon_04.png?nolink}}:
+  * Click on the "**''Settings''**" {{:icon_01.png?nolink}} icon to open the settings dialog;
+  * Click on the style list {{:icon_02.png?nolink}} and select "**''Standard''**";
+  * Click on "**''OK''**" {{:icon_03.png?nolink}} to validate.
-{{ :en:help:orientation:window.jpg?nolink}}
+{{ :en:help:orientation:compass-settings-style.jpg?nolink }}
-The "**''compass view''**" {{:icon_01.png?nolink}} is a graphical representation of the true (geographic) north direction, pointed by the red arrow.
+\\
-If a waypoint has been set as target, a green arrow also indicates its direction.
+===== Problems with the compass =====
+\\
+**Compass won't turn on**\\
+{{ :en:help:orientation:compass-error-sensor.jpg?nolink }}
+If you can't turn on the compass, it means that your device doesn't have a built-in magnetic sensor, which is required to get the direction of the north. Recent versions of the application display this message when this case occurs:\\
+Note that you can still use the map rotation using the GPS (if available), from the [[en:help:geolocation|Positioning]] menu.
-{{:icon_help.png?nolink}} Graduations are given in degrees and angular mils.
+**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 facing the sky.\\
+If you still get a wrong direction, it usually means that the magnetic sensor needs to be calibrated. This is fast and easy:
+  * Turn on the compass;
+  * Rotate your device in the air in all directions;
+  * Done!
+{{ :en:help:orientation:problems-declination.jpg?nolink}}
-It also gives you the following information:
+**Wrong magnetic declination**\\
-  * **The heading** {{:icon_02.png?nolink}}, in degree (0° to 360°, 0° being the north, 90° the east), which is the angle between the geographic north and the current direction you are looking at (the orientation of your phone);
+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 declination. Most of the time you just need to be sure that the map points your current location to fix your problem.\\
-  * **The magnetic declination** {{:icon_03.png?nolink}}, in degree, which is the difference between the magnetic north and the geographic north, at your current location. 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.
+If you still believe the computed declination is incorrect or already applied by your device, you can turn off this computation as explained in the settings sections.
-==== The target finder ====
+**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.
-The "**''target finder''**" {{:icon_04.png?nolink}} is a graphical representation of the direction toward the targeted waypoint. Once the green arrow is at the center of the target finder, you are currently looking at direction of the target.
+**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.
-{{:icon_help.png?nolink}} The application uses the screen center location as your current location. You can lock this screen center point on the current GPS location to get updated directions, based on your real location.
+To do so:
+  * Tap on the ''"**Settings**"'' {{:icon_01.png?nolink}} icon to open the settings dialog;
+  * Tap on ''"**More**"'' {{:icon_02.png?nolink}};
+  * Tap on the currently used ''"**Sensor**"'' {{:icon_03.png?nolink}} and choose another one;
+  * Tap on ''"**Ok**"'' {{:icon_04.png?nolink}}.
-It also gives you the following information:
+The list of available sensors depends on the device and system version, but usually contains:
-  * **The bearing** {{:icon_05.png?nolink}} of the target, in degree, which is the angle between the geographic north and the targeted waypoint, at your current location;
+  * ''"**ROTATION_VECTOR**"'' which uses the ''"**magnetometer**"'', the ''"**accelerometer**"'' and the ''"**gyroscope**"'' sensors. When available, it usually provides the more precise value;
-  * **The direction** {{:icon_06.png?nolink}} of the target, in degree, which is the angle between your current heading and the bearing of the target, at your current location;
+  * ''"**MAGNETIC_FIELD**"'' which uses the ''"**magnetometer**"'' and the ''"**accelerometer**"'' sensors;
-  * **The distance** {{:icon_07.png?nolink}} of the target, from your current location.
+  * ''"**ORIENTATION**"'' which uses a device-dependent internal computation.
-{{:icon_help.png?nolink}} When your heading is equals to the target bearing, it means that you are currently looking at the target direction (direction of 0°).
+{{ :en:help:orientation:problems-sensor.jpg?nolink }}