Differences

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

--- manual:chapter6:angles:cmd_tagdms [2019/10/21 14:48]
jojo1973 created
+++ manual:chapter6:angles:cmd_tagdms [2021/09/16 15:40] (current)
jojo1973
@@ Line 1: / Line 1: @@
 ==== →∡d ====
-----
 <callout type="primary" color="" icon="fa fa-book" title="Synopsis">
 ----
@@ Line 9: / Line 8: @@
 ----
 ^  __Input Stack__  ^  ^  __Output Stack__  ^
-|  **Num<sub>1</sub>**  |  **→**  |  **∡<sub>1</sub>**  |
+|  **Num**  |  **→**  |  **∡<sub>dms</sub>**  |
 |  //Level 1//  |  //→//  |  //Level 1//  |
 {{page>manual:chapter6:aux:legend&nofooter&noeditbtn&inline}}
-|**Type**| [[manual:chapter5:basics#operators|Command]]  ||
+| **Keyword type**  | [[manual:chapter5:basics#commands|Command]]  ||
-|**Parallel list processing**| [[manual:chapter5:listproc#group-5one-argument-one-result-commands|Group 5]]  ||
+| **Parallel list processing capabilities**  | [[manual:chapter5:listproc#group-5one-argument-one-result-commands|Group 5]]  | //One argument, one result commands//  |
-|**Affected by flags**| None  ||
+| **Affected by flags**  | //None//  ||
 </callout>
 <callout color="orangered" icon="fa fa-comment" title="Description">
 ----
-The ''→∡d'' command turns a scalar into an angle measured in degrees / minutes / seconds.
+The ''→∡d'' command turns a scalar into an angle measured in degrees / minutes / seconds.
 The angle is entered / displayed as a real number in the format **DD.MMSSxxx...** where:
@@ Line 28: / Line 41: @@
   * **MM** expresses the number of minutes of arc and ranges from ''00'' to ''59'';
   * **SS** expresses the number of seconds of arc and ranges from ''00'' to ''59'';
-  * **xxx...** expresses the fraction of seconds of arc.
+  * **xxx...** expresses the remaining fraction of seconds of arc.
 When a scalar is converted to an angle in degrees / minutes / seconds no check is performed to ensure that the digits at **MM** and **SS** positions range from ''00'' to ''59''. However addition of ''0'' (or multiplication by ''1'') will return a properly //normalized// angle.
@@ Line 35: / Line 48: @@
 <callout type="danger" icon="true" title="Compatibility">
 ----
-This command is new in newRPL and does not exist in userRPL.
+''→∡d'' is specific to **newRPL** and has no direct equivalent in **userRPL**.
 </callout>
 <callout type="info" icon="true" title="Usage">
 ----
+To see how normalization works, let's enter an "incorrect" angle; for example $30° 75^{\prime} 10^{\prime\prime}$:\\
+\\
+**__Input__**
 <code>
-:                       30.7510
+:
-……………………………………………………………………………………
+:
-→∡d
+:
+:                                30.751
+…………………………………………………………………………………………………………
+→∡d
 </code>
-will result in $30° 75^{\prime} 10^{\prime\prime}$.
+\\
+**__Output__**
 <code>
-:                      ∡30.751d
+:
-……………………………………………………………………………………
+:
+:
+:                              ∡30.751d
+…………………………………………………………………………………………………………
 </code>
-After multiplication by ''1''
+\\
+To trigger normalization of $30° 75^{\prime} 10^{\prime\prime}$ it's sufficient to multiply it by ''1'':\\
+\\
+**__Input__**
 <code>
-:                      ∡30.751d
+:
-……………………………………………………………………………………
+:
-*
+:
+:                              ∡30.751d
+…………………………………………………………………………………………………………
+*
 </code>
-the angle is normalized to $31° 15^{\prime} 10^{\prime\prime}$.
+\\
+**__Output__**
 <code>
-:                     ∡31.151.d
+:
-……………………………………………………………………………………
+:
+:
+:                             ∡31.151.d
+…………………………………………………………………………………………………………
 </code>
+The normalized angle is $31° 15^{\prime} 10^{\prime\prime}$.
 </callout>
@@ Line 67: / Line 103: @@
 {{page>manual:chapter6:angles&nofooter&noeditbtn&inline}}
 </callout>