GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  ASTRO::COORDS::OFFSET (3)

.ds Aq ’

NAME

Astro::Coords::Offset - Represent an offset from a base position

CONTENTS

SYNOPSIS



  use Astro::Coords::Offset;

  my $offset = new Astro::Coords::Offset( 10, 20,
                                          system => J2000,
                                          projection => "TAN" );

  my $offset = new Astro::Coords::Offset( $ang1, $ang2,
                                          system => J2000,
                                          projection => "TAN" );

  my ($a1, $a2) = $offset->offsets;
  my $arcsec = $a1->arcsec;



DESCRIPTION

Sometimes, it is necessary for a position to be specified that is offset from the base tracking system. This class provides a means of specifying an offset in a particular coordinate system and using a specified projection.

METHODS

    Constructor

<B>newB> Create a new Offset object. The first two arguments must be the offsets in arcseconds or Astro::Coords::Angle objects. The projection and tracking system can be specified as optional hash arguments (defaulting to TAN and J2000 respectively).



  my $off = new Astro::Coords::Offset( 10, -20 );

  my $off = new Astro::Coords::Offset( @off, system => "AZEL",
                                             projection => "SIN");

  my $off = new Astro::Coords::Offset( @off, system => "AZEL",
                                             projection => "SIN",
                                             posang => $pa,
                                     );



    Accessor Methods

<B>offsetsB> Return the X and Y offsets.



  @offsets = $self->offsets;



as Astro::Coords::Angle objects.

<B>xoffsetB> Returns just the X offset.



  $x = $off->xoffset;



<B>yoffsetB> Returns just the Y offset.



  $x = $off->yoffset;



<B>systemB> Coordinate system of this offset. Can be different to the coordinate system of the base position.

Allowed values are J2000, B1950, AZEL plus others specified by the JAC TCS XML (see SEE ALSO section at end). TRACKING is special since it can change, depending on which output coordinate frame is in use. See the tracking_system attribute for more details.

Az/El is treated as AZEL for backwards compatibility reasons.

<B>posangB> Position angle of this offset as an Astro::Coords::Angle object. Position angle follows the normal East of North convention.



  $off->posang( 45 );
  $pa = $off->posang;



If a number is supplied it is assumed to be in degrees (this matches the common usage in the JCMT TCS XML DTD).

By default returns a position angle of 0 deg.

<B>projectionB> Return (or set) the projection that should be used for this offset. Defaults to tangent plane. Allowed options are TAN, SIN or ARC.
<B>tracking_systemB> In some cases, the offset can be specified to be relative to the system that the telescope is currently using to track the source. This does not necessarily have to be the same as the coordinate frame that was originally used to specify the target. For example, it is perfectly acceptable to ask a telescope to go to a certain Az/El and then ask it to track in RA/Dec.

This method allows the tracking system to be specified independenttly of the offset coordinate system. It will only be used if the offset is specified to use TRACKING (but it allows the system to disambiguate an offset that was defined as TRACKING B1950 from an offset that is simply B1950.

The allowed types are the same as for system except that TRACKING is not permitted.

    General Methods

<B>invertB> Return a new offset object with the sense of the offset inverted.



  $inv = $offset->invert;



<B>cloneB> Create a cloned copy of this offset.



  $clone = $offset->clone;



<B>offsets_rotatedB> This can be thought of as a version of offsets which returns offsets which have been rotated through the position angle. It uses the offsets method internally to fetch the stored values. Results are Astro::Coords::Angle objects.



  ($x_rotated, $y_rotated) = $offset->offsets_rotated();



It is assumed that the coordinate system has the first coordinate being positive to the East in order to match the definiton of the posang given above.

SEE ALSO

The allowed offset types are designed to match the specification used by the Portable Telescope Control System configuration XML. See <http://www.jach.hawaii.edu/JACdocs/JCMT/OCS/ICD/006> for more on this.

AUTHOR

Tim Jenness <tjenness@cpan.org>

COPYRIGHT

Copyright 2002-2006 Particle Physics and Astronomy Research Council. 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

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 ASTRO::COORDS::OFFSET (3) 2016-04-03

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.