NAME

Astro::Coords::Angle::Hour - Representation of an angle in units of hours

SYNOPSIS

  use Astro::Coords::Angle::Hour;

  $ha = new Astro::Coords::Angle::Hour( "12h30m22.4s", units => 'sex');
  $ha = new Astro::Coords::Angle::Hour( 12.53, units => 'hour);

  $ha = new Astro::Coords::Angle::Hour( 12.53 );

DESCRIPTION

Class similar to Astro::Coords::Angle but representing the angle as a time. Suitable for use as hour angle or Right Ascension. Inherits from Astro::Coords::Angle.

For hour angle a range of "PI" is suitable, for Right Ascension use "2PI". Default range is none at all. If no units are provided, the units will be guessed using the same scheme as for Astro::Coords::Angle except that values greater than 2PI will be assumed to be decimal hours.

METHODS

Accessor Methods

hours

Return the angle in decimal hours.

 $deg = $ang->hours;

General Methods

in_format

As for base class implementation, except that 'hour' (and abbreviation) is a supported format. 'sexagesimal' format will result in a stringified form of the object in hours, minutes and seconds.

 $hr = $hour->in_format( 'hour' );

Class Methods

The following methods control the default behaviour of the class.

NDP

As for the base class except that the default number of decimal places is 3.

This method has no effect on the base class.

DELIM

As for the base class. The global value in this class does not have any effect on the base class.

AUTHOR

Tim Jenness <t.jenness@cpan.org>

COPYRIGHT

Copyright (C) 2004-2005 Tim Jenness. All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place,Suite 330, Boston, MA 02111-1307, USA