Next Previous Up Contents
Next: cone: Executes a Cone Search-like query
Up: cdsskymatch: Crossmatches table on sky position against VizieR/SIMBAD table
Previous: Usage

### B.3.2 Examples

Here are some examples of `cdsskymatch`:

    stilts cdsskymatch cdstable=II/246/out find=all
                       in=dr5qso.fits ra=RA dec=DEC radius=1 out=qso_2mass.fits

  Matches a local catalogue `dr5qso.fits` against the VizieR table `II/246/out` (the 2MASS Point Source Catalogue). The search radius is 1 arcsecond, and all 2MASS sources within the radius of each input source are returned.

    stilts cdsskymatch cdstable=simbad find=best
                       in=sources.txt ifmt=ascii ra=RAJ2000 dec=DEJ2000 radius=8.5
                       blocksize=1000 icmd=progress omode=topcat

  This finds the closest object in the SIMBAD database within 8.5 arcsec for each row of an input ASCII table. Uploads are done in blocks of 1,000 rows at a time, and progress is displayed on the console. When the match is complete, the result is sent directly to a running instance of TOPCAT.

    stilts cdsskymatch in=3XMM_DR4cat_slim_v1.0.fits
                       icmd='select "SC_POSERR < 1 && SC_EXTENT == 0"'
                       cdstable=B/mk/mktypes
                       ra=SC_RA dec=SC_DEC radius=1.5
                       find=best suffixin=_XMM suffixremote=_MK fixcols=all
                       ocmd='select startsWith(spType_MK,\"G\")'
                       out=xmm_gtype.fits

  This locates XMM-Newton point-like sources identified as being of spectral type G. It uses the 3XMM-DR4 XMM-Newton serendipitous source catalogue as input. The `icmd` filter selects the objects in that catalogue with well-defined point-like positions. It then matches them with Skiff's MK spectral classification catalogue (B/mk/mktypes in VizieR) and finally filters the result to include only those sources identified as being of spectral type G. Thanks to Ada Nebot (CDS) for this example.

Next Previous Up Contents
Next: cone: Executes a Cone Search-like query
Up: cdsskymatch: Crossmatches table on sky position against VizieR/SIMBAD table
Previous: Usage

STILTS - Starlink Tables Infrastructure Library Tool Set
Starlink User Note256
STILTS web page: http://www.starlink.ac.uk/stilts/
Author email: m.b.taylor@bristol.ac.uk
Mailing list: topcat-user@jiscmail.ac.uk