Astro::SIMBAD::Result::Object - A individual astronomical object

NAME

Astro::SIMBAD::Result::Object - A individual astronomical object

SYNOPSIS

  $object = new Astro::SIMBAD::Result::Object( Name   => $object_name,
                                               Type   => $object_type,
                                               Long   => $long_type,
                                               Frame => \@coord_frame,
                                               RA     => $ra,
                                               Dec    => $declination,
                                               Spec   => $spectral_type,
                                               URL    => $url );

DESCRIPTION

Stores meta-data about an individual astronomical object in the Astro::SIMBAD::Result object returned by an Astro::SIMBAD::Query object.

REVISION

$Id: Object.pm,v 1.3 2005/06/08 01:38:17 aa Exp $

METHODS

Constructor

new
Create a new instance from a hash of options 
  $paper = new Astro::SIMBAD::Result::Object(  );

returns a reference to an SIMBAD astronomical object.

Accessor Methods

name
Return (or set) the name of the object 
   $name = $object->name();
   $object->name( $name );

Query types: list, object

target
Return (or set) the target name of the object. Available whenever a target is specified in the query. The returned value is identical to the query parameter, except that it is normalized (spaces replaced with '+' characters). This is useful because name() may return a different designation than the target that is supplied as a query parameter. 
   $target = $object->target();
   $object->target( $target );

Query types: list, object

type
Return (or set) the (short) type of the object 
   $type = $object->type();
   $object->type( $type );

Query types: list

long
Return (or set) the (long) type of the object 
   $long_type = $object->long();
   $object->long( $long_type );

Query types: list, object

frame
Return (or set) the system the R.A. and DEC stored in the object are defined in, e.g. Co-ordinate Frame FK5, Epoch 1950 and Equinox 2000 
   @system = $object->frame();
   $object->frame( \@system );

where @system would be [ ``FK5'', 1950.0, 2000.0 ]. If called in a scalar context will return a string of the form ``FK5 1950/2000'' to

Query types: list, object

ra
Return (or set) the R.A. of the object 
   $ra = $object->ra();
   $object->ra( $ra );

Query types: list, object

dec
Return (or set) the Declination of the object 
   $dec = $object->dec();
   $object->dec( $dec );

Query types: list, object

spec
Return (or set) the Spectral Type of the object 
   $spec_type = $object->spec();
   $object->spec( $spec_type );

Query types: list, object

url
Return (or set) the followup URL for the object where more information can be found via SIMBAD, including pointers to reduced data. 
   $url = $object->url();
   $object->url( $url );

bmag
Return (or set) the B-magnitude of the object 
   $bmag = $object->bmag();
   $object->bmag( $bmag );

Query types: list, object

vmag
Return (or set) the V-magnitude of the object 
   $vmag = $object->vmag();
   $object->vmag( $vmag );

Query types: list, object

ident
Return (or append) the array of object identifiers 
   @ident = $object->ident();
   $object->ident( @ident );

Query types: object

pm
Return (or set) the proper motion of the object in mas/year 
   @pm = $object->pm();
   $object->pm( @pm );

Query types: object

plx
Return (or set) the parallax of the object 
   $plx = $object->plx();
   $object->plx( $plx );

Query types: object

radial
Return (or set) the radial velocity (km/s) of the object 
   $radial = $object->radial();
   $object->radial( $radial );

Query types: object

redshift
Return (or set) the redshift of the object 
   $redshift = $object->redshift();
   $object->redshift( $redshift );

Query types: object

General Methods

configure
Configures the object from multiple pieces of information. 
  $object->configure( %options );

Takes a hash as argument with the following keywords:

COPYRIGHT

Copyright (C) 2001 University of Exeter. All Rights Reserved.

This program was written as part of the eSTAR project and is free software; you can redistribute it and/or modify it under the terms of the GNU Public License.

AUTHORS

Alasdair Allan <aa@astro.ex.ac.uk>,

 Astro::SIMBAD::Result::Object - A individual astronomical object