Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1488

News	FAQ
Search	Home

cscatalog.queryimage - Function

	Package	vo
	Module	conesearch
	Tool	cscatalog

Query a catalog for an image

Synopsis
queryimage(im, catalog, fluxrange)

Description
This queries a specific catalog for all sources overlapping the specified image tool. The VOTable is returned after conversion to a componentlist tool. The componentlist tool is anonymous and must be renamed using the componentlist.rename function.

Note that the componentlist contains all sources from the cone that circumscribes the image so there are points in the componentlist that will not be overlaid on the image.

Arguments

im		Image tool
		Allowed:	Image tool
		Default:	None
catalog		Catalog to be queried
		Allowed:	NVSS|FIRST|WENSS
		Default:	NVSS
fluxrange		Flux limitation
		Allowed:	Vector of quantities
		Default:	F

Returns
componentlist

Example

#
# Make an image tool
#
include 'image.g';
im:=image('C1200M24.sub');
# 
# Make a conesearch catalog. This will return a componentlist
#
include 'cscatalog.g';
cs:=cscatalog();
cl:=cs.queryimage(im, 'NVSS', fluxrange='5mJy');
if(is_fail(cl)) fail;
cs.done();
#
# Skycatalog is a simple format for displaying catalogs
#
include 'skycatalog.g'
sc:=skycatalog(spaste(im.name(), '.sc'));
sc.fromcomponentlist(cl);
if(is_fail(sc)) fail;
#
# Now the image and the skycatalog should be visible in the viewer
#
include 'viewer.g';
dv.gui();