bargument special text
references either the approximate air line distance or the
approximate course angle (true track)1 between any of two geographic point locations. The selection,
which value has to be calculated by using this special text is done by
specifying the mode part of the preceding argument. Actually,
exactly three different modes can be used that are represented by the
|Calculates the air line distance between
The calculated air line distance value is displayed in kilometers by
default. A ‘*’ character directly before this mode character causes
Gcal to display the distance value for another quantity, and that in
statute miles; where one statute mile is equal to 1.609344
kilometer. If Gcal is unable to compute the approximate distance between
the two geographic point locations by reason of a misspecified argument,
|Calculates the course angle (true track) between
The calculated course angle value is displayed in degrees and arcminutes
by default. The course angle is measured clockwise relative to the geographic,
true North (not the magnetic North as shown by a compass), where angle values
for the North direction are both denoted as 0 degree and 360 degree.
A ‘*’ character directly before this mode character causes Gcal to display
the course angle value using another style; and that in decimal degrees.
If Gcal is unable to compute the approximate course angle between the two
geographic point locations by reason of a misspecified argument, a
|Like mode |
If no mode is given, Gcal automatically uses that mode, which is enabled by the mode character ‘0’. If a mode character is given that is not according to one of the ‘0’...‘2’ characters, Gcal also automatically uses that mode, which is enabled by the mode character ‘0’.
After the optional style and mode characters, the latitude and longitude of the geographic co-ordinates follows, for which the calculations must be made. They must be conform the ISO-6709:1983 standard representation of latitude and longitude for geographic point locations. The two co-ordinates have to be separated by a ‘/’ termination character from each other.
See Arguments of the Sun oriented special texts, for the detailed description of the components of the ISO-6709:1983 standard representation of latitude and longitude for geographic point locations.
The text ‘Distance Paris-Tokyo: %b+4852+00220/+3542+13946 km’ will be expanded to
==> ‘Distance Paris-Tokyo: 9746km’.
The text ‘Distance Paris-Tokyo: %b*0+4852+00220/+3542+13946 ms’ will be expanded to
==> ‘Distance Paris-Tokyo: 6056ms’.
The text ‘Course angle Paris-Tokyo: %b1+4852+00220/+3542+13946’ will be expanded to
==> ‘Course angle Paris-Tokyo: 033d22'’.
The text ‘Course angle Tokyo-Paris: %b*2+4852+00220/+3542+13946’ will be expanded to
==> ‘Course angle Tokyo-Paris: 333.548’.
While praying, people of Islamic faith always turn their heads into the direction of Makkah, Saudi-Arabia. Now by means of Gcal, these people can easily find out for their respective location, where they have to turn to, and that by:
where ISO-6709:1983-co-ordinate-1 is simply replaced by the co-ordinate of the respective location.
See Fixed date option --precise, how to obtain a more precise representation of the values that are caused by this special text.
This special text must always be trailed by a whitespace character which is removed in output!
 The course angle gives the direction, which is the vertex of a great circles arc (Orthodrome) that is casted between two points on a surface of a sphere, at a meridian (Gcal uses a geoid (rotation ellipsoid) that is calculated taking pattern from the World Geodetic System, short W.G.S, that was designed in 1961). Such an arc is the shortest geodetic connecting line between two points on a sphere. Indeed, the course angles on such an arc are changing continually, because the circular line that is casted intersects each meridian with another angle — except the case, that both co-ordinates are referring to exactly the same meridian (longitude), or to exactly the same latitude.