WCSTools programs

stmx Examples

1. Search with results to standard output
2. Search with results to a file
3. Find closest star
4. List selected stars from catalog
5. Match stars in input catalog

Example 1. Search with results to standard output

Find the 10 brightest 2MASS extended sources in a 1-degree square centered on 10:00:00 +10:00:00 J2000 and sort them by right ascension.
stmx -s r -hn 10 -r -1800 10:00:00 +10:00:00 J2000
produces the following:
stmx WCSTools 3.6.9, 11 July 2007, Doug Mink SAO
  2MASS XSC 10:00:00.000 +10:00:00.00 J2000 +- +00:30:27.8 +00:30:00.0 at epoch 2000.0000
10 / 35 2MASS Extended Sources (MagK brighter than 13.72)
2MASS_XSC    RA2000       Dec2000      MagJ    MagH    MagK     Size  Arcsec
1003.000646 09:58:06.914 +10:21:35.31 10.342   9.644   9.394    31.2  2113.13
1003.000647 09:58:24.056 +10:21:45.91 13.035  12.343  11.976    11.6  1926.61
0997.000759 09:58:56.074 +09:46:48.93 12.768  12.065  11.710    12.3  1232.12
1003.000649 09:59:05.127 +10:21:39.95 13.496  12.923  12.543     9.3  1531.73
1002.000666 09:59:08.990 +10:17:02.95 13.725  13.037  12.598     8.4  1270.33
1003.000650 09:59:37.643 +10:19:56.93 12.731  12.063  11.666    16.8  1241.61
0999.000681 09:59:42.451 +09:57:06.93 13.265  12.607  12.163    15.2   311.71
0996.000747 10:00:12.078 +09:38:54.90 12.146  11.478  11.212    15.3  1277.63
1004.000671 10:00:49.948 +10:26:39.11 13.699  13.089  12.738     8.0  1760.91
0995.000704 10:01:11.331 +09:35:17.10 13.520  12.876  12.431    12.0  1819.53

Example 2. Search with results to a file

Find all 2MASS extended sources within 1 degree of M51 and write results to a file
stmx -twr 3600 -o m51 13:27:48.311 +47:27:28.98 B1950
produces the following in the file m51.tmx:
catalog 2MASS XSC
ra      13:27:48.311
dec     +47:27:28.98
radecsys        fk4
equinox 1950.0000
epoch   1950.0000
radsec  3600.00
catsort mag 
program stmx WCSTools 3.6.9, 11 July 2007, Doug Mink SAO
2mass_id        ra1950          dec1950         magj    magh    magk    size    arcsec
-----------     ------------    ------------    ------- ------- ------- ------  ------
1367.000641     13:31:11.982    +46:59:24.45     0.000  14.880  14.161     5.0  2672.50
1375.000599     13:22:50.214    +47:45:49.26     0.000   0.000  14.157     5.0  3208.97
1372.000660     13:27:55.039    +47:28:19.41     0.000   0.000   0.000     0.0  84.84
1371.000733     13:27:38.495    +47:25:26.53     0.000   0.000   0.000     0.0  157.83
1371.000732     13:27:36.659    +47:27:04.60     0.000   0.000   0.000     0.0  120.67
1371.000731     13:27:32.947    +47:24:08.75     0.000   0.000   0.000     0.0  253.77
1378.000674     13:28:19.439    +48:07:10.59     0.000  14.861  14.286     5.0  2402.18
1367.000642     13:31:34.615    +47:01:50.68     0.000   0.000  14.179     5.0  2770.71
1372.000658     13:27:53.208    +47:31:25.45     0.000   0.000   0.000     0.0  241.62
1372.000657     13:27:51.356    +47:33:12.49     0.000   0.000   0.000     0.0  344.90
1372.000656     13:27:42.995    +47:28:08.34     0.000   0.000   0.000     0.0  66.75
1372.000655     13:27:40.850    +47:29:05.43     0.000   0.000   0.000     0.0  122.58
1372.000654     13:27:40.128    +47:27:53.47     0.000   0.000   0.000     0.0  86.53
1371.000736     13:27:56.075    +47:25:16.38     0.000   0.000   0.000     0.0  154.23
1371.000735     13:27:52.228    +47:24:42.47     0.000   0.000   0.000     0.0  171.19
1371.000734     13:27:46.321    +47:27:10.59     6.517   5.817   5.601   197.5  27.31
1372.000659     13:27:53.315    +47:31:25.53     7.361   6.641   6.402   124.2  241.92
 . . .

1366.000664     13:31:41.006    +46:55:15.37    15.363  14.495  13.924     5.6  3060.23
1375.000602     13:28:52.057    +47:50:11.47    15.369  14.891  14.046     5.0  1507.10
1378.000673     13:27:43.196    +48:04:21.66    15.377  15.004  14.261     6.4  2213.28
1372.000649     13:24:03.384    +47:32:49.41    15.379  14.677  14.401     5.0  2301.67
1373.000668     13:25:33.204    +47:34:36.10    15.388  14.740  13.861     5.3  1433.79

Example 3. Find closest star

Find the closest 2MASS extended source to 10:00:00 +10:00:00 J2000
stmx -a 10:00:00 +10:00:00 J2000
produces the following:
1000.000671 10:00:17.655 +10:01:28.49 15.179   0.000  13.648     5.7  275.40

Example 4. List selected objects from catalog

List 2MASS Extended sources 1-10 in region 0900
stmx -s n -h 0900.000001-0900.000010x0.000001
produces the following:
stmx WCSTools 3.6.9, 11 July 2007, Doug Mink SAO
2MASS_XSC    RA2000       Dec2000      MagJ    MagH    MagK     Size
0900.000001 00:00:42.149 +00:01:35.80 14.722  14.152  13.813     5.5
0900.000002 00:00:45.183 +00:04:32.95 15.168  14.422  14.082     5.0
0900.000003 00:00:46.349 +00:03:54.80 14.459  13.673  13.231     5.9
0900.000004 00:01:02.861 +00:04:12.14 15.349  14.737  13.995     5.0
0900.000005 00:02:02.813 +00:04:36.65 15.348  14.910  14.104     5.0
0900.000006 00:02:52.652 +00:00:30.34 14.900  14.196  14.045     5.0
0900.000007 00:03:00.530 +00:03:31.41 15.178  14.346  13.904     5.0
0900.000008 00:03:01.151 +00:03:38.47 15.528  14.664  13.944     5.8
0900.000009 00:04:36.245 +00:01:43.31 15.849  14.798  14.276     5.0
0900.000010 00:05:10.529 +00:05:40.52 15.320  14.377  13.979     5.0
where 0.000 magnitudes indicate that there is no reliable magnitude.

Example 5. Match stars in input catalog

Match the stars in the input catalog test.tab to the 2MASS Extended Source Catalog and list them one match per line.
stmx -l @test.tab
produces the following:
240020 22:15:54.555 -11:36:56.13  9.80  __  0785.001061 22:15:57.656 -11:28:56.07 14.589  13.966  13.556     8.2 6   45.58  480.06  482.22
196784 13:42:07.204 -09:06:40.06  8.60  K0  0807.000744 13:42:56.107 -09:12:03.65 15.036  14.244  13.786     5.5 1  724.20 -323.59  793.21
127373 10:24:43.528 +11:21:21.15 10.20  K0  1015.000619 10:25:01.630 +11:30:06.53 13.626  12.925  12.615     6.7 5  266.14  525.38  588.94
095438 06:07:46.792 +23:28:44.76 10.30  K0  1134.000425 06:08:17.878 +23:28:47.25 15.043  14.170  13.765     7.9 1  427.69    2.49  427.69
where the columns are input catalog star name, RA, Dec, magnitude, spectral type, 2MASS region.number, RA, Dec, J, H, K magnitudes, number of objects in the 900-arcsec-radius default search radius, and catalog-search dra, ddec, and dr (in arcseconds). No objects were found within 900 arcseconds of the second input catalog object.

WCSTools Telescope Data Center

Last updated 11 July 2007 by Doug Mink

[WCSTools] [WCSTools programs] [scat] [stmx] [stmc]