fromDMS

fun fromDMS(degrees: Int, minutes: Int, seconds: Double): Angle

Obtain an angle from a given number of positive degrees, minutes and seconds.

Return

a new angle whose size in degrees is given by degrees, minutes and seconds.

Parameters

degrees

integer number of degrees, positive.

minutes

integer number of minutes, positive only between 0 and 60.

seconds

integer number of seconds, positive only between 0 and 60.

Throws

if minutes or seconds are outside the 0-60 range or the degrees is negative.


fun fromDMS(dmsString: String): Angle

Obtain an angle from a degrees, minute and seconds character string.

eg:

 123 34 42 -123* 34' 42" (where * stands for the degree symbol) +45* 12' 30" (where * stands for the degree symbol) 45 12 30 S 45 12 30 N

For a string containing both a sign and compass direction, the compass direction will take precedence.

Return

the corresponding angle.

Parameters

dmsString

the degrees, minute and second character string.

Throws

if dmsString is not properly formatted.