aboutsummaryrefslogtreecommitdiff
path: root/vo/votools/doc/qstring.hlp
diff options
context:
space:
mode:
authorJoseph Hunkeler <jhunkeler@gmail.com>2015-07-08 20:46:52 -0400
committerJoseph Hunkeler <jhunkeler@gmail.com>2015-07-08 20:46:52 -0400
commitfa080de7afc95aa1c19a6e6fc0e0708ced2eadc4 (patch)
treebdda434976bc09c864f2e4fa6f16ba1952b1e555 /vo/votools/doc/qstring.hlp
downloadiraf-linux-fa080de7afc95aa1c19a6e6fc0e0708ced2eadc4.tar.gz
Initial commit
Diffstat (limited to 'vo/votools/doc/qstring.hlp')
-rw-r--r--vo/votools/doc/qstring.hlp71
1 files changed, 71 insertions, 0 deletions
diff --git a/vo/votools/doc/qstring.hlp b/vo/votools/doc/qstring.hlp
new file mode 100644
index 00000000..55c46cba
--- /dev/null
+++ b/vo/votools/doc/qstring.hlp
@@ -0,0 +1,71 @@
+.help qstring Mar12 votools
+.ih
+NAME
+qstring -- Generate a query string URL
+.ih
+USAGE
+qstring base field
+.ih
+PARAMETERS
+.ls base
+Base URL or resource name.
+.le
+.ls field
+Query image or field name.
+.le
+.ls type = "catalog"
+Data service type.
+.le
+.ls ra = 0.0
+RA position of query string (object or image center if provided).
+.le
+.ls dec = 0.0
+Dec position of query string (object or image center if provided).
+.le
+.ls size = 0.25
+Desired query size (or size derived from image).
+.le
+
+.ih
+DESCRIPTION
+The \fIQSTRING\fR task .....
+
+.ih
+EXAMPLES
+1. Print the query string used to access the NED service for the field
+covering the dev$ypix test image:
+
+.nf
+ votools> qstring ned dev$ypix
+ http://ned.ipac.caltech.edu/cgi-bin/nph-NEDobjsearch?search_type=Near+Position+Search&of=xml_main&RA=202.47023333333&DEC=47.194552777778&SR=0.1088616739748&RUNID=iraf2160
+.fi
+
+1. Print the query string used to access the NED service for the field
+covering the dev$ypix test image:
+
+.nf
+ votools> qstring ned dev$ypix
+ http://ned.ipac.caltech.edu/cgi-bin/nph-NEDobjsearch?search_type=Near+Position+Search&of=xml_main&RA=202.47023333333&DEC=47.194552777778&SR=0.1088616739748&RUNID=iraf2160
+.fi
+
+2. Print the query string used to access the DSS image service for the field
+covering the dev$ypix test image:
+
+.nf
+ votools> qstring dss dev$ypix type="image"
+ http://skyview.gsfc.nasa.gov/cgi-bin/vo/sia.pl?survey=dss2&POS=202.47023333333,47.194552777778&SIZE=0.1088616739748&RUNID=iraf2160
+.fi
+
+3. Construct a catalog query string for a local URL at an explicit position:
+.nf
+ votools> qstring http://foo.bar/cat ra=1.23 dec=2.34 size=0.2
+ http://foo.bar/cat?RA=1.23&DEC=2.34&SR=0.2&RUNID=iraf2160
+.fi
+
+.ih
+REVISIONS
+.le
+.ih
+SEE ALSO
+getcat, getimg, getspec, vodata
+.endhelp