Utility (libnova for Java with multi thread fix 0.15.0.1 API)

java.lang.Object
- de.kah2.zodiac.nova4jmt.Utility

```
public class Utility
extends Object
```

Constructor Summary

Constructors
Constructor and Description

Utility()

Constructors
Constructor and Description
`Utility()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static double`	`cbrt(double x)` Simple cube root
`static void`	`ln_add_hms(LnHms source, LnHms dest)` add hms to hms
`static void`	`ln_add_secs_hms(LnHms hms, double seconds)` add seconds to hms
`static void`	`ln_deg_to_dms(double degrees, LnDms dms)` convert degrees to dms
`static void`	`ln_deg_to_hms(double degrees, LnHms hms)` convert degrees to hh:mm:ss
`static BigDecimal`	`ln_deg_to_rad(BigDecimal degrees)` BigDecimal variant
`static double`	`ln_deg_to_rad(double degrees)` convert degrees to radians
`static double`	`ln_dms_to_deg(LnDms dms)` convert dms to degrees
`static double`	`ln_dms_to_rad(LnDms dms)` convert dms to radians
`static void`	`ln_equ_to_hequ(LnEquPosn pos, LnhEquPosn hpos)` void ln_equ_to_hequ(LnEquPosn pos, LnhEquPosn hpos) \brief human double equatorial position to human readable equatorial position \ingroup conversion
`static double`	`ln_get_dec_location(String s)` double ln_get_dec_location(String s) \param s Location string \return angle in degrees Obtains Latitude, Longitude, RA or Declination from a string.
`static String`	`ln_get_humanr_location(double location)` String ln_get_humanr_location(double location) \param location Location angle in degress \return Angle string Obtains a human readable location in the form: ddºmm'ss.ss"
`static double`	`ln_get_light_time(double dist)` \fn double ln_get_light_time (double dist) \param dist Distance in AU \return Distance in light days.
`static double`	`ln_get_rect_distance(LnRectPosn a, LnRectPosn b)` \fn double ln_get_rect_distance(LnRectPosn a, LnRectPosn b) \param a First rectangular coordinate \param b Second rectangular coordinate \return Distance between a and b.
`static String`	`ln_get_version()` String ln_get_version (void) \return Null terminated version string.
`static void`	`ln_hequ_to_equ(LnhEquPosn hpos, LnEquPosn pos)` void ln_hequ_to_equ(LnhEquPosn hpos, LnEquPosn pos) \brief human readable equatorial position to double equatorial position \ingroup conversion
`static void`	`ln_hhrz_to_hrz(LnhHrzPosn hpos, LnHrzPosn pos)` void ln_hhrz_to_hrz(LnhHrzPosn hpos, LnHrzPosn pos) \brief human readable horizontal position to double horizontal position \ingroup conversion
`static void`	`ln_hlnlat_to_lnlat(LnhLnlatPosn hpos, LnLnlatPosn pos)` void ln_hlnlat_to_lnlat(LnhLnlatPosn hpos, LnLnlatPosn pos) \brief human readable long/lat position to double long/lat position \ingroup conversion
`static double`	`ln_hms_to_deg(LnHms hms)` convert hours:mins:secs to degrees
`static double`	`ln_hms_to_rad(LnHms hms)` convert hours:mins:secs to radians
`static void`	`ln_hrz_to_hhrz(LnHrzPosn pos, LnhHrzPosn hpos)` void ln_hrz_to_hhrz(LnHrzPosn pos, LnhHrzPosn hpos) \brief double horizontal position to human readable horizontal position \ingroup conversion
`static String`	`ln_hrz_to_nswe(LnHrzPosn pos)` String ln_hrz_to_nswe(LnHrzPosn pos); \brief returns direction of given azimuth - like N,S,W,E,NSW,...
`static double`	`ln_interpolate3(double n, double y1, double y2, double y3)` double ln_interpolate3 (double n, double y1, double y2, double y3) \return interpolation value \param n Interpolation factor \param y1 Argument 1 \param y2 Argument 2 \param y3 Argument 3 Calculate an intermediate value of the 3 arguments for the given interpolation factor.
`static double`	`ln_interpolate5(double n, double y1, double y2, double y3, double y4, double y5)` double ln_interpolate5 (double n, double y1, double y2, double y3, double y4, double y5) \return interpolation value \param n Interpolation factor \param y1 Argument 1 \param y2 Argument 2 \param y3 Argument 3 \param y4 Argument 4 \param y5 Argument 5 Calculate an intermediate value of the 5 arguments for the given interpolation factor.
`static void`	`ln_lnlat_to_hlnlat(LnLnlatPosn pos, LnhLnlatPosn hpos)` void ln_lnlat_to_hlnlat(LnLnlatPosn pos, LnhLnlatPosn hpos) \brief double long/lat position to human readable long/lat position \ingroup conversion
`static double`	`ln_rad_to_deg(double radians)` convert radians to degrees
`static void`	`ln_rad_to_dms(double radians, LnDms dms)` convert radians to dms
`static void`	`ln_rad_to_hms(double radians, LnHms hms)` convert radians to hh:mm:ss
`static double`	`ln_range_degrees(double angle)` puts a large angle in the correct range 0 - 360 degrees
`static double`	`ln_range_radians(double angle)` puts a large angle in the correct range 0 - 2PI radians
`static double`	`ln_range_radians2(double angle)` preserve sign
`static double`	`nan(String code)` Not a Number function generator
`static String`	`trim(String x)` []---------------------------------------------------------------------- -- [] \| trim() & strip() \| \| \| \| strips trailing whitespaces from buf. \| \| \| [ ]------------------------------------------------------------------------ []

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Utility
```
public Utility()
```
- Method Detail
  - ln_get_version
```
public static String ln_get_version()
```
    String ln_get_version (void) \return Null terminated version string. Return the libnova library version number string e.g. "0.4.0"
  - ln_rad_to_deg
```
public static double ln_rad_to_deg(double radians)
```
    convert radians to degrees
  - ln_deg_to_rad
```
public static double ln_deg_to_rad(double degrees)
```
    convert degrees to radians
  - ln_deg_to_rad
```
public static BigDecimal ln_deg_to_rad(BigDecimal degrees)
```
    BigDecimal variant
    
    Parameters:
    
    degrees -
    
    Returns:
  - ln_hms_to_deg
```
public static double ln_hms_to_deg(LnHms hms)
```
    convert hours:mins:secs to degrees
  - ln_hms_to_rad
```
public static double ln_hms_to_rad(LnHms hms)
```
    convert hours:mins:secs to radians
  - ln_deg_to_hms
```
public static void ln_deg_to_hms(double degrees,
                                 LnHms hms)
```
    convert degrees to hh:mm:ss
  - ln_rad_to_hms
```
public static void ln_rad_to_hms(double radians,
                                 LnHms hms)
```
    convert radians to hh:mm:ss
  - ln_dms_to_deg
```
public static double ln_dms_to_deg(LnDms dms)
```
    convert dms to degrees
  - ln_dms_to_rad
```
public static double ln_dms_to_rad(LnDms dms)
```
    convert dms to radians
  - ln_deg_to_dms
```
public static void ln_deg_to_dms(double degrees,
                                 LnDms dms)
```
    convert degrees to dms
  - ln_rad_to_dms
```
public static void ln_rad_to_dms(double radians,
                                 LnDms dms)
```
    convert radians to dms
  - ln_range_degrees
```
public static double ln_range_degrees(double angle)
```
    puts a large angle in the correct range 0 - 360 degrees
  - ln_range_radians
```
public static double ln_range_radians(double angle)
```
    puts a large angle in the correct range 0 - 2PI radians
  - ln_range_radians2
```
public static double ln_range_radians2(double angle)
```
    preserve sign
  - ln_add_secs_hms
```
public static void ln_add_secs_hms(LnHms hms,
                                   double seconds)
```
    add seconds to hms
  - ln_add_hms
```
public static void ln_add_hms(LnHms source,
                              LnHms dest)
```
    add hms to hms
  - ln_hequ_to_equ
```
public static void ln_hequ_to_equ(LnhEquPosn hpos,
                                  LnEquPosn pos)
```
    void ln_hequ_to_equ(LnhEquPosn hpos, LnEquPosn pos) \brief human readable equatorial position to double equatorial position \ingroup conversion
  - ln_equ_to_hequ
```
public static void ln_equ_to_hequ(LnEquPosn pos,
                                  LnhEquPosn hpos)
```
    void ln_equ_to_hequ(LnEquPosn pos, LnhEquPosn hpos) \brief human double equatorial position to human readable equatorial position \ingroup conversion
  - ln_hhrz_to_hrz
```
public static void ln_hhrz_to_hrz(LnhHrzPosn hpos,
                                  LnHrzPosn pos)
```
    void ln_hhrz_to_hrz(LnhHrzPosn hpos, LnHrzPosn pos) \brief human readable horizontal position to double horizontal position \ingroup conversion
  - ln_hrz_to_hhrz
```
public static void ln_hrz_to_hhrz(LnHrzPosn pos,
                                  LnhHrzPosn hpos)
```
    void ln_hrz_to_hhrz(LnHrzPosn pos, LnhHrzPosn hpos) \brief double horizontal position to human readable horizontal position \ingroup conversion
  - ln_hrz_to_nswe
```
public static String ln_hrz_to_nswe(LnHrzPosn pos)
```
    String ln_hrz_to_nswe(LnHrzPosn pos); \brief returns direction of given azimuth - like N,S,W,E,NSW,... \ingroup conversion
  - ln_hlnlat_to_lnlat
```
public static void ln_hlnlat_to_lnlat(LnhLnlatPosn hpos,
                                      LnLnlatPosn pos)
```
    void ln_hlnlat_to_lnlat(LnhLnlatPosn hpos, LnLnlatPosn pos) \brief human readable long/lat position to double long/lat position \ingroup conversion
  - ln_lnlat_to_hlnlat
```
public static void ln_lnlat_to_hlnlat(LnLnlatPosn pos,
                                      LnhLnlatPosn hpos)
```
    void ln_lnlat_to_hlnlat(LnLnlatPosn pos, LnhLnlatPosn hpos) \brief double long/lat position to human readable long/lat position \ingroup conversion
  - ln_get_rect_distance
```
public static double ln_get_rect_distance(LnRectPosn a,
                                          LnRectPosn b)
```
    \fn double ln_get_rect_distance(LnRectPosn a, LnRectPosn b) \param a First rectangular coordinate \param b Second rectangular coordinate \return Distance between a and b. Calculate the distance between rectangular points a and b.
  - ln_get_light_time
```
public static double ln_get_light_time(double dist)
```
    \fn double ln_get_light_time (double dist) \param dist Distance in AU \return Distance in light days. Convert units of AU into light days.
  - trim
```
public static String trim(String x)
```
    []---------------------------------------------------------------------- -- [] | trim() & strip() | | | | strips trailing whitespaces from buf. | | | [ ]------------------------------------------------------------------------ []
  - ln_get_dec_location
```
public static double ln_get_dec_location(String s)
```
    double ln_get_dec_location(String s) \param s Location string \return angle in degrees Obtains Latitude, Longitude, RA or Declination from a string. If the last char is N/S doesn't accept more than 90 degrees. If it is E/W doesn't accept more than 180 degrees. If they are hours don't accept more than 24:00 Any position can be expressed as follows: (please use a 8 bits charset if you want to view the degrees separator char '0xba') 42.30.35,53 90º0'0,01 W 42º30'35.53 N 42º30'35.53S 42º30'N - 42.30.35.53 42:30:35.53 S + 42.30.35.53 +42º30 35,53 23h36'45,0 42:30:35.53 S = -42º30'35.53" + 42 30.35.53 S the same previous position, the plus (+) sign is considered like an error, the last 'S' has precedence over the sign 90º0'0,01 N ERROR: +- 90º0'00.00" latitude limit
  - ln_get_humanr_location
```
public static String ln_get_humanr_location(double location)
```
    String ln_get_humanr_location(double location) \param location Location angle in degress \return Angle string Obtains a human readable location in the form: ddºmm'ss.ss"
  - ln_interpolate3
```
public static double ln_interpolate3(double n,
                                     double y1,
                                     double y2,
                                     double y3)
```
    double ln_interpolate3 (double n, double y1, double y2, double y3) \return interpolation value \param n Interpolation factor \param y1 Argument 1 \param y2 Argument 2 \param y3 Argument 3 Calculate an intermediate value of the 3 arguments for the given interpolation factor.
  - ln_interpolate5
```
public static double ln_interpolate5(double n,
                                     double y1,
                                     double y2,
                                     double y3,
                                     double y4,
                                     double y5)
```
    double ln_interpolate5 (double n, double y1, double y2, double y3, double y4, double y5) \return interpolation value \param n Interpolation factor \param y1 Argument 1 \param y2 Argument 2 \param y3 Argument 3 \param y4 Argument 4 \param y5 Argument 5 Calculate an intermediate value of the 5 arguments for the given interpolation factor.
  - cbrt
```
public static double cbrt(double x)
```
    Simple cube root
  - nan
```
public static double nan(String code)
```
    Not a Number function generator

Class Utility

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Utility

Method Detail

ln_get_version

ln_rad_to_deg

ln_deg_to_rad

ln_deg_to_rad

ln_hms_to_deg

ln_hms_to_rad

ln_deg_to_hms

ln_rad_to_hms

ln_dms_to_deg

ln_dms_to_rad

ln_deg_to_dms

ln_rad_to_dms

ln_range_degrees

ln_range_radians

ln_range_radians2

ln_add_secs_hms

ln_add_hms

ln_hequ_to_equ

ln_equ_to_hequ

ln_hhrz_to_hrz

ln_hrz_to_hhrz

ln_hrz_to_nswe

ln_hlnlat_to_lnlat

ln_lnlat_to_hlnlat

ln_get_rect_distance

ln_get_light_time

trim

ln_get_dec_location

ln_get_humanr_location

ln_interpolate3

ln_interpolate5

cbrt

nan