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>,