NAME

Astro::NED::Query::ByName - query NED by object name

SYNOPSIS

  use Astro::NED::Query::ByName;

  $req = Astro::NED::Query::ByName->new( Field => $value, ... );

  $req->Field( $value );

  $objs = $req->query;

DESCRIPTION

This class queries NED using the "Objects By Name" interface. It is a subclass of Astro::NED::Query, and thus shares all of its methods.

Class specific details are provided here. See Astro::NED::Query for general information on the class methods (including those not documented here) and how to set or get the search parameters.

Methods

new
  $req = Astro::NED::Query::ByName->new( keyword1 => $value1,
                                 keyword2 => $value2, ... );

Queries are constructed using the new method, which is passed a list of keyword and value pairs. The keywords may be the names of single valued query parameters.

Search parameters may also be set or queried using the accessor methods; see Astro::NED::Query.

query
  $res = $req->query;

The query method returns an instance of the Astro::NED::Response::Objects class, which contains the results of the query. At present it returns only the summary table, not the detailed information on each object. See Astro::NED::Response::Object for more info.

If an error ocurred an exception is thrown via croak.

Search Parameters

Please note that for fields which take specific enumerated values, the values are often not those which are displayed by a web browser. It's best to initially use the possible_values method to determine acceptable values. Usually it's pretty obvious what they correspond to.

The class accessor methods have the same names as the search parameters. See Astro::NED::Query on how to use them.

ObjName

The object name.

Extend

Whether to perform an extended search. Possible values are yes and no.

CoordSys

The output coordinate system. Use the possible_values method to determine which ones are available.

Equinox

The output coordinate system equinox.

Sort

The output sort order. Use the possible_values method to determine which ones are available.

Format

Whether the output is formatted as an HTML table or plain text. This will always be forced to HTML.

ListLimit

The upper limit to the number of objects with detailed information. This is always set to force no detailed information

ZVBreaker

The maximum redshift velocity which will be displayed as km/s.

ImageStamp

Whether or not to return an image preview. Always forced off.

EXPORT

None by default.

AUTHOR

Diab Jerius, <djerius@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (C) 2003 Smithsonian Astrophysical Observatory. All rights are of course reserved.

It is released under the GNU General Public License. You may find a copy at

   http://www.fsf.org/copyleft/gpl.html

SEE ALSO

Astro::NED::Query, Astro::NED::Response::Objects, Astro::NED::Response::Object, perl.