/ 
Astro-Catalog-2.1.3
River stage one • 2 direct dependents • 2 total dependents
/ Astro::Catalog::SuperCOSMOS::Query

NAME

Astro::Catalog::SuperCOSMOS::Query - Query the SuperCOSMOS Catalog

SYNOPSIS

$supercos = new Astro::Catalog::SuperCOSMOS::Query( RA        => $ra,
                                                    Dec       => $dec,
                                                    Band      => $waveband,
                                                    Radius    => $radius,
                                                  );
    
my $catalog = $supercos->querydb();

DESCRIPTION

Stores information about an prospective SuperCOSMOS Sky Survey query and allows the query to be made, returning an Astro::Catalog object.

Since the module uses the Astro::Aladin module to drive the CDS Aladin application to retrieve the catalogue, its doubtful that it will work through a proxy (unlike the USNO-A2 and GSC modules).

REVISION

$Id: Query.pm,v 1.2 2003/02/24 22:31:09 aa Exp $

METHODS

Constructor

new

Create a new instance from a hash of options

$supercos = new Astro::Catalog::SuperCOSMOS::Query( RA        => $ra,
                                                    Dec       => $dec,
                                                    Band      => $waveband,
                                                    Radius    => $radius
                                                  );

returns a reference to an SuperCOSMOS query object.

Accessor Methods

querydb

Returns an Astro::Catalog object from a SuperCOSMOS query.

$catalog = $supercos->querydb();
RA

Return (or set) the current target R.A. defined for the SuperCOSMOS query

$ra = $supercos->ra();
$supercos->ra( $ra );

where $ra should be a string of the form "HH MM SS.SS", e.g. 21 42 42.66

Dec

Return (or set) the current target Declination defined for the SuperCOSMOS query

$dec = $supercos->dec();
$supercos->dec( $dec );

where $dec should be a string of the form "+-HH MM SS.SS", e.g. +43 35 09.5 or -40 25 67.89

Radius

The radius to be searched for objects around the target R.A. and Dec in arc minutes, the radius defaults to 5 arc minutes.

$radius = $query->radius();
$query->radius( 20 );
Band

Set (or query) the Primary survey/waveband, options UKST Blue: -90 < Dec < +2.5, UKST Red: -90 < Dec < +2.5, UKST Infrared: -90 < Dec < +2.5, ESO Red: -90 < Dec < -17.5, POSS I Red: -20.5 < Dec < +2.5.

$band = $query->band();
$query->band( "UKST IR" );

valid options are "UKST Blue", "UKST Red", "UKST Infrared", "ESO Red" and "POSS-I Red".

General Methods

configure

Configures the object, takes an options hash as an argument

$dss->configure( %options );

Does nothing if the array is not supplied.

COPYRIGHT

Copyright (C) 2003 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>,