NAME

Astro::Unit - Astronomical unit conversion with high precision and large number support

VERSION

version 1.00

SYNOPSIS

Astro::Unit can capable of converting the astrological units into mile or kilometers with the added support of conversion from astrological to light year and vice-versa

# Raw number input will be truncated by Perl hence need to use
# either bignum in the script or single quotes to pass large number to methods

 use Astro::Unit;
 use bignum;
 my $astro =  new Astouniuts();
 print $astro->get_astronomical_units(19999); #use bigint
 
           OR
 
 use Astro::Unit;
 my $astro =  new Astouniuts();
 print $astro->get_astronomical_units('19999'); #single quote

DESCRIPTION

Astro::Unit,

Features include:

High Precision
Support for very large number range
Fast
Imperial as well as SI unit system support

Astro::Unit is useful for performing the astrological conversion and calculation till n'th digit with precision. Without worrying about result getting truncated.

IMPORTANT LINKS =head3 ACKNOWLEDGEMENTS

Conversion Values were taken from

http://www.kylesconverter.com/length/

https://www.calculateme.com/astronomy

Module internally uses

https://perldoc.perl.org/bignum.html

https://perldoc.perl.org/Math/BigFloat.html

https://github.com/spajai/Asto-Units

Report issue on above link

Frequently asked questions. Make sure you read here FIRST.

CONSTRUCTOR AND STARTUP

new()

Creates and returns a new Astro::Unit object.

my $astro = Astro::Unit->new()

Astro::Unit supports unit option

new() set metric system

my $astro = Astro::Unit->new(unit => 'mile')
                    or 
my $astro = Astro::Unit->new(unit => 'kilometer')

supported unit input

Default is Kilometers

mile
mi
m  
anything starting will m will be considered as miles
kilometers
kl
k
anything starting will k will be considered as kilometers

Methods available

#Astrologocal units to mi/km
get_astronomical_units
get_light_years
get_light_week 
get_light_days
get_light_hours
get_light_minutes
get_light_seconds
get_light_parsecs

#reverse function mi/km to Astrologocal units
convert_to_astronomical_units
convert_to_light_years
convert_to_light_weeks
convert_to_light_days
convert_to_light_hours
convert_to_light_minutes
convert_to_light_seconds
convert_to_light_parsec

#Astrologocal units to light units mi/km not applicable
au_to_light_years
au_to_light_weeks
au_to_light_days
au_to_light_hours
au_to_light_minutes
au_to_light_seconds
au_to_light_parsecs

#light units to astronomical units mi/km not applicable
light_years_to_au
light_weeks_to_au
light_days_to_au
light_hours_to_au
light_minutes_to_au
light_seconds_to_au
light_parsecs_to_au

To convert the user astrological units to kilometers or miles as per the setting in object.

$astro->get_astronomical_units('1234567899.123456789')

Returns equivalent mi/km for given astronomical_units (au)

$astro->get_light_years('1234567899.123456789Kilometer')

Returns equivalent mi/km for given light-years (ly)

$astro->get_light_week('12,34,567,899.123,456,789')

Returns equivalent mi/km for given light-week (lw)

$astro->get_light_days('12_34_567,899.123,456,789')

Returns equivalent mi/km for given light-days (ld)

$astro->get_light_hours('12_34_567,899.123,456,789m')

Returns equivalent mi/km for given light-hours (lh)

$astro->get_light_minutes('12_34_567,899.123,456')

Returns equivalent mi/km for given light-minutes (lm)

$astro->get_light_seconds(1)

Returns equivalent mi/km for given light-seconds (ls)