Astro::NED::Query::NearPosition - query NED for objects near a specified position
use Astro::NED::Query::NearPosition; $req = Astro::NED::Query::NearPosition->new( Field => value, ... ); $req->Field( $value ); # for fields which take multiple values $req->Field( $value1 => $state ); $req->Field( $value2 => $state ); $objs = $req->query;
This class queries NED using the "Objects Near Position" 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.
$req = Astro::NED::Query::NearPosition->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.
Fields which may have mutiple concurrent values (such as IncObjType) cannot be specified in the call to new; use the field accessor method, and specify the value and whether it should be selected or not:
$req->IncObjType( 'Galaxies' => 1 ) $req->IncObjType( 'XRay' => 1 )
Search parameters may also be set or queried using the accessor methods; see Astro::NED::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.
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 input coordinate system. Use the possible_values method to determine which ones are available.
The input coordinate system equinox.
The longitude of the search position, if applicable. (Internally this is the same as the RA field.)
The latitude of the search position, if applicable. (Internally this is the same as the Dec field.)
The Right Ascension of the search position, if applicable. (Internally this is the same as the Longitude field.)
The Declination of the search position, if applicable. (Internally this is the same as the Latitude field.)
The search radius in arcminutes
The output coordinate system. Use the possible_values method to determine which ones are available.
The output coordinate system equinox.
The output sort order. Use the possible_values method to determine which ones are available.
Whether the output is formatted as an HTML table or plain text. This will always be forced to HTML.
The upper limit to the number of objects with detailed information. This is always set to force no detailed information
The maximum redshift velocity which will be displayed as km/s.
Whether or not to return an image preview. Always forced off.
Constraints on the redshifts of the objects. Used in conjunction with the ZValue1 and ZValue2 fields.
Use the possible_values method to determine which constraints are available.
Values for the redshift constraints.
Either km/s or z.
km/s
z
Whether to objects must have ANY or ALL of the types in the IncObjType field. Takes the values ANY or ALL.
ANY
ALL
This specifies the types of objects to include. This is a multi-valued field, meaning that it can hold more than one type of object concurrently. As such, it cannot be initialized in the object constructor. The accessor method must be used instead:
$obj->IncObjType( Galaxies => 1 ); $obj->IncObjType( GPairs => 1 );
Use the possible_values method to determine which object types are available.
This specifies the types of objects to exclude. This is a multi-valued field, meaning that it can hold more than one type of object concurrently. As such, it cannot be initialized in the object constructor. The accessor method must be used instead:
$obj->ExcObjType( Galaxies => 1 ); $obj->ExcObjType( GPairs => 1 );
This specifies how to handle objects with name prefixes specified with the NamePrefix field. This is so complicated there's an extra documentation link on the NED site, so I suggest you look there: http://nedwww.ipac.caltech.edu/help/object_help.html#exclcat.
This specifies the types of name prefix used with NamePrefixOp. This is a multi-valued field, meaning that it can hold more than one type of object concurrently. As such, it cannot be initialized in the object constructor. The accessor method must be used instead:
$obj->NamePrefix( ABELL => 1 ); $obj->NamePrefix( 'ABELL S' => 1 );
Use the possible_values method to determine which prefixes are available.
None by default.
Diab Jerius, <djerius@cpan.org>
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
Astro::NED::Query, Astro::NED::Response::Objects, Astro::NED::Response::Object, perl.
To install Astro::NED::Query, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Astro::NED::Query
CPAN shell
perl -MCPAN -e shell install Astro::NED::Query
For more information on module installation, please visit the detailed CPAN module installation guide.