diff options
| author | Joe Hunkeler <jhunkeler@gmail.com> | 2015-08-11 16:51:37 -0400 |
|---|---|---|
| committer | Joe Hunkeler <jhunkeler@gmail.com> | 2015-08-11 16:51:37 -0400 |
| commit | 40e5a5811c6ffce9b0974e93cdd927cbcf60c157 (patch) | |
| tree | 4464880c571602d54f6ae114729bf62a89518057 /vendor/voclient/doc | |
| download | iraf-osx-40e5a5811c6ffce9b0974e93cdd927cbcf60c157.tar.gz | |
Repatch (from linux) of OSX IRAF
Diffstat (limited to 'vendor/voclient/doc')
80 files changed, 17182 insertions, 0 deletions
diff --git a/vendor/voclient/doc/Notes b/vendor/voclient/doc/Notes new file mode 100644 index 00000000..0bec7c3e --- /dev/null +++ b/vendor/voclient/doc/Notes @@ -0,0 +1,238 @@ + + VO Client-Side Libraries and Applications + v1.0 + + March 2, 2011 + + +Introduction +------------ + + The VOClient/VO-CLI support project (WBS 1.7) is intended to provide +a user-ready software distribution for both scientists and developers. Part +of the work to be done for this project is simple maintenance work required +to bring the code to a common standard, packaging work needed fior distrib- +ution, etc. Additional work is planned to provide new functionality needed +by higher-level projects built from this code. + + +User Applications +----------------- + + We expect to provide the following set of applications in the initial +distribution: + +* vodata Query and Access DAL services +* vodirectory VO Registry query +* vosesame Sesame Name Resolver + voxmatch VO Crossmatch + +* votinfo Print summary information about a VOTable document + votcopy Copy a VOTable to a different format + votlint VOTable validator + + samp Send a SAMP message + sampexec Listender to execute a host command from SAMP message + sampmon Monitor SAMP messages + +* voclientd VOClient Daemon startup script + + (*) Existing application requiring mantenance work only. + + + These applications are built entirely from the various libraries included +in this package. Each task has a complete unix-like man page to document +it's option and functionality as well as test cases that can be used for +Q&A (TBD). The work required for each application is described generally +below and in documentation included in the source tree. + + + +Client-Side Libraries +--------------------- + + The VOClient package will provide a number of APIs to support developers +building science applications of their own or for use in other environments. +These libraries are implemented in C and provide additional bindings for a +number of VO supported languages. Each interface is fully documented and +higher-level "User's Guide" documentation is planned for each interface. + + + VOApps High-level interface to application functionality. + Tasks are built on these routines to provide the + cmdline user interface, but are encapsulated in an + API to provide this functionality to other environ- + ments easily (as opposed to having that functionality + be re-implemented using the low-level interfaces). + + VOTable A VOTable parser library. The interface provides + both read (lax parsing) and write (strict compliance) + capabilities. Reference is VOTable v1.2. + + VOEvent A VOEvent parser library. The interface provides + both read (lax parsing) and write (strict compliance) + capabilities. Reference is VOTable v2.0. + + VOClient A VO Service interface library. This interface uses + the VOClient Daemon to access a variety of VO web + services (Registry, Sesame, DAL services, etc) which + then communicate to the API to pass information back + to the application. + + SAMP Client-side SAMP interface library. This interface + allows an application to send and receive SAMP + messages but does NOT (at this time) provide a local + Hub implementation. Applications can register their + own functions to be used as callbacks in response to + a message, the API provides only the middle-ware needed + to handle the SAMP protocol. + + + The VOApps library represents new development for the package but is +required to for the VO-IRAF Integration Science Initiative project to +allow multi-threaded queries (there is currently no native threading +interface in the IRAF environment). The high-level interface to the task +functionality also makes it trivial to include and extend these tasks in +other environemts or applications. + + The other libraries are mostly "complete", however they require some +work to bring them to a common code standard and to fit properly into the +new package structure. In particular, the VOClient library contains a +VOTable parser interface that should be replaced with code layered on the +more general VOTable parser library. Likewise, existing VO-CLI application +code is a mix of the VOClient interface and what will become the VOApps +interface. Since much of the code is already written, work will concentrate +on moving that code into the new package structure before beginning new +development or serious refactoring of existing code. + + + + +Documentation +------------- + + End-user documentation will be provided for each application and library +in the following form: + + - Command-line applications will have a unix-like manual page detailing + the options for the task, describing it's behavior and providing + working usage examples. + + - Interface documentation consists of Doxygen-generated manuals + created from the in-line source code tags. This documentation + gives a description of each function, its arguments and return + value. Both on-line and off-line formats will be created. Recent + versions of SWIG that generate the multi-language bindings can be + used to preserve the documentation for target languages. + + - Hand-written high-level Programmer's Guides will be written for each + library interface describing it's expected use within an application + and information needed to use the multi-language interfaces. + + + +Examples and Testing +-------------------- + + Usage examples in application help pages will be written to provide +both documentation and test cases for the task. Static resources (i.e. +catalogs rather than observation logs) will be used when necessary to +help ensure results are reproducible and provide a means of regression +testing. These examples can be captured in a script to provide the test +application. + + For library interfaces, example applications will be written in each +of the target languages that can similarly be used for testing. These +example apps will attempt to cover as much of the interface as possible, +unit tests will be developed according to the (TBD) requirements of the +Product Development WBS. + + + +Maintendance Development +------------------------ + + TBD + + + + + + + +Distribution Directory Structure +-------------------------------- + + The restructured VOClient distribution will provide a distribution +containing both command-line applications and the API libraries to be used by +developers. End-user documentation for apps and libraries is also included. +The distribution will have the following directory structure: + + bin - Directory for application binaries + doc - Top-level documentation, User's Guides for libs, + app man pages, etc + include - Include files needed by VOClient APIs, and for + include files needed to build those APIs (e.g. + from CURL or eXpat) + lib - Public libraries and dependency libs (CURL, etc) + used to build the interfaces + + common - Dependency libs used to build the interfaces. This + allows us to use controlled versions and not rely + on platform capabilities. + + apps - Applications provided by this package. Basically + the existing VO-CLI tools plus new work + libvoapps - High-level API to task functionality + libvoclient - VOClient API + libvotable - VOTable parser API + libsamp - SAMP API + + voclient - VOClient Daemon code + + + + +============================================================================= + +A 1) Hi-Level Requirements +--------------------------- + +VOCLient Distribution + 1.1 The VOClient distribution shall be self-contained (i.e. all + dependent code should be bundled with the distribution), binaries + shall run and be buildable from source on VO-supported platforms. + 1.1 The VOClient distribution shall provide complete documentation for + developers and end-users of both the API and command-line apps. + 1.2 The VOClient distribution shall support as many VO services as is + practical within the alloted resources. + +VOCLient API + 2.1 The VOClient API shall be language neutral: It shall be written in C + and provide bindings for all languages supported by the VO, API + methods only return datatype primitives common to all languages + (integers, strings, etc). + 2.2 Example applications for developers shall be be available for all + supported languages, these applications shall also be used in product + testing. + 2.3 All supported languages shall provide the same set of VO capabilities, + example applications, and test cases. + 2.4 Supported languages shall include Fortran and IRAF/SPP (as hand-coded + interfaces when automated bindings are not possible). + +VO-CLI Applications + 3.1 CLI applications shall provide a common interface across all tasks + where possible (i.e. a '-v' flag mean the same to all apps). + 3.2 CLI applications shall allow result tables to be saved is a format + other than VOTable. + 3.3 CLI applications shall process lists of input when appropriate and + allow simultaneous queries of VO services. + +VOCLient Daemon + 4.1 The VOClient daemon shall trap and return service errors to the API + code and higher-level applications. + 4.2 The VOClient daemon shall support multiple simultaneous clients. + 4.3 The VOClient daemon shall be started automatically by any + application using the VOClient API if it is not already running. + 4.4 The VOClient daemon shall be extensible to new services. + diff --git a/vendor/voclient/doc/Notes-CLI b/vendor/voclient/doc/Notes-CLI new file mode 100644 index 00000000..c57e613c --- /dev/null +++ b/vendor/voclient/doc/Notes-CLI @@ -0,0 +1,172 @@ + +Common Flags: + + -h Print task help + -v Verbose output + -q Suppress all output + +d Debug output + + + +------------------------------------------------------------------------------- + +Registry: + vodirectory VO Resource discovery (keyword search, resolution, info) + + +------------------------------------------------------------------------------- + +Data Access: + vodata Query and Access VO data (general engine) + vocatalog Query VO catalog services (SAMP load to overlay) (1 + voimage Query VO image services (SAMP load to display) (1 + vospectrum Query VO spectrum services (SAMP load) (1 + + dss Load DSS field in display (SAMP to ds9/aladin) (1 + obslog Query public observation logs (SAMP table load) (1 + + + +------------------------------------------------------------------------------- + +VOTable: + Common Flags: + -i <fname> Input filename (else STDIN) + -n Number rows + -o <fname> Output filename (else STDOUT) + -r <range> Extract range of rows + + + votcopy Copy to/from votable format + + votcopy [flags] [<in>] [<out>] + + -f <fmt> Specify format (fits|ascii|asv|bsv|csv|tsv) + + + votget Download data access references in a VOTable (w/ selection) + + votget [flags] <votable> + + -A <ucd> Specify UCD for access reference + -F <ucd> Specify UCD for format description + -N <N> N-threads to download + + -b <base> Base filename + -c <col> Download reference in column N (1-indexed) + -e <extn> Filename extension + -f <fmt> Format to download + -l List instead of download references + + + votinfo Print information about a votable + + votinfo [flags] <votable> + + -N <what> Print number of <what> elements + -s Print size of table (ncols x nrows x nres) + -f name|id|ucd Find column by value + -p name|id|ucd Print column name/id/ucd + + + votpos Extract position columns from a VOTable + + votpos [flags] <votable> + + -r <range> Extract from row range + + + votsplit Split a multi-resource votable (opt. output conversion) (2a + + votsplit [flags] <votable> + + -R <resnum> Extract specified resource number (can be range) + + -b <base> Base filename + -e <extn> Filename extension + -f <fmt> Output format + + + votjoin Join multiple votables into a multi-resource table (2a + + votjoin [flags] <votable> ..... + + -N <name> Base name for <RESOURCE> + + + +------------------------------------------------------------------------------- + +SAMP: + Common Flags: + -r <recip> Send to specific app, otherwise broadcast + -p <sync|async> Send as specified pattern + + + samp SAMP utility command (list clients, start hub, etc) + + samp [flags] <cmd> + + -f <file> Process commands in <file> + + <cmd> is one of: + access <app> Is <app> available? (status=0 or 1) + list List available clients + ping Ping a specified client + sub <mtype> Print which clients are subscribed + meta <key> Print client metadata + getenv <key> Get client environment value + setenv <key> <val> Set client environment value + getpar <key> Get client parameter value + setpar <key> <val> Set client parameter value + exec <cmd_str> Execute command string + load <file> Load the named file (as appropriate) + + send <mtype> [k=v] Send message (low level) + listen <mtype> Wait for specified mtype + + snoop Print all messages seen + help Print help summary + + proxy <server> <key> Run as proxy to forward messages + + + proxy + (inet:6543:server) + / \ + App / | \ App + \ / | \ / + App - Hub -- samp | samp -- Hub - App + / | \ + App | App + + + +------------------------------------------------------------------------------- + +Cross-Compare + voxmatch Cross-compare local table an VO data (3 + + +------------------------------------------------------------------------------- + +VOSpace: + + vosput Put files to a VOSpace (4 + vosget Get files from a VOSpace (4 + vosmove Move files/nodes between VOSpaces (4 + voslist List files/nodes in a VOSpace (4 + vosdelete Delete files/nodes in a VOSpace (4 + + +------------------------------------------------------------------------------- + +Name Resolver: + sesame Resolve object names to positions + + +------------------------------------------------------------------------------- + +Moving Targets: + skybot List known moving objects in an image (2b + diff --git a/vendor/voclient/doc/OLD/vodata.html b/vendor/voclient/doc/OLD/vodata.html new file mode 100644 index 00000000..7f8a3851 --- /dev/null +++ b/vendor/voclient/doc/OLD/vodata.html @@ -0,0 +1,1152 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VODATA</TITLE> +</HEAD><BODY> +<H1>VODATA</H1> +Section: User Commands (1)<BR>Updated: July 2007<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +vodata - query and access VO data services +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>vodata</B> [<I><flags></I>] [ <<I>resource</I>> [[ <<I>objname</I>> [ <<I>sr</I>> ]]] ] +<P> +<B>vodata</B> [<I><flags></I>] [ <<I>resource</I>> [[ <<I>ra</I>> <<I>dec</I>> [ <<I>sr</I>> ]]] ] +<P> +<B>vodata</B> [<I><flags></I>] [ <<I>url</I>> ] +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>vodata</I> task accepts the following options: +<DL COMPACT> +<DT><B>-h,--help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<DT><B>-v,--verbose</B> + +<DD> +Verbose output. The output will be more verbose than normal but exactly +what is printed depends on whether other flags are enabled to changed the +basic task behavior. +<DT><B>--vverbose</B> + +<DD> +Very-verbose output. Even more output. +<P> +<DT>The following flags control the major behavior of the task, i.e. the type <DD> +of output to present. +<DT><B>-a, --all</B> + +<DD> +Perform an action based on all available data. When used as part of a +data query, this flag causes the <<I>resource</I>> argument to be used in +a substring match of Directory <I>ShortName</I> or <I>Identifier</I> fields +to create the actual list of resources to be queried. If the <I>ShortName</I> +of a <I>TABULARSKYSERVICE</I> from Vizier is given, the <<I>resource</I>> +will typically expand to include all tables associated with the paper, +and providing a means to access all of these tables from a single query. +<DT><B>-c, --count</B> + +<DD> +Print only a count of the matching records found and do not save any +results. The standard output for the task is to echo some of the input +parameters and print a table of results showing progress and the number +of matching records. If this flag is set, the output written to the +screen will be the same, however the data will not be saved locally. +<DT><B>-g, --get</B> + +<DD> +Get the data referenced by the results of a data query. This typically +only applies to Simple Image Access service in which the result of a +query include a column of "<I>access references</I>" to the actual data +that must be resolved separately. Setting this flag will cause all data +references to be resolved by the task once all of the data queries have +been completed. +<P> +Access references are appended to a master "access list" as each query +completes. In general the order in which these are retrieved cannot be +guaranteed. Data downloads can be done in parallel by setting the number +of concurrent max downloads using the <I>--maxdownloads=<N></I> flag, the +default is to download one file at a time. If this flag is followed +with a comma-delimited list of numbers, only those rows in the result +table will be accessed. +<DT><B>-m, --meta</B> + +<DD> +Print only the column metadata for the named services. The output will be +a list of the columns return by a data query to the service, but will not +save the actual data. A default position and search size will be used for +the query: In the case of Cone services a negative size is used, for SIAP +services the FORMAT=METADATA flag is used in the query, and for tabular +Vizier services the entire table is accessed. Compliant VO services will +respond quickly with only the column metadata, tabular services may respond +more slowly due to the need to transfer the data. Adding the <I>-v</I> or +<I>--verbose-<N></I> options will increment the VERBOSE level of services +and may return more metadata if available, to access these extra columns +the same level of verbosity must be set during a data query. +<P> +<DT>The following flags specify data query options:<DD> +<DT><B>-b <bpass> or --bandpass=<bpass></B> + +<DD> +Constrain the query by bandpass. The argument following the flag must +be one of the allowed bandpass specification string. Setting the flag +will constrain any Directory search used to only those resources where +the spectral coverage matches the given bandpass. Aliases for bandpasses +are allowed, see below. +<DT><B>-i <file></B> + +<DD> +Specify a file containing the remaining positional command-line input. The +command line is thought of as having the following components: the options +beginning with a '-' character and their associated arguments, one or more +<<I>resource</I>> names giving the service to invoke, an object name or +position, and an optional query size. The '-i' flag allows everything +except the options to be specified from a file (or the standard input if +the '-' argument is used), creating in effect a means to interactively +specify the e.g. resource/object without restarting the task, or to take +these values from a file or input stream to create multiple independent +queries. If either the resource or object name/position has already been +specified they do not need to be specified again. +<P> +The format for the command file is the same as for the <<I>resource</I>>, +<<I>objname</I>>, <<I>ra</I>> <<I>dec</I>>, <<I>url</I>>, or <<I>sr</I>> described +below and as they would appear on the command line, all input lines are +terminated with a newline, the file or input stream is terminated with an +EOF. An example of how this +may be used would be the using a command file such as: +<P> +<PRE> + 2mass-psc m31,m51 0.5 + chandra ngc4258,m51 0.25 +</PRE> + +<P> +The task will process this file as if the two lines had been invoked as +separate commands. The advantage is that this input can be created +dynamically by another task, and we can group resource and object lists +into independent queries. See the <I>Examples</I> below for other uses. +<DT><B>-o <obj|file> or --object=<obj|file></B> + +<DD> +Specify the object name to use in a query. Object names are resolved +automatically to J2000 equatorial coordinates. The argument to this +flag may be the name of a single object, a comma-delimited list of +object names, the name of a file containing object names, or the +reserved value '-'. +<P> +The reserved value '-' tells the task to take this information from the +standard input, processing doesn't begin until the object list has been +fully read. +<DT><B>-p <pos|file> or --pos=<pos|file></B> + +<DD> +Specify the position to use in a query. Positions are composed of two +values assumed to be equatorial J2000 coordinates. +Values specified as a floating-point decimal are assumed to be in units +of degrees, sexagesimal values may also be used and are assumed to be +equatorial RA and Dec. If the <I><pos></I> arg is used only one set of +coordinates may be given on the command-line and must be delimited by a comma, +however the argument may also be the name of a file containing coordinates +to be processed, or the reserved value '-'. +<P> +The reserved value '-' tells the task to take this information from the +standard input, processing doesn't begin until the position list has been +fully read. +<DT><B>-r <radius> or --sr=<radius>[<units>]</B> + +<DD> +Set the search radius. The default search size is 0.1 degrees unless +specified on the command-line and argument are assumed to be +in degrees, setting the size in other units is permitted using the +<I>-sr</I> flag. To specify the <units> for the <I>--sr</I> flag, the +argument should be suffixed by an 's' to specify arcseconds, an 'm' to set +arcminutes, and 'd' to set the size in degrees. By default, all +queries will be done using the same search size. Variable search +sizes accomplished using the '-i' flag described above. +<DT><B>-s <service> or --svc=<service></B> + +<DD> +Specify the service or url to invoke. In most cases the service, i.e. +the <<I>resource</I>> argument will be taken from the commandline based on +it's position. The exception is when the user want to specify a service +URL directly (e.g. to test a local service) because it isn't known to the +Directory, or to use the reserved values '-' or 'any'. Use of '-' tells +the task to read the service list from the standard input; use of +the word 'any' is a means to telling the task to dynamically create the +resource list from other options (e.g. "any image service" by using the + +<DT><B>-t <type> or --type=<type></B> + +<DD> +Constrain the query by service type. The list of allowed service types +is given below. The actual string used in a Directory resource record +may be used if known, otherwise common use is to specify 'image' to +access Simple Image Access (SIAP) services, 'catalog' for Cone searches, +or 'table' for Vizier tabular data. +<P> +<DT>The following flags are specific to the writing of HTML or KML files:<DD> +<DT><B>--webnoborder</B> + +<DD> +Disable the shaded border drawn around an HTML table. +<DT><B>--webnocolor</B> + +<DD> +Disable the coloring for an HTML table. +<DT><B>--webnoheader</B> + +<DD> +Disable the HTML page header written to the output file. +<P> +<DT><B>--kmlmax=<N></B> + +<DD> +Specify the max number of placemarks to write. The default is 50, ordering +is not guaranteed. Setting the sampling will automatically increase the +maximum number of results returned. +<DT><B>--kmlsample=<N></B> + +<DD> +Specify the sampling of the result to be every <I><N></I> rows. The +default is to write all rows to the output file. If set, this value will +be used as a multiplier for the max number of placemarks automatically. +<DT><B>--kmlgroup=object </B> + +<DD> +Group the results of a multi-resource/multi-object query into a single +hierarchical KML file grouped by the object or position index (default); +<DT><B>--kmlgroup=service </B> + +<DD> +Group the results of a multi-resource/multi-object query into a single +hierarchical KML file grouped by the service name. +<DT><B>--kmlgroup=both </B> + +<DD> +Groups the results of a multi-resource/multi-object query into a single +hierarchical KML file. The two top-level folders will be 'By Source' and + +<DT><B>--kmlnolabel</B> + +<DD> +Disable the labelling of placemarks. By default, the ID_MAIN ucd for +each point will be used as a label. +<DT><B>--kmlnoregion</B> + +<DD> +Disable the drawing of the region bounding box in a KML file. +<DT><B>--kmlnoverbose</B> + +<DD> +Disable the writing of verbose information to the KML placemarks. By +default, each placemark will contain all information from that result. +<P> +<P> +<DT>Input Options:<DD> +<DT><B>--cols=</B><I>col_str</I> + +<DD> +Use columns specified in <I>col_str</I> to read the <I>ra</I>, <I>dec</I> +and <I>id</I> values respectively. <I>col_str</I> is a comma-delimited +list where the <I>id</I> column is optional and will not be used if not +present as the third element in the list. Other columns may be given as +a single integer or as a range of the form <I>start</I>-<I>end</I> indicating +the values in the <I>start</I> thru <I>end</I> columns should be combined +into a single value. +<DT><B>-d, --delim=</B><I>delim</I> + +<DD> +Use the <I>delim</I> as the input table delimiter. By default, a space, tab, +comma, vertical bar ('|'), or semicolon may be used as a delimiter for the +input table. If no explicit delimiter is specified, the first occurance of +any one of these will be used. The reserved words <I>comma</I>, +<I>space</I>, <I>tab</I>, or <I>bar</I> may be used in place of a specific +character. +<P> +<DT><B>--ecols=</B><I>col_str</I> +<DT><B>--ecols=</B><I>col_str</I> + +<DD> +Use the explicit columns specified in <I>col_str</I> in the input table. This +option should only be used with formatted text tables where the desired +values will always be in the same columns of the file. Note that 'column' in +this case refers to a specific character column in a text file. Columns +may be a single integer or a range, and is a comma-delimited list as with +the <I>--cols</I> option. +<DT><B>-f, --force</B> + +<DD> +Force the input table to be used even in the number of columns varies on +each line. The assumption here is that any variation (e.g empty columns) +occurs after the <I>ra</I>, <I>dec</I> and <I>id</I> columns in the table. +<DT><B>--hskip=</B><I><N></I> + +<DD> +Skip <I><N></I> header lines in the input file. This option is only needed +when the lines to be skipped do not begin with the normal '#' comment +character. +<DT><B>--nlines=</B><I><N></I> + +<DD> +Use only <I><N></I> lines of the input table. +<DT><B>--sample=</B><I><N></I> + +<DD> +Sample the table every <I><N></I> lines. Setting the sample will not affect +the <I>nlines</I> used. +<P> +<P> +<DT>Output Options:<DD> +<DT><B>-1,--one</B> + +<DD> +Save the results into a single file regardless of format. This option will +be set automatically if the output is being written to the standard output. +If the output format is something other than KML or XML, all results will +be concatenated into individual files of the form +"<svc>_<pid>.<extn>" so that each file will contain the object results from +each service where the columns will be the same. +<DT><B>-A,--ascii</B> + +<DD> +Save the results as a whitespace delimited ascii table. If an output file +is created it will have a ".txt" extension appended automatically. +<DT><B>-C,--csv</B> + +<DD> +Save the results as a comma-separated-value (CSV) table. If an output file +is created it will have a ".csv" extension appended automatically. +<DT><B>-H,--html</B> + +<DD> +Save the results as an HTML table. If an output file +is created it will have a ".html" extension appended automatically. See +above for the <I>--webnoheader</I> option that can be used to disable the HTML page +header. +<DT><B>-I,--inventory</B> + +<DD> +Query the <I>Inventory Service</I> rather than the data services directly. +This will return simply a count of the results found, but when presented +with a table of resources and sources can be used to do a simple +crossmatch of the sources found in the catalogs available through the +service. +<DT><B>-K,--KML</B> + +<DD> +Save the results as a Google Earth/Sky KML placemark file. If an output file +is created it will have a ".kml" extension appended automatically. See +above for additional options that control the content of the file. +<DT><B>-R, -V or --raw, --votable</B> + +<DD> +Save the results as a raw VOTable. If an output file is created it will +have a ".vot" extension appended automatically. +<DT><B>-T,--tsv</B> + +<DD> +Save the results as a tab-separated-value (TSV) table. If an output file +is created it will have a ".tsv" extension appended automatically. +<DT><B>-O <root> or --output=<root></B> + +<DD> +Set the root of the output name. The reserved value '-' tells the task to +write to the standard output. +<DT><B>-X,--xml</B> + +<DD> +Save the results wrapped XML file of the raw VOTable results. If an output +file is created it will have a ".xml" extension appended automatically. The +XML document will gather all the individual VOTable result files to a single +XML document, where each entry is wrapped by the element <I><VOTABLE_ENTRY></I>. +There will be three attributes: <I>svc</I> will be the data service name, +<I>obj</I> will be the object name (if supplied), and the <I>index</I> attribute +giving an index into the results. This index list is created by looping over +each service, and for each service, looping over the object/position list. +<DT><B>-e,--extract</B> + +<DD> +Extract positional and access information to extra output files. By +default both files will be written, using <I>--extract=pos</I> will write only the +positional information file, using <I>--extract=urls</I> will write the access URLs only. +Access URLs are written one-per-line to a file with the same root name as +the main output but with a ".urls" extension; Positional information is +written to a file with a ".pos" extension and will contain three columns +made up of the identifier (the column with the <I>ID_MAIN</I> ucd), RA and +Dec (the <I>POS_EQ_RA_MAIN</I> and <I>POS_EQ_DEC_MAIN</I> ucd columns +respectively). If these ucds appear more than once in a table, the first +occurrance will be used. +<P> +Additionally, the <I>--extract=headers</I> and <I>--extract=kml</I> flags may be to to specify the +HTML and KML output be written to files with ".html" and ".kml" +extensions respectively. The <I>--extract=KML</I> flag will cause multi-resource +and/or multi-object queries to be collected into a single KML file. +The format-specific <I>--kml<opt></I> and <I>--web<opt></I> flags will apply to these files. +A <I>--extract=xml</I> flag will force the output format to be raw VOTable and gather +the results to a single XML document (see the <I>-X</I> option). +<P> +Note that the URLs file can be used to later access the data (perhaps +after sub-selecting from the table based on some criteria) by calling +the task again using the filename as the only argument. +<DT><B>-n,--nosave</B> + +<DD> +If enabled, this flag tells the task not to save results to local disk. +Status and result information will continue to be printed to the screen, +but no data are saved to disk. +<DT><B>-q,--quiet</B> + +<DD> +Quiet mode. Suppress any extraneous output and warning messages. +<DT><B>-u,--url</B> + +<DD> +Force the specified URL to be downloaded. +<P> +<P> +<DT>DAL2 Query Options:<DD> +<DT><B>--band=</B><I>band_string</I> + +<DD> +The spectral bandpass is given in range-list format. For a numerical +bandpass the units are wavelength in vacuum in units of meters. +The spectral rest frame may optionally be qualified as either +<I>source</I> or observer, specified as a range-list +qualifier. Bandpass names are often not useful for spectra (they are +probably more useful for image or time series data) but there are cases where +they are useful for spectra, for example for a velocity spectrum of a +specific emission line. +<DT><B>--time=</B><I>time_string</I> + +<DD> +The time coverage (epoch) specified in range-list form as defined in section +8.7.2, in ISO 8601 format. If the time system used is not specified UTC is +assumed. The value specified may be a single value or an open or closed +range. If a single value is specified it matches any spectrum for which the +time coverage includes the specified value. If a two valued range is given, a +dataset matches if any portion of it overlaps the given temporal region. +<P> +<P> +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <B>vodata</B> task allows a user to query and access VO data for multiple +resources and objects from a desktop or scripting environment. By design, +the task interface is meant to provide the following features: +<P> +<DL COMPACT> +<DT><B>-</B> + +<DD> +Resources (i.e. data services) may be referred to using a more familiar +<I>ShortName</I> designation, or an IVO identifier, either of which will be +resolved to a specific <I>ServiceURL</I> internally using the Directory. +<DT><B>-</B> + +<DD> +Object names may be used to specify the location of a data query, the +position will be resolved internally using the <I>Sesame</I> web service. +<DT><B>-</B> + +<DD> +Output files may be created in a variety of common formats easily manipulated +with other desktop tools. +<DT><B>-</B> + +<DD> +Multiple resources and objects shall be queried in parallel when possible to +optimize the task. +<DT><B>-</B> + +<DD> +Data referenced in a query response should be accessible by the task +automatically. +<DT><B>-</B> + +<DD> +The command-line interface should be as friendly and as flexible as possible +to allow the task to be used in multiple ways. +<P> +</DL> +<P> + +The task should quickly become familiar to users and is meant operate in +concert with the <B>vodirectory</B> and <B>vosesame</B> tasks to allow novice +users to begin to explore for data resources to be used in the final query. +Some of the flexibility of the task is shown in the Examples section below. +Major concepts of the task are detailed below as well. +<P> +<BR> +<A NAME="lbAF"> </A> +<H3>Argument Parsing</H3> + +<P> + +The meaning of the various command-line arguments is detailed below: +<P> +<DL COMPACT> +<DT><B></B><I><resource></I> + +<DD> +The <I>ShortName</I> or <I>Identifier</I> of a data resource to be queried, a +comma-delimited list of either, or the name of a file containing either. +These names will be resolved to a data service URL using the Directory. The +<I>-s</I> option may be used to specify a non-registered <I>ServiceURL</I> that +the task may use, however the <I>-t</I> option is then also required to +specify the type of service. +<DT><B></B><I><objname></I> + +<DD> +The name of an object, a comma-delimited list of object names, or the name of +a file containing object names. The coordinates of each object will be +resolved to a position prior to processing using the <I>Sesame</I> name +resolver service. An error will be returned if an object name cannot be +resolved, and that object will be skipped. +<DT><B></B><I><ra> <dec></I> + +<DD> +The J2000 equatorial RA and Dec position to the searched. Values given as +floating point values are assumed to be in decimal degrees, sexagesimal +values are assumed to be equatorial RA/Dec positions. Sexagesimal values may +be of the form <I>hh:mm:ss.s</I> or <I>hh:mm.m</I> for RA, or +<I>dd:mm:ss.s</I> or <I>dd:mm.m</I> for Dec. Only one coordinate pair may be +specified on the commandline. +<DT><B></B><I><sr></I> + +<DD> +The search size for the data query specified in decimal degrees. The default +size of 0.1 degrees will be used if this is not specified on the command line. +The <I>-rs</I> and +<I>-rm</I> options may be used specify the size in arc seconds and minutes +respectively. The <I>-i</I> option may be used to specify command-line input +options, where each command-line can include a different value for the search +size, otherwise only one value is allowed. +<DT><B></B><I><url></I> + +<DD> +A single URL, or the name of a file containing URLs listed one per line. +<P> +<P> +</DL> +<A NAME="lbAG"> </A> +<H3>Multi-Thread and Multi-Process Data Querying</H3> + +<P> + +All data queries require at least one <I>resource</I> and one <I>source</I> +to be successful. The <I>resource</I> defines a specific data service to be +queried, and the <I>source</I> is either an explicit position on the sky or +the name of an object that can be resolved to a position. Additional +parameters to the query are used to specify other options, but in essence +each data query is translated to a single URL that must be accessed by the +client task. In a complex query, lists of resource and/or objects create a +potentially large matrix of queries that must be made (i.e. +<I>N-services</I> by <I>N-objects</I> in total). Because a large fraction of +the time spent in waiting for a query to finish is in waiting for the +server to respond, we are able to run multiple queries simultaneously +without saturating our network bandwidth in most cases. +<P> + +The <B>vodata</B> task will parallelize the list of services to be queried +by running a separate processing <I>thread</I> (i.e. a lightweight process +running in parallel within the main application) for each of the services +to be called. This allows queries to different servers to be run in +parallel, and since these servers will often reside on multiple machines +the client won't impact any one data provider too badly. In addition, +the list of objects to be queried at each service will be broken up into +multiple child processes and called simultaneously. This allows, for +example, 10 objects to be queried from 3 services (a total of 30 queries) +simultaneously. +<P> + +The <I>--maxthreads=<N>mt</I> option can be used to set the max number of threads to be +created for processing the resource list (the default is 20). If the +resource list is larger than this value, the list will be processed with no +more than the max number running at any one time until all resources have +been queried. Similarly, the <I>--maxprocs=<N></I> option can be used to set the +number of child processes to be created to process the object list (the +default is 10). When setting these values it is important to remember that +the total number of <I>potential</I> processes running on your machine will +be the product of these to values. The default values were empirically found +to work reasonably well on most modern machines. +<P> + +Additionally, it is worth considering the potential strain that can be put +on data providers' machines before changing these settings. The large +majority of Cone services for example come from a single server at HEASARC +and overloading the server with hundreds of requests to multiple resources +it provides may result in a failed request and what would appear to be no +data. One should consider using the <I>-i</I> flag as a means to query a +large object list against a resource list such that only the object +processing is parallelized and the server load is minimized (See the example +below). +<P> +<P> +<A NAME="lbAH"> </A> +<H3>Output Filename Generation</H3> + +<P> + +The <I>-O</I> option may be used to specify the root part of output files +created by a data query. However, to guarantee that a multi-service, and/or +multi-object query doesn't overwrite a single output file, the filename root +will also include the <I>pid</I> (process ID) of the task that created it. +For a single service and object query no <I>pid</I> will be used as part of +the filename. This scheme guarantees unique output files across the various +processing scenarios, with similar root names for multiple files associated +with a specific query. +<P> +Output tables may be created in a number of formats and will likewise have +extensions indicating the table type. The <I>-e</I>/<I>--extract</I> option +may create additional files for each query, and the <I>-g</I>/<I>--get</I> +option to access data will similarly create additional files. The structure +of an output filename is: +<P> +<PRE> + + <I><root>[_<pid>].<extn></I> + +</PRE> + +The meaning of <I><pid></I> and <I><extn></I> have been discussed above. If +the <I>-O</I> option was set then the <I><root></I> part of the name will +simply be the argument given to set the root name. Otherwise, the <I><root></I> +element will be of the form: +<PRE> + + <I><svc>_<type>_<objname></I> + <I><svc>_<type>_<index></I> + +</PRE> + +The <I><svc></I> is derived from the service name used, the <I><type></I> is +a single-character code to indicate the type of service used ('I' for image, + +object name or the index in a list of positions of no object was specified. +<P> +<A NAME="lbAI"> </A> +<H3>Verbosity</H3> + +<P> + +The <I>-v</I> and <I>-vv</I> options serve a dual purpose: within the task they +set the level of output verbosity in terms of what is reported during +processing (Similarly, the <I>-q</I> option can be used to turn off output +reporting entirely). These flags will however also increase the value of the +<B>VERBOSE</B> parameter sent to services during a data query. The default +value is at least 1, with the highest level being 3. Using the <I>-v</I> flag +sets <B>VERBOSE=2</B> and <I>-vv</I> sets <B>VERBOSE=3</B>. +<P> + +The VERBOSE level can be important in accessing result columns that may only +be returned at the highest level. When using the <I>-m</I> +(or <I>--meta</I>) flag to print +the column metadata, the verbose options will also affect the results and it +is important that the same verbosity be set when doing the actual data +query and access. +<P> +<A NAME="lbAJ"> </A> +<H3>Bandpass and Service Type Aliases</H3> + +<P> + +The type constraint (<I>-t</I> or <I>--type</I>) accepts only the +following arguments: +<PRE> + + catalog Cone search services + image Simple Image Access services + spectra Simple Spectral Access services + table Vizier services + <literal> ResourceType from Directory record + +</PRE> + +<P> + +The bandpass constraint (<I>-b</I> or <I>--bandpass</I>) accepts only +the following arguments: +<PRE> + + Radio Millimeter Infrared (IR) + Optical Ultraviolet (UV) X-Ray (xray) + Gamma-Ray (GR) + +</PRE> + +Values in parenthese are acceptable aliases. All matches are cases +insensitive. +<P> +<P> +<A NAME="lbAK"> </A> +<H3>Range-List Parameters</H3> + +<P> + +Some parameters (for example BAND and TIME) may allow a parameter value to be +specified as a numeric range. Such range-valued parameters use the forward +slash (<I>/</I>) character as the separator between elements of the +range specification (as in the ISO 8601 date specification after which this +convention is patterned). For example, <I>5E-7/8E-7</I> would +specify a range consisting of all values from 5E-7 to 8E-7, inclusive. If a +third field is specified it is a step size for traversing the indicated +range. If a parameter permits a step size the semantics of the step size are +defined by the specific parameter. +<P> + +An open range may be specified by omitting either range value. If the first +value is omitted the range is open toward lower values. If the second value +is omitted the range is open toward higher values. Omitting both values +indicates an infinite range which accepts all values. For example, +<I>/5</I> is an open range which accepts all values less than or +equal to 5. To specify all values less than 5, <I>/4</I> would be +used (for an integer valued range). Range values are limited to numeric +values or ISO dates. +<P> + +A list may be qualified by appending the character <I>;</I> (semicolon) +followed by a qualifier string. For example <I>1E-7/3E-6;source</I> could +specify a spectral bandpass in the rest frame of the source. List and +range syntax may be combined, e.g., to indicate a list of scalar or +range-valued parameter values. Such a range list may be ordered or +unordered, and may contain either numeric or string data. An ordered +list is one which requires values to be processed in a specified order, +and to ensure this the range list is sorted or ordered by the service as +necessary before being used. It is the responsibility of the service to +sort an ordered range list, hence the client can input ranges or range +values in any order for an ordered range list and the result will be +the same. The sequence in which items in an unordered list occur on the +other hand is significant, as since there is no intrinsic ordering for +the list which can be enforced by the service, items will be processed +by the service in the order they are input by the client. +<P> + +TIME and BAND are typical examples of ordered range lists. Since a dataset +matches the query if it contains data in any of the specified ranges, +logically it does not matter in what order the ranges are given, or whether +the first element of a range is less than the second, or whether ranges +overlap; the result should be the same in all cases. Hence the range list has +an intrinsic ordering irrespective of how ranges are input. Unless otherwise +specified in the definition of a given parameter, range lists are assumed to +be ordered. +<P> +<BR> +<P> +<A NAME="lbAL"> </A> +<H2>VOCLIENT DAEMON PROCESSING</H2> + +All VO-CLI tasks are built upon the VOClient interface an rely on a +separate <I>voclientd</I> process to provide the VO functionality. The +voclientd task is distributed as part of VO-CLI and will be started +automatically by each task if it is not already running. If problems are +encountered, you may want to manually start the voclientd in a separate +window before running the task so you can monitor the output for error +messages. +<P> +<A NAME="lbAM"> </A> +<H2>RESOURCE CACHING</H2> + +Directory resolution is a common activity of VO-CLI tasks and so results +will be cached in the $HOME/.voclient/cache/regResolver directory based on +the search term, service type and bandpass parameters. Defining the +<I>VOC_NO_CACHE</I> environment variable will cause the task to ignore the +cache. +<P> +<A NAME="lbAN"> </A> +<H2>EXAMPLES</H2> + +<P> +<DL COMPACT> +<DT>1)<DD> +Query the GSC 2.3 catalog for stars a) within the 0.1 degree +default search size around NGC 1234: b) around all positions +contained in file 'pos.txt': c) for the list of objects given +on the command line: d) query a list of services for a list +of positions: e) print a count of results that would be returned +from 3 services for each position in a file: +<PRE> + + % vodata gsc2.3 ngc1234 (a) + % vodata gsc2.3 pos.txt (b) + % vodata gsc2.3 m31,m51,m93 (c) + % vodata svcs.txt pos.txt (d) + % vodata hst,chandra,gsc2.3 pos.txt (e) + +</PRE> + +<P> +<DT>2)<DD> +Query all (142) image services having data of the subdwarf galaxy +IC 10, print a count of the results only: +<PRE> + + % vodata -c -t image any IC10 + % vodata --count --type=image any IC10 + +</PRE> + +Note that we use the reserved word '<I>any</I>' for the service name and +constrain by image type. The task will automatically query the Directory to +create the list of services to be queried. +<P> +<DT>3)<DD> +Print a count of X-ray catalog data around Abell2712: +<PRE> + + % vodata -c -t catalog -b x-ray any abell2712 + % vodata --count --type=catalog --bandpass=x-ray any abell2712 + +</PRE> + +In this case we constrain both the service type as well as the spectral +coverage published for the resource in the Directory. We use the reserved +<I> +any</I>' service name to query multiple services and use the '<I>-c</I>' +flag to print a count without saving results. The object name is resolved +to coordinates internally. (Note: this example may take a while to run). +<P> +<P> +<DT>4)<DD> +Print the column metadata returned by the RC3 catalog service: +<PRE> + + % vodata --meta rc3 or vodata -m rc3 + +</PRE> + +The output will print the result using the default VERBOSE level, adding +the <I>-v</I> will set the query parameter VERBOSE=2, adding <I>-vv</I> will +set VERBOSE=3 (to print all available columns). When accessing data the +same <I>-v</I> flags will be required to retrieve columns at that +<I>VERBOSE</I> level. +<P> +<P> +<DT>5)<DD> +Use the Directory to query for resources using the search terms +"cooling flow". Upon examining the output the user notices a +Vizier paper titled "<I>Cooling Flows in 207 clusters of Galaxies</I>" +that looks interesting. Use the <B>vodata</B> task to download all +tables associated with this paper, save tables in the default +CSV format: +<PRE> + + % vodirectory cooling flow + % vodata -O white97 -all J/MNRAS/292/419/ + % vodata --output=white97 --all J/MNRAS/292/419/ + +</PRE> + +All 7 tables will be written to the current directory to files +having a root name 'white97' (chosen based on the author and +publication date). +<P> +<P> +<DT>6)<DD> +Find a suitable XMM image service, get a (brief) count of the +XMM images available for 3c273, and if there aren't too many, +download the images and save the extracted access URLs: +<PRE> + + % vodirectory -rv -t image xmm + ShortName ResourceType Title + ------------------------------------------------------.... + XMM-Newton SIAP/ARCHIVE XMM-Newton Archive .... + + % vodata -cq xmm-newton 3c273 + xmm-newton 27 I XMM-Newton Archive .... + + % vodata --count --quiet xmm-newton 3c273 + xmm-newton 27 I XMM-Newton Archive .... + + % vodata --get xmm-newton 3c273 + .... will query and download 27 images. + +</PRE> + +<P> +<DT>7)<DD> +Query for the images available from 2MASS at a given position, +extract the positions and service URLs to separate files: +<PRE> + + % vodata -e -O 2mass -t image 2mass 12:34:56.7 -23:12:45.2 + % vodata -e --output=2mass --type=image 2mass 12:34:56.7 -23:12:45.2 + +</PRE> + +The query produces files with the root name '2mass', and exten- sions of +"<I>.csv</I>" (the main response), "<I>.pos</I>" (the extracted pos- itions), +and "<I>.urls</I>" (the access references). The user inspects the files and +notices that the references return both FITS and HTML files, but she only +wants the FITS image date and uses <B>vodata</B> to download only those: +<PRE> + + % grep fits 2mass_I_001_15998.urls > images.txt + % vodata images.txt + or + % grep fits 2mass_I_001_15998.urls | vodata -i - + +</PRE> + +In both cases we pass URLs to the task which bypasses the query and directly +access the images. However, in the first case we process the entire list +and are able to take advantage of the <I>-maxdownloads=<N></I> option to +increase the number of simultaneous downloads. In the second case, the +<I>-i</I> flag causes the task to interpret each line of the input stream +as a separate command and so the data are always downloaded one at a time +(which is the default download behavior anyway). +<P> +<DT>8)<DD> +Use <B>vodata</B> as a test client for a locally-installed SIAP service: +<PRE> + + % vodata -t image -s <A HREF="http://localhost/siap.pl">http://localhost/siap.pl</A> 180.0 0.0 + % vodata --type=image --svc=<A HREF="http://localhost/siap.pl">http://localhost/siap.pl</A> 180.0 0.0 + +</PRE> + +In this case we force the ServiceURL using the '<I>-s</I>' flag, but since we +can't do a Directory query to discover what type of service this is, we must +use the '<I>-t</I>' flag to indicate it is an image service. +<P> +<P> +<DT>9)<DD> +Create a local table containing the Abell catalog. Begin with a +Directory query to find likely services using the <B>vodirectory</B> task, print +a verbose description of each resource and page the results with <I>less</I>: +<PRE> + + % vodirectory -v -v --type=catalog abell | less + +</PRE> + +The verbose results indicate a number of services with differing +requirements for what is included. We decide to use the service from +HEASARC since it contains southern hemisphere data and constraints we are +interested in. Try an all-sky query to retrieve the entire catalog, use +the service identifier to be specific about where we want to go: +<PRE> + + % vodata -e <A HREF="ivo://nasa.heasarc/abell">ivo://nasa.heasarc/abell</A> 0.0 0.0 180.0 + % vodata --extract <A HREF="ivo://nasa.heasarc/abell">ivo://nasa.heasarc/abell</A> 0.0 0.0 180.0 + +</PRE> + +We use the '<I>-e</I>' flag to extract the positions to a separate file with +a "<I>.pos</I>" extension so that we can use these in later queries. +However, the <I>.pos</I> file additionally contains the ID from the original +catalog in column 1. Strip this column so we're left with only RA and DEC +and query for Chandra observations at each position: +<PRE> + + % cut -c6- *.pos | vodata <A HREF="ivo://nasa.heasarc/chanmaster">ivo://nasa.heasarc/chanmaster</A> -p - + % cut -c6- *.pos | vodata <A HREF="ivo://nasa.heasarc/chanmaster">ivo://nasa.heasarc/chanmaster</A> --pos=- + +</PRE> + +Here we used the unix '<I>cut</I>' utility to remove the first column and +pipe the resulting positions to the task, using the '<I>-p -</I>' option to +indicate positions should be read from stding, and the IVO identifier of +the Chandra observation master log we also discovered from the Directory. +<P> +<P> +<DT>10)<DD> +Interactively query for a count of Chandra observations of Messier +objects: +<PRE> + + % vodata -cq chandra -i - + m31 + chandra 335 I Chandra X-Ray Observatory Data Archive + : : : : : + +</PRE> + +Note that by using the '<I>-i</I>' flag we execute each query as if we'd put +the object name on the command line. Using the '<I>-o</I>' flag would +instead read all of the objects from the stdin but then execute the queries +in parallel following an EOF to terminate the input. +<P> +<P> +<DT>11)<DD> +Use the <I>STILTS</I> task '<I>tpipe</I>' to select rows from a VOTable +of QSOs (made with an earlier query) where the redshift is > 0.2. Output +only the positions and pipe this to <B>vodata</B> to generate a new query to +see whether HST has observed any of these objects: +<PRE> + + % stilts tpipe ifmt=votable qso_survey.vot + cmd='select "Z > 0.2"' + cmd='keepcols "RA DEC"' | vodata -p - hstpaec + +</PRE> + +Note that we use the '<I>-p -</I>' flag to tell the task to take it's list of +positions from the piped input. The positions are used to query the HST +Planned and Archived Exposure Catalog (<I>hstpaec</I>) +<P> +<P> +<DT>12)<DD> +The user has a task called '<I>wcsinfo</I>' that takes a list of images +and outputs a text table containing the plate center and size in degrees. +Use this task as part of a query for 2MASS point sources contained in each +image: +<PRE> + + % wcsinfo *.fits | vodata 2mass-psc -i - + +</PRE> + +Here we specify the desired service (<I>2mass-psc</I>) on the commandline as +usual, and allow the remainder of the args (i.e. the position and search +size) to be read from the stdin. This allows for variable search sizes but +processes the positions serially. If the sizes are all the same (say 25 +arcmin), multiple queries can be done simultaneously using just a position +file, e.g. +<PRE> + + % wcsinfo -pos_only *.fits > centers.txt + % vodata --sr=25m 2mass-psc centers.txt + +</PRE> + +<P> +<P> +<P> +<DT>13)<DD> +Query a large list of objects against a number of ASCA resources. +Because the ASCA catalogs are served by the same machine, use the <I>'-i'</I> +option and a command file to process only each resource sequentially while +still parallelizing the object lists: +<P> +<PRE> + % cat cmds.txt + ASCA survey.tbl + ASCA\ GIS survey.tbl + ASCA\ GPS survey.tbl + : : + + % vodata -i cmds.txt +</PRE> + +</DL> +<P> + +Note that we've needed to escape the space in the resource name in some +cases. To avoid this, use of the IVO identifier for each resource is usually +preferred. +<P> +<DL COMPACT> +<DT>14)<DD> +Query the VO for GALEX data of M51. Because the <I>ShortName</I> GALEX +is not unique, we must either specify the IVO identifier of a +specific service to query, or if we're interested in results from all +supported data services with <I>galex</I> in the name: +<PRE> + + % vodata -a galex M51 + % vodata --all galex M51 + +</PRE> + +The results come from the Cone and SIAP services both called <I>GALEX</I>, +as well as an additional SIAP service called 'GALEX_Atlas'. Note that the +service names are case insensitive in either case. +<P> +<P> +<DT>15)<DD> +Process a list of hundreds of positions against the GSC2.3 catalog: +<PRE> + + % vodata gsc2.3 positions.txt + +</PRE> + +<P> +<P> +<DT>16)<DD> +Process a list of hundreds of positions against the GSC2.3 catalog, assume +that the input table has a 5 line header of text and three columns +(id,ra,dec). Note that the <I>cols</I> option requires the optional id +be specified last: +<PRE> + + % vodata --cols=2,3,1 --hskip=5 gsc2.3 positions.txt + +</PRE> + +<P> +</DL> +<A NAME="lbAO"> </A> +<H2>BUGS</H2> + +Some services don't repond properly to the metadata query and will print +a "no attributes found" message. +<P> +<A NAME="lbAP"> </A> +<H2>TODO</H2> + +<P> + +- Additional command-line options should be allowed to be specified in a +command file. +<P> + +- Support for SSAP, SAMP, TAP +<P> +<P> +<A NAME="lbAQ"> </A> +<H2>Revision History</H2> + +June 2007 - This task is new. +<A NAME="lbAR"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), June 2007 +<A NAME="lbAS"> </A> +<H2>SEE ALSO</H2> + +<A HREF="http://localhost/cgi-bin/man/man2html?1+voclient">voclient</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+voclientd">voclientd</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+vosesame">vosesame</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+vodirectory">vodirectory</A>(1) +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DL> +<DT><A HREF="#lbAF">Argument Parsing</A><DD> +<DT><A HREF="#lbAG">Multi-Thread and Multi-Process Data Querying</A><DD> +<DT><A HREF="#lbAH">Output Filename Generation</A><DD> +<DT><A HREF="#lbAI">Verbosity</A><DD> +<DT><A HREF="#lbAJ">Bandpass and Service Type Aliases</A><DD> +<DT><A HREF="#lbAK">Range-List Parameters</A><DD> +</DL> +<DT><A HREF="#lbAL">VOCLIENT DAEMON PROCESSING</A><DD> +<DT><A HREF="#lbAM">RESOURCE CACHING</A><DD> +<DT><A HREF="#lbAN">EXAMPLES</A><DD> +<DT><A HREF="#lbAO">BUGS</A><DD> +<DT><A HREF="#lbAP">TODO</A><DD> +<DT><A HREF="#lbAQ">Revision History</A><DD> +<DT><A HREF="#lbAR">Author</A><DD> +<DT><A HREF="#lbAS">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 20:46:31 GMT, May 21, 2009 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/OLD/vodata.man b/vendor/voclient/doc/OLD/vodata.man new file mode 100644 index 00000000..2f27f606 --- /dev/null +++ b/vendor/voclient/doc/OLD/vodata.man @@ -0,0 +1,986 @@ +.\" @(#)vodata.1 1.0 June-07 MJF +.TH VODATA 1 "July 2007" "NVO VO-CLI Project" +.SH NAME +vodata \- query and access VO data services +.SH SYNOPSIS +\fBvodata\fP [\fI<flags>\fP] [ <\fIresource\fP> [[ <\fIobjname\fP> [ <\fIsr\fP> ]]] ] + +\fBvodata\fP [\fI<flags>\fP] [ <\fIresource\fP> [[ <\fIra\fP> <\fIdec\fP> [ <\fIsr\fP> ]]] ] + +\fBvodata\fP [\fI<flags>\fP] [ <\fIurl\fP> ] + +.SH OPTIONS +The \fIvodata\fP task accepts the following options: +.TP 8 +.B \-h,\--help +Print a help summary to the terminal and exit. No processing is done +following this flag. +.TP 8 +.B \-v,\--verbose +Verbose output. The output will be more verbose than normal but exactly +what is printed depends on whether other flags are enabled to changed the +basic task behavior. +.TP 8 +.B \--vverbose +Very-verbose output. Even more output. + +.TP 0 +The following flags control the major behavior of the task, i.e. the type +of output to present. +.TP 8 +.B \-a, --all +Perform an action based on all available data. When used as part of a +data query, this flag causes the <\fIresource\fP> argument to be used in +a substring match of Directory \fIShortName\fR or \fIIdentifier\fR fields +to create the actual list of resources to be queried. If the \fIShortName\fP +of a \fITABULARSKYSERVICE\fP from Vizier is given, the <\fIresource\fP> +will typically expand to include all tables associated with the paper, +and providing a means to access all of these tables from a single query. +.TP 8 +.B \-c, --count +Print only a count of the matching records found and do not save any +results. The standard output for the task is to echo some of the input +parameters and print a table of results showing progress and the number +of matching records. If this flag is set, the output written to the +screen will be the same, however the data will not be saved locally. +.TP 8 +.B \-g, --get +Get the data referenced by the results of a data query. This typically +only applies to Simple Image Access service in which the result of a +query include a column of "\fIaccess references\fP" to the actual data +that must be resolved separately. Setting this flag will cause all data +references to be resolved by the task once all of the data queries have +been completed. + +Access references are appended to a master "access list" as each query +completes. In general the order in which these are retrieved cannot be +guaranteed. Data downloads can be done in parallel by setting the number +of concurrent max downloads using the \fI--maxdownloads=<N>\fP flag, the +default is to download one file at a time. If this flag is followed +with a comma-delimited list of numbers, only those rows in the result +table will be accessed. +.TP 8 +.B \-m, --meta +Print only the column metadata for the named services. The output will be +a list of the columns return by a data query to the service, but will not +save the actual data. A default position and search size will be used for +the query: In the case of Cone services a negative size is used, for SIAP +services the FORMAT=METADATA flag is used in the query, and for tabular +Vizier services the entire table is accessed. Compliant VO services will +respond quickly with only the column metadata, tabular services may respond +more slowly due to the need to transfer the data. Adding the \fI-v\fP or +\fI--verbose-<N>\fP options will increment the VERBOSE level of services +and may return more metadata if available, to access these extra columns +the same level of verbosity must be set during a data query. + +.TP 0 +The following flags specify data query options: +.TP 8 +.B \-b <bpass> or --bandpass=<bpass> +Constrain the query by bandpass. The argument following the flag must +be one of the allowed bandpass specification string. Setting the flag +will constrain any Directory search used to only those resources where +the spectral coverage matches the given bandpass. Aliases for bandpasses +are allowed, see below. +.TP 8 +.B \-i <file> +Specify a file containing the remaining positional command-line input. The +command line is thought of as having the following components: the options +beginning with a '-' character and their associated arguments, one or more +<\fIresource\fP> names giving the service to invoke, an object name or +position, and an optional query size. The '-i' flag allows everything +except the options to be specified from a file (or the standard input if +the '-' argument is used), creating in effect a means to interactively +specify the e.g. resource/object without restarting the task, or to take +these values from a file or input stream to create multiple independent +queries. If either the resource or object name/position has already been +specified they do not need to be specified again. + +The format for the command file is the same as for the <\fIresource\fP>, +<\fIobjname\fP>, <\fIra\fP> <\fIdec\fP>, <\fIurl\fP>, or <\fIsr\fP> described +below and as they would appear on the command line, all input lines are +terminated with a newline, the file or input stream is terminated with an +EOF. An example of how this +may be used would be the using a command file such as: + +.nf + 2mass-psc m31,m51 0.5 + chandra ngc4258,m51 0.25 +.fi + +The task will process this file as if the two lines had been invoked as +separate commands. The advantage is that this input can be created +dynamically by another task, and we can group resource and object lists +into independent queries. See the \fIExamples\fP below for other uses. +.TP 8 +.B \-o <obj|file> or --object=<obj|file> +Specify the object name to use in a query. Object names are resolved +automatically to J2000 equatorial coordinates. The argument to this +flag may be the name of a single object, a comma-delimited list of +object names, the name of a file containing object names, or the +reserved value '-'. + +The reserved value '-' tells the task to take this information from the +standard input, processing doesn't begin until the object list has been +fully read. +.TP 8 +.B \-p <pos|file> or --pos=<pos|file> +Specify the position to use in a query. Positions are composed of two +values assumed to be equatorial J2000 coordinates. +Values specified as a floating-point decimal are assumed to be in units +of degrees, sexagesimal values may also be used and are assumed to be +equatorial RA and Dec. If the \fI<pos>\fP arg is used only one set of +coordinates may be given on the command-line and must be delimited by a comma, +however the argument may also be the name of a file containing coordinates +to be processed, or the reserved value '-'. + +The reserved value '-' tells the task to take this information from the +standard input, processing doesn't begin until the position list has been +fully read. +.TP 8 +.B \-r <radius> or --sr=<radius>[<units>] +Set the search radius. The default search size is 0.1 degrees unless +specified on the command-line and argument are assumed to be +in degrees, setting the size in other units is permitted using the +\fI-sr\fP flag. To specify the <units> for the \fI--sr\fP flag, the +argument should be suffixed by an 's' to specify arcseconds, an 'm' to set +arcminutes, and 'd' to set the size in degrees. By default, all +queries will be done using the same search size. Variable search +sizes accomplished using the '-i' flag described above. +.TP 8 +.B \-s <service> or --svc=<service> +Specify the service or url to invoke. In most cases the service, i.e. +the <\fIresource\fP> argument will be taken from the commandline based on +it's position. The exception is when the user want to specify a service +URL directly (e.g. to test a local service) because it isn't known to the +Directory, or to use the reserved values '-' or 'any'. Use of '-' tells +the task to read the service list from the standard input; use of +the word 'any' is a means to telling the task to dynamically create the +resource list from other options (e.g. "any image service" by using the +'-t image' option). +.TP 8 +.B \-t <type> or --type=<type> +Constrain the query by service type. The list of allowed service types +is given below. The actual string used in a Directory resource record +may be used if known, otherwise common use is to specify 'image' to +access Simple Image Access (SIAP) services, 'catalog' for Cone searches, +or 'table' for Vizier tabular data. + +.TP 0 +The following flags are specific to the writing of HTML or KML files: +.TP 8 +.B \--webnoborder +Disable the shaded border drawn around an HTML table. +.TP 8 +.B \--webnocolor +Disable the coloring for an HTML table. +.TP 8 +.B \--webnoheader +Disable the HTML page header written to the output file. + +.TP 8 +.B \--kmlmax=<N> +Specify the max number of placemarks to write. The default is 50, ordering +is not guaranteed. Setting the sampling will automatically increase the +maximum number of results returned. +.TP 8 +.B \--kmlsample=<N> +Specify the sampling of the result to be every \fI<N>\fP rows. The +default is to write all rows to the output file. If set, this value will +be used as a multiplier for the max number of placemarks automatically. +.TP 8 +.B \--kmlgroup=object +Group the results of a multi-resource/multi-object query into a single +hierarchical KML file grouped by the object or position index (default); +.TP 8 +.B \--kmlgroup=service +Group the results of a multi-resource/multi-object query into a single +hierarchical KML file grouped by the service name. +.TP 8 +.B \--kmlgroup=both +Groups the results of a multi-resource/multi-object query into a single +hierarchical KML file. The two top-level folders will be 'By Source' and +'By Object' indicating the grouping of the results. +.TP 8 +.B \--kmlnolabel +Disable the labelling of placemarks. By default, the ID_MAIN ucd for +each point will be used as a label. +.TP 8 +.B \--kmlnoregion +Disable the drawing of the region bounding box in a KML file. +.TP 8 +.B \--kmlnoverbose +Disable the writing of verbose information to the KML placemarks. By +default, each placemark will contain all information from that result. + + +.TP 0 +Input Options: +.TP 8 +.B \--cols=\fIcol_str\fP +Use columns specified in \fIcol_str\fP to read the \fIra\fP, \fIdec\fP +and \fIid\fP values respectively. \fIcol_str\fP is a comma-delimited +list where the \fIid\fP column is optional and will not be used if not +present as the third element in the list. Other columns may be given as +a single integer or as a range of the form \fIstart\fP-\fIend\fP indicating +the values in the \fIstart\fP thru \fIend\fP columns should be combined +into a single value. +.TP 8 +.B \-d, --delim=\fIdelim\fP +Use the \fIdelim\fP as the input table delimiter. By default, a space, tab, +comma, vertical bar ('|'), or semicolon may be used as a delimiter for the +input table. If no explicit delimiter is specified, the first occurance of +any one of these will be used. The reserved words \fIcomma\fP, +\fIspace\fP, \fItab\fP, or \fIbar\fP may be used in place of a specific +character. + +<DT><B>--ecols=</B><I>col_str</I> +.TP 8 +.B \--ecols=\fIcol_str\fP +Use the explicit columns specified in \fIcol_str\fP in the input table. This +option should only be used with formatted text tables where the desired +values will always be in the same columns of the file. Note that 'column' in +this case refers to a specific character column in a text file. Columns +may be a single integer or a range, and is a comma-delimited list as with +the \fI--cols\fP option. +.TP 8 +.B \-f, --force +Force the input table to be used even in the number of columns varies on +each line. The assumption here is that any variation (e.g empty columns) +occurs after the \fIra\fP, \fIdec\fP and \fIid\fP columns in the table. +.TP 8 +.B \--hskip=\fI<N>\fP +Skip \fI<N>\fP header lines in the input file. This option is only needed +when the lines to be skipped do not begin with the normal '#' comment +character. +.TP 8 +.B \--nlines=\fI<N>\fP +Use only \fI<N>\fP lines of the input table. +.TP 8 +.B \--sample=\fI<N>\fP +Sample the table every \fI<N>\fP lines. Setting the sample will not affect +the \fInlines\fP used. + + +.TP 0 +Output Options: +.TP 8 +.B \-1,--one +Save the results into a single file regardless of format. This option will +be set automatically if the output is being written to the standard output. +If the output format is something other than KML or XML, all results will +be concatenated into individual files of the form +"<svc>_<pid>.<extn>" so that each file will contain the object results from +each service where the columns will be the same. +.TP 8 +.B \-A,--ascii +Save the results as a whitespace delimited ascii table. If an output file +is created it will have a ".txt" extension appended automatically. +.TP 8 +.B \-C,--csv +Save the results as a comma-separated-value (CSV) table. If an output file +is created it will have a ".csv" extension appended automatically. +.TP 8 +.B \-H,--html +Save the results as an HTML table. If an output file +is created it will have a ".html" extension appended automatically. See +above for the \fI--webnoheader\fP option that can be used to disable the HTML page +header. +.TP 8 +.B \-I,--inventory +Query the \fIInventory Service\fP rather than the data services directly. +This will return simply a count of the results found, but when presented +with a table of resources and sources can be used to do a simple +crossmatch of the sources found in the catalogs available through the +service. +.TP 8 +.B \-K,--KML +Save the results as a Google Earth/Sky KML placemark file. If an output file +is created it will have a ".kml" extension appended automatically. See +above for additional options that control the content of the file. +.TP 8 +.B \-R, \-V or --raw, --votable +Save the results as a raw VOTable. If an output file is created it will +have a ".vot" extension appended automatically. +.TP 8 +.B \-T,--tsv +Save the results as a tab-separated-value (TSV) table. If an output file +is created it will have a ".tsv" extension appended automatically. +.TP 8 +.B \-O <root> or --output=<root> +Set the root of the output name. The reserved value '-' tells the task to +write to the standard output. +.TP 8 +.B \-X,--xml +Save the results wrapped XML file of the raw VOTable results. If an output +file is created it will have a ".xml" extension appended automatically. The +XML document will gather all the individual VOTable result files to a single +XML document, where each entry is wrapped by the element \fI<VOTABLE_ENTRY>\fP. +There will be three attributes: \fIsvc\fP will be the data service name, +\fIobj\fP will be the object name (if supplied), and the \fIindex\fP attribute +giving an index into the results. This index list is created by looping over +each service, and for each service, looping over the object/position list. +.TP 8 +.B \-e,--extract +Extract positional and access information to extra output files. By +default both files will be written, using \fI--extract=pos\fP will write only the +positional information file, using \fI--extract=urls\fP will write the access URLs only. +Access URLs are written one-per-line to a file with the same root name as +the main output but with a ".urls" extension; Positional information is +written to a file with a ".pos" extension and will contain three columns +made up of the identifier (the column with the \fIID_MAIN\fP ucd), RA and +Dec (the \fIPOS_EQ_RA_MAIN\fP and \fIPOS_EQ_DEC_MAIN\fP ucd columns +respectively). If these ucds appear more than once in a table, the first +occurrance will be used. + +Additionally, the \fI--extract=headers\fP and \fI--extract=kml\fP flags may be to to specify the +HTML and KML output be written to files with ".html" and ".kml" +extensions respectively. The \fI--extract=KML\fP flag will cause multi-resource +and/or multi-object queries to be collected into a single KML file. +The format-specific \fI--kml<opt>\fP and \fI--web<opt>\fP flags will apply to these files. +A \fI--extract=xml\fP flag will force the output format to be raw VOTable and gather +the results to a single XML document (see the \fI-X\fP option). + +Note that the URLs file can be used to later access the data (perhaps +after sub-selecting from the table based on some criteria) by calling +the task again using the filename as the only argument. +.TP 8 +.B \-n,--nosave +If enabled, this flag tells the task not to save results to local disk. +Status and result information will continue to be printed to the screen, +but no data are saved to disk. +.TP 8 +.B \-q,--quiet +Quiet mode. Suppress any extraneous output and warning messages. +.TP 8 +.B \-u,--url +Force the specified URL to be downloaded. + + +.TP 0 +DAL2 Query Options: +.TP 8 +.B \--band=\fIband_string\fP +The spectral bandpass is given in range-list format. For a numerical +bandpass the units are wavelength in vacuum in units of meters. +The spectral rest frame may optionally be qualified as either +\fIsource\fP or \fPobserver\fP, specified as a range-list +qualifier. Bandpass names are often not useful for spectra (they are +probably more useful for image or time series data) but there are cases where +they are useful for spectra, for example for a velocity spectrum of a +specific emission line. +.TP 8 +.B \--time=\fItime_string\fP +The time coverage (epoch) specified in range-list form as defined in section +8.7.2, in ISO 8601 format. If the time system used is not specified UTC is +assumed. The value specified may be a single value or an open or closed +range. If a single value is specified it matches any spectrum for which the +time coverage includes the specified value. If a two valued range is given, a +dataset matches if any portion of it overlaps the given temporal region. + + + +.SH DESCRIPTION +The \fBvodata\fP task allows a user to query and access VO data for multiple +resources and objects from a desktop or scripting environment. By design, +the task interface is meant to provide the following features: + +.TP 4 +.B \- +Resources (i.e. data services) may be referred to using a more familiar +\fIShortName\fP designation, or an IVO identifier, either of which will be +resolved to a specific \fIServiceURL\fR internally using the Directory. +.TP 4 +.B \- +Object names may be used to specify the location of a data query, the +position will be resolved internally using the \fISesame\fR web service. +.TP 4 +.B \- +Output files may be created in a variety of common formats easily manipulated +with other desktop tools. +.TP 4 +.B \- +Multiple resources and objects shall be queried in parallel when possible to +optimize the task. +.TP 4 +.B \- +Data referenced in a query response should be accessible by the task +automatically. +.TP 4 +.B \- +The command-line interface should be as friendly and as flexible as possible +to allow the task to be used in multiple ways. + +.PP +The task should quickly become familiar to users and is meant operate in +concert with the \fBvodirectory\fP and \fBvosesame\fP tasks to allow novice +users to begin to explore for data resources to be used in the final query. +Some of the flexibility of the task is shown in the Examples section below. +Major concepts of the task are detailed below as well. + + +.SS Argument Parsing +.PP +The meaning of the various command-line arguments is detailed below: + +.TP 8 +.B \fI<resource>\fP +The \fIShortName\fP or \fIIdentifier\fP of a data resource to be queried, a +comma-delimited list of either, or the name of a file containing either. +These names will be resolved to a data service URL using the Directory. The +\fI-s\fP option may be used to specify a non-registered \fIServiceURL\fP that +the task may use, however the \fI-t\fP option is then also required to +specify the type of service. +.TP 8 +.B \fI<objname>\fP +The name of an object, a comma-delimited list of object names, or the name of +a file containing object names. The coordinates of each object will be +resolved to a position prior to processing using the \fISesame\fR name +resolver service. An error will be returned if an object name cannot be +resolved, and that object will be skipped. +.TP 8 +.B \fI<ra> <dec>\fP +The J2000 equatorial RA and Dec position to the searched. Values given as +floating point values are assumed to be in decimal degrees, sexagesimal +values are assumed to be equatorial RA/Dec positions. Sexagesimal values may +be of the form \fIhh:mm:ss.s\fP or \fIhh:mm.m\fP for RA, or +\fIdd:mm:ss.s\fP or \fIdd:mm.m\fP for Dec. Only one coordinate pair may be +specified on the commandline. +.TP 8 +.B \fI<sr>\fP +The search size for the data query specified in decimal degrees. The default +size of 0.1 degrees will be used if this is not specified on the command line. +The \fI-rs\fP and +\fI-rm\fP options may be used specify the size in arc seconds and minutes +respectively. The \fI-i\fP option may be used to specify command-line input +options, where each command-line can include a different value for the search +size, otherwise only one value is allowed. +.TP 8 +.B \fI<url>\fP +A single URL, or the name of a file containing URLs listed one per line. + + +.SS Multi-Thread and Multi-Process Data Querying +.PP +All data queries require at least one \fIresource\fP and one \fIsource\fP +to be successful. The \fIresource\fP defines a specific data service to be +queried, and the \fIsource\fR is either an explicit position on the sky or +the name of an object that can be resolved to a position. Additional +parameters to the query are used to specify other options, but in essence +each data query is translated to a single URL that must be accessed by the +client task. In a complex query, lists of resource and/or objects create a +potentially large matrix of queries that must be made (i.e. +\fIN-services\fP by \fIN-objects\fP in total). Because a large fraction of +the time spent in waiting for a query to finish is in waiting for the +server to respond, we are able to run multiple queries simultaneously +without saturating our network bandwidth in most cases. +.PP +The \fBvodata\fP task will parallelize the list of services to be queried +by running a separate processing \fIthread\fP (i.e. a lightweight process +running in parallel within the main application) for each of the services +to be called. This allows queries to different servers to be run in +parallel, and since these servers will often reside on multiple machines +the client won't impact any one data provider too badly. In addition, +the list of objects to be queried at each service will be broken up into +multiple child processes and called simultaneously. This allows, for +example, 10 objects to be queried from 3 services (a total of 30 queries) +simultaneously. +.PP +The \fI--maxthreads=<N>mt\fP option can be used to set the max number of threads to be +created for processing the resource list (the default is 20). If the +resource list is larger than this value, the list will be processed with no +more than the max number running at any one time until all resources have +been queried. Similarly, the \fI--maxprocs=<N>\fP option can be used to set the +number of child processes to be created to process the object list (the +default is 10). When setting these values it is important to remember that +the total number of \fIpotential\fP processes running on your machine will +be the product of these to values. The default values were empirically found +to work reasonably well on most modern machines. +.PP +Additionally, it is worth considering the potential strain that can be put +on data providers' machines before changing these settings. The large +majority of Cone services for example come from a single server at HEASARC +and overloading the server with hundreds of requests to multiple resources +it provides may result in a failed request and what would appear to be no +data. One should consider using the \fI-i\fP flag as a means to query a +large object list against a resource list such that only the object +processing is parallelized and the server load is minimized (See the example +below). + + +.SS Output Filename Generation +.PP +The \fI-O\fP option may be used to specify the root part of output files +created by a data query. However, to guarantee that a multi-service, and/or +multi-object query doesn't overwrite a single output file, the filename root +will also include the \fIpid\fP (process ID) of the task that created it. +For a single service and object query no \fIpid\fP will be used as part of +the filename. This scheme guarantees unique output files across the various +processing scenarios, with similar root names for multiple files associated +with a specific query. + +Output tables may be created in a number of formats and will likewise have +extensions indicating the table type. The \fI-e\fP/\fI--extract\fP option +may create additional files for each query, and the \fI-g\fP/\fI--get\fP +option to access data will similarly create additional files. The structure +of an output filename is: + +.nf + + \fI<root>[_<pid>].<extn>\fP + +.fi +The meaning of \fI<pid>\fP and \fI<extn>\fP have been discussed above. If +the \fI-O\fP option was set then the \fI<root>\fP part of the name will +simply be the argument given to set the root name. Otherwise, the \fI<root>\fP +element will be of the form: +.nf + + \fI<svc>_<type>_<objname>\fP + \fI<svc>_<type>_<index>\fP + +.fi +The \fI<svc>\fP is derived from the service name used, the \fI<type>\fP is +a single-character code to indicate the type of service used ('I' for image, +'C' for catalog, and 'T' for table). The final element will either be the +object name or the index in a list of positions of no object was specified. + +.SS Verbosity +.PP +The \fI-v\fP and \fI-vv\fP options serve a dual purpose: within the task they +set the level of output verbosity in terms of what is reported during +processing (Similarly, the \fI-q\fP option can be used to turn off output +reporting entirely). These flags will however also increase the value of the +\fBVERBOSE\fP parameter sent to services during a data query. The default +value is at least 1, with the highest level being 3. Using the \fI-v\fP flag +sets \fBVERBOSE=2\fP and \fI-vv\fP sets \fBVERBOSE=3\fP. +.PP +The VERBOSE level can be important in accessing result columns that may only +be returned at the highest level. When using the \fI-m\fR +(or \fI--meta\fR) flag to print +the column metadata, the verbose options will also affect the results and it +is important that the same verbosity be set when doing the actual data +query and access. + +.SS Bandpass and Service Type Aliases +.PP +The type constraint (\fI-t\fP or \fI--type\fP) accepts only the +following arguments: +.nf + + catalog Cone search services + image Simple Image Access services + spectra Simple Spectral Access services + table Vizier services + <literal> ResourceType from Directory record + +.fi +.PP +The bandpass constraint (\fI-b\fP or \fI--bandpass\fP) accepts only +the following arguments: +.nf + + Radio Millimeter Infrared (IR) + Optical Ultraviolet (UV) X-Ray (xray) + Gamma-Ray (GR) + +.fi +Values in parenthese are acceptable aliases. All matches are cases +insensitive. + + +.SS Range-List Parameters +.PP +Some parameters (for example BAND and TIME) may allow a parameter value to be +specified as a numeric range. Such range-valued parameters use the forward +slash (\fI/\fP) character as the separator between elements of the +range specification (as in the ISO 8601 date specification after which this +convention is patterned). For example, \fI5E-7/8E-7\fP would +specify a range consisting of all values from 5E-7 to 8E-7, inclusive. If a +third field is specified it is a step size for traversing the indicated +range. If a parameter permits a step size the semantics of the step size are +defined by the specific parameter. +.PP +An open range may be specified by omitting either range value. If the first +value is omitted the range is open toward lower values. If the second value +is omitted the range is open toward higher values. Omitting both values +indicates an infinite range which accepts all values. For example, +\fI/5\fP is an open range which accepts all values less than or +equal to 5. To specify all values less than 5, \fI/4\fP would be +used (for an integer valued range). Range values are limited to numeric +values or ISO dates. +.PP +A list may be qualified by appending the character \fI;\fP (semicolon) +followed by a qualifier string. For example \fI1E-7/3E-6;source\fP could +specify a spectral bandpass in the rest frame of the source. List and +range syntax may be combined, e.g., to indicate a list of scalar or +range-valued parameter values. Such a range list may be ordered or +unordered, and may contain either numeric or string data. An ordered +list is one which requires values to be processed in a specified order, +and to ensure this the range list is sorted or ordered by the service as +necessary before being used. It is the responsibility of the service to +sort an ordered range list, hence the client can input ranges or range +values in any order for an ordered range list and the result will be +the same. The sequence in which items in an unordered list occur on the +other hand is significant, as since there is no intrinsic ordering for +the list which can be enforced by the service, items will be processed +by the service in the order they are input by the client. +.PP +TIME and BAND are typical examples of ordered range lists. Since a dataset +matches the query if it contains data in any of the specified ranges, +logically it does not matter in what order the ranges are given, or whether +the first element of a range is less than the second, or whether ranges +overlap; the result should be the same in all cases. Hence the range list has +an intrinsic ordering irrespective of how ranges are input. Unless otherwise +specified in the definition of a given parameter, range lists are assumed to +be ordered. + + + +.SH VOCLIENT DAEMON PROCESSING +All VO-CLI tasks are built upon the VOClient interface an rely on a +separate \fIvoclientd\fP process to provide the VO functionality. The +voclientd task is distributed as part of VO-CLI and will be started +automatically by each task if it is not already running. If problems are +encountered, you may want to manually start the voclientd in a separate +window before running the task so you can monitor the output for error +messages. + +.SH RESOURCE CACHING +Directory resolution is a common activity of VO-CLI tasks and so results +will be cached in the $HOME/.voclient/cache/regResolver directory based on +the search term, service type and bandpass parameters. Defining the +\fIVOC_NO_CACHE\fP environment variable will cause the task to ignore the +cache. + +.SH EXAMPLES + +.TP 4 +1) +Query the GSC 2.3 catalog for stars a) within the 0.1 degree +default search size around NGC 1234: b) around all positions +contained in file 'pos.txt': c) for the list of objects given +on the command line: d) query a list of services for a list +of positions: e) print a count of results that would be returned +from 3 services for each position in a file: +.nf + + % vodata gsc2.3 ngc1234 (a) + % vodata gsc2.3 pos.txt (b) + % vodata gsc2.3 m31,m51,m93 (c) + % vodata svcs.txt pos.txt (d) + % vodata hst,chandra,gsc2.3 pos.txt (e) + +.fi + +.TP 4 +2) +Query all (142) image services having data of the subdwarf galaxy +IC 10, print a count of the results only: +.nf + + % vodata -c -t image any IC10 + % vodata --count --type=image any IC10 + +.fi +Note that we use the reserved word '\fIany\fP' for the service name and +constrain by image type. The task will automatically query the Directory to +create the list of services to be queried. + +.TP 4 +3) +Print a count of X-ray catalog data around Abell2712: +.nf + + % vodata -c -t catalog -b x-ray any abell2712 + % vodata --count --type=catalog --bandpass=x-ray any abell2712 + +.fi +In this case we constrain both the service type as well as the spectral +coverage published for the resource in the Directory. We use the reserved +'\fIany\fP' service name to query multiple services and use the '\fI-c\fP' +flag to print a count without saving results. The object name is resolved +to coordinates internally. (Note: this example may take a while to run). + + +.TP 4 +4) +Print the column metadata returned by the RC3 catalog service: +.nf + + % vodata --meta rc3 or vodata -m rc3 + +.fi +The output will print the result using the default VERBOSE level, adding +the \fI-v\fP will set the query parameter VERBOSE=2, adding \fI-vv\fP will +set VERBOSE=3 (to print all available columns). When accessing data the +same \fI-v\fP flags will be required to retrieve columns at that +\fIVERBOSE\fP level. + + +.TP 4 +5) +Use the Directory to query for resources using the search terms +"cooling flow". Upon examining the output the user notices a +Vizier paper titled "\fICooling Flows in 207 clusters of Galaxies\fP" +that looks interesting. Use the \fBvodata\fP task to download all +tables associated with this paper, save tables in the default +CSV format: +.nf + + % vodirectory cooling flow + % vodata -O white97 -all J/MNRAS/292/419/ + % vodata --output=white97 --all J/MNRAS/292/419/ + +.fi +All 7 tables will be written to the current directory to files +having a root name 'white97' (chosen based on the author and +publication date). + + +.TP 4 +6) +Find a suitable XMM image service, get a (brief) count of the +XMM images available for 3c273, and if there aren't too many, +download the images and save the extracted access URLs: +.nf + + % vodirectory -rv -t image xmm + ShortName ResourceType Title + ------------------------------------------------------.... + XMM-Newton SIAP/ARCHIVE XMM-Newton Archive .... + + % vodata -cq xmm-newton 3c273 + xmm-newton 27 I XMM-Newton Archive .... + + % vodata --count --quiet xmm-newton 3c273 + xmm-newton 27 I XMM-Newton Archive .... + + % vodata --get xmm-newton 3c273 + .... will query and download 27 images. + +.fi + +.TP 4 +7) +Query for the images available from 2MASS at a given position, +extract the positions and service URLs to separate files: +.nf + + % vodata -e -O 2mass -t image 2mass 12:34:56.7 -23:12:45.2 + % vodata -e --output=2mass --type=image 2mass 12:34:56.7 -23:12:45.2 + +.fi +The query produces files with the root name '2mass', and exten- sions of +"\fI.csv\fP" (the main response), "\fI.pos\fP" (the extracted pos- itions), +and "\fI.urls\fP" (the access references). The user inspects the files and +notices that the references return both FITS and HTML files, but she only +wants the FITS image date and uses \fBvodata\fP to download only those: +.nf + + % grep fits 2mass_I_001_15998.urls > images.txt + % vodata images.txt + or + % grep fits 2mass_I_001_15998.urls | vodata -i - + +.fi +In both cases we pass URLs to the task which bypasses the query and directly +access the images. However, in the first case we process the entire list +and are able to take advantage of the \fI-maxdownloads=<N>\fR option to +increase the number of simultaneous downloads. In the second case, the +\fI-i\fP flag causes the task to interpret each line of the input stream +as a separate command and so the data are always downloaded one at a time +(which is the default download behavior anyway). + +.TP 4 +8) +Use \fBvodata\fP as a test client for a locally-installed SIAP service: +.nf + + % vodata -t image -s http://localhost/siap.pl 180.0 0.0 + % vodata --type=image --svc=http://localhost/siap.pl 180.0 0.0 + +.fi +In this case we force the ServiceURL using the '\fI-s\fP' flag, but since we +can't do a Directory query to discover what type of service this is, we must +use the '\fI-t\fP' flag to indicate it is an image service. + + +.TP 4 +9) +Create a local table containing the Abell catalog. Begin with a +Directory query to find likely services using the \fBvodirectory\fP task, print +a verbose description of each resource and page the results with \fIless\fP: +.nf + + % vodirectory -v -v --type=catalog abell | less + +.fi +The verbose results indicate a number of services with differing +requirements for what is included. We decide to use the service from +HEASARC since it contains southern hemisphere data and constraints we are +interested in. Try an all-sky query to retrieve the entire catalog, use +the service identifier to be specific about where we want to go: +.nf + + % vodata -e ivo://nasa.heasarc/abell 0.0 0.0 180.0 + % vodata --extract ivo://nasa.heasarc/abell 0.0 0.0 180.0 + +.fi +We use the '\fI-e\fP' flag to extract the positions to a separate file with +a "\fI.pos\fP" extension so that we can use these in later queries. +However, the \fI.pos\fP file additionally contains the ID from the original +catalog in column 1. Strip this column so we're left with only RA and DEC +and query for Chandra observations at each position: +.nf + + % cut -c6- *.pos | vodata ivo://nasa.heasarc/chanmaster -p - + % cut -c6- *.pos | vodata ivo://nasa.heasarc/chanmaster --pos=- + +.fi +Here we used the unix '\fIcut\fP' utility to remove the first column and +pipe the resulting positions to the task, using the '\fI-p -\fP' option to +indicate positions should be read from stding, and the IVO identifier of +the Chandra observation master log we also discovered from the Directory. + + +.TP 4 +10) +Interactively query for a count of Chandra observations of Messier +objects: +.nf + + % vodata -cq chandra -i - + m31 + chandra 335 I Chandra X-Ray Observatory Data Archive + : : : : : + +.fi +Note that by using the '\fI-i\fP' flag we execute each query as if we'd put +the object name on the command line. Using the '\fI-o\fP' flag would +instead read all of the objects from the stdin but then execute the queries +in parallel following an EOF to terminate the input. + + +.TP 4 +11) +Use the \fISTILTS\fP task '\fItpipe\fP' to select rows from a VOTable +of QSOs (made with an earlier query) where the redshift is > 0.2. Output +only the positions and pipe this to \fBvodata\fP to generate a new query to +see whether HST has observed any of these objects: +.nf + + % stilts tpipe ifmt=votable qso_survey.vot \ + cmd='select "Z > 0.2"' \ + cmd='keepcols "RA DEC"' | vodata -p - hstpaec + +.fi +Note that we use the '\fI-p -\fP' flag to tell the task to take it's list of +positions from the piped input. The positions are used to query the HST +Planned and Archived Exposure Catalog (\fIhstpaec\fP) + + +.TP 4 +12) +The user has a task called '\fIwcsinfo\fP' that takes a list of images +and outputs a text table containing the plate center and size in degrees. +Use this task as part of a query for 2MASS point sources contained in each +image: +.nf + + % wcsinfo *.fits | vodata 2mass-psc -i - + +.fi +Here we specify the desired service (\fI2mass-psc\fP) on the commandline as +usual, and allow the remainder of the args (i.e. the position and search +size) to be read from the stdin. This allows for variable search sizes but +processes the positions serially. If the sizes are all the same (say 25 +arcmin), multiple queries can be done simultaneously using just a position +file, e.g. +.nf + + % wcsinfo -pos_only *.fits > centers.txt + % vodata --sr=25m 2mass-psc centers.txt + +.fi + + + +.TP 4 +13) +Query a large list of objects against a number of ASCA resources. +Because the ASCA catalogs are served by the same machine, use the \fI'-i'\fP +option and a command file to process only each resource sequentially while +still parallelizing the object lists: + +.nf + % cat cmds.txt + ASCA survey.tbl + ASCA\\ GIS survey.tbl + ASCA\\ GPS survey.tbl + : : + + % vodata -i cmds.txt +.fi +.PP +Note that we've needed to escape the space in the resource name in some +cases. To avoid this, use of the IVO identifier for each resource is usually +preferred. + +.TP 4 +14) +Query the VO for GALEX data of M51. Because the \fIShortName\fP GALEX +is not unique, we must either specify the IVO identifier of a +specific service to query, or if we're interested in results from all +supported data services with \fIgalex\fP in the name: +.nf + + % vodata -a galex M51 + % vodata --all galex M51 + +.fi +The results come from the Cone and SIAP services both called \fIGALEX\fP, +as well as an additional SIAP service called 'GALEX_Atlas'. Note that the +service names are case insensitive in either case. + + +.TP 4 +15) +Process a list of hundreds of positions against the GSC2.3 catalog: +.nf + + % vodata gsc2.3 positions.txt + +.fi + + +.TP 4 +16) +Process a list of hundreds of positions against the GSC2.3 catalog, assume +that the input table has a 5 line header of text and three columns +(id,ra,dec). Note that the \fIcols\fP option requires the optional id +be specified last: +.nf + + % vodata --cols=2,3,1 --hskip=5 gsc2.3 positions.txt + +.fi + +.SH BUGS +Some services don't repond properly to the metadata query and will print +a "no attributes found" message. + +.SH TODO +.PP +- Additional command-line options should be allowed to be specified in a +command file. +.PP +- Support for SSAP, SAMP, TAP + + +.SH Revision History +June 2007 - This task is new. +.SH Author +Michael Fitzpatrick (fitz@noao.edu), June 2007 +.SH "SEE ALSO" +voclient(1), voclientd(1), vosesame(1), vodirectory(1) diff --git a/vendor/voclient/doc/OLD/vodata.pdf b/vendor/voclient/doc/OLD/vodata.pdf Binary files differnew file mode 100644 index 00000000..bb90b187 --- /dev/null +++ b/vendor/voclient/doc/OLD/vodata.pdf diff --git a/vendor/voclient/doc/OLD/vodata.ps b/vendor/voclient/doc/OLD/vodata.ps new file mode 100644 index 00000000..0619513b --- /dev/null +++ b/vendor/voclient/doc/OLD/vodata.ps @@ -0,0 +1,1890 @@ +%!PS-Adobe-3.0 +%%Creator: groff version 1.18.1 +%%CreationDate: Thu May 21 13:46:30 2009 +%%DocumentNeededResources: font Times-Roman +%%+ font Times-Bold +%%+ font Times-Italic +%%DocumentSuppliedResources: procset grops 1.18 1 +%%Pages: 13 +%%PageOrder: Ascend +%%Orientation: Portrait +%%EndComments +%%BeginProlog +%%BeginResource: procset grops 1.18 1 +/setpacking where{ +pop +currentpacking +true setpacking +}if +/grops 120 dict dup begin +/SC 32 def +/A/show load def +/B{0 SC 3 -1 roll widthshow}bind def +/C{0 exch ashow}bind def +/D{0 exch 0 SC 5 2 roll awidthshow}bind def +/E{0 rmoveto show}bind def +/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def +/G{0 rmoveto 0 exch ashow}bind def +/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/I{0 exch rmoveto show}bind def +/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def +/K{0 exch rmoveto 0 exch ashow}bind def +/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/M{rmoveto show}bind def +/N{rmoveto 0 SC 3 -1 roll widthshow}bind def +/O{rmoveto 0 exch ashow}bind def +/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/Q{moveto show}bind def +/R{moveto 0 SC 3 -1 roll widthshow}bind def +/S{moveto 0 exch ashow}bind def +/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/SF{ +findfont exch +[exch dup 0 exch 0 exch neg 0 0]makefont +dup setfont +[exch/setfont cvx]cvx bind def +}bind def +/MF{ +findfont +[5 2 roll +0 3 1 roll +neg 0 0]makefont +dup setfont +[exch/setfont cvx]cvx bind def +}bind def +/level0 0 def +/RES 0 def +/PL 0 def +/LS 0 def +/MANUAL{ +statusdict begin/manualfeed true store end +}bind def +/PLG{ +gsave newpath clippath pathbbox grestore +exch pop add exch pop +}bind def +/BP{ +/level0 save def +1 setlinecap +1 setlinejoin +72 RES div dup scale +LS{ +90 rotate +}{ +0 PL translate +}ifelse +1 -1 scale +}bind def +/EP{ +level0 restore +showpage +}bind def +/DA{ +newpath arcn stroke +}bind def +/SN{ +transform +.25 sub exch .25 sub exch +round .25 add exch round .25 add exch +itransform +}bind def +/DL{ +SN +moveto +SN +lineto stroke +}bind def +/DC{ +newpath 0 360 arc closepath +}bind def +/TM matrix def +/DE{ +TM currentmatrix pop +translate scale newpath 0 0 .5 0 360 arc closepath +TM setmatrix +}bind def +/RC/rcurveto load def +/RL/rlineto load def +/ST/stroke load def +/MT/moveto load def +/CL/closepath load def +/Fr{ +setrgbcolor fill +}bind def +/Fk{ +setcmykcolor fill +}bind def +/Fg{ +setgray fill +}bind def +/FL/fill load def +/LW/setlinewidth load def +/Cr/setrgbcolor load def +/Ck/setcmykcolor load def +/Cg/setgray load def +/RE{ +findfont +dup maxlength 1 index/FontName known not{1 add}if dict begin +{ +1 index/FID ne{def}{pop pop}ifelse +}forall +/Encoding exch def +dup/FontName exch def +currentdict end definefont pop +}bind def +/DEFS 0 def +/EBEGIN{ +moveto +DEFS begin +}bind def +/EEND/end load def +/CNT 0 def +/level1 0 def +/PBEGIN{ +/level1 save def +translate +div 3 1 roll div exch scale +neg exch neg exch translate +0 setgray +0 setlinecap +1 setlinewidth +0 setlinejoin +10 setmiterlimit +[]0 setdash +/setstrokeadjust where{ +pop +false setstrokeadjust +}if +/setoverprint where{ +pop +false setoverprint +}if +newpath +/CNT countdictstack def +userdict begin +/showpage{}def +}bind def +/PEND{ +clear +countdictstack CNT sub{end}repeat +level1 restore +}bind def +end def +/setpacking where{ +pop +setpacking +}if +%%EndResource +%%IncludeResource: font Times-Roman +%%IncludeResource: font Times-Bold +%%IncludeResource: font Times-Italic +grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 +def/PL 841.89 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron +/Zcaron/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef +/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef +/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef +/.notdef/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent +/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen +/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon +/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O +/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex +/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y +/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft +/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl +/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut +/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash +/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen +/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft +/logicalnot/minus/registered/macron/degree/plusminus/twosuperior +/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior +/ordmasculine/guilsinglright/onequarter/onehalf/threequarters +/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE +/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex +/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis +/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn +/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla +/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis +/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash +/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def +/Times-Italic@0 ENC0/Times-Italic RE/Times-Bold@0 ENC0/Times-Bold RE +/Times-Roman@0 ENC0/Times-Roman RE +%%EndProlog +%%Page: 1 1 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S -.4<4441>.4 G -.93<5441>-.71 G +363.44<2831292056>.93 F<4f44>-.4 E -1.21 -1.11<41542041>-.4 H<283129> +1.11 E/F1 10.95/Times-Bold@0 SF -.219<4e41>72 84 S<4d45>.219 E F0 -.2 +<766f>108 96 S<6461746120ad20717565727920616e64206163636573732056>.2 E +2.5<4f64>-.4 G<617461207365727669636573>-2.5 E F1<53594e4f50534953>72 +112.8 Q/F2 10/Times-Bold@0 SF -.1<766f>108 124.8 S<64617461>.1 E F0<5b> +2.5 E/F3 10/Times-Italic@0 SF<3c8d61>A<67733e>-.1 E F0 2.5<5d5b3c>C F3 +-.37<7265>-2.5 G<736f7572>.37 E<6365>-.37 E F0 2.5<3e5b>C 2.5<5b3c>-2.5 +G F3<6f626a6e616d65>-2.5 E F0 2.5<3e5b3c>C F3<7372>-2.5 E F0 2.5<3e5d>C +<5d5d205d>-2.5 E F2 -.1<766f>108 148.8 S<64617461>.1 E F0<5b>2.5 E F3 +<3c8d61>A<67733e>-.1 E F0 2.5<5d5b3c>C F3 -.37<7265>-2.5 G<736f7572>.37 +E<6365>-.37 E F0 2.5<3e5b>C 2.5<5b3c>-2.5 G F3 -.15<7261>-2.5 G F0 2.5 +<3e3c>.15 G F3<646563>-2.5 E F0 2.5<3e5b3c>C F3<7372>-2.5 E F0 2.5<3e5d> +C<5d5d205d>-2.5 E F2 -.1<766f>108 172.8 S<64617461>.1 E F0<5b>2.5 E F3 +<3c8d61>A<67733e>-.1 E F0 2.5<5d5b3c>C F3<75726c>-2.5 E F0 2.5<3e5d>C F1 +<4f5054494f4e53>72 201.6 Q F0<546865>108 213.6 Q F3<766f64617461>2.5 E +F0<7461736b20616363657074732074686520666f6c6c6f>2.5 E +<77696e67206f7074696f6e733a>-.25 E F2<ad682cad2d68656c70>108 230.4 Q F0< +5072696e7420612068656c702073756d6d61727920746f20746865207465726d696e616c +20616e642065>148 242.4 Q 2.5<7869742e204e6f>-.15 F +<70726f63657373696e6720697320646f6e6520666f6c6c6f>2.5 E +<77696e672074686973208d61672e>-.25 E F2<ad76>108 259.2 Q<2cad2d76>-.55 E +<6572626f7365>-.1 E F0 -1.11<5665>148 271.2 S .004 +<72626f7365206f75747075742e>1.11 F .004 +<546865206f75747075742077696c6c206265206d6f72652076>5.004 F .003 +<6572626f7365207468616e206e6f726d616c2062>-.15 F .003<75742065>-.2 F +.003<786163746c792077686174206973207072696e74656420646570656e6473>-.15 F +<6f6e2077686574686572206f74686572208d6167732061726520656e61626c65642074 +6f206368616e67656420746865206261736963207461736b2062656861>148 283.2 Q +<76696f72>-.2 E<2e>-.55 E F2<ad2d7676>108 300 Q<6572626f7365>-.1 E F0 +-1.11<5665>148 312 S<72792d76>1.11 E<6572626f7365206f75747075742e>-.15 E +<4576>5 E<656e206d6f7265206f75747075742e>-.15 E<54686520666f6c6c6f>108 +340.8 Q +<77696e67208d61677320636f6e74726f6c20746865206d616a6f722062656861>-.25 E +<76696f72206f6620746865207461736b2c20692e652e207468652074797065>-.2 E +<6f66206f757470757420746f2070726573656e742e>108 352.8 Q F2 +<ad612c202d2d616c6c>108 369.6 Q F0 .254 +<506572666f726d20616e20616374696f6e206261736564206f6e20616c6c2061>7.08 F +-.25<7661>-.2 G .254<696c61626c6520646174612e>.25 F .255 +<5768656e20757365642061732070617274206f6620612064617461207175657279> +5.254 F 2.755<2c74>-.65 G .255<686973208d616720636175736573>-2.755 F +1.153<746865203c>148 381.6 R F3 -.37<7265>C<736f7572>.37 E<6365>-.37 E +F0 3.653<3e61>C -.18<7267>-3.653 G 1.153<756d656e7420746f20626520757365 +6420696e206120737562737472696e67206d61746368206f66204469726563746f7279> +.18 F F3<53686f72744e616d65>3.653 E F0<6f72>3.652 E F3 +<4964656e74698c6572>3.652 E F0 .837<8c656c647320746f20637265617465207468 +652061637475616c206c697374206f66207265736f757263657320746f20626520717565 +726965642e>148 393.6 R .838<496620746865>5.838 F F3<53686f72744e616d65> +3.338 E F0 .838<6f662061>3.338 F F3 -.5<5441>3.338 G -.1<4255>.5 G +<4c4152534b59>.1 E<2d>-.74 E<534552>148 405.6 Q<56494345>-.18 E F0 .54 +<66726f6d2056>3.04 F .54<697a696572206973206769>-.6 F -.15<7665>-.25 G +.54<6e2c20746865203c>.15 F F3 -.37<7265>C<736f7572>.37 E<6365>-.37 E F0 +3.04<3e77>C .54<696c6c207479706963616c6c792065>-3.04 F .54 +<7870616e6420746f20696e636c75646520616c6c207461626c6573206173736f63692d> +-.15 F<61746564207769746820746865207061706572>148 417.6 Q 2.5<2c61>-.4 G +<6e642070726f>-2.5 E<766964696e672061206d65616e7320746f2061636365737320 +616c6c206f66207468657365207461626c65732066726f6d20612073696e676c65207175 +657279>-.15 E<2e>-.65 E F2<ad632c202d2d636f756e74>108 434.4 Q F0 .003<50 +72696e74206f6e6c79206120636f756e74206f6620746865206d61746368696e67207265 +636f72647320666f756e6420616e6420646f206e6f74207361>148 446.4 R .303 -.15 +<76652061>-.2 H .303 -.15<6e792072>.15 H 2.503<6573756c74732e20546865> +.15 F .003<7374616e64617264206f7574707574>2.503 F .468<666f722074686520 +7461736b20697320746f206563686f20736f6d65206f662074686520696e707574207061 +72616d657465727320616e64207072696e742061207461626c65206f6620726573756c74 +732073686f>148 458.4 R .467<77696e672070726f6772657373>-.25 F .108 +<616e6420746865206e756d626572206f66206d61746368696e67207265636f7264732e> +148 470.4 R .108<49662074686973208d6167206973207365742c20746865206f7574 +707574207772697474656e20746f207468652073637265656e2077696c6c206265207468 +65>5.108 F<73616d652c20686f>148 482.4 Q<7765>-.25 E -.15<7665>-.25 G 2.5 +<7274>.15 G<686520646174612077696c6c206e6f74206265207361>-2.5 E -.15 +<7665>-.2 G 2.5<646c>.15 G<6f63616c6c79>-2.5 E<2e>-.65 E F2 +<ad672c202d2d676574>108 499.2 Q F0 1.663<476574207468652064617461207265 +666572656e6365642062792074686520726573756c7473206f6620612064617461207175 +657279>148 511.2 R 6.662<2e54>-.65 G 1.662<686973207479706963616c6c7920 +6f6e6c79206170706c69657320746f2053696d706c65>-6.662 F .813<496d61676520 +416363657373207365727669636520696e2077686963682074686520726573756c74206f +66206120717565727920696e636c756465206120636f6c756d6e206f662022>148 523.2 +R F3 .814<6163636573732072>B<65666572>-.37 E<656e636573>-.37 E F0 3.314 +<2274>C<6f>-3.314 E .353 +<7468652061637475616c20646174612074686174206d757374206265207265736f6c76> +148 535.2 R .353<65642073657061726174656c79>-.15 F 5.353<2e53>-.65 G +.353<657474696e672074686973208d61672077696c6c20636175736520616c6c206461 +7461207265666572656e63657320746f>-5.353 F<6265207265736f6c76>148 547.2 Q +<656420627920746865207461736b206f6e636520616c6c206f66207468652064617461 +2071756572696573206861>-.15 E .3 -.15<76652062>-.2 H +<65656e20636f6d706c657465642e>.15 E .321<416363657373207265666572656e63 +65732061726520617070656e64656420746f2061206d6173746572202261636365737320 +6c69737422206173206561636820717565727920636f6d706c657465732e>148 571.2 R +.321<496e2067656e6572616c20746865>5.321 F .388 +<6f7264657220696e2077686963682074686573652061726520726574726965>148 +583.2 R -.15<7665>-.25 G 2.888<6463>.15 G .388 +<616e6e6f742062652067756172616e746565642e>-2.888 F .388<4461746120646f> +5.388 F .388 +<776e6c6f6164732063616e20626520646f6e6520696e20706172616c6c656c>-.25 F +1.165<62792073657474696e6720746865206e756d626572206f6620636f6e6375727265 +6e74206d617820646f>148 595.2 R 1.165<776e6c6f616473207573696e6720746865> +-.25 F F3<2d2d6d6178646f776e6c6f6164733d3c4e3e>3.665 E F0 1.165 +<8d61672c20746865>3.665 F<646566>148 607.2 Q .702 +<61756c7420697320746f20646f>-.1 F .701 +<776e6c6f6164206f6e65208c6c6520617420612074696d652e>-.25 F .701 +<49662074686973208d616720697320666f6c6c6f>5.701 F .701 +<7765642077697468206120636f6d6d612d64656c696d69746564206c697374206f66> +-.25 F<6e756d626572732c206f6e6c792074686f736520726f>148 619.2 Q<77732069 +6e2074686520726573756c74207461626c652077696c6c2062652061636365737365642e> +-.25 E F2<ad6d2c202d2d6d657461>108 636 Q F0 .528<5072696e74206f6e6c7920 +74686520636f6c756d6e206d6574616461746120666f7220746865206e616d6564207365 +7276696365732e>148 648 R .528<546865206f75747075742077696c6c206265206120 +6c697374206f662074686520636f6c756d6e73>5.528 F 1.154<72657475726e206279 +2061206461746120717565727920746f2074686520736572766963652c2062>148 660 R +1.154<75742077696c6c206e6f74207361>-.2 F 1.454 -.15<76652074>-.2 H 1.154 +<68652061637475616c20646174612e>.15 F 3.654<4164>6.154 G<6566>-3.654 E +1.153<61756c7420706f736974696f6e20616e64>-.1 F .858<7365617263682073697a +652077696c6c206265207573656420666f72207468652071756572793a>148 672 R +.859<496e207468652063617365206f6620436f6e652073657276696365732061206e65> +5.858 F -.05<6761>-.15 G<7469>.05 E 1.159 -.15<76652073>-.25 H .859 +<697a6520697320757365642c20666f72>.15 F 1.036 +<534941502073657276696365732074686520464f524d41>148 684 R<543d4d4554> +-1.11 E<4144>-.93 E -1.21 -1.11<41542041>-.4 H 1.036 +<8d6167206973207573656420696e20746865207175657279>4.646 F 3.536<2c61> +-.65 G 1.035<6e6420666f7220746162>-3.536 F 1.035<756c61722056>-.2 F +1.035<697a69657220736572>-.6 F<2d>-.2 E .256 +<76696365732074686520656e74697265207461626c652069732061636365737365642e> +148 696 R .256<436f6d706c69616e742056>5.256 F 2.756<4f73>-.4 G .256<6572 +76696365732077696c6c20726573706f6e6420717569636b6c792077697468206f6e6c79 +2074686520636f6c2d>-2.756 F 1.298<756d6e206d657461646174612c20746162>148 +708 R 1.298 +<756c6172207365727669636573206d617920726573706f6e64206d6f726520736c6f> +-.2 F 1.298<776c792064756520746f20746865206e65656420746f207472616e736665 +722074686520646174612e>-.25 F .242<416464696e6720746865>148 720 R F3 +<2d76>2.742 E F0<6f72>2.743 E F3<2d2d766572626f73652d3c4e3e>2.743 E F0 +.243<6f7074696f6e732077696c6c20696e6372656d656e742074686520564552424f53 +45206c65>2.743 F -.15<7665>-.25 G 2.743<6c6f>.15 G 2.743<6673>-2.743 G +.243<6572766963657320616e64206d6179>-2.743 F<4e56>72 768 Q 2.5<4f56>-.4 +G<4f2d434c492050726f6a656374>-2.9 E<4a756c792032303037>126.345 E<31> +209.415 E 0 Cg EP +%%Page: 2 2 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S -.4<4441>.4 G -.93<5441>-.71 G +363.44<2831292056>.93 F<4f44>-.4 E -1.21 -1.11<41542041>-.4 H<283129> +1.11 E .364<72657475726e206d6f7265206d657461646174612069662061>148 84 R +-.25<7661>-.2 G .363<696c61626c652c20746f206163636573732074686573652065> +.25 F .363<7874726120636f6c756d6e73207468652073616d65206c65>-.15 F -.15 +<7665>-.25 G 2.863<6c6f>.15 G 2.863<6676>-2.863 G .363 +<6572626f73697479206d757374>-3.013 F +<62652073657420647572696e6720612064617461207175657279>148 96 Q<2e>-.65 E +<54686520666f6c6c6f>108 124.8 Q<77696e67208d6167732073706563696679206461 +7461207175657279206f7074696f6e733a>-.25 E/F1 10/Times-Bold@0 SF +<ad62203c62706173733e206f72202d2d62616e64706173733d3c62706173733e>108 +141.6 Q F0 .978 +<436f6e73747261696e207468652071756572792062792062616e64706173732e>148 +153.6 R .978<546865206172>5.978 F .978<67756d656e7420666f6c6c6f>-.18 F +.978<77696e6720746865208d6167206d757374206265206f6e65206f66207468652061 +6c6c6f>-.25 F<776564>-.25 E 1.13 +<62616e64706173732073706563698c636174696f6e20737472696e672e>148 165.6 R +1.13<53657474696e6720746865208d61672077696c6c20636f6e73747261696e20616e> +6.13 F 3.63<7944>-.15 G 1.13 +<69726563746f727920736561726368207573656420746f206f6e6c79>-3.63 F .419< +74686f7365207265736f75726365732077686572652074686520737065637472616c2063 +6f>148 177.6 R -.15<7665>-.15 G .419 +<72616765206d61746368657320746865206769>.15 F -.15<7665>-.25 G 2.919 +<6e62>.15 G 2.919<616e64706173732e20416c6961736573>-2.919 F .42 +<666f722062616e64706173736573>2.92 F<61726520616c6c6f>148 189.6 Q +<7765642c207365652062656c6f>-.25 E -.65<772e>-.25 G F1<ad69203c8c6c653e> +108 206.4 Q F0 1.858<537065636966792061208c6c6520636f6e7461696e696e6720 +7468652072656d61696e696e6720706f736974696f6e616c20636f6d6d616e642d6c696e +6520696e7075742e2054686520636f6d6d616e64206c696e65206973>148 218.4 R +.962<74686f75676874206f66206173206861>148 230.4 R .963 +<76696e672074686520666f6c6c6f>-.2 F .963 +<77696e6720636f6d706f6e656e74733a>-.25 F .963 +<746865206f7074696f6e73206265>5.963 F .963 +<67696e6e696e672077697468206120272d272063686172616374657220616e64>-.15 F +.19<7468656972206173736f636961746564206172>148 242.4 R .19 +<67756d656e74732c206f6e65206f72206d6f7265203c>-.18 F/F2 10 +/Times-Italic@0 SF -.37<7265>C<736f7572>.37 E<6365>-.37 E F0 2.69<3e6e>C +.19<616d6573206769>-2.69 F .19 +<76696e6720746865207365727669636520746f20696e>-.25 F -.2<766f>-.4 G -.1 +<6b65>.2 G 2.69<2c61>.1 G 2.69<6e6f>-2.69 G<626a656374>-2.69 E .022<6e61 +6d65206f7220706f736974696f6e2c20616e6420616e206f7074696f6e616c2071756572 +792073697a652e>148 254.4 R .022<54686520272d6927208d616720616c6c6f>5.022 +F .022<77732065>-.25 F -.15<7665>-.25 G .022<72797468696e672065>.15 F +.022<786365707420746865206f7074696f6e7320746f>-.15 F 1.297<626520737065 +63698c65642066726f6d2061208c6c6520286f7220746865207374616e6461726420696e +7075742069662074686520272d27206172>148 266.4 R 1.297 +<67756d656e742069732075736564292c206372656174696e6720696e206566>-.18 F +1.297<666563742061>-.25 F .362<6d65616e7320746f20696e74657261637469>148 +278.4 R -.15<7665>-.25 G .362<6c7920737065636966792074686520652e672e2072 +65736f757263652f6f626a65637420776974686f75742072657374617274696e67207468 +65207461736b2c206f7220746f2074616b>.15 F 2.863<6574>-.1 G<68657365> +-2.863 E -.25<7661>148 290.4 S .181<6c7565732066726f6d2061208c6c65206f72 +20696e7075742073747265616d20746f20637265617465206d756c7469706c6520696e64 +6570656e64656e7420717565726965732e>.25 F .18 +<49662065697468657220746865207265736f75726365206f72>5.18 F<6f626a656374 +206e616d652f706f736974696f6e2068617320616c7265616479206265656e2073706563 +698c656420746865>148 302.4 Q 2.5<7964>-.15 G 2.5<6f6e>-2.5 G +<6f74206e65656420746f2062652073706563698c6564206167>-2.5 E<61696e2e>-.05 +E 1.374<54686520666f726d617420666f722074686520636f6d6d616e64208c6c652069 +73207468652073616d6520617320666f7220746865203c>148 326.4 R F2 -.37<7265> +C<736f7572>.37 E<6365>-.37 E F0 1.374<3e2c203c>B F2<6f626a6e616d65>A F0 +1.374<3e2c203c>B F2 -.15<7261>C F0 3.874<3e3c>.15 G F2<646563>-3.874 E +F0<3e2c>A<3c>148 338.4 Q F2<75726c>A F0 .115<3e2c206f72203c>B F2<7372>A +F0 2.614<3e64>C .114<65736372696265642062656c6f>-2.614 F 2.614<7761>-.25 +G .114<6e6420617320746865>-2.614 F 2.614<7977>-.15 G .114<6f756c64206170 +70656172206f6e2074686520636f6d6d616e64206c696e652c20616c6c20696e70757420 +6c696e657320617265>-2.714 F 1.157 +<7465726d696e6174656420776974682061206e65>148 350.4 R 1.157<776c696e652c +20746865208c6c65206f7220696e7075742073747265616d206973207465726d696e6174 +6564207769746820616e20454f46>-.25 F 6.158<2e41>-.8 G 3.658<6e65>-6.158 G +1.158<78616d706c65206f66>-3.808 F<686f>148 362.4 Q 2.5<7774>-.25 G +<686973206d617920626520757365642077>-2.5 E<6f756c6420626520746865207573 +696e67206120636f6d6d616e64208c6c6520737563682061733a>-.1 E 2.5 +<326d6173732d707363206d33312c6d353120302e35>184 386.4 R 2.5 +<6368616e647261206e6763343235382c6d353120302e3235>184 398.4 R .871<5468 +65207461736b2077696c6c2070726f636573732074686973208c6c652061732069662074 +6865207477>148 422.4 R 3.371<6f6c>-.1 G .87 +<696e657320686164206265656e20696e>-3.371 F -.2<766f>-.4 G -.1<6b65>.2 G +3.37<6461>.1 G 3.37<7373>-3.37 G .87<6570617261746520636f6d6d616e64732e> +-3.37 F<546865>5.87 E<616476>148 434.4 Q 2.266<616e74616765206973207468 +6174207468697320696e7075742063616e20626520637265617465642064796e616d6963 +616c6c7920627920616e6f74686572207461736b2c20616e642077652063616e2067726f +7570>-.25 F<7265736f7572636520616e64206f626a656374206c6973747320696e746f +20696e646570656e64656e7420717565726965732e>148 446.4 Q<53656520746865>5 +E F2<4578616d706c6573>2.5 E F0<62656c6f>2.5 E 2.5<7766>-.25 G +<6f72206f7468657220757365732e>-2.5 E F1 +<ad6f203c6f626a7c8c6c653e206f72202d2d6f626a6563743d3c6f626a7c8c6c653e> +108 463.2 Q F0 1.395<5370656369667920746865206f626a656374206e616d652074 +6f2075736520696e2061207175657279>148 475.2 R 6.395<2e4f>-.65 G 1.394 +<626a656374206e616d657320617265207265736f6c76>-6.395 F 1.394 +<6564206175746f6d61746963616c6c7920746f204a32303030>-.15 F .574 +<65717561746f7269616c20636f6f7264696e617465732e>148 487.2 R .574 +<546865206172>5.574 F .574<67756d656e7420746f2074686973208d6167206d6179 +20626520746865206e616d65206f6620612073696e676c65206f626a6563742c20612063 +6f6d6d612d>-.18 F .709<64656c696d69746564206c697374206f66206f626a656374 +206e616d65732c20746865206e616d65206f662061208c6c6520636f6e7461696e696e67 +206f626a656374206e616d65732c206f722074686520726573657276>148 499.2 R +.709<65642076>-.15 F<616c7565>-.25 E<272d272e>148 511.2 Q .763 +<54686520726573657276>148 535.2 R .763<65642076>-.15 F .763 +<616c756520272d272074656c6c7320746865207461736b20746f2074616b>-.25 F +3.263<6574>-.1 G .764<68697320696e666f726d6174696f6e2066726f6d2074686520 +7374616e6461726420696e7075742c2070726f63657373696e67>-3.263 F +<646f65736e27>148 547.2 Q 2.5<7462>-.18 G -.15<6567>-2.5 G<696e20756e74 +696c20746865206f626a656374206c69737420686173206265656e2066756c6c79207265 +61642e>.15 E F1 +<ad70203c706f737c8c6c653e206f72202d2d706f733d3c706f737c8c6c653e>108 564 +Q F0 .13<537065636966792074686520706f736974696f6e20746f2075736520696e20 +61207175657279>148 576 R 5.13<2e50>-.65 G .13 +<6f736974696f6e732061726520636f6d706f736564206f66207477>-5.13 F 2.63 +<6f76>-.1 G .13<616c75657320617373756d656420746f20626520657175612d>-2.88 +F .622<746f7269616c204a3230303020636f6f7264696e617465732e>148 588 R +-1.11<5661>5.622 G .622<6c7565732073706563698c65642061732061208d6f617469 +6e672d706f696e7420646563696d616c2061726520617373756d656420746f2062652069 +6e20756e697473>1.11 F .652<6f66206465>148 600 R .652<67726565732c207365> +-.15 F .652<7861676573696d616c2076>-.15 F .651<616c756573206d617920616c +736f206265207573656420616e642061726520617373756d656420746f20626520657175 +61746f7269616c20524120616e64204465632e>-.25 F .167<496620746865>148 612 +R F2<3c706f733e>2.667 E F0<6172>2.667 E 2.667<6769>-.18 G 2.668<7375> +-2.667 G .168<736564206f6e6c79206f6e6520736574206f6620636f6f7264696e6174 +6573206d6179206265206769>-2.668 F -.15<7665>-.25 G 2.668<6e6f>.15 G +2.668<6e74>-2.668 G .168 +<686520636f6d6d616e642d6c696e6520616e64206d757374>-2.668 F .412 +<62652064656c696d69746564206279206120636f6d6d612c20686f>148 624 R<7765> +-.25 E -.15<7665>-.25 G 2.911<7274>.15 G .411<6865206172>-2.911 F .411< +67756d656e74206d617920616c736f20626520746865206e616d65206f662061208c6c65 +20636f6e7461696e696e6720636f6f72>-.18 F<2d>-.2 E<64696e6174657320746f20 +62652070726f6365737365642c206f722074686520726573657276>148 636 Q +<65642076>-.15 E<616c756520272d272e>-.25 E .763<54686520726573657276>148 +660 R .763<65642076>-.15 F .763 +<616c756520272d272074656c6c7320746865207461736b20746f2074616b>-.25 F +3.263<6574>-.1 G .764<68697320696e666f726d6174696f6e2066726f6d2074686520 +7374616e6461726420696e7075742c2070726f63657373696e67>-3.263 F +<646f65736e27>148 672 Q 2.5<7462>-.18 G -.15<6567>-2.5 G<696e20756e7469 +6c2074686520706f736974696f6e206c69737420686173206265656e2066756c6c792072 +6561642e>.15 E F1<ad72203c7261646975733e206f72202d2d73723d3c726164697573 +3e5b3c756e6974733e5d>108 688.8 Q F0 .008 +<5365742074686520736561726368207261646975732e>148 700.8 R .008 +<54686520646566>5.008 F .007 +<61756c74207365617263682073697a6520697320302e31206465>-.1 F .007<677265 +657320756e6c6573732073706563698c6564206f6e2074686520636f6d6d616e642d6c69 +6e65>-.15 F .548<616e64206172>148 712.8 R .548 +<67756d656e742061726520617373756d656420746f20626520696e206465>-.18 F +3.048<67726565732c2073657474696e67>-.15 F .548<7468652073697a6520696e20 +6f7468657220756e697473206973207065726d6974746564207573696e6720746865> +3.048 F F2<2d7372>148 724.8 Q F0 3.777<8d61672e2054>3.777 F 3.776<6f73> +-.8 G 1.276<70656369667920746865203c756e6974733e20666f7220746865>-3.776 +F F2<2d2d7372>3.776 E F0 1.276<8d61672c20746865206172>3.776 F 1.276 +<67756d656e742073686f756c6420626520737566>-.18 F<8c78>-.25 E 1.276 +<656420627920616e2027>-.15 F 1.276<732720746f>-.55 F<4e56>72 768 Q 2.5 +<4f56>-.4 G<4f2d434c492050726f6a656374>-2.9 E<4a756c792032303037>126.345 +E<32>209.415 E 0 Cg EP +%%Page: 3 3 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S -.4<4441>.4 G -.93<5441>-.71 G +363.44<2831292056>.93 F<4f44>-.4 E -1.21 -1.11<41542041>-.4 H<283129> +1.11 E 1.049<73706563696679206172637365636f6e64732c20616e20276d2720746f +20736574206172636d696e757465732c20616e642027>148 84 R 1.049 +<642720746f20736574207468652073697a6520696e206465>-.5 F 3.549 +<67726565732e204279>-.15 F<646566>3.549 E 1.049<61756c742c20616c6c>-.1 F +.047<717565726965732077696c6c20626520646f6e65207573696e6720746865207361 +6d65207365617263682073697a652e>148 96 R -1.11<5661>5.047 G .046<72696162 +6c65207365617263682073697a6573206163636f6d706c6973686564207573696e672074 +686520272d6927>1.11 F<8d6167206465736372696265642061626f>148 108 Q -.15 +<7665>-.15 G<2e>.15 E/F1 10/Times-Bold@0 SF<ad73203c736572>108 124.8 Q +<766963653e206f72202d2d7376633d3c736572>-.1 E<766963653e>-.1 E F0 .289 +<53706563696679207468652073657276696365206f722075726c20746f20696e>148 +136.8 R -.2<766f>-.4 G -.1<6b65>.2 G 5.289<2e49>.1 G 2.789<6e6d>-5.289 G +.289<6f73742063617365732074686520736572766963652c20692e652e>-2.789 F .29 +<746865203c>5.29 F/F2 10/Times-Italic@0 SF -.37<7265>C<736f7572>.37 E +<6365>-.37 E F0 2.79<3e61>C -.18<7267>-2.79 G .29<756d656e742077696c6c> +.18 F .879<62652074616b>148 148.8 R .879<656e2066726f6d2074686520636f6d +6d616e646c696e65206261736564206f6e20697427>-.1 F 3.379<7370>-.55 G 3.379 +<6f736974696f6e2e20546865>-3.379 F -.15<6578>3.379 G .878 +<63657074696f6e206973207768656e2074686520757365722077>.15 F .878 +<616e7420746f>-.1 F .023<73706563696679206120736572766963652055524c2064 +69726563746c792028652e672e20746f20746573742061206c6f63616c20736572766963 +652920626563617573652069742069736e27>148 160.8 R 2.523<746b>-.18 G<6e6f> +-2.523 E .023<776e20746f20746865204469726563746f7279>-.25 F<2c>-.65 E +.299<6f7220746f207573652074686520726573657276>148 172.8 R .298<65642076> +-.15 F .298<616c75657320272d27206f722027616e>-.25 F 2.798 +<79272e20557365>-.15 F .298<6f6620272d272074656c6c7320746865207461736b20 +746f2072656164207468652073657276696365206c6973742066726f6d20746865>2.798 +F 1.344<7374616e6461726420696e7075743b>148 184.8 R 1.344 +<757365206f66207468652077>6.344 F 1.345<6f72642027616e>-.1 F 1.345<7927 +2069732061206d65616e7320746f2074656c6c696e6720746865207461736b20746f2064 +796e616d6963616c6c792063726561746520746865>-.15 F<7265736f75726365206c69 +73742066726f6d206f74686572206f7074696f6e732028652e672e2022616e>148 196.8 +Q 2.5<7969>-.15 G<6d616765207365727669636522206279207573696e6720746865> +-2.5 E F1<ad74203c747970653e206f72202d2d747970653d3c747970653e>108 213.6 +Q F0 .261<436f6e73747261696e20746865207175657279206279207365727669636520 +747970652e>148 225.6 R .261<546865206c697374206f6620616c6c6f>5.261 F .26 +<7765642073657276696365207479706573206973206769>-.25 F -.15<7665>-.25 G +2.76<6e62>.15 G<656c6f>-2.76 E 4.06 -.65<772e2054>-.25 H .26 +<68652061637475616c>.65 F 1.169<737472696e67207573656420696e206120446972 +6563746f7279207265736f75726365207265636f7264206d617920626520757365642069 +66206b6e6f>148 237.6 R 1.17 +<776e2c206f746865727769736520636f6d6d6f6e2075736520697320746f>-.25 F +.654<737065636966792027696d6167652720746f206163636573732053696d706c6520 +496d61676520416363657373202853494150292073657276696365732c2027636174616c +6f672720666f7220436f6e652073656172636865732c206f72>148 249.6 R -.18 +<2774>148 261.6 S<61626c652720666f722056>.18 E<697a69657220746162>-.6 E +<756c617220646174612e>-.2 E<54686520666f6c6c6f>108 290.4 Q<77696e67208d +616773206172652073706563698c6320746f207468652077726974696e67206f66204854 +4d4c206f72204b4d4c208c6c65733a>-.25 E F1<ad2d7765626e6f626f72646572>108 +307.2 Q F0<44697361626c65207468652073686164656420626f7264657220647261> +148 319.2 Q<776e2061726f756e6420616e2048544d4c207461626c652e>-.15 E F1 +<ad2d7765626e6f636f6c6f72>108 336 Q F0<44697361626c652074686520636f6c6f +72696e6720666f7220616e2048544d4c207461626c652e>148 348 Q F1 +<ad2d7765626e6f686561646572>108 364.8 Q F0<44697361626c6520746865204854 +4d4c207061676520686561646572207772697474656e20746f20746865206f7574707574 +208c6c652e>148 376.8 Q F1<ad2d6b6d6c6d61783d3c4e3e>108 405.6 Q F0 .978< +5370656369667920746865206d6178206e756d626572206f6620706c6163656d61726b73 +20746f2077726974652e>148 417.6 R .978<54686520646566>5.978 F .978<61756c +742069732035302c206f72646572696e67206973206e6f742067756172616e746565642e> +-.1 F<53657474696e67207468652073616d706c696e672077696c6c206175746f6d6174 +6963616c6c7920696e63726561736520746865206d6178696d756d206e756d626572206f +6620726573756c74732072657475726e65642e>148 429.6 Q F1 +<ad2d6b6d6c73616d706c653d3c4e3e>108 446.4 Q F0 .605<53706563696679207468 +652073616d706c696e67206f662074686520726573756c7420746f2062652065>148 +458.4 R -.15<7665>-.25 G<7279>.15 E F2<3c4e3e>3.105 E F0<726f>3.105 E +3.105<77732e20546865>-.25 F<646566>3.105 E .604 +<61756c7420697320746f20777269746520616c6c20726f>-.1 F .604 +<777320746f20746865>-.25 F .328<6f7574707574208c6c652e>148 470.4 R .328 +<4966207365742c20746869732076>5.328 F .328<616c75652077696c6c2062652075 +7365642061732061206d756c7469706c69657220666f7220746865206d6178206e756d62 +6572206f6620706c6163656d61726b73206175746f2d>-.25 F<6d61746963616c6c79> +148 482.4 Q<2e>-.65 E F1<ad2d6b6d6c6772>108 499.2 Q +<6f75703d6f626a656374>-.18 E F0 2.208<47726f75702074686520726573756c7473 +206f662061206d756c74692d7265736f757263652f6d756c74692d6f626a656374207175 +65727920696e746f20612073696e676c652068696572617263686963616c204b4d4c208c +6c65>148 511.2 R<67726f7570656420627920746865206f626a656374206f7220706f +736974696f6e20696e6465>148 523.2 Q 2.5<7828>-.15 G<646566>-2.5 E +<61756c74293b>-.1 E F1<ad2d6b6d6c6772>108 540 Q<6f75703d736572>-.18 E +<76696365>-.1 E F0 2.208<47726f75702074686520726573756c7473206f66206120 +6d756c74692d7265736f757263652f6d756c74692d6f626a65637420717565727920696e +746f20612073696e676c652068696572617263686963616c204b4d4c208c6c65>148 552 +R<67726f75706564206279207468652073657276696365206e616d652e>148 564 Q F1 +<ad2d6b6d6c6772>108 580.8 Q<6f75703d626f7468>-.18 E F0 1.676<47726f7570 +732074686520726573756c7473206f662061206d756c74692d7265736f757263652f6d75 +6c74692d6f626a65637420717565727920696e746f20612073696e676c65206869657261 +7263686963616c204b4d4c208c6c652e>148 592.8 R<546865207477>148 604.8 Q +2.5<6f74>-.1 G<6f702d6c65>-2.5 E -.15<7665>-.25 G 2.5<6c66>.15 G +<6f6c646572732077696c6c2062652027427920536f757263652720616e64>-2.5 E F1 +<ad2d6b6d6c6e6f6c6162656c>108 621.6 Q F0 .153<44697361626c6520746865206c +6162656c6c696e67206f6620706c6163656d61726b732e>148 633.6 R .153 +<427920646566>5.153 F .153<61756c742c207468652049445f4d41494e2075636420 +666f72206561636820706f696e742077696c6c2062652075736564206173>-.1 F 2.5 +<616c>148 645.6 S<6162656c2e>-2.5 E F1<ad2d6b6d6c6e6f72>108 662.4 Q +<6567696f6e>-.18 E F0<44697361626c652074686520647261>148 674.4 Q +<77696e67206f6620746865207265>-.15 E +<67696f6e20626f756e64696e6720626f7820696e2061204b4d4c208c6c652e>-.15 E +F1<ad2d6b6d6c6e6f>108 691.2 Q -.1<7665>-.1 G<72626f7365>.1 E F0 .521 +<44697361626c65207468652077726974696e67206f662076>148 703.2 R .521<6572 +626f736520696e666f726d6174696f6e20746f20746865204b4d4c20706c6163656d6172 +6b732e>-.15 F .52<427920646566>5.521 F .52 +<61756c742c206561636820706c6163656d61726b>-.1 F<77696c6c20636f6e7461696e +20616c6c20696e666f726d6174696f6e2066726f6d207468617420726573756c742e>148 +715.2 Q<4e56>72 768 Q 2.5<4f56>-.4 G<4f2d434c492050726f6a656374>-2.9 E +<4a756c792032303037>126.345 E<33>209.415 E 0 Cg EP +%%Page: 4 4 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S -.4<4441>.4 G -.93<5441>-.71 G +363.44<2831292056>.93 F<4f44>-.4 E -1.21 -1.11<41542041>-.4 H<283129> +1.11 E<496e707574204f7074696f6e733a>108 84 Q/F1 10/Times-Bold@0 SF +<ad2d636f6c733d>108 100.8 Q/F2 10/Times-Italic@0 SF<636f6c5f737472>A F0 +1.902<55736520636f6c756d6e732073706563698c656420696e>148 112.8 R F2 +<636f6c5f737472>4.402 E F0 1.902<746f207265616420746865>4.402 F F2 -.15 +<7261>4.402 G F0<2c>.15 E F2<646563>4.403 E F0<616e64>4.403 E F2<6964> +4.403 E F0 -.25<7661>4.403 G 1.903<6c756573207265737065637469>.25 F -.15 +<7665>-.25 G<6c79>.15 E<2e>-.65 E F2<636f6c5f737472>6.903 E F0 1.903 +<69732061>4.403 F .822 +<636f6d6d612d64656c696d69746564206c69737420776865726520746865>148 124.8 +R F2<6964>3.322 E F0 .822<636f6c756d6e206973206f7074696f6e616c20616e6420 +77696c6c206e6f742062652075736564206966206e6f742070726573656e742061732074 +6865>3.322 F .075<746869726420656c656d656e7420696e20746865206c6973742e> +148 136.8 R .075<4f7468657220636f6c756d6e73206d6179206265206769>5.075 F +-.15<7665>-.25 G 2.575<6e61>.15 G 2.575<736173>-2.575 G .075 +<696e676c6520696e7465>-2.575 F .075 +<676572206f7220617320612072616e6765206f662074686520666f726d>-.15 F F2 +<7374617274>148 148.8 Q F0<2d>A F2<656e64>A F0 1.244 +<696e6469636174696e67207468652076>3.744 F 1.244 +<616c75657320696e20746865>-.25 F F2<7374617274>3.743 E F0<74687275>3.743 +E F2<656e64>3.743 E F0 1.243<636f6c756d6e732073686f756c6420626520636f6d +62696e656420696e746f20612073696e676c65>3.743 F -.25<7661>148 160.8 S +<6c75652e>.25 E F1<ad642c202d2d64656c696d3d>108 177.6 Q F2<64656c696d>A +F0 .705<55736520746865>148 189.6 R F2<64656c696d>3.205 E F0 .705 +<61732074686520696e707574207461626c652064656c696d69746572>3.205 F 5.705 +<2e42>-.55 G 3.205<7964>-5.705 G<6566>-3.205 E .705 +<61756c742c20612073706163652c207461622c20636f6d6d612c2076>-.1 F .706 +<6572746963616c206261722028277c27292c206f72>-.15 F .358<73656d69636f6c6f +6e206d6179206265207573656420617320612064656c696d6974657220666f7220746865 +20696e707574207461626c652e>148 201.6 R .357<4966206e6f2065>5.358 F .357 +<78706c696369742064656c696d697465722069732073706563698c65642c20746865> +-.15 F .522<8c727374206f63637572616e6365206f6620616e>148 213.6 R 3.022 +<796f>-.15 G .522<6e65206f662074686573652077696c6c20626520757365642e> +-3.022 F .522<54686520726573657276>8.022 F .523<65642077>-.15 F +<6f726473>-.1 E F2<636f6d6d61>3.023 E F0<2c>A F2<7370616365>3.023 E F0 +<2c>A F2<746162>3.023 E F0 3.023<2c6f>C<72>-3.023 E F2<626172>3.023 E F0 +<6d6179206265207573656420696e20706c616365206f6620612073706563698c632063 +6861726163746572>148 225.6 Q<2e>-.55 E +<3c44543e3c423e2d2d65636f6c733d3c2f423e3c493e636f6c5f7374723c2f493e>148 +249.6 Q F1<ad2d65636f6c733d>108 266.4 Q F2<636f6c5f737472>A F0 .552 +<557365207468652065>148 278.4 R .552 +<78706c6963697420636f6c756d6e732073706563698c656420696e>-.15 F F2 +<636f6c5f737472>3.051 E F0 .551<696e2074686520696e707574207461626c652e> +3.051 F .551 +<54686973206f7074696f6e2073686f756c64206f6e6c792062652075736564>5.551 F +.058<7769746820666f726d6174746564207465>148 290.4 R .058 +<7874207461626c65732077686572652074686520646573697265642076>-.15 F .058 +<616c7565732077696c6c20616c>-.25 F -.1<7761>-.1 G .058<797320626520696e +207468652073616d6520636f6c756d6e73206f6620746865208c6c652e>.1 F .506<4e +6f746520746861742027636f6c756d6e2720696e20746869732063617365207265666572 +7320746f20612073706563698c632063686172616374657220636f6c756d6e20696e2061 +207465>148 302.4 R .506<7874208c6c652e>-.15 F .505 +<436f6c756d6e73206d6179>5.505 F<626520612073696e676c6520696e7465>148 +314.4 Q<676572206f7220612072616e67652c20616e64206973206120636f6d6d612d64 +656c696d69746564206c697374206173207769746820746865>-.15 E F2 +<2d2d636f6c73>2.5 E F0<6f7074696f6e2e>2.5 E F1<ad66>108 331.2 Q 2.5 +<2c2d>-.15 G<2d66>-2.5 E<6f72>-.25 E<6365>-.18 E F0 -.15<466f>148 343.2 +S .251<7263652074686520696e707574207461626c6520746f20626520757365642065> +.15 F -.15<7665>-.25 G 2.752<6e69>.15 G 2.752<6e74>-2.752 G .252 +<6865206e756d626572206f6620636f6c756d6e732076>-2.752 F .252 +<6172696573206f6e2065616368206c696e652e>-.25 F .252 +<54686520617373756d702d>5.252 F .423 +<74696f6e2068657265206973207468617420616e>148 355.2 R 2.923<7976>-.15 G +.423<6172696174696f6e2028652e6720656d70747920636f6c756d6e7329206f636375 +727320616674657220746865>-3.173 F F2 -.15<7261>2.923 G F0<2c>.15 E F2 +<646563>2.923 E F0<616e64>2.923 E F2<6964>2.922 E F0 .422 +<636f6c756d6e7320696e20746865>2.922 F<7461626c652e>148 367.2 Q F1 +<ad2d68736b69703d>108 384 Q F2<3c4e3e>A F0<536b6970>148 396 Q F2<3c4e3e> +2.911 E F0 .411 +<686561646572206c696e657320696e2074686520696e707574208c6c652e>2.911 F +.411<54686973206f7074696f6e206973206f6e6c79206e6565646564207768656e2074 +6865206c696e657320746f20626520736b6970706564>5.411 F<646f206e6f74206265> +148 408 Q<67696e207769746820746865206e6f726d616c2027232720636f6d6d656e74 +20636861726163746572>-.15 E<2e>-.55 E F1<ad2d6e6c696e65733d>108 424.8 Q +F2<3c4e3e>A F0<557365206f6e6c79>148 436.8 Q F2<3c4e3e>2.5 E F0 +<6c696e6573206f662074686520696e707574207461626c652e>2.5 E F1 +<ad2d73616d706c653d>108 453.6 Q F2<3c4e3e>A F0 +<53616d706c6520746865207461626c652065>148 465.6 Q -.15<7665>-.25 G<7279> +.15 E F2<3c4e3e>2.5 E F0 2.5<6c696e65732e2053657474696e67>2.5 F +<7468652073616d706c652077696c6c206e6f74206166>2.5 E<6665637420746865> +-.25 E F2<6e6c696e6573>2.5 E F0<757365642e>2.5 E +<4f7574707574204f7074696f6e733a>108 506.4 Q F1<ad312c2d2d6f6e65>108 +523.2 Q F0<5361>5.14 E .469 -.15<76652074>-.2 H .169 +<686520726573756c747320696e746f20612073696e676c65208c6c65207265>.15 F +-.05<6761>-.15 G .168<72646c657373206f6620666f726d61742e>.05 F .168<5468 +6973206f7074696f6e2077696c6c20626520736574206175746f6d61746963616c6c7920 +696620746865>5.168 F .334<6f7574707574206973206265696e67207772697474656e +20746f20746865207374616e64617264206f75747075742e>148 535.2 R .335<496620 +746865206f757470757420666f726d617420697320736f6d657468696e67206f74686572 +207468616e204b4d4c>5.334 F .61<6f7220584d4c2c20616c6c20726573756c747320 +77696c6c20626520636f6e636174656e6174656420696e746f20696e6469>148 547.2 R +.61<76696475616c208c6c6573206f662074686520666f726d20223c7376633e5f3c7069 +643e2e3c65>-.25 F<78746e3e22>-.15 E .759<736f20746861742065616368208c6c +652077696c6c20636f6e7461696e20746865206f626a65637420726573756c7473206672 +6f6d206561636820736572766963652077686572652074686520636f6c756d6e73207769 +6c6c20626520746865>148 559.2 R<73616d652e>148 571.2 Q F1 +<ad412c2d2d6173636969>108 588 Q F0<5361>148 600 Q 1.287 -.15<76652074> +-.2 H .987<686520726573756c7473206173206120776869746573706163652064656c +696d69746564206173636969207461626c652e>.15 F .986<496620616e206f75747075 +74208c6c6520697320637265617465642069742077696c6c206861>5.987 F 1.286 +-.15<76652061>-.2 H<222e747874222065>148 612 Q +<7874656e73696f6e20617070656e646564206175746f6d61746963616c6c79>-.15 E +<2e>-.65 E F1<ad432c2d2d637376>108 628.8 Q F0<5361>148 640.8 Q .697 -.15 +<76652074>-.2 H .397 +<686520726573756c7473206173206120636f6d6d612d7365706172617465642d76>.15 +F .397<616c7565202843535629207461626c652e>-.25 F .398<496620616e206f7574 +707574208c6c6520697320637265617465642069742077696c6c206861>5.397 F -.15 +<7665>-.2 G 2.5<6122>148 652.8 S<2e637376222065>-2.5 E +<7874656e73696f6e20617070656e646564206175746f6d61746963616c6c79>-.15 E +<2e>-.65 E F1<ad482c2d2d68746d6c>108 669.6 Q F0<5361>148 681.6 Q 1.289 +-.15<76652074>-.2 H .989 +<686520726573756c747320617320616e2048544d4c207461626c652e>.15 F .988<49 +6620616e206f7574707574208c6c6520697320637265617465642069742077696c6c2068 +61>5.988 F 1.288 -.15<766520612022>-.2 H .988<2e68746d6c222065>.15 F +<7874656e73696f6e>-.15 E .493 +<617070656e646564206175746f6d61746963616c6c79>148 693.6 R 5.493<2e53> +-.65 G .493<65652061626f>-5.493 F .793 -.15<76652066>-.15 H .493 +<6f7220746865>.15 F F2<2d2d7765626e6f686561646572>2.993 E F0 .494<6f7074 +696f6e20746861742063616e206265207573656420746f2064697361626c6520746865> +2.994 F<48544d4c207061676520686561646572>148 705.6 Q<2e>-.55 E<4e56>72 +768 Q 2.5<4f56>-.4 G<4f2d434c492050726f6a656374>-2.9 E +<4a756c792032303037>126.345 E<34>209.415 E 0 Cg EP +%%Page: 5 5 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S -.4<4441>.4 G -.93<5441>-.71 G +363.44<2831292056>.93 F<4f44>-.4 E -1.21 -1.11<41542041>-.4 H<283129> +1.11 E/F1 10/Times-Bold@0 SF<ad492c2d2d696e>108 84 Q -.1<7665>-.4 G +<6e746f7279>.1 E F0 .154<517565727920746865>148 96 R/F2 10 +/Times-Italic@0 SF<496e>2.654 E .154<76656e746f72792053657276696365>-.4 +F F0 .153<726174686572207468616e2074686520646174612073657276696365732064 +69726563746c79>2.654 F 5.153<2e54>-.65 G .153 +<6869732077696c6c2072657475726e2073696d706c79206120636f756e74>-5.153 F +.179<6f662074686520726573756c747320666f756e642c2062>148 108 R .179<7574 +207768656e2070726573656e74656420776974682061207461626c65206f66207265736f +757263657320616e6420736f75726365732063616e206265207573656420746f20646f20 +61>-.2 F<73696d706c652063726f73736d61746368206f662074686520736f75726365 +7320666f756e6420696e2074686520636174616c6f67732061>148 120 Q -.25<7661> +-.2 G<696c61626c65207468726f7567682074686520736572766963652e>.25 E F1 +<ad4b2c2d2d4b4d4c>108 136.8 Q F0<5361>148 148.8 Q 1.316 -.15<76652074> +-.2 H 1.016 +<686520726573756c7473206173206120476f6f676c652045617274682f536b>.15 F +3.516<794b>-.15 G 1.016<4d4c20706c6163656d61726b208c6c652e>-3.516 F +1.016 +<496620616e206f7574707574208c6c6520697320637265617465642069742077696c6c> +6.016 F<6861>148 160.8 Q .326 -.15<766520612022>-.2 H .026 +<2e6b6d6c222065>.15 F .026 +<7874656e73696f6e20617070656e646564206175746f6d61746963616c6c79>-.15 F +5.026<2e53>-.65 G .026<65652061626f>-5.026 F .326 -.15<76652066>-.15 H +.026<6f72206164646974696f6e616c206f7074696f6e73207468617420636f6e74726f +6c20746865>.15 F<636f6e74656e74206f6620746865208c6c652e>148 172.8 Q F1 +<ad522c20ad56206f72202d2d726177>108 189.6 Q 2.5<2c2d>-.55 G<2d76>-2.5 E +<6f7461626c65>-.1 E F0<5361>148 201.6 Q 1.738 -.15<76652074>-.2 H 1.438 +<686520726573756c74732061732061207261>.15 F 3.937<7756>-.15 G -.4<4f54> +-4.337 G 3.937<61626c652e204966>-.4 F 1.437 +<616e206f7574707574208c6c6520697320637265617465642069742077696c6c206861> +3.937 F 1.737 -.15<766520612022>-.2 H<2e76>.15 E 1.437<6f74222065>-.2 F +<7874656e73696f6e>-.15 E<617070656e646564206175746f6d61746963616c6c79> +148 213.6 Q<2e>-.65 E F1<ad54>108 230.4 Q<2c2d2d747376>-.74 E F0<5361> +6.99 E 1.311 -.15<76652074>-.2 H 1.011 +<686520726573756c74732061732061207461622d7365706172617465642d76>.15 F +1.012<616c7565202854535629207461626c652e>-.25 F 1.012<496620616e206f7574 +707574208c6c6520697320637265617465642069742077696c6c206861>6.012 F 1.312 +-.15<76652061>-.2 H<222e747376222065>148 242.4 Q +<7874656e73696f6e20617070656e646564206175746f6d61746963616c6c79>-.15 E +<2e>-.65 E F1<ad4f203c72>108 259.2 Q +<6f6f743e206f72202d2d6f75747075743d3c72>-.18 E<6f6f743e>-.18 E F0 .349 +<5365742074686520726f6f74206f6620746865206f7574707574206e616d652e>148 +271.2 R .349<54686520726573657276>5.349 F .349<65642076>-.15 F .349<616c +756520272d272074656c6c7320746865207461736b20746f20777269746520746f207468 +65207374616e64617264206f75742d>-.25 F<7075742e>148 283.2 Q F1 +<ad582c2d2d786d6c>108 300 Q F0<5361>148 312 Q .685 -.15<76652074>-.2 H +.385<686520726573756c7473207772617070656420584d4c208c6c65206f6620746865 +207261>.15 F 2.886<7756>-.15 G -.4<4f54>-3.286 G .386 +<61626c6520726573756c74732e>-.4 F .386 +<496620616e206f7574707574208c6c6520697320637265617465642069742077696c6c> +5.386 F<6861>148 324 Q .583 -.15<766520612022>-.2 H .283<2e786d6c222065> +.15 F .283 +<7874656e73696f6e20617070656e646564206175746f6d61746963616c6c79>-.15 F +5.282<2e54>-.65 G .282<686520584d4c20646f63756d656e742077696c6c2067> +-5.282 F .282<617468657220616c6c2074686520696e6469>-.05 F<7669642d>-.25 +E .42<75616c2056>148 336 R -.4<4f54>-.4 G .421<61626c6520726573756c7420 +8c6c657320746f20612073696e676c6520584d4c20646f63756d656e742c207768657265 +206561636820656e74727920697320777261707065642062792074686520656c656d656e +74>-.4 F F2<3c56>148 348 Q -.4<4f54>-.3 G<41424c455f454e5452>-.1 E<593e> +-.18 E F0 5.287<2e54>C .287 +<686572652077696c6c20626520746872656520617474726962>-5.287 F<757465733a> +-.2 E F2<737663>5.287 E F0 .286 +<77696c6c2062652074686520646174612073657276696365206e616d652c>2.786 F F2 +<6f626a>2.786 E F0<77696c6c>2.786 E 1.271<626520746865206f626a656374206e +616d652028696620737570706c696564292c20616e6420746865>148 360 R F2 +<696e6465>3.771 E<78>-.2 E F0<617474726962>3.771 E 1.271<757465206769> +-.2 F 1.271<76696e6720616e20696e6465>-.25 F 3.772<7869>-.15 G 1.272 +<6e746f2074686520726573756c74732e>-3.772 F<54686973>6.272 E<696e6465>148 +372 Q 5.3<786c>-.15 G 2.8 +<6973742069732063726561746564206279206c6f6f70696e67206f>-5.3 F -.15 +<7665>-.15 G 5.3<7265>.15 G 2.8<61636820736572766963652c20616e6420666f72 +206561636820736572766963652c206c6f6f70696e67206f>-5.3 F -.15<7665>-.15 G +5.3<7274>.15 G<6865>-5.3 E<6f626a6563742f706f736974696f6e206c6973742e> +148 384 Q F1<ad652c2d2d65787472616374>108 400.8 Q F0 .392<45787472616374 +20706f736974696f6e616c20616e642061636365737320696e666f726d6174696f6e2074 +6f2065>148 412.8 R .393<78747261206f7574707574208c6c65732e>-.15 F .393 +<427920646566>5.393 F .393 +<61756c7420626f7468208c6c65732077696c6c20626520777269742d>-.1 F .768 +<74656e2c207573696e67>148 424.8 R F2<2d2d65>3.268 E<787472>-.2 E +<6163743d706f73>-.15 E F0 .767<77696c6c207772697465206f6e6c792074686520 +706f736974696f6e616c20696e666f726d6174696f6e208c6c652c207573696e67>3.268 +F F2<2d2d65>3.267 E<787472>-.2 E<6163743d75726c73>-.15 E F0<77696c6c> +3.267 E .911<777269746520746865206163636573732055524c73206f6e6c79>148 +436.8 R 5.912<2e41>-.65 G .912 +<63636573732055524c7320617265207772697474656e206f6e652d706572>-5.912 F +.912<2d6c696e6520746f2061208c6c652077697468207468652073616d6520726f6f74> +-.2 F .818<6e616d6520617320746865206d61696e206f75747075742062>148 448.8 +R .818<75742077697468206120222e75726c73222065>-.2 F 3.317 +<7874656e73696f6e3b20506f736974696f6e616c>-.15 F .817 +<696e666f726d6174696f6e206973207772697474656e20746f2061208c6c65>3.317 F +.13<77697468206120222e706f73222065>148 460.8 R .13<7874656e73696f6e2061 +6e642077696c6c20636f6e7461696e20746872656520636f6c756d6e73206d6164652075 +70206f6620746865206964656e74698c6572202874686520636f6c756d6e2077697468> +-.15 F<746865>148 472.8 Q F2<49445f4d41494e>5.624 E F0 3.124 +<756364292c20524120616e64204465632028746865>5.624 F F2 +<504f535f45515f52415f4d41494e>5.624 E F0<616e64>5.624 E F2 +<504f535f45515f4445435f4d41494e>5.624 E F0<756364>5.624 E .138 +<636f6c756d6e73207265737065637469>148 484.8 R -.15<7665>-.25 G 2.638 +<6c79292e204966>.15 F .139<7468657365207563647320617070656172206d6f7265 +207468616e206f6e636520696e2061207461626c652c20746865208c727374206f636375 +7272616e63652077696c6c206265>2.638 F<757365642e>148 496.8 Q +<4164646974696f6e616c6c79>148 520.8 Q 3.1<2c74>-.65 G<6865>-3.1 E F2 +<2d2d65>3.1 E<787472>-.2 E<6163743d686561646572>-.15 E<73>-.1 E F0 +<616e64>3.1 E F2<2d2d65>3.099 E<787472>-.2 E<6163743d6b6d6c>-.15 E F0 +.599<8d616773206d617920626520746f20746f2073706563696679207468652048544d +4c20616e64>3.099 F 4.556<4b4d4c206f7574707574206265207772697474656e2074 +6f208c6c6573207769746820222e68746d6c2220616e6420222e6b6d6c222065>148 +532.8 R 4.556<7874656e73696f6e73207265737065637469>-.15 F -.15<7665>-.25 +G<6c79>.15 E 9.556<2e54>-.65 G<6865>-9.556 E F2<2d2d65>148 544.8 Q +<787472>-.2 E<6163743d4b4d4c>-.15 E F0 1.073<8d61672077696c6c2063617573 +65206d756c74692d7265736f7572636520616e642f6f72206d756c74692d6f626a656374 +207175657269657320746f20626520636f6c6c656374656420696e746f2061>3.574 F +.344<73696e676c65204b4d4c208c6c652e>148 556.8 R .344 +<54686520666f726d61742d73706563698c63>5.344 F F2<2d2d6b6d6c3c6f70743e> +2.844 E F0<616e64>2.845 E F2<2d2d7765623c6f70743e>2.845 E F0 .345 +<8d6167732077696c6c206170706c7920746f207468657365208c6c65732e>2.845 F +<41>148 568.8 Q F2<2d2d65>3.316 E<787472>-.2 E<6163743d786d6c>-.15 E F0 +.816<8d61672077696c6c20666f72636520746865206f757470757420666f726d617420 +746f206265207261>3.316 F 3.316<7756>-.15 G -.4<4f54>-3.716 G .816 +<61626c6520616e642067>-.4 F .816 +<61746865722074686520726573756c747320746f2061>-.05 F +<73696e676c6520584d4c20646f63756d656e74202873656520746865>148 580.8 Q F2 +<2d58>2.5 E F0<6f7074696f6e292e>2.5 E .434<4e6f746520746861742074686520 +55524c73208c6c652063616e206265207573656420746f206c6174657220616363657373 +207468652064617461202870657268617073206166746572207375622d73656c65637469 +6e672066726f6d20746865>148 604.8 R<7461626c65206261736564206f6e20736f6d +65206372697465726961292062792063616c6c696e6720746865207461736b206167>148 +616.8 Q<61696e207573696e6720746865208c6c656e616d6520617320746865206f6e6c +79206172>-.05 E<67756d656e742e>-.18 E F1<ad6e2c2d2d6e6f7361>108 633.6 Q +-.1<7665>-.25 G F0 .793<496620656e61626c65642c2074686973208d61672074656c +6c7320746865207461736b206e6f7420746f207361>148 645.6 R 1.093 -.15 +<76652072>-.2 H .793<6573756c747320746f206c6f63616c206469736b2e>.15 F +.793<53746174757320616e6420726573756c7420696e666f726d6174696f6e>5.793 F< +77696c6c20636f6e74696e756520746f206265207072696e74656420746f207468652073 +637265656e2c2062>148 657.6 Q<7574206e6f206461746120617265207361>-.2 E +-.15<7665>-.2 G 2.5<6474>.15 G 2.5<6f64>-2.5 G<69736b2e>-2.5 E F1 +<ad712c2d2d7175696574>108 674.4 Q F0<5175696574206d6f64652e>148 686.4 Q +<537570707265737320616e>5 E 2.5<7965>-.15 G +<787472616e656f7573206f757470757420616e642077>-2.65 E +<61726e696e67206d657373616765732e>-.1 E F1<ad752c2d2d75726c>108 703.2 Q +F0 -.15<466f>6.8 G +<726365207468652073706563698c65642055524c20746f20626520646f>.15 E +<776e6c6f616465642e>-.25 E<4e56>72 768 Q 2.5<4f56>-.4 G +<4f2d434c492050726f6a656374>-2.9 E<4a756c792032303037>126.345 E<35> +209.415 E 0 Cg EP +%%Page: 6 6 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S -.4<4441>.4 G -.93<5441>-.71 G +363.44<2831292056>.93 F<4f44>-.4 E -1.21 -1.11<41542041>-.4 H<283129> +1.11 E -.4<4441>108 84 S<4c32205175657279204f7074696f6e733a>.4 E/F1 10 +/Times-Bold@0 SF<ad2d62616e643d>108 100.8 Q/F2 10/Times-Italic@0 SF +<62616e645f737472696e67>A F0 2.091 +<54686520737065637472616c2062616e6470617373206973206769>148 112.8 R -.15 +<7665>-.25 G 4.591<6e69>.15 G 4.591<6e72>-4.591 G 2.091 +<616e67652d6c69737420666f726d61742e>-4.591 F -.15<466f>7.091 G 4.592 +<72616e>.15 G 2.092 +<756d65726963616c2062616e64706173732074686520756e69747320617265>-4.592 F +-.1<7761>148 124.8 S -.15<7665>-.1 G .499<6c656e67746820696e2076>.15 F +.499<616375756d20696e20756e697473206f66206d65746572732e>-.25 F .498<5468 +6520737065637472616c2072657374206672616d65206d6179206f7074696f6e616c6c79 +206265207175616c698c6564206173>5.499 F<656974686572>148 136.8 Q F2 +<736f7572>2.813 E<6365>-.37 E F0<6f72>2.813 E F2<6f62736572766572>2.813 +E F0 2.813<2c73>C .313 +<706563698c656420617320612072616e67652d6c697374207175616c698c6572>-2.813 +F 5.314<2e42>-.55 G .314 +<616e6470617373206e616d657320617265206f6674656e206e6f742075736566756c> +-5.314 F .065<666f7220737065637472612028746865>148 148.8 R 2.564<7961> +-.15 G .064<72652070726f6261626c79206d6f72652075736566756c20666f7220696d +616765206f722074696d65207365726965732064617461292062>-2.564 F .064 +<757420746865726520617265206361736573207768657265>-.2 F<746865>148 160.8 +Q 2.5<7961>-.15 G +<72652075736566756c20666f7220737065637472612c20666f722065>-2.5 E +<78616d706c6520666f7220612076>-.15 E<656c6f6369747920737065637472756d20 +6f6620612073706563698c6320656d697373696f6e206c696e652e>-.15 E F1 +<ad2d74696d653d>108 177.6 Q F2<74696d655f737472696e67>A F0 .935 +<5468652074696d6520636f>148 189.6 R -.15<7665>-.15 G .935<72616765202865 +706f6368292073706563698c656420696e2072616e67652d6c69737420666f726d206173 +2064658c6e656420696e2073656374696f6e20382e372e322c20696e2049534f20383630 +31>.15 F .903<666f726d61742e204966207468652074696d652073797374656d207573 +6564206973206e6f742073706563698c65642055544320697320617373756d65642e2054 +68652076>148 201.6 R .903<616c75652073706563698c6564206d61792062652061> +-.25 F .352<73696e676c652076>148 213.6 R .352<616c7565206f7220616e206f70 +656e206f7220636c6f7365642072616e67652e20496620612073696e676c652076>-.25 +F .352<616c75652069732073706563698c6564206974206d61746368657320616e>-.25 +F 2.853<7973>-.15 G .353<7065637472756d20666f72>-2.853 F 1.184 +<7768696368207468652074696d6520636f>148 225.6 R -.15<7665>-.15 G 1.184 +<7261676520696e636c75646573207468652073706563698c65642076>.15 F 1.184 +<616c75652e2049662061207477>-.25 F 3.684<6f76>-.1 G 1.183 +<616c7565642072616e6765206973206769>-3.934 F -.15<7665>-.25 G 1.183 +<6e2c20612064617461736574>.15 F<6d61746368657320696620616e>148 237.6 Q +2.5<7970>-.15 G<6f7274696f6e206f66206974206f>-2.5 E -.15<7665>-.15 G +<726c61707320746865206769>.15 E -.15<7665>-.25 G 2.5<6e74>.15 G +<656d706f72616c207265>-2.5 E<67696f6e2e>-.15 E/F3 10.95/Times-Bold@0 SF +<4445534352495054494f4e>72 290.4 Q F0<546865>108 302.4 Q F1 -.1<766f> +2.752 G<64617461>.1 E F0 .252<7461736b20616c6c6f>2.752 F .252 +<77732061207573657220746f20717565727920616e64206163636573732056>-.25 F +2.752<4f64>-.4 G .252<61746120666f72206d756c7469706c65207265736f75726365 +7320616e64206f626a656374732066726f6d2061206465736b2d>-2.752 F +<746f70206f7220736372697074696e6720656e>108 314.4 Q 2.5 +<7669726f6e6d656e742e204279>-.4 F +<64657369676e2c20746865207461736b20696e74657266>2.5 E +<616365206973206d65616e7420746f2070726f>-.1 E +<766964652074686520666f6c6c6f>-.15 E<77696e672066656174757265733a>-.25 E +F1<ad>108 343.2 Q F0 .665<5265736f75726365732028692e652e2064617461207365 +72766963657329206d617920626520726566657272656420746f207573696e672061206d +6f72652066>14.3 F<616d696c696172>-.1 E F2<53686f72744e616d65>3.164 E F0 +.664<64657369676e6174696f6e2c206f7220616e>3.164 F<4956>128 355.2 Q 2.578 +<4f69>-.4 G<64656e74698c6572>-2.578 E 2.578<2c65>-.4 G .078 +<6974686572206f662077686963682077696c6c206265207265736f6c76>-2.578 F +.078<656420746f20612073706563698c63>-.15 F F2<5365727669636555524c>2.578 +E F0 .078<696e7465726e616c6c79207573696e6720746865204469726563746f7279> +2.578 F<2e>-.65 E F1<ad>108 372 Q F0 .556<4f626a656374206e616d6573206d61 +79206265207573656420746f207370656369667920746865206c6f636174696f6e206f66 +20612064617461207175657279>14.3 F 3.056<2c74>-.65 G .556 +<686520706f736974696f6e2077696c6c206265207265736f6c76>-3.056 F .556 +<656420696e746572>-.15 F<2d>-.2 E<6e616c6c79207573696e6720746865>128 384 +Q F2<536573616d65>2.5 E F0<77656220736572766963652e>2.5 E F1<ad>108 +400.8 Q F0 1.246 +<4f7574707574208c6c6573206d6179206265206372656174656420696e20612076>14.3 +F 1.246<617269657479206f6620636f6d6d6f6e20666f726d61747320656173696c7920 +6d616e6970756c617465642077697468206f74686572206465736b746f70>-.25 F +<746f6f6c732e>128 412.8 Q F1<ad>108 429.6 Q F0<4d756c7469706c6520726573 +6f757263657320616e64206f626a65637473207368616c6c206265207175657269656420 +696e20706172616c6c656c207768656e20706f737369626c6520746f206f7074696d697a +6520746865207461736b2e>14.3 E F1<ad>108 446.4 Q F0<44617461207265666572 +656e63656420696e206120717565727920726573706f6e73652073686f756c6420626520 +61636365737369626c6520627920746865207461736b206175746f6d61746963616c6c79> +14.3 E<2e>-.65 E F1<ad>108 463.2 Q F0 .952 +<54686520636f6d6d616e642d6c696e6520696e74657266>14.3 F .951 +<6163652073686f756c6420626520617320667269656e646c7920616e64206173208d65> +-.1 F .951<7869626c6520617320706f737369626c6520746f20616c6c6f>-.15 F +3.451<7774>-.25 G .951<6865207461736b20746f206265>-3.451 F +<7573656420696e206d756c7469706c652077>128 475.2 Q<6179732e>-.1 E .258 +<546865207461736b2073686f756c6420717569636b6c79206265636f6d652066>108 +504 R .259<616d696c69617220746f20757365727320616e64206973206d65616e7420 +6f70657261746520696e20636f6e63657274207769746820746865>-.1 F F1 -.1 +<766f>2.759 G<646972>.1 E<6563746f7279>-.18 E F0<616e64>2.759 E F1 -.1 +<766f>108 516 S<736573616d65>.1 E F0 .858<7461736b7320746f20616c6c6f> +3.358 F 3.358<776e>-.25 G -.15<6f76>-3.358 G .858 +<69636520757365727320746f206265>.15 F .858<67696e20746f2065>-.15 F .858< +78706c6f726520666f722064617461207265736f757263657320746f2062652075736564 +20696e20746865208c6e616c207175657279>-.15 F<2e>-.65 E .453 +<536f6d65206f6620746865208d65>108 528 R .453 +<786962696c697479206f6620746865207461736b2069732073686f>-.15 F .454 +<776e20696e20746865204578616d706c65732073656374696f6e2062656c6f>-.25 F +4.254 -.65<772e204d>-.25 H .454 +<616a6f7220636f6e6365707473206f6620746865207461736b20617265>.65 F +<64657461696c65642062656c6f>108 540 Q 2.5<7761>-.25 G 2.5<7377>-2.5 G +<656c6c2e>-2.5 E F1<4172>87 580.8 Q<67756d656e742050>-.1 E<617273696e67> +-.1 E F0<546865206d65616e696e67206f66207468652076>108 592.8 Q +<6172696f757320636f6d6d616e642d6c696e65206172>-.25 E +<67756d656e74732069732064657461696c65642062656c6f>-.18 E<773a>-.25 E F2 +<3c72>108 621.6 Q<65736f7572>-.37 E<63653e>-.37 E F0<546865>148 633.6 Q +F2<53686f72744e616d65>2.794 E F0<6f72>2.794 E F2<4964656e74698c6572> +2.794 E F0 .294<6f6620612064617461207265736f7572636520746f20626520717565 +726965642c206120636f6d6d612d64656c696d69746564206c697374206f662065697468 +6572>2.794 F 2.793<2c6f>-.4 G<72>-2.793 E .8 +<746865206e616d65206f662061208c6c6520636f6e7461696e696e6720656974686572> +148 645.6 R 5.8<2e54>-.55 G .8 +<68657365206e616d65732077696c6c206265207265736f6c76>-5.8 F .8 +<656420746f2061206461746120736572766963652055524c207573696e67>-.15 F +1.062<746865204469726563746f7279>148 657.6 R 6.062<2e54>-.65 G<6865> +-6.062 E F2<2d73>3.562 E F0 1.062<6f7074696f6e206d6179206265207573656420 +746f20737065636966792061206e6f6e2d7265>3.562 F<6769737465726564>-.15 E +F2<5365727669636555524c>3.562 E F0 1.062<7468617420746865207461736b> +3.562 F<6d6179207573652c20686f>148 669.6 Q<7765>-.25 E -.15<7665>-.25 G +2.5<7274>.15 G<6865>-2.5 E F2<2d74>2.5 E F0<6f7074696f6e206973207468656e +20616c736f20726571756972656420746f2073706563696679207468652074797065206f +6620736572766963652e>2.5 E F2<3c6f626a6e616d653e>108 686.4 Q F0 .562<54 +6865206e616d65206f6620616e206f626a6563742c206120636f6d6d612d64656c696d69 +746564206c697374206f66206f626a656374206e616d65732c206f7220746865206e616d +65206f662061208c6c6520636f6e7461696e696e67>148 698.4 R .907 +<6f626a656374206e616d65732e>148 710.4 R .907<54686520636f6f7264696e6174 +6573206f662065616368206f626a6563742077696c6c206265207265736f6c76>5.907 F +.906<656420746f206120706f736974696f6e207072696f7220746f2070726f63657373 +696e67>-.15 F .835<7573696e6720746865>148 722.4 R F2<536573616d65>3.335 +E F0 .835<6e616d65207265736f6c76>3.335 F .835<657220736572766963652e> +-.15 F .835<416e206572726f722077696c6c2062652072657475726e65642069662061 +6e206f626a656374206e616d652063616e6e6f74206265>5.835 F<4e56>72 768 Q 2.5 +<4f56>-.4 G<4f2d434c492050726f6a656374>-2.9 E<4a756c792032303037>126.345 +E<36>209.415 E 0 Cg EP +%%Page: 7 7 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S -.4<4441>.4 G -.93<5441>-.71 G +363.44<2831292056>.93 F<4f44>-.4 E -1.21 -1.11<41542041>-.4 H<283129> +1.11 E<7265736f6c76>148 84 Q<65642c20616e642074686174206f626a6563742077 +696c6c20626520736b69707065642e>-.15 E/F1 10/Times-Italic@0 SF<3c72>108 +100.8 Q<613e203c6465633e>-.15 E F0 .347<546865204a323030302065717561746f +7269616c20524120616e642044656320706f736974696f6e20746f207468652073656172 +636865642e>148 112.8 R -1.11<5661>5.347 G .346<6c756573206769>1.11 F +-.15<7665>-.25 G 2.846<6e61>.15 G 2.846<738d>-2.846 G .346 +<6f6174696e6720706f696e742076>-2.846 F<616c756573>-.25 E .724 +<61726520617373756d656420746f20626520696e20646563696d616c206465>148 +124.8 R .724<67726565732c207365>-.15 F .724<7861676573696d616c2076>-.15 +F .725<616c7565732061726520617373756d656420746f2062652065717561746f7269 +616c2052412f446563>-.25 F 2.557<706f736974696f6e732e205365>148 136.8 R +.057<7861676573696d616c2076>-.15 F .057 +<616c756573206d6179206265206f662074686520666f726d>-.25 F F1 +<68683a6d6d3a73732e73>2.556 E F0<6f72>2.556 E F1<68683a6d6d2e6d>2.556 E +F0 .056<666f722052412c206f72>2.556 F F1<64643a6d6d3a73732e73>2.556 E F0 +<6f72>148 148.8 Q F1<64643a6d6d2e6d>2.5 E F0<666f72204465632e>2.5 E<4f6e +6c79206f6e6520636f6f7264696e6174652070616972206d61792062652073706563698c +6564206f6e2074686520636f6d6d616e646c696e652e>5 E F1<3c73723e>108 165.6 Q +F0 .73<546865207365617263682073697a6520666f7220746865206461746120717565 +72792073706563698c656420696e20646563696d616c206465>18.72 F 3.23 +<67726565732e20546865>-.15 F<646566>3.23 E .73 +<61756c742073697a65206f6620302e31206465>-.1 F<6772656573>-.15 E .741<77 +696c6c20626520757365642069662074686973206973206e6f742073706563698c656420 +6f6e2074686520636f6d6d616e64206c696e652e>148 177.6 R<546865>5.74 E F1 +<2d72>3.24 E<73>-.1 E F0<616e64>3.24 E F1<2d726d>3.24 E F0 .74 +<6f7074696f6e73206d61792062652075736564>3.24 F 1.028<737065636966792074 +68652073697a6520696e20617263207365636f6e647320616e64206d696e757465732072 +65737065637469>148 189.6 R -.15<7665>-.25 G<6c79>.15 E 6.028<2e54>-.65 G +<6865>-6.028 E F1<2d69>3.528 E F0 1.028 +<6f7074696f6e206d6179206265207573656420746f2073706563696679>3.528 F +1.998<636f6d6d616e642d6c696e6520696e707574206f7074696f6e732c207768657265 +206561636820636f6d6d616e642d6c696e652063616e20696e636c756465206120646966> +148 201.6 R 1.997<666572656e742076>-.25 F 1.997 +<616c756520666f7220746865>-.25 F +<7365617263682073697a652c206f7468657277697365206f6e6c79206f6e652076>148 +213.6 Q<616c756520697320616c6c6f>-.25 E<7765642e>-.25 E F1<3c75726c3e> +108 230.4 Q F0 2.5<4173>14.83 G<696e676c652055524c2c206f7220746865206e61 +6d65206f662061208c6c6520636f6e7461696e696e672055524c73206c6973746564206f +6e6520706572206c696e652e>-2.5 E/F2 10/Times-Bold@0 SF +<4d756c74692d546872>87 271.2 Q<65616420616e64204d756c74692d5072>-.18 E +<6f636573732044617461205175657279696e67>-.18 E F0 .466<416c6c2064617461 +20717565726965732072657175697265206174206c65617374206f6e65>108 283.2 R +F1 -.37<7265>2.967 G<736f7572>.37 E<6365>-.37 E F0 .467<616e64206f6e65> +2.967 F F1<736f7572>2.967 E<6365>-.37 E F0 .467 +<746f206265207375636365737366756c2e>2.967 F<546865>5.467 E F1 -.37<7265> +2.967 G<736f7572>.37 E<6365>-.37 E F0 .467<64658c6e65732061207370652d> +2.967 F .845<63698c632064617461207365727669636520746f206265207175657269 +65642c20616e6420746865>108 295.2 R F1<736f7572>3.345 E<6365>-.37 E F0 +.845<69732065697468657220616e2065>3.345 F .845 +<78706c6963697420706f736974696f6e206f6e2074686520736b>-.15 F 3.344<796f> +-.15 G 3.344<7274>-3.344 G .844<6865206e616d65206f6620616e>-3.344 F +1.552<6f626a65637420746861742063616e206265207265736f6c76>108 307.2 R +1.552<656420746f206120706f736974696f6e2e>-.15 F 1.553<4164646974696f6e61 +6c20706172616d657465727320746f207468652071756572792061726520757365642074 +6f2073706563696679206f74686572>6.552 F .997<6f7074696f6e732c2062>108 +319.2 R .996<757420696e20657373656e636520656163682064617461207175657279 +206973207472616e736c6174656420746f20612073696e676c652055524c207468617420 +6d7573742062652061636365737365642062792074686520636c69656e74>-.2 F 3.399 +<7461736b2e20496e>108 331.2 R 3.399<6163>3.399 G<6f6d706c65>-3.399 E +3.399<7871>-.15 G<75657279>-3.399 E 3.399<2c6c>-.65 G .899<69737473206f +66207265736f7572636520616e642f6f72206f626a656374732063726561746520612070 +6f74656e7469616c6c79206c6172>-3.399 F .9 +<6765206d6174726978206f6620717565726965732074686174>-.18 F .455 +<6d757374206265206d6164652028692e652e>108 343.2 R F1 +<4e2d7365727669636573>5.455 E F0<6279>2.955 E F1<4e2d6f626a65637473> +2.955 E F0 .455<696e20746f74616c292e>2.955 F .454 +<426563617573652061206c6172>5.454 F .454 +<6765206672616374696f6e206f66207468652074696d65207370656e7420696e2077> +-.18 F<616974696e67>-.1 E .629 +<666f72206120717565727920746f208c6e69736820697320696e2077>108 355.2 R +.629<616974696e6720666f72207468652073657276>-.1 F .63<657220746f20726573 +706f6e642c207765206172652061626c6520746f2072756e206d756c7469706c65207175 +65726965732073696d756c74616e652d>-.15 F +<6f75736c7920776974686f75742073617475726174696e67206f7572206e657477>108 +367.2 Q<6f726b2062616e64776964746820696e206d6f73742063617365732e>-.1 E +<546865>108 384 Q F2 -.1<766f>3.255 G<64617461>.1 E F0 .754<7461736b2077 +696c6c20706172616c6c656c697a6520746865206c697374206f66207365727669636573 +20746f20626520717565726965642062792072756e6e696e672061207365706172617465 +2070726f63657373696e67>3.255 F F1<746872>3.254 E<656164>-.37 E F0 1.151< +28692e652e2061206c696768747765696768742070726f636573732072756e6e696e6720 +696e20706172616c6c656c2077697468696e20746865206d61696e206170706c69636174 +696f6e2920666f722065616368206f662074686520736572766963657320746f206265> +108 396 R 2.553<63616c6c65642e2054686973>108 408 R<616c6c6f>2.553 E .053 +<7773207175657269657320746f20646966>-.25 F .053<666572656e742073657276> +-.25 F .053<65727320746f2062652072756e20696e20706172616c6c656c2c20616e64 +2073696e63652074686573652073657276>-.15 F .052 +<6572732077696c6c206f6674656e20726573696465>-.15 F 1.695 +<6f6e206d756c7469706c65206d616368696e65732074686520636c69656e742077>108 +420 R<6f6e27>-.1 E 4.195<7469>-.18 G 1.695<6d7061637420616e>-4.195 F +4.195<796f>-.15 G 1.695<6e6520646174612070726f>-4.195 F 1.695 +<766964657220746f6f206261646c79>-.15 F 6.696<2e49>-.65 G 4.196<6e61> +-6.696 G 1.696<64646974696f6e2c20746865206c697374206f66>-4.196 F .569<6f +626a6563747320746f206265207175657269656420617420656163682073657276696365 +2077696c6c2062652062726f6b>108 432 R .569<656e20757020696e746f206d756c74 +69706c65206368696c642070726f63657373657320616e642063616c6c65642073696d75 +6c74616e652d>-.1 F<6f75736c79>108 444 Q 5.358<2e54>-.65 G .358 +<68697320616c6c6f>-5.358 F .358<77732c20666f722065>-.25 F .358<78616d70 +6c652c203130206f626a6563747320746f20626520717565726965642066726f6d203320 +736572766963657320286120746f74616c206f662033302071756572696573292073696d +756c74616e652d>-.15 F<6f75736c79>108 456 Q<2e>-.65 E<546865>108 472.8 Q +F1<2d2d6d6178746872>2.516 E<656164733d3c4e3e6d74>-.37 E F0 .015<6f707469 +6f6e2063616e206265207573656420746f2073657420746865206d6178206e756d626572 +206f66207468726561647320746f206265206372656174656420666f722070726f636573 +73696e67>2.516 F .81 +<746865207265736f75726365206c697374202874686520646566>108 484.8 R .81 +<61756c74206973203230292e>-.1 F .81 +<496620746865207265736f75726365206c697374206973206c6172>5.81 F .811 +<676572207468616e20746869732076>-.18 F .811 +<616c75652c20746865206c6973742077696c6c2062652070726f636573736564>-.25 F +.883<77697468206e6f206d6f7265207468616e20746865206d6178206e756d62657220 +72756e6e696e6720617420616e>108 496.8 R 3.383<796f>-.15 G .883 +<6e652074696d6520756e74696c20616c6c207265736f7572636573206861>-3.383 F +1.182 -.15<76652062>-.2 H .882<65656e20717565726965642e>.15 F +<53696d692d>5.882 E<6c61726c79>108 508.8 Q 2.678<2c74>-.65 G<6865>-2.678 +E F1<2d2d6d61787072>2.678 E<6f63733d3c4e3e>-.45 E F0 .178<6f7074696f6e20 +63616e206265207573656420746f2073657420746865206e756d626572206f6620636869 +6c642070726f63657373657320746f206265206372656174656420746f2070726f636573 +73>2.678 F .287<746865206f626a656374206c697374202874686520646566>108 +520.8 R .287<61756c74206973203130292e>-.1 F .286 +<5768656e2073657474696e672074686573652076>5.286 F .286<616c756573206974 +20697320696d706f7274616e7420746f2072656d656d6265722074686174207468652074 +6f74616c206e756d2d>-.25 F .302<626572206f66>108 532.8 R F1 +<706f74656e7469616c>2.802 E F0 .303<70726f6365737365732072756e6e696e6720 +6f6e20796f7572206d616368696e652077696c6c206265207468652070726f6475637420 +6f6620746865736520746f2076>2.802 F 2.803<616c7565732e20546865>-.25 F +<646566>2.803 E .303<61756c742076>-.1 F<616c2d>-.25 E +<756573207765726520656d7069726963616c6c7920666f756e6420746f2077>108 +544.8 Q<6f726b20726561736f6e61626c792077656c6c206f6e206d6f7374206d6f6465 +726e206d616368696e65732e>-.1 E<4164646974696f6e616c6c79>108 561.6 Q +2.876<2c69>-.65 G 2.876<7469>-2.876 G 2.876<7377>-2.876 G .376<6f727468 +20636f6e7369646572696e672074686520706f74656e7469616c2073747261696e207468 +61742063616e20626520707574206f6e20646174612070726f>-2.976 F .375 +<76696465727327206d616368696e6573206265666f7265>-.15 F 1.375 +<6368616e67696e672074686573652073657474696e67732e>108 573.6 R 1.375 +<546865206c6172>6.375 F 1.376 +<6765206d616a6f72697479206f6620436f6e6520736572766963657320666f722065> +-.18 F 1.376 +<78616d706c6520636f6d652066726f6d20612073696e676c652073657276>-.15 F +1.376<6572206174>-.15 F 1.46<4845415341524320616e64206f>108 585.6 R -.15 +<7665>-.15 G 1.46<726c6f6164696e67207468652073657276>.15 F 1.459<657220 +776974682068756e6472656473206f6620726571756573747320746f206d756c7469706c +65207265736f75726365732069742070726f>-.15 F 1.459<7669646573206d6179> +-.15 F .677<726573756c7420696e20612066>108 597.6 R .677 +<61696c6564207265717565737420616e6420776861742077>-.1 F .677 +<6f756c642061707065617220746f206265206e6f20646174612e>-.1 F .677 +<4f6e652073686f756c6420636f6e7369646572207573696e6720746865>5.677 F F1 +<2d69>3.177 E F0 .678<8d61672061732061>3.178 F .406 +<6d65616e7320746f2071756572792061206c6172>108 609.6 R .406 +<6765206f626a656374206c697374206167>-.18 F .405<61696e73742061207265736f +75726365206c69737420737563682074686174206f6e6c7920746865206f626a65637420 +70726f63657373696e6720697320706172616c6c656c697a6564>-.05 F +<616e64207468652073657276>108 621.6 Q +<6572206c6f6164206973206d696e696d697a65642028536565207468652065>-.15 E +<78616d706c652062656c6f>-.15 E<77292e>-.25 E F2 +<4f75747075742046696c656e616d652047656e65726174696f6e>87 662.4 Q F0 +<546865>108 674.4 Q F1<2d4f>3.564 E F0 1.064<6f7074696f6e206d6179206265 +207573656420746f20737065636966792074686520726f6f742070617274206f66206f75 +74707574208c6c6573206372656174656420627920612064617461207175657279>3.564 +F 6.064<2e48>-.65 G -.25<6f77>-6.064 G -2.15 -.25<65762065>.25 H 1.864 +-.4<722c2074>.25 H<6f>.4 E .222<67756172616e74656520746861742061206d756c +74692d736572766963652c20616e642f6f72206d756c74692d6f626a6563742071756572 +7920646f65736e27>108 686.4 R 2.721<746f>-.18 G -.15<7665>-2.871 G .221< +72777269746520612073696e676c65206f7574707574208c6c652c20746865208c6c656e +616d65>.15 F .472<726f6f742077696c6c20616c736f20696e636c75646520746865> +108 698.4 R F1<706964>2.972 E F0 .472<2870726f6365737320494429206f662074 +6865207461736b207468617420637265617465642069742e>2.972 F -.15<466f>5.473 +G 2.973<726173>.15 G .473 +<696e676c65207365727669636520616e64206f626a656374207175657279>-2.973 F +<6e6f>108 710.4 Q F1<706964>3.092 E F0 .591<77696c6c20626520757365642061 +732070617274206f6620746865208c6c656e616d652e>3.092 F .591<54686973207363 +68656d652067756172616e7465657320756e69717565206f7574707574208c6c65732061 +63726f7373207468652076>5.591 F<6172696f7573>-.25 E<70726f63657373696e67 +207363656e6172696f732c20776974682073696d696c617220726f6f74206e616d657320 +666f72206d756c7469706c65208c6c6573206173736f6369617465642077697468206120 +73706563698c63207175657279>108 722.4 Q<2e>-.65 E<4e56>72 768 Q 2.5<4f56> +-.4 G<4f2d434c492050726f6a656374>-2.9 E<4a756c792032303037>126.345 E<37> +209.415 E 0 Cg EP +%%Page: 8 8 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S -.4<4441>.4 G -.93<5441>-.71 G +363.44<2831292056>.93 F<4f44>-.4 E -1.21 -1.11<41542041>-.4 H<283129> +1.11 E .351<4f7574707574207461626c6573206d617920626520637265617465642069 +6e2061206e756d626572206f6620666f726d61747320616e642077696c6c206c696b>108 +84 R -.25<6577>-.1 G .351<697365206861>.25 F .651 -.15<7665206578>-.2 H +.352<74656e73696f6e7320696e6469636174696e6720746865207461626c65>.15 F +3.516<747970652e20546865>108 96 R/F1 10/Times-Italic@0 SF<2d65>3.516 E +F0<2f>A F1<2d2d65>A<787472>-.2 E<616374>-.15 E F0 1.016<6f7074696f6e206d +617920637265617465206164646974696f6e616c208c6c657320666f7220656163682071 +75657279>3.516 F 3.515<2c61>-.65 G 1.015<6e6420746865>-3.515 F F1<2d67> +3.515 E F0<2f>A F1<2d2d67>A<6574>-.1 E F0 1.015 +<6f7074696f6e20746f20616363657373>3.515 F<646174612077696c6c2073696d696c +61726c7920637265617465206164646974696f6e616c208c6c65732e>108 108 Q<5468 +6520737472756374757265206f6620616e206f7574707574208c6c656e616d652069733a> +5 E F1<3c72>180 144 Q<6f6f743e5b5f3c7069643e5d2e3c65>-.45 E<78746e3e>-.2 +E F0 .72<546865206d65616e696e67206f66>108 168 R F1<3c7069643e>3.22 E F0 +<616e64>3.22 E F1<3c65>3.22 E<78746e3e>-.2 E F0<6861>3.22 E 1.02 -.15 +<76652062>-.2 H .72<65656e206469736375737365642061626f>.15 F -.15<7665> +-.15 G 5.721<2e49>.15 G 3.221<6674>-5.721 G<6865>-3.221 E F1<2d4f>3.221 +E F0 .721<6f7074696f6e2077>3.221 F .721<617320736574207468656e20746865> +-.1 F F1<3c72>3.221 E<6f6f743e>-.45 E F0 .795<70617274206f6620746865206e +616d652077696c6c2073696d706c7920626520746865206172>108 180 R .794 +<67756d656e74206769>-.18 F -.15<7665>-.25 G 3.294<6e74>.15 G 3.294<6f73> +-3.294 G .794<65742074686520726f6f74206e616d652e>-3.294 F .794 +<4f74686572776973652c20746865>5.794 F F1<3c72>3.294 E<6f6f743e>-.45 E F0 +<656c656d656e74>3.294 E<77696c6c206265206f662074686520666f726d3a>108 192 +Q F1<3c7376633e5f3c747970653e5f3c6f626a6e616d653e>180 216 Q +<3c7376633e5f3c747970653e5f3c696e6465>180 228 Q<783e>-.2 E F0<546865>108 +252 Q F1<3c7376633e>2.574 E F0 .074<69732064657269>2.574 F -.15<7665> +-.25 G 2.574<6466>.15 G .074 +<726f6d207468652073657276696365206e616d6520757365642c20746865>-2.574 F +F1<3c747970653e>2.574 E F0 .075<697320612073696e676c652d6368617261637465 +7220636f646520746f20696e646963617465207468652074797065>2.575 F<6f662073 +6572766963652075736564202827492720666f7220696d6167652c206f626a656374206e +616d65206f722074686520696e6465>108 264 Q 2.5<7869>-.15 G 2.5<6e616c>-2.5 +G<697374206f6620706f736974696f6e73206f66206e6f206f626a6563742077>-2.5 E +<61732073706563698c65642e>-.1 E/F2 10/Times-Bold@0 SF -1<5665>87 292.8 S +<72626f73697479>1 E F0<546865>108 304.8 Q F1<2d76>2.52 E F0<616e64>2.52 +E F1<2d7676>2.52 E F0 .02<6f7074696f6e732073657276>2.52 F 2.52<656164> +-.15 G .02 +<75616c20707572706f73653a2077697468696e20746865207461736b20746865>-2.52 +F 2.519<7973>-.15 G .019<657420746865206c65>-2.519 F -.15<7665>-.25 G +2.519<6c6f>.15 G 2.519<666f>-2.519 G .019<75747075742076>-2.519 F .019 +<6572626f7369747920696e207465726d73206f66>-.15 F 2.093 +<77686174206973207265706f7274656420647572696e672070726f63657373696e67> +108 316.8 R<2853696d696c61726c79>7.094 E 4.594<2c74>-.65 G<6865>-4.594 E +F1<2d71>4.594 E F0 2.094 +<6f7074696f6e2063616e206265207573656420746f207475726e206f66>4.594 F +4.594<666f>-.25 G 2.094<7574707574207265706f7274696e67>-4.594 F 3.606 +<656e746972656c79292e205468657365>108 328.8 R 1.106 +<8d6167732077696c6c20686f>3.606 F<7765>-.25 E -.15<7665>-.25 G 3.606 +<7261>.15 G 1.106<6c736f20696e637265617365207468652076>-3.606 F 1.106 +<616c7565206f6620746865>-.25 F F2<564552424f5345>3.606 E F0 1.106 +<706172616d657465722073656e7420746f207365727669636573>3.606 F .799 +<647572696e6720612064617461207175657279>108 340.8 R 5.799<2e54>-.65 G +.799<686520646566>-5.799 F .799<61756c742076>-.1 F .799<616c756520697320 +6174206c6561737420312c2077697468207468652068696768657374206c65>-.25 F +-.15<7665>-.25 G 3.3<6c62>.15 G .8<65696e6720332e>-3.3 F .8 +<5573696e6720746865>5.8 F F1<2d76>3.3 E F0 .8<8d61672073657473>3.3 F F2 +<564552424f53453d32>108 352.8 Q F0<616e64>2.5 E F1<2d7676>2.5 E F0 +<73657473>2.5 E F2<564552424f53453d33>2.5 E F0<2e>A .226 +<54686520564552424f5345206c65>108 369.6 R -.15<7665>-.25 G 2.726<6c63> +.15 G .226<616e20626520696d706f7274616e7420696e20616363657373696e672072 +6573756c7420636f6c756d6e732074686174206d6179206f6e6c79206265207265747572 +6e6564206174207468652068696768657374>-2.726 F<6c65>108 381.6 Q -.15 +<7665>-.25 G 2.736<6c2e205768656e>.15 F .236<7573696e6720746865>2.736 F +F1<2d6d>2.736 E F0<286f72>2.736 E F1<2d2d6d657461>2.736 E F0 2.737<298d> +C .237<616720746f207072696e742074686520636f6c756d6e206d657461646174612c +207468652076>-2.737 F .237 +<6572626f7365206f7074696f6e732077696c6c20616c736f206166>-.15 F<66656374> +-.25 E<74686520726573756c747320616e6420697420697320696d706f7274616e7420 +74686174207468652073616d652076>108 393.6 Q<6572626f73697479206265207365 +74207768656e20646f696e67207468652061637475616c20646174612071756572792061 +6e64206163636573732e>-.15 E F2<42616e647061737320616e6420536572>87 422.4 +Q<766963652054>-.1 E<79706520416c6961736573>-.74 E F0 +<546865207479706520636f6e73747261696e742028>108 434.4 Q F1<2d74>A F0 +<6f72>2.5 E F1<2d2d74797065>2.5 E F0 2.5<2961>C +<636365707473206f6e6c792074686520666f6c6c6f>-2.5 E<77696e67206172>-.25 E +<67756d656e74733a>-.18 E 66.62<636174616c6f6720436f6e65>118 458.4 R +<736561726368207365727669636573>2.5 E 71.06<696d6167652053696d706c65>118 +470.4 R<496d61676520416363657373207365727669636573>2.5 E 67.18 +<737065637472612053696d706c65>118 482.4 R +<537065637472616c20416363657373207365727669636573>2.5 E 76.06 +<7461626c652056>118 494.4 R<697a696572207365727669636573>-.6 E 60.89 +<3c6c69746572616c3e205265736f7572636554>118 506.4 R +<7970652066726f6d204469726563746f7279207265636f7264>-.8 E +<5468652062616e647061737320636f6e73747261696e742028>108 535.2 Q F1<2d62> +A F0<6f72>2.5 E F1<2d2d62616e6470617373>2.5 E F0 2.5<2961>C +<636365707473206f6e6c792074686520666f6c6c6f>-2.5 E<77696e67206172>-.25 E +<67756d656e74733a>-.18 E 71.61<526164696f204d696c6c696d65746572>118 +559.2 R<496e6672617265642028495229>65.22 E 66.06 +<4f70746963616c20556c747261>118 571.2 R<76696f6c65742028555629>-.2 E +<582d52617920287872617929>41.27 E<47616d6d612d5261792028475229>118 583.2 +Q -1.11<5661>108 607.2 S<6c75657320696e20706172656e74686573652061726520 +61636365707461626c6520616c69617365732e>1.11 E +<416c6c206d6174636865732061726520636173657320696e73656e73697469>5 E -.15 +<7665>-.25 G<2e>.15 E F2<52616e67652d4c6973742050>87 648 Q +<6172616d6574657273>-.1 E F0 .036 +<536f6d6520706172616d65746572732028666f722065>108 660 R .036 +<78616d706c652042>-.15 F .036 +<414e4420616e642054494d4529206d617920616c6c6f>-.35 F 2.536<776170>-.25 G +.036<6172616d657465722076>-2.536 F .036 +<616c756520746f2062652073706563698c65642061732061206e756d65726963>-.25 F +.515<72616e67652e20537563682072616e67652d76>108 672 R .515 +<616c75656420706172616d6574657273207573652074686520666f7277>-.25 F .516 +<61726420736c6173682028>-.1 F F1<2f>A F0 3.016<2963>C .516<686172616374 +65722061732074686520736570617261746f72206265747765656e20656c656d656e7473> +-3.016 F .806<6f66207468652072616e67652073706563698c636174696f6e20286173 +20696e207468652049534f203836303120646174652073706563698c636174696f6e2061 +66746572207768696368207468697320636f6e>108 684 R -.15<7665>-.4 G .806 +<6e74696f6e206973207061747465726e6564292e>.15 F -.15<466f>108 696 S +3.402<7265>.15 G<78616d706c652c>-3.552 E F1<35452d372f38452d37>3.402 E +F0 -.1<776f>3.402 G .902<756c64207370656369667920612072616e676520636f6e +73697374696e67206f6620616c6c2076>.1 F .903 +<616c7565732066726f6d2035452d3720746f2038452d372c20696e636c757369>-.25 F +-.15<7665>-.25 G 3.403<2e49>.15 G 3.403<6661>-3.403 G .636<746869726420 +8c656c642069732073706563698c6564206974206973206120737465702073697a652066 +6f7220747261>108 708 R -.15<7665>-.2 G .635<7273696e672074686520696e6469 +63617465642072616e67652e204966206120706172616d65746572207065726d69747320 +6120737465702073697a65>.15 F<7468652073656d616e74696373206f662074686520 +737465702073697a65206172652064658c6e6564206279207468652073706563698c6320 +706172616d65746572>108 720 Q<2e>-.55 E<4e56>72 768 Q 2.5<4f56>-.4 G +<4f2d434c492050726f6a656374>-2.9 E<4a756c792032303037>126.345 E<38> +209.415 E 0 Cg EP +%%Page: 9 9 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S -.4<4441>.4 G -.93<5441>-.71 G +363.44<2831292056>.93 F<4f44>-.4 E -1.21 -1.11<41542041>-.4 H<283129> +1.11 E 1.129<416e206f70656e2072616e6765206d61792062652073706563698c6564 +206279206f6d697474696e67206569746865722072616e67652076>108 84 R 1.129 +<616c75652e20496620746865208c7273742076>-.25 F 1.129 +<616c7565206973206f6d6974746564207468652072616e6765206973>-.25 F .565 +<6f70656e20746f>108 96 R -.1<7761>-.25 G .565<7264206c6f>.1 F .565 +<7765722076>-.25 F .565<616c7565732e20496620746865207365636f6e642076> +-.25 F .565<616c7565206973206f6d6974746564207468652072616e6765206973206f +70656e20746f>-.25 F -.1<7761>-.25 G .564<7264206869676865722076>.1 F +.564<616c7565732e204f6d697474696e67>-.25 F 1.132<626f74682076>108 108 R +1.133<616c75657320696e6469636174657320616e20696e8c6e6974652072616e676520 +7768696368206163636570747320616c6c2076>-.25 F 1.133<616c7565732e2046> +-.25 F 1.133<6f722065>-.15 F<78616d706c652c>-.15 E/F1 10/Times-Italic@0 +SF<2f35>3.633 E F0 1.133<697320616e206f70656e2072616e6765207768696368> +3.633 F .367<6163636570747320616c6c2076>108 120 R .367 +<616c756573206c657373207468616e206f7220657175616c20746f20352e2054>-.25 F +2.867<6f73>-.8 G .367<70656369667920616c6c2076>-2.867 F .367 +<616c756573206c657373207468616e20352c>-.25 F F1<2f34>2.867 E F0 -.1 +<776f>2.867 G .366<756c6420626520757365642028666f7220616e20696e7465>.1 F +<676572>-.15 E -.25<7661>108 132 S +<6c7565642072616e6765292e2052616e67652076>.25 E +<616c75657320617265206c696d6974656420746f206e756d657269632076>-.25 E +<616c756573206f722049534f2064617465732e>-.25 E 2.555<416c>108 148.8 S +.056<697374206d6179206265207175616c698c656420627920617070656e64696e6720 +74686520636861726163746572>-2.555 F F1<3b>2.556 E F0 .056 +<2873656d69636f6c6f6e2920666f6c6c6f>2.556 F .056 +<7765642062792061207175616c698c657220737472696e672e2046>-.25 F .056 +<6f722065>-.15 F<78616d706c65>-.15 E F1<31452d372f33452d363b736f7572>108 +160.8 Q<6365>-.37 E F0 .606<636f756c642073706563696679206120737065637472 +616c2062616e647061737320696e207468652072657374206672616d65206f6620746865 +20736f757263652e>3.106 F .605 +<4c69737420616e642072616e67652073796e746178>5.605 F .53<6d61792062652063 +6f6d62696e65642c20652e672e2c20746f20696e6469636174652061206c697374206f66 +207363616c6172206f722072616e67652d76>108 172.8 R .53 +<616c75656420706172616d657465722076>-.25 F .53 +<616c7565732e205375636820612072616e6765206c697374206d6179>-.25 F 1.806< +6265206f726465726564206f7220756e6f7264657265642c20616e64206d617920636f6e +7461696e20656974686572206e756d65726963206f7220737472696e6720646174612e20 +416e206f726465726564206c697374206973206f6e65207768696368>108 184.8 R +.373<72657175697265732076>108 196.8 R .373<616c75657320746f206265207072 +6f63657373656420696e20612073706563698c6564206f72646572>-.25 F 2.873 +<2c61>-.4 G .373<6e6420746f20656e737572652074686973207468652072616e6765 +206c69737420697320736f72746564206f72206f726465726564206279>-2.873 F .008 +<7468652073657276696365206173206e6563657373617279206265666f726520626569 +6e6720757365642e2049742069732074686520726573706f6e736962696c697479206f66 +20746865207365727669636520746f20736f727420616e206f7264657265642072616e67 +65206c6973742c>108 208.8 R .106<68656e63652074686520636c69656e742063616e +20696e7075742072616e676573206f722072616e67652076>108 220.8 R .106 +<616c75657320696e20616e>-.25 F 2.606<796f>-.15 G .106<7264657220666f7220 +616e206f7264657265642072616e6765206c69737420616e642074686520726573756c74 +2077696c6c206265>-2.606 F .474<7468652073616d652e205468652073657175656e +636520696e207768696368206974656d7320696e20616e20756e6f726465726564206c69 +7374206f63637572206f6e20746865206f746865722068616e64206973207369676e698c +63616e742c2061732073696e6365>108 232.8 R .694<7468657265206973206e6f2069 +6e7472696e736963206f72646572696e6720666f7220746865206c697374207768696368 +2063616e20626520656e666f726365642062792074686520736572766963652c20697465 +6d732077696c6c2062652070726f636573736564206279>108 244.8 R +<746865207365727669636520696e20746865206f7264657220746865>108 256.8 Q +2.5<7961>-.15 G<726520696e7075742062792074686520636c69656e742e>-2.5 E +.654<54494d4520616e642042>108 273.6 R .654 +<414e4420617265207479706963616c2065>-.35 F .653<78616d706c6573206f66206f +7264657265642072616e6765206c697374732e2053696e63652061206461746173657420 +6d6174636865732074686520717565727920696620697420636f6e2d>-.15 F .548 +<7461696e73206461746120696e20616e>108 285.6 R 3.048<796f>-.15 G 3.048 +<6674>-3.048 G .548<68652073706563698c65642072616e6765732c206c6f67696361 +6c6c7920697420646f6573206e6f74206d617474657220696e2077686174206f72646572 +207468652072616e67657320617265206769>-3.048 F -.15<7665>-.25 G .548 +<6e2c206f72>.15 F .36<7768657468657220746865208c72737420656c656d656e7420 +6f6620612072616e6765206973206c657373207468616e20746865207365636f6e642c20 +6f7220776865746865722072616e676573206f>108 297.6 R -.15<7665>-.15 G .359 +<726c61703b2074686520726573756c742073686f756c64206265>.15 F 1.017<746865 +2073616d6520696e20616c6c2063617365732e2048656e6365207468652072616e676520 +6c6973742068617320616e20696e7472696e736963206f72646572696e67206972726573 +7065637469>108 309.6 R 1.317 -.15<7665206f>-.25 H 3.517<6668>.15 G 1.517 +-.25<6f772072>-3.517 H 1.017<616e6765732061726520696e7075742e>.25 F<556e +6c657373206f74686572776973652073706563698c656420696e207468652064658c6e69 +74696f6e206f662061206769>108 321.6 Q -.15<7665>-.25 G 2.5<6e70>.15 G +<6172616d65746572>-2.5 E 2.5<2c72>-.4 G<616e6765206c69737473206172652061 +7373756d656420746f206265206f7264657265642e>-2.5 E/F2 10.95/Times-Bold@0 +SF -.493<564f>72 374.4 S<434c49454e542044>.493 E<41454d4f4e205052>-.383 +E<4f43455353494e47>-.329 E F0 .605<416c6c2056>108 386.4 R .605 +<4f2d434c49207461736b73206172652062>-.4 F .605 +<75696c742075706f6e207468652056>-.2 F .605<4f436c69656e7420696e74657266> +-.4 F .605<61636520616e2072656c79206f6e2061207365706172617465>-.1 F F1 +<766f636c69656e7464>3.104 E F0 .604<70726f6365737320746f2070726f>3.104 F +<76696465>-.15 E .382<7468652056>108 398.4 R 2.882<4f66>-.4 G +<756e6374696f6e616c697479>-2.882 E 5.382<2e54>-.65 G .382<68652076> +-5.382 F .382<6f636c69656e7464207461736b2069732064697374726962>-.2 F +.383<757465642061732070617274206f662056>-.2 F .383<4f2d434c4920616e6420 +77696c6c2062652073746172746564206175746f6d61746963616c6c79>-.4 F .524<62 +792065616368207461736b206966206974206973206e6f7420616c72656164792072756e +6e696e672e>108 410.4 R .524<49662070726f626c656d732061726520656e636f756e +74657265642c20796f75206d61792077>5.524 F .523 +<616e7420746f206d616e75616c6c7920737461727420746865>-.1 F -.2<766f>108 +422.4 S<636c69656e746420696e20612073657061726174652077696e646f>.2 E 2.5 +<7762>-.25 G<65666f72652072756e6e696e6720746865207461736b20736f20796f75 +2063616e206d6f6e69746f7220746865206f757470757420666f72206572726f72206d65 +7373616765732e>-2.5 E F2<5245534f55524345204341>72 451.2 Q<4348494e47> +-.602 E F0 3.363<4469726563746f7279207265736f6c7574696f6e20697320612063 +6f6d6d6f6e2061637469>108 463.2 R 3.363<76697479206f662056>-.25 F 3.363< +4f2d434c49207461736b7320616e6420736f20726573756c74732077696c6c2062652063 +616368656420696e20746865>-.4 F<24484f4d452f2e76>108 475.2 Q +<6f636c69656e742f63616368652f7265>-.2 E<675265736f6c76>-.15 E .364<6572 +206469726563746f7279206261736564206f6e2074686520736561726368207465726d2c +2073657276696365207479706520616e642062616e647061737320706172616d2d>-.15 +F 2.5<65746572732e2044658c6e696e67>108 487.2 R<746865>2.5 E F1 -.3<564f> +2.5 G<435f4e4f5f4341>.3 E<434845>-.3 E F0<656e>2.5 E +<7669726f6e6d656e742076>-.4 E<61726961626c652077696c6c206361757365207468 +65207461736b20746f2069676e6f7265207468652063616368652e>-.25 E F2 +<4558414d504c4553>72 516 Q F0 9.17<3129205175657279>108 528 R .176<7468 +652047534320322e3320636174616c6f6720666f72207374617273206129207769746869 +6e2074686520302e31206465>2.676 F .176<6772656520646566>-.15 F .176 +<61756c74207365617263682073697a652061726f756e64204e474320313233343a>-.1 +F<6229>5.177 E .12<61726f756e6420616c6c20706f736974696f6e7320636f6e7461 +696e656420696e208c6c652027706f732e747874273a>128 540 R .119 +<632920666f7220746865206c697374206f66206f626a65637473206769>5.12 F -.15 +<7665>-.25 G 2.619<6e6f>.15 G 2.619<6e74>-2.619 G .119 +<686520636f6d6d616e64206c696e653a>-2.619 F<6429>5.119 E .433<7175657279 +2061206c697374206f6620736572766963657320666f722061206c697374206f6620706f +736974696f6e733a206529207072696e74206120636f756e74206f6620726573756c7473 +20746861742077>128 552 R .434 +<6f756c642062652072657475726e65642066726f6d2033>-.1 F<736572766963657320 +666f72206561636820706f736974696f6e20696e2061208c6c653a>128 564 Q 2.5 +<2576>164 588 S<6f6461746120677363322e33206e676331323334>-2.7 E<286129> +77.44 E 2.5<2576>164 600 S<6f6461746120677363322e3320706f732e747874>-2.7 +E<286229>84.93 E 2.5<2576>164 612 S +<6f6461746120677363322e33206d33312c6d35312c6d3933>-2.7 E<286329>53.54 E +2.5<2576>164 624 S<6f6461746120737663732e74787420706f732e747874>-2.7 E +<286429>80.48 E 2.5<2576>164 636 S +<6f64617461206873742c6368616e6472612c677363322e3320706f732e747874>-2.7 E +<286529>36.61 E 9.17<3229205175657279>108 676.8 R .614 +<616c6c20283134322920696d616765207365727669636573206861>3.114 F .613 +<76696e672064617461206f6620746865207375626477>-.2 F .613<6172662067>-.1 +F .613<616c6178792049432031302c207072696e74206120636f756e74206f66207468 +6520726573756c7473>-.05 F<6f6e6c793a>128 688.8 Q 2.5<2576>164 712.8 S +<6f64617461202d63202d7420696d61676520616e>-2.7 E 2.5<7949>-.15 G<433130> +-2.5 E 2.5<2576>164 724.8 S +<6f64617461202d2d636f756e74202d2d747970653d696d61676520616e>-2.7 E 2.5 +<7949>-.15 G<433130>-2.5 E<4e56>72 768 Q 2.5<4f56>-.4 G +<4f2d434c492050726f6a656374>-2.9 E<4a756c792032303037>126.345 E<39> +209.415 E 0 Cg EP +%%Page: 10 10 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S -.4<4441>.4 G -.93<5441>-.71 G +363.44<2831292056>.93 F<4f44>-.4 E -1.21 -1.11<41542041>-.4 H<283129> +1.11 E .377<4e6f74652074686174207765207573652074686520726573657276>128 +84 R .378<65642077>-.15 F .378<6f72642027>-.1 F/F1 10/Times-Italic@0 SF +<616e79>A F0 2.878<2766>C .378<6f72207468652073657276696365206e616d6520 +616e6420636f6e73747261696e20627920696d61676520747970652e>-2.878 F .378 +<546865207461736b>5.378 F<77696c6c206175746f6d61746963616c6c792071756572 +7920746865204469726563746f727920746f2063726561746520746865206c697374206f +6620736572766963657320746f20626520717565726965642e>128 96 Q 9.17 +<3329205072696e74>108 124.8 R 2.5<6163>2.5 G<6f756e74206f6620582d726179 +20636174616c6f6720646174612061726f756e64204162656c6c323731323a>-2.5 E +2.5<2576>164 148.8 S +<6f64617461202d63202d7420636174616c6f67202d6220782d72617920616e>-2.7 E +2.5<7961>-.15 G<62656c6c32373132>-2.5 E 2.5<2576>164 160.8 S<6f64617461 +202d2d636f756e74202d2d747970653d636174616c6f67202d2d62616e64706173733d78 +2d72617920616e>-2.7 E 2.5<7961>-.15 G<62656c6c32373132>-2.5 E 1.758<496e +2074686973206361736520776520636f6e73747261696e20626f74682074686520736572 +7669636520747970652061732077656c6c2061732074686520737065637472616c20636f> +128 184.8 R -.15<7665>-.15 G 1.758 +<72616765207075626c697368656420666f7220746865>.15 F .277 +<7265736f7572636520696e20746865204469726563746f7279>128 196.8 R 5.277 +<2e57>-.65 G 2.777<6575>-6.077 G .277<73652074686520726573657276>-2.777 +F .277 +<6564208d616720746f207072696e74206120636f756e7420776974686f7574207361> +-.15 F .277<76696e6720726573756c74732e>-.2 F .278<546865206f626a656374> +5.277 F<6e616d65206973207265736f6c76>128 208.8 Q +<656420746f20636f6f7264696e6174657320696e7465726e616c6c79>-.15 E 2.5 +<2e28>-.65 G<4e6f74653a20746869732065>-2.5 E +<78616d706c65206d61792074616b>-.15 E 2.5<656177>-.1 G +<68696c6520746f2072756e292e>-2.5 E 9.17<3429205072696e74>108 249.6 R<74 +686520636f6c756d6e206d657461646174612072657475726e6564206279207468652052 +433320636174616c6f6720736572766963653a>2.5 E 2.5<2576>164 273.6 S +<6f64617461202d2d6d65746120726333>-2.7 E 5<6f722076>7.5 F +<6f64617461202d6d20726333>-.2 E 1.293<546865206f75747075742077696c6c2070 +72696e742074686520726573756c74207573696e672074686520646566>128 297.6 R +1.292<61756c7420564552424f5345206c65>-.1 F -.15<7665>-.25 G 1.292 +<6c2c20616464696e6720746865>.15 F F1<2d76>3.792 E F0 1.292 +<77696c6c2073657420746865207175657279>3.792 F 1.605 +<706172616d6574657220564552424f53453d322c20616464696e67>128 309.6 R F1 +<2d7676>4.106 E F0 1.606 +<77696c6c2073657420564552424f53453d332028746f207072696e7420616c6c2061> +4.106 F -.25<7661>-.2 G 1.606<696c61626c6520636f6c756d6e73292e>.25 F +<5768656e>6.606 E<616363657373696e672064617461207468652073616d65>128 +321.6 Q F1<2d76>2.5 E F0 +<8d6167732077696c6c20626520726571756972656420746f20726574726965>2.5 E .3 +-.15<76652063>-.25 H<6f6c756d6e732061742074686174>.15 E F1 +<564552424f5345>2.5 E F0<6c65>2.5 E -.15<7665>-.25 G<6c2e>.15 E 9.17 +<352920557365>108 362.4 R .639<746865204469726563746f727920746f20717565 +727920666f72207265736f7572636573207573696e672074686520736561726368207465 +726d732022636f6f6c696e67208d6f>3.14 F 3.139<77222e2055706f6e>-.25 F -.15 +<6578>3.139 G .639<616d696e696e6720746865>.15 F 1.187 +<6f7574707574207468652075736572206e6f746963657320612056>128 374.4 R +1.187<697a696572207061706572207469746c65642022>-.6 F F1 1.188 +<436f6f6c696e6720466c6f777320696e2032303720636c7573746572>B 3.688<736f> +-.1 G 3.688<6647>-3.688 G<616c6178696573>-3.688 E F0 3.688<2274>C 1.188 +<686174206c6f6f6b73>-3.688 F 3.339<696e746572657374696e672e20557365>128 +386.4 R<746865>3.339 E/F2 10/Times-Bold@0 SF -.1<766f>3.339 G<64617461> +.1 E F0 .839<7461736b20746f20646f>3.339 F .839<776e6c6f616420616c6c2074 +61626c6573206173736f63696174656420776974682074686973207061706572>-.25 F +3.338<2c73>-.4 G -2.25 -.2<61762065>-3.338 H .838 +<7461626c657320696e20746865>3.538 F<646566>128 398.4 Q +<61756c742043535620666f726d61743a>-.1 E 2.5<2576>164 422.4 S +<6f6469726563746f727920636f6f6c696e67208d6f>-2.7 E<77>-.25 E 2.5<2576> +164 434.4 S<6f64617461202d4f2077686974653937202d616c6c204a2f4d4e5241532f +3239322f3431392f>-2.7 E 2.5<2576>164 446.4 S<6f64617461202d2d6f75747075 +743d77686974653937202d2d616c6c204a2f4d4e5241532f3239322f3431392f>-2.7 E +.095<416c6c2037207461626c65732077696c6c206265207772697474656e20746f2074 +68652063757272656e74206469726563746f727920746f208c6c6573206861>128 470.4 +R .095<76696e67206120726f6f74206e616d6520277768697465393727202863686f73 +656e206261736564>-.2 F<6f6e2074686520617574686f7220616e64207075626c6963 +6174696f6e2064617465292e>128 482.4 Q 9.17<36292046696e64>108 523.2 R +2.992<6173>2.992 G .492<75697461626c6520584d4d20696d61676520736572766963 +652c206765742061202862726965662920636f756e74206f662074686520584d4d20696d +616765732061>-2.992 F -.25<7661>-.2 G .491 +<696c61626c6520666f722033633237332c20616e64>.25 F +<6966207468657265206172656e27>128 535.2 Q 2.5<7474>-.18 G<6f6f206d616e> +-2.5 E 1.3 -.65<792c2064>-.15 H -.25<6f77>.65 G +<6e6c6f61642074686520696d6167657320616e64207361>.25 E .3 -.15<76652074> +-.2 H<68652065>.15 E<7874726163746564206163636573732055524c733a>-.15 E +2.5<2576>164 559.2 S +<6f6469726563746f7279202d7276202d7420696d61676520786d6d>-2.7 E 15 +<53686f72744e616d65205265736f7572636554>164 571.2 R 7.5<7970652054>-.8 F +<69746c65>-.35 E<2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d +2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2e2e2e2e>164 583.2 +Q<584d4d2d4e65>164 595.2 Q 12.5<77746f6e20534941502f41524348495645>-.25 +F<584d4d2d4e65>10 E<77746f6e204172636869>-.25 E .3 -.15<7665202e>-.25 H +<2e2e2e>.15 E 2.5<2576>164 619.2 S<6f64617461202d637120786d6d2d6e65>-2.7 +E<77746f6e203363323733>-.25 E<786d6d2d6e65>169 631.2 Q 20 +<77746f6e203237>-.25 F 5<4958>10 G<4d4d2d4e65>-5 E<77746f6e204172636869> +-.25 E .3 -.15<7665202e>-.25 H<2e2e2e>.15 E 2.5<2576>164 655.2 S +<6f64617461202d2d636f756e74202d2d717569657420786d6d2d6e65>-2.7 E +<77746f6e203363323733>-.25 E<786d6d2d6e65>169 667.2 Q 20<77746f6e203237> +-.25 F 5<4958>10 G<4d4d2d4e65>-5 E<77746f6e204172636869>-.25 E .3 -.15 +<7665202e>-.25 H<2e2e2e>.15 E 2.5<2576>164 691.2 S +<6f64617461202d2d67657420786d6d2d6e65>-2.7 E<77746f6e203363323733>-.25 E +<2e2e2e2e2077696c6c20717565727920616e6420646f>171.5 703.2 Q +<776e6c6f616420323720696d616765732e>-.25 E<4e56>72 768 Q 2.5<4f56>-.4 G +<4f2d434c492050726f6a656374>-2.9 E<4a756c792032303037>126.345 E<3130> +204.415 E 0 Cg EP +%%Page: 11 11 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S -.4<4441>.4 G -.93<5441>-.71 G +363.44<2831292056>.93 F<4f44>-.4 E -1.21 -1.11<41542041>-.4 H<283129> +1.11 E 9.17<3729205175657279>108 84 R 1.574 +<666f722074686520696d616765732061>4.074 F -.25<7661>-.2 G 1.574 +<696c61626c652066726f6d20324d4153532061742061206769>.25 F -.15<7665>-.25 +G 4.074<6e70>.15 G 1.574<6f736974696f6e2c2065>-4.074 F 1.574 +<7874726163742074686520706f736974696f6e7320616e642073657276696365>-.15 F +<55524c7320746f207365706172617465208c6c65733a>128 96 Q 2.5<2576>164 120 +S<6f64617461202d65202d4f20326d617373202d7420696d61676520326d617373203132 +3a33343a35362e37202d32333a31323a34352e32>-2.7 E 2.5<2576>164 132 S<6f64 +617461202d65202d2d6f75747075743d326d617373202d2d747970653d696d6167652032 +6d6173732031323a33343a35362e37202d32333a31323a34352e32>-2.7 E .688<5468 +652071756572792070726f6475636573208c6c657320776974682074686520726f6f7420 +6e616d652027326d617373272c20616e642065>128 156 R .688 +<7874656e2d2073696f6e73206f662022>-.15 F/F1 10/Times-Italic@0 SF +<2e637376>A F0 3.188<2228>C .688<746865206d61696e20726573706f6e7365292c> +-3.188 F<22>128 168 Q F1<2e706f73>A F0 3.413<2228>C .913<7468652065> +-3.413 F .913<787472616374656420706f732d206974696f6e73292c20616e642022> +-.15 F F1<2e75726c73>A F0 3.413<2228>C .913 +<74686520616363657373207265666572656e636573292e>-3.413 F .914 +<546865207573657220696e73706563747320746865208c6c657320616e64>5.913 F +.466<6e6f7469636573207468617420746865207265666572656e636573207265747572 +6e20626f7468204649545320616e642048544d4c208c6c65732c2062>128 180 R .465 +<757420736865206f6e6c792077>-.2 F .465 +<616e747320746865204649545320696d6167652064617465>-.1 F +<616e642075736573>128 192 Q/F2 10/Times-Bold@0 SF -.1<766f>2.5 G +<64617461>.1 E F0<746f20646f>2.5 E<776e6c6f6164206f6e6c792074686f73653a> +-.25 E 2.5<2567>164 216 S<726570208c747320326d6173735f495f3030315f313539 +39382e75726c73203e20696d616765732e747874>-2.5 E 2.5<2576>164 228 S +<6f6461746120696d616765732e747874>-2.7 E<6f72>138 240 Q 2.5<2567>164 252 +S<726570208c747320326d6173735f495f3030315f31353939382e75726c73207c2076> +-2.5 E<6f64617461202d69202d>-.2 E 1.462<496e20626f7468206361736573207765 +20706173732055524c7320746f20746865207461736b2077686963682062797061737365 +732074686520717565727920616e64206469726563746c79206163636573732074686520 +696d616765732e>128 276 R<486f>128 288 Q<7765>-.25 E -.15<7665>-.25 G +1.566 -.4<722c2069>.15 H 3.266<6e74>.4 G .766<6865208c727374206361736520 +77652070726f636573732074686520656e74697265206c69737420616e64206172652061 +626c6520746f2074616b>-3.266 F 3.265<6561>-.1 G<6476>-3.265 E .765 +<616e74616765206f6620746865>-.25 F F1<2d6d6178646f776e2d>3.265 E +<6c6f6164733d3c4e3e>128 300 Q F0 .432<6f7074696f6e20746f20696e6372656173 +6520746865206e756d626572206f662073696d756c74616e656f757320646f>2.932 F +2.933<776e6c6f6164732e20496e>-.25 F .433 +<746865207365636f6e6420636173652c20746865>2.933 F F1<2d69>2.933 E F0 +<8d6167>2.933 E .944<63617573657320746865207461736b20746f20696e74657270 +7265742065616368206c696e65206f662074686520696e7075742073747265616d206173 +206120736570617261746520636f6d6d616e6420616e6420736f20746865206461746120 +617265>128 312 R<616c>128 324 Q -.1<7761>-.1 G<797320646f>.1 E<776e6c6f +61646564206f6e6520617420612074696d65202877686963682069732074686520646566> +-.25 E<61756c7420646f>-.1 E<776e6c6f61642062656861>-.25 E +<76696f7220616e>-.2 E<7977>-.15 E<6179292e>-.1 E 9.17<382920557365>108 +352.8 R F2 -.1<766f>2.5 G<64617461>.1 E F0<61732061207465737420636c6965 +6e7420666f722061206c6f63616c6c792d696e7374616c6c656420534941502073657276 +6963653a>2.5 E 2.5<2576>164 376.8 S<6f64617461202d7420696d616765202d7320 +687474703a2f2f6c6f63616c686f73742f736961702e706c203138302e3020302e30> +-2.7 E 2.5<2576>164 388.8 S<6f64617461202d2d747970653d696d616765202d2d73 +76633d687474703a2f2f6c6f63616c686f73742f736961702e706c203138302e3020302e +30>-2.7 E .89<496e2074686973206361736520776520666f7263652074686520536572 +7669636555524c207573696e67207468652027>128 412.8 R F1<2d73>A F0 3.391 +<278d>C .891<61672c2062>-3.391 F .891<75742073696e63652077652063616e27> +-.2 F 3.391<7464>-.18 G 3.391<6f6144>-3.391 G .891 +<69726563746f727920717565727920746f>-3.391 F<646973636f>128 424.8 Q -.15 +<7665>-.15 G 2.5<7277>.15 G<6861742074797065206f662073657276696365207468 +69732069732c207765206d75737420757365207468652027>-2.5 E F1<2d74>A F0 2.5 +<278d>C<616720746f20696e64696361746520697420697320616e20696d616765207365 +72766963652e>-2.5 E 9.17<392920437265617465>108 465.6 R 2.923<616c>2.923 +G .423<6f63616c207461626c6520636f6e7461696e696e6720746865204162656c6c20 +636174616c6f672e>-2.923 F<4265>5.423 E .422<67696e2077697468206120446972 +6563746f727920717565727920746f208c6e64206c696b>-.15 F .422 +<656c79207365727669636573>-.1 F<7573696e6720746865>128 477.6 Q F2 -.1 +<766f>2.5 G<646972>.1 E<6563746f7279>-.18 E F0 +<7461736b2c207072696e7420612076>2.5 E<6572626f7365206465736372697074696f +6e206f662065616368207265736f7572636520616e642070616765207468652072657375 +6c74732077697468>-.15 E F1<6c657373>2.5 E F0<3a>A 2.5<2576>164 501.6 S< +6f6469726563746f7279202d76202d76202d2d747970653d636174616c6f67206162656c +6c207c206c657373>-2.7 E 1.268<5468652076>128 525.6 R 1.268<6572626f7365 +20726573756c747320696e6469636174652061206e756d626572206f6620736572766963 +6573207769746820646966>-.15 F 1.269<666572696e6720726571756972656d656e74 +7320666f72207768617420697320696e636c756465642e>-.25 F 2.848 -.8 +<57652064>128 537.6 T 1.247<656369646520746f2075736520746865207365727669 +63652066726f6d20484541534152432073696e636520697420636f6e7461696e7320736f +75746865726e2068656d69737068657265206461746120616e6420636f6e2d>.8 F .437 +<73747261696e74732077652061726520696e746572657374656420696e2e>128 549.6 +R -.35<5472>5.437 G 2.937<7961>.35 G 2.938<6e61>-2.937 G<6c6c2d736b> +-2.938 E 2.938<7971>-.15 G .438<7565727920746f20726574726965>-2.938 F +.738 -.15<76652074>-.25 H .438<686520656e7469726520636174616c6f672c2075 +7365207468652073657276696365206964656e74692d>.15 F +<8c657220746f2062652073706563698c632061626f75742077686572652077652077> +128 561.6 Q<616e7420746f20676f3a>-.1 E 2.5<2576>164 585.6 S +<6f64617461202d652069>-2.7 E -.2<766f>-.25 G +<3a2f2f6e6173612e686561736172632f6162656c6c20302e3020302e30203138302e30> +.2 E 2.5<2576>164 597.6 S<6f64617461202d2d65>-2.7 E<7874726163742069> +-.15 E -.2<766f>-.25 G +<3a2f2f6e6173612e686561736172632f6162656c6c20302e3020302e30203138302e30> +.2 E 1.733 -.8<57652075>128 621.6 T .133<7365207468652027>.8 F F1<2d65>A +F0 2.633<278d>C .133<616720746f2065>-2.633 F .133<7874726163742074686520 +706f736974696f6e7320746f2061207365706172617465208c6c65207769746820612022> +-.15 F F1<2e706f73>A F0 2.633<2265>C .132 +<7874656e73696f6e20736f20746861742077652063616e20757365>-2.783 F .576 +<746865736520696e206c6174657220717565726965732e>128 633.6 R<486f>5.576 E +<7765>-.25 E -.15<7665>-.25 G 1.376 -.4<722c2074>.15 H<6865>.4 E F1 +<2e706f73>3.076 E F0 .576<8c6c65206164646974696f6e616c6c7920636f6e746169 +6e73207468652049442066726f6d20746865206f726967696e616c20636174616c6f6720 +696e>3.076 F .246<636f6c756d6e20312e>128 645.6 R .246 +<5374726970207468697320636f6c756d6e20736f20776527>5.246 F .246<7265206c +6566742077697468206f6e6c7920524120616e642044454320616e642071756572792066 +6f72204368616e647261206f6273657276>-.5 F<6174696f6e73>-.25 E +<6174206561636820706f736974696f6e3a>128 657.6 Q 2.5<2563>164 681.6 S +<7574202d63362d202a2e706f73207c2076>-2.5 E<6f646174612069>-.2 E -.2 +<766f>-.25 G +<3a2f2f6e6173612e686561736172632f6368616e6d6173746572202d70202d>.2 E 2.5 +<2563>164 693.6 S<7574202d63362d202a2e706f73207c2076>-2.5 E +<6f646174612069>-.2 E -.2<766f>-.25 G +<3a2f2f6e6173612e686561736172632f6368616e6d6173746572202d2d706f733d2d>.2 +E .808<4865726520776520757365642074686520756e69782027>128 717.6 R F1 +<637574>A F0 3.308<2775>C .808<74696c69747920746f2072656d6f>-3.308 F +1.108 -.15<76652074>-.15 H .809<6865208c72737420636f6c756d6e20616e642070 +6970652074686520726573756c74696e6720706f736974696f6e7320746f20746865>.15 +F .383<7461736b2c207573696e67207468652027>128 729.6 R F1 .383<2d70202d>B +F0 2.882<276f>C .382<7074696f6e20746f20696e64696361746520706f736974696f +6e732073686f756c6420626520726561642066726f6d20737464696e672c20616e642074 +6865204956>-2.882 F 2.882<4f69>-.4 G .382<64656e74698c6572206f66>-2.882 +F<4e56>72 768 Q 2.5<4f56>-.4 G<4f2d434c492050726f6a656374>-2.9 E +<4a756c792032303037>126.345 E<3131>204.415 E 0 Cg EP +%%Page: 12 12 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S -.4<4441>.4 G -.93<5441>-.71 G +363.44<2831292056>.93 F<4f44>-.4 E -1.21 -1.11<41542041>-.4 H<283129> +1.11 E<746865204368616e647261206f6273657276>128 84 Q +<6174696f6e206d6173746572206c6f6720776520616c736f20646973636f>-.25 E +-.15<7665>-.15 G<7265642066726f6d20746865204469726563746f7279>.15 E<2e> +-.65 E 4.17<31302920496e74657261637469>108 124.8 R -.15<7665>-.25 G<6c79 +20717565727920666f72206120636f756e74206f66204368616e647261206f6273657276> +.15 E<6174696f6e73206f66204d657373696572206f626a656374733a>-.25 E 2.5 +<2576>164 148.8 S<6f64617461202d6371206368616e647261202d69202d>-2.7 E +<6d3331>164 160.8 Q 17.5<6368616e64726120333335>166.5 172.8 R 5<4943>10 +G<68616e64726120582d526179204f6273657276>-5 E +<61746f72792044617461204172636869>-.25 E -.15<7665>-.25 G 32.5<3a3a> +171.5 184.8 S 30<3a3a>-10 G<3a>-12.5 E .311 +<4e6f74652074686174206279207573696e67207468652027>128 208.8 R/F1 10 +/Times-Italic@0 SF<2d69>A F0 2.811<278d>C .311<61672077652065>-2.811 F +-.15<7865>-.15 G .311 +<63757465206561636820717565727920617320696620776527>.15 F 2.811<6470>-.5 +G .311 +<757420746865206f626a656374206e616d65206f6e2074686520636f6d6d616e64> +-2.811 F 4.068<6c696e652e205573696e67>128 220.8 R 1.568<7468652027>4.068 +F F1<2d6f>A F0 4.068<278d>C 1.567<61672077>-4.068 F 1.567<6f756c6420696e +7374656164207265616420616c6c206f6620746865206f626a656374732066726f6d2074 +686520737464696e2062>-.1 F 1.567<7574207468656e2065>-.2 F -.15<7865>-.15 +G 1.567<6375746520746865>.15 F +<7175657269657320696e20706172616c6c656c20666f6c6c6f>128 232.8 Q +<77696e6720616e20454f4620746f207465726d696e6174652074686520696e7075742e> +-.25 E 4.17<31312920557365>108 273.6 R<746865>3.902 E F1<5354494c>3.903 +E<5453>-.2 E F0 1.403<7461736b2027>3.903 F F1<7470697065>A F0 3.903 +<2774>C 3.903<6f73>-3.903 G 1.403<656c65637420726f>-3.903 F 1.403 +<77732066726f6d20612056>-.25 F -.4<4f54>-.4 G 1.403<61626c65206f66205153 +4f7320286d616465207769746820616e206561726c69657220717565727929>-.4 F +.297<776865726520746865207265647368696674206973203e20302e322e>128 285.6 +R .297<4f7574707574206f6e6c792074686520706f736974696f6e7320616e64207069 +7065207468697320746f>5.297 F/F2 10/Times-Bold@0 SF -.1<766f>2.797 G +<64617461>.1 E F0 .296<746f2067656e65726174652061206e65>2.797 F 2.796 +<7771>-.25 G<75657279>-2.796 E +<746f2073656520776865746865722048535420686173206f6273657276>128 297.6 Q +<656420616e>-.15 E 2.5<796f>-.15 G 2.5<6674>-2.5 G +<68657365206f626a656374733a>-2.5 E 2.5<2573>164 321.6 S +<74696c74732074706970652069666d743d76>-2.5 E +<6f7461626c652071736f5f73757276>-.2 E -.15<6579>-.15 G<2e76>-.5 E<6f74> +-.2 E<636d643d27>174 333.6 Q<73656c65637420225a203e20302e322227>-.55 E +<636d643d276b>158 345.6 Q<656570636f6c7320225241204445432227207c2076>-.1 +E<6f64617461202d70202d2068737470616563>-.2 E .677 +<4e6f7465207468617420776520757365207468652027>128 369.6 R F1 .677 +<2d70202d>B F0 3.177<278d>C .677 +<616720746f2074656c6c20746865207461736b20746f2074616b>-3.177 F 3.177 +<6569>-.1 G<7427>-3.177 E 3.177<736c>-.55 G .678<697374206f6620706f7369 +74696f6e732066726f6d2074686520706970656420696e7075742e>-3.177 F<546865> +5.678 E<706f736974696f6e7320617265207573656420746f2071756572792074686520 +48535420506c616e6e656420616e64204172636869>128 381.6 Q -.15<7665>-.25 G +2.5<6445>.15 G<78706f7375726520436174616c6f672028>-2.5 E F1 +<68737470616563>A F0<29>A 4.17<31322920546865>108 422.4 R .604 +<75736572206861732061207461736b2063616c6c65642027>3.104 F F1 +<776373696e666f>A F0 3.104<2774>C .604<6861742074616b>-3.104 F .604<6573 +2061206c697374206f6620696d6167657320616e64206f7574707574732061207465>-.1 +F .603<7874207461626c6520636f6e7461696e696e6720746865>-.15 F .044 +<706c6174652063656e74657220616e642073697a6520696e206465>128 434.4 R +2.544<67726565732e20557365>-.15 F .044<74686973207461736b20617320706172 +74206f66206120717565727920666f7220324d41535320706f696e7420736f7572636573 +20636f6e7461696e656420696e>2.544 F<6561636820696d6167653a>128 446.4 Q +2.5<2577>164 470.4 S<6373696e666f202a2e8c7473207c2076>-2.5 E +<6f6461746120326d6173732d707363202d69202d>-.2 E .564<486572652077652073 +70656369667920746865206465736972656420736572766963652028>128 494.4 R F1 +<326d6173732d707363>A F0 3.064<296f>C 3.064<6e74>-3.064 G .564 +<686520636f6d6d616e646c696e6520617320757375616c2c20616e6420616c6c6f> +-3.064 F 3.064<7774>-.25 G .564<68652072656d61696e2d>-3.064 F .949 +<646572206f6620746865206172>128 506.4 R .949<67732028692e652e2074686520 +706f736974696f6e20616e64207365617263682073697a652920746f2062652072656164 +2066726f6d2074686520737464696e2e>-.18 F .95<5468697320616c6c6f>5.95 F +.95<777320666f722076>-.25 F<61726961626c65>-.25 E .27 +<7365617263682073697a65732062>128 518.4 R .27 +<75742070726f6365737365732074686520706f736974696f6e732073657269616c6c79> +-.2 F 5.27<2e49>-.65 G 2.77<6674>-5.27 G .27<68652073697a65732061726520 +616c6c207468652073616d652028736179203235206172636d696e292c206d756c746970 +6c65>-2.77 F<717565726965732063616e20626520646f6e652073696d756c74616e65 +6f75736c79207573696e67206a757374206120706f736974696f6e208c6c652c20652e67 +2e>128 530.4 Q 2.5<2577>164 554.4 S<6373696e666f202d706f735f6f6e6c79202a +2e8c7473203e2063656e746572732e747874>-2.5 E 2.5<2576>164 566.4 S<6f6461 +7461202d2d73723d32356d20326d6173732d7073632063656e746572732e747874>-2.7 +E 4.17<313329205175657279>108 631.2 R 3.478<616c>3.478 G<6172>-3.478 E +.978<6765206c697374206f66206f626a65637473206167>-.18 F .978 +<61696e73742061206e756d626572206f662041534341207265736f75726365732e>-.05 +F .978<4265636175736520746865204153434120636174616c6f677320617265>5.978 +F<73657276>128 643.2 Q 1.276 +<6564206279207468652073616d65206d616368696e652c2075736520746865>-.15 F +F1<272d6927>3.775 E F0 1.275<6f7074696f6e20616e64206120636f6d6d616e6420 +8c6c6520746f2070726f63657373206f6e6c792065616368207265736f75726365>3.775 +F<73657175656e7469616c6c79207768696c65207374696c6c20706172616c6c656c697a +696e6720746865206f626a656374206c697374733a>128 655.2 Q 2.5<2563>164 +679.2 S<617420636d64732e747874>-2.5 E 2.5<415343412073757276>164 691.2 R +-.15<6579>-.15 G<2e74626c>-.5 E<415343415c20474953>164 703.2 Q<73757276> +5 E -.15<6579>-.15 G<2e74626c>-.5 E<415343415c20475053>164 715.2 Q +<73757276>5 E -.15<6579>-.15 G<2e74626c>-.5 E 22.5<3a3a>174 727.2 S +<4e56>72 768 Q 2.5<4f56>-.4 G<4f2d434c492050726f6a656374>-2.9 E +<4a756c792032303037>126.345 E<3132>204.415 E 0 Cg EP +%%Page: 13 13 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S -.4<4441>.4 G -.93<5441>-.71 G +363.44<2831292056>.93 F<4f44>-.4 E -1.21 -1.11<41542041>-.4 H<283129> +1.11 E 2.5<2576>164 84 S<6f64617461202d6920636d64732e747874>-2.7 E .656 +<4e6f7465207468617420776527>108 100.8 R .956 -.15<7665206e>-.5 H .656<65 +6564656420746f206573636170652074686520737061636520696e20746865207265736f +75726365206e616d6520696e20736f6d652063617365732e>.15 F 2.256 -.8 +<546f2061>5.656 H -.2<766f>.6 G .656 +<696420746869732c20757365206f6620746865>.2 F<4956>108 112.8 Q 2.5<4f69> +-.4 G<64656e74698c657220666f722065616368207265736f7572636520697320757375 +616c6c79207072656665727265642e>-2.5 E 4.17<313429205175657279>108 141.6 +R 1.352<7468652056>3.852 F 3.852<4f66>-.4 G 1.352 +<6f722047414c45582064617461206f66204d35312e>-3.852 F 1.352 +<4265636175736520746865>6.352 F/F1 10/Times-Italic@0 SF +<53686f72744e616d65>3.852 E F0 1.352 +<47414c4558206973206e6f7420756e697175652c207765206d757374>3.852 F .233 +<656974686572207370656369667920746865204956>128 153.6 R 2.733<4f69>-.4 G +.233<64656e74698c6572206f6620612073706563698c63207365727669636520746f20 +7175657279>-2.733 F 5.233<2c6f>-.65 G 2.733<7269>-5.233 G 2.734<6677> +-2.733 G<6527>-2.734 E .234 +<726520696e746572657374656420696e20726573756c74732066726f6d20616c6c>-.5 +F<737570706f7274656420646174612073657276696365732077697468>128 165.6 Q +F1<67616c65>2.5 E<78>-.2 E F0<696e20746865206e616d653a>2.5 E 2.5<2576> +164 189.6 S<6f64617461202d612067>-2.7 E<616c65>-.05 E 2.5<784d>-.15 G +<3531>-2.5 E 2.5<2576>164 201.6 S<6f64617461202d2d616c6c2067>-2.7 E +<616c65>-.05 E 2.5<784d>-.15 G<3531>-2.5 E .284<54686520726573756c747320 +636f6d652066726f6d2074686520436f6e6520616e642053494150207365727669636573 +20626f74682063616c6c6564>128 225.6 R F1<47414c4558>2.784 E F0 2.784 +<2c61>C 2.784<7377>-2.784 G .284 +<656c6c20617320616e206164646974696f6e616c2053494150>-2.784 F +<736572766963652063616c6c6564202747414c45585f41746c6173272e>128 237.6 Q< +4e6f74652074686174207468652073657276696365206e616d6573206172652063617365 +20696e73656e73697469>5 E .3 -.15<76652069>-.25 H 2.5<6e65>.15 G +<697468657220636173652e>-2.5 E 4.17<3135292050726f63657373>108 278.4 R +2.5<616c>2.5 G +<697374206f662068756e6472656473206f6620706f736974696f6e73206167>-2.5 E +<61696e73742074686520475343322e3320636174616c6f673a>-.05 E 2.5<2576>164 +302.4 S<6f6461746120677363322e3320706f736974696f6e732e747874>-2.7 E 4.17 +<3136292050726f63657373>108 355.2 R 2.893<616c>2.893 G .393 +<697374206f662068756e6472656473206f6620706f736974696f6e73206167>-2.893 F +.394<61696e73742074686520475343322e3320636174616c6f672c20617373756d6520 +746861742074686520696e707574207461626c652068617320612035>-.05 F .442 +<6c696e6520686561646572206f66207465>128 367.2 R .441 +<787420616e6420746872656520636f6c756d6e73202869642c72612c646563292e>-.15 +F .441<4e6f7465207468617420746865>5.441 F F1<636f6c73>2.941 E F0 .441 +<6f7074696f6e20726571756972657320746865206f7074696f6e616c206964206265> +2.941 F<73706563698c6564206c6173743a>128 379.2 Q 2.5<2576>164 403.2 S<6f +64617461202d2d636f6c733d322c332c31202d2d68736b69703d3520677363322e332070 +6f736974696f6e732e747874>-2.7 E/F2 10.95/Times-Bold@0 SF -.11<4255>72 +444 S<4753>.11 E F0<536f6d6520736572766963657320646f6e27>108 456 Q 2.5 +<7472>-.18 G<65706f6e642070726f7065726c7920746f20746865206d657461646174 +6120717565727920616e642077696c6c207072696e74206120226e6f20617474726962> +-2.5 E<7574657320666f756e6422206d6573736167652e>-.2 E F2 -.197<544f>72 +484.8 S<444f>.197 E F0 5<2d41>108 496.8 S<64646974696f6e616c20636f6d6d61 +6e642d6c696e65206f7074696f6e732073686f756c6420626520616c6c6f>-5 E<776564 +20746f2062652073706563698c656420696e206120636f6d6d616e64208c6c652e>-.25 +E 5<2d53>108 513.6 S<7570706f727420666f722053534150>-5 E 2.5<2c53>-1.11 +G<414d50>-2.5 E 2.5<2c54>-1.11 G<4150>-3.43 E F2<5265>72 554.4 Q +<766973696f6e20486973746f7279>-.164 E F0 +<4a756e652032303037202d2054686973207461736b206973206e65>108 566.4 Q -.65 +<772e>-.25 G F2 -.548<4175>72 583.2 S<74686f72>.548 E F0<4d69636861656c +204669747a7061747269636b20288c747a406e6f616f2e656475292c204a756e65203230 +3037>108 595.2 Q F2<53454520414c534f>72 612 Q F0 -.2<766f>108 624 S +<636c69656e742831292c2076>.2 E<6f636c69656e74642831292c2076>-.2 E +<6f736573616d652831292c2076>-.2 E<6f6469726563746f7279283129>-.2 E<4e56> +72 768 Q 2.5<4f56>-.4 G<4f2d434c492050726f6a656374>-2.9 E +<4a756c792032303037>126.345 E<3133>204.415 E 0 Cg EP +%%Trailer +end +%%EOF diff --git a/vendor/voclient/doc/OLD/vodirectory.html b/vendor/voclient/doc/OLD/vodirectory.html new file mode 100644 index 00000000..2e8d5fee --- /dev/null +++ b/vendor/voclient/doc/OLD/vodirectory.html @@ -0,0 +1,445 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VODIRECTORY</TITLE> +</HEAD><BODY> +<H1>VODIRECTORY</H1> +Section: User Commands (1)<BR>Updated: July 2007<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +vodirectory - NVO Directory search client +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>vodirectory</B> [-<I><flags></I>] [ <I><keywords></I> | <<I>term</I>> ] [ ... ] +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>vodirectory</I> task accepts the following options: +<DL COMPACT> +<DT><B>-h,--help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<DT><B>-v,--verbose</B> + +<DD> +Verbose output. The output will be more verbose than normal but exactly +what is printed depends on whether other flags are enabled to changed the +basic task behavior. +<DT><B>--vverbose</B> + +<DD> +Very-verbose output. Even more output. +<DT>The following flags control the major behavior of the task, i.e. the type<DD> +of output to present. +<DT><B>-c, --count</B> + +<DD> +Print a count of matching records. For each of the search terms, a simple +count of matching resources will be printed. A breakdown by service type +will be printed if the verbose flag is enabled. +<DT><B>-e, --exact</B> + +<DD> +Match exactly the search term (resolve mode only). The <I>term</I> in this +case will normally be an IVO identifier, this flag can be used to match the +identifier exactly rather than as a potential substring. This option will +return an empty string if no exact match is found. +<DT><B>-l, --list</B> + +<DD> +List the full resource record for each matching resource. For each matching +resource, all (well, most) of the information available about a resource +will be printed to the screen. Additional information may be available from +the Directory web interface. +<DT><B>-m, --meta</B> + +<DD> +List the metadata for the data services associated with the resource. For +each resource found, the table metadata (i.e. the column UCD values) +associated with the resource will be printed. Currently only those DAL +services supported by VOClient may be queried. +<DT><B>-r, --resolve</B> + +<DD> +<I>Resolve</I> the search term to a specified resource. In <I>resolve mode</I> +the search terms are assumed to be either the resource <I>ShortName</I> or +<I>Identifier</I> and the match will be done using only these two fields in +the Directory resource record. The default output is simply the +<I>ServiceURL</I> for all matching records (i.e. resources where the search +string is part of the <I>ShortName</I> or <I>Identifier</I> fields) unless +the <I>-f</I> flag is given to select other fields. +<DT><B>-s, --search</B> + +<DD> +Do a full search of the keywords and/or search terms. This is the default +mode and will output a list of matching resources containing at a minimum the +service <I>Type</I>, <I>Title</I>, <I>ShortName</I> and <I>Subject</I>. +Additional information is printed depending on the <I>verbose</I> level. +<DT>Shorthand Convenience Options:<DD> +<DT><B>-I, --Id</B> + +<DD> +Print only the <I>Identifier</I> field for the resolved resource. +<DT><B>-L, --long </B> + +<DD> +Suppress the linebreaks imposed for output fields that would wrap around the +normal 80-character output and allow long lines. This allows tasks to parse +the output more predictably. +<DT><B>-R, --Resolve</B> + +<DD> +Print the <I>ShortName</I>, <I>ServiceType</I> and <I>Identifier</I> fields for +the resolved resource. +<DT><B>-S, --SName</B> + +<DD> +Print only the <I>ShortName</I> field for the resolved resource. +<DT><B>-T, --Title</B> + +<DD> +Print only the <I>Title</I> for the resolved resources. +<DT>Constraint Options:<DD> +</DL> +<P> + +The list of allowed constraint strings is generally specified in the +<I>Resource Metadata for the Virtual Observatory</I> document available on +the IVOA document repository. These flags provide a convenient method to +limit a result list to resources that explicitly specify a value for the +given constraint. +<DL COMPACT> +<DT><B>-b <bpass> or --bandpass=<bpass></B> + +<DD> +Constrain the search to the specified bandpass string. +The text argument following the -f flag +will be matched against the <I>SpectralCoverage</I> field of the resource +record. Directory resources allow a list of values, however only a single +argument may be used to constrain the search. Permitted values include: +"Radio", "Millimeter", "Infrared" (IR), "Optical", "Ultraviolet" (UV), +"X-Ray" (XRay), and "Gamma-Ray" (GR). The match is case insensitive, values +shown in parentheses may be given and will be substituted automatically. +<DT><B>-C <content> or --clevel=<content></B> + +<DD> +Constrain the search to the specified ContentLevel string. The Directory +may contain data for a variety of intended audiences; Most often this +constraint will be used to limit the results to 'Research' grade data. +<DT><B>-t <type> or --type=<type></B> + +<DD> +Constrain the search to the specified ResourceType string. The Directory +records may contain any user-specified string, however unless you know +specifically how a specific resource is defined, this constraint should +use the values 'catalog' (for Cone services), 'image' (for SIAP +services), 'spectra' (for SSAP services), 'table' (for Vizier tables), +or a literal string which appears in the +resource record. Additional aliases will be added as new +data services are supported. +<DT><B>--new <time> or --new=<time></B> + +<DD> +Constrain the search to those resources that have been newly created during +the specified <time>. By default, <time> is an integer value assumed to be +a number of days, the last character may contain one of the qualifying +characters to change the time period: 'h' for hours, 'd' for days, + +refers to the last siz months. If no search term is given, all results +for that period will be returned, otherwise only those results that match +both the search terms and the time constraint will be listed. +<DT><B>--updated <time> or --updated=<time></B> + +<DD> +Constrain the search to those resource records that have been updated during +the specified time period. +<DT>Output Control Options:<DD> +<DT><B>-a, --all</B> + +<DD> +Output all matching records (default). When used with the constraint flags +above, this flag will allow those constraint strings to be matched as a +substring, e.g. using "-t siap" will exactly match resources with type + +<DT><B>-f <fields> or --fields=<fields></B> + +<DD> +Output the specified fields from the resource record (used in Resolve Mode +only). The list of available fields is given below, an 'INDEF' string is +printed for invalid field names or when no information is available. +<DT><B>-o, --or</B> + +<DD> +Logically OR the search terms. By default, all terms will be used when +matching resource records. +<DT><B>-n <index> or --index=<index></B> + +<DD> +Output only the results for the matchng <I>index</I>. Results are 1-indexed, +i.e. the first result is index 1 (one). +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>vodirectory</I> task provides a command-line interface to the <I>NVO +Directory</I> at STScI/JHU. The task also provides a basic search capability +for the Directory, as well as a "Resolve Mode" that can be used to lookup +resource records given some familiar name (e.g. 'USNO-B1'). Constraint +parameters allow the search to be restricted to resources declaring a +specific type (the <I>-t</I> flag), spectral coverage (the <I>-b</I> flag), or +content level (the <I>-C</I> flag). +<P> + +Search terms may be provided on the +command-line, in a filename specified on the commandline, or read from the +standard input (e.g. redirected from a file or other command). Advanced +users can submit a quoted ADQL string to access specific fields of a resource +record. This is similar to using the "Advanced Search" capability on the +NVO Directory web page. ADQL strings are required to be in double quotes +when given on the command line, the quotes are needed when query strings +come from a file. Standard SQL operators apply for comparison and boolean +operations, the 'like' operator is used to match strings (which must be in +single quotes), one or more '%' metacharacters may be used in the string +to indicate a wildcard match. +<P> + +In the default search mode, keywords given on the command line will all be +used to match resource records. The <I>-o</I> flag may be used to logically +OR the keyword terms, e.g. to allow a search of 'galaxy' or 'galaxies'. The +minimal output provides the resource title, type, subject and the 'ShortName' +that can be used in the resolve mode or be passed to other tasks such as +<A HREF="http://localhost/cgi-bin/man/man2html?1+vodata">vodata</A>(1). Additional output can be had with the <I>-v</I> or <I>-vv</I> +verbose flags. A simple count of the resources will be printed if the +<I>-c</I> flag is set (e.g. the command "vodirectory -oc chandra spitzer" +will print a count of how many records match each term rather than display +them directly, without the -o flag a count of resources mentioning both +keywords will be printed). +<P> + +The "Resolve mode" is activated by the <I>-r</I> flag; In this mode the +keywords will only be matched against the Directory <I>ShortName</I> and +<I>Identifier</I> fields. The default output is simply the <I>ServiceURL</I>, +adding the verbose flags will instead print the ShortName, ResourceType and +Title (with "-v") or Description (with "-vv"). The user can select specific +fields to be printed using the <I>-f</I> flag followed by a comma-delimited +list of fields. The allowed fields are shown with the <I>-h</I> help flag. +<P> + +The <I>-list</I> flag implies Resolve Mode and will cause all fields of the +matching resource to be printed. Unless the <I>-a</I> flag is set, the +search term will be matched exactly, otherwise it will be considered to be +a substring of the ShortName or Identifier fields. For example, searching +with the term '2mass' will list only 2MASS image service, but using the +<I>-a</I> flag will list all services where '2mass' appears in the ShortName. +<P> + +The <I>-meta</I> flag likewise assumes the command line arg is a resource +ShortName to be resolved and will query the DAL service associated with it +using a <I>FORMAT=METADATA</I> query. The default position will be (0.0,0.0) +with a search size of 0.1 degrees, the response will be a list of the column +UCDs returned by the query (note that adding <I>-v</I> flags will likewise +increase the VERBOSE of the query and may return additional columns). +<P> +<A NAME="lbAF"> </A> +<H2>RETURN STATUS</H2> + +The task will exit with a status of 0 if at least one search term could +be successfully resolved, otherwise the status will be 1. +<P> +<A NAME="lbAG"> </A> +<H2>VOCLIENT DAEMON PROCESSING</H2> + +All VO-CLI tasks are built upon the VOClient interface an rely on a +separate <I>voclientd</I> process to provide the VO functionality. The +voclientd task is distributed as part of VO-CLI and will be started +automatically by each task if it is not already running. If problems +are encountered, you may want to manually start the voclientd in a separate +window before running the task so you can monitor the output for error +messages. +<P> +<A NAME="lbAH"> </A> +<H2>RESOURCE CACHING</H2> + +Directory resolution is a common activity of VO-CLI tasks and so results +will be cached in the $HOME/.voclient/cache/regResolver directory based +on the search term, service type and bandpass parameters. Defining the +<I>VOC_NO_CACHE</I> environment variable will cause the task to ignore the +cache. +<P> +<P> +<A NAME="lbAI"> </A> +<H2>EXAMPLES</H2> + +<P> +<DL COMPACT> +<DT>1)<DD> +Get a count of all the SIAP services available in the Directory, then +list more information about each one: +<PRE> + + % vodirectory -count -t image + 142 + % vodirectory -rv -t image + +</PRE> + +<DT>2)<DD> +Find all catalog (i.e. Cone) services using the search words 'radio' +and 'galaxies': +<PRE> + + % vodirectory -t catalog radio galaxies + +</PRE> + +<DT>3)<DD> +Print the full resource record of the GSC2.2 catalog at STScI: +<PRE> + + % vodirectory -list GSC2.2 + +</PRE> + +<DT>4)<DD> +Find all services with radio data of Abell clusters. Then print the +full description of the first record associated with one of the matching +Vizier tables: +<PRE> + + % vodirectory -b radio abell + % vodirectory -rvv -n 1 J/A+A/446/97/tab + +</PRE> + +<DT>5)<DD> +Find all image services that have WFPC data: +<PRE> + + % vodirectory -v -t image wfpc + +</PRE> + +<DT>6)<DD> +Print a breakdown of VO services having Keck data: +<PRE> + + % vodirectory -cv keck + keck 122 (Cat: 2 Tab: 117 SNode: 1 Other: 2) + +</PRE> + +<DT>7)<DD> +Print a count of services having all of Chandra, HST and Spitzer data, +then break it down by each mission: +<PRE> + + % vodirectory -c chandra hst spitzer + chandra hst spitzer 3 + % vodirectory -co chandra hst spitzer + chandra 323 + hst 443 + spitzer 31 + +</PRE> + +<DT>8)<DD> +Print the column metadata returned by the GSC2.2 service: +<PRE> + + % vodirectory -meta gsc2.2 + +</PRE> + +<DT>9)<DD> +Use the ADQL query format to find services in which HST was the used, +and not simply a match of 'HST' in the resource record: +<PRE> + + % vodirectory "Facility like 'HST'" + +</PRE> + +Note that use assumed knowledge of the Directory being queried, specifically +that there exists a 'Facility' field with this information and that the +syntax of the query requires the string to be in quotes. +<P> +<DT>10) Use the ADQL query format to find services in which 'Keck' appears in<DD> +the Title of the resource: +<PRE> + + % vodirectory "Title like '%Keck%'" + + or + + % cat query.txt + Title like '%Keck%' + % cat query.txt | vodirectory + +</PRE> + +Note that here we use the '%' operator around the string so that we perform +a substring match on the entire title. As before, the ADQL string itself +must be enclosed in double quotes. +<P> +<DT>11) Find all resources that are newly registered in the last 3 months, then<DD> +find only those resources dealing with "cool stars", and finally just print +a count of resources updated in the last year: +<PRE> + + % vodirectory --new 3m + % vodirectory --new 3m cool stars + % vodirectory --updated 12m --count + +</PRE> + +<P> +</DL> +<A NAME="lbAJ"> </A> +<H2>BUGS</H2> + +Some services don't repond properly to the metadata query and will print +a "no attributes found" message. +<A NAME="lbAK"> </A> +<H2>Revision History</H2> + +June 2007 - This task is new. +<A NAME="lbAL"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), July 2007 +<A NAME="lbAM"> </A> +<H2>SEE ALSO</H2> + +<A HREF="http://localhost/cgi-bin/man/man2html?1+voclient">voclient</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+voclientd">voclientd</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+vosesame">vosesame</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+vodata">vodata</A>(1) +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">RETURN STATUS</A><DD> +<DT><A HREF="#lbAG">VOCLIENT DAEMON PROCESSING</A><DD> +<DT><A HREF="#lbAH">RESOURCE CACHING</A><DD> +<DT><A HREF="#lbAI">EXAMPLES</A><DD> +<DT><A HREF="#lbAJ">BUGS</A><DD> +<DT><A HREF="#lbAK">Revision History</A><DD> +<DT><A HREF="#lbAL">Author</A><DD> +<DT><A HREF="#lbAM">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 20:46:31 GMT, May 21, 2009 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/OLD/vodirectory.man b/vendor/voclient/doc/OLD/vodirectory.man new file mode 100644 index 00000000..734df4e2 --- /dev/null +++ b/vendor/voclient/doc/OLD/vodirectory.man @@ -0,0 +1,359 @@ +.\" @(#)vodirectory.1 1.0 June-07 MJF +.TH VODIRECTORY 1 "July 2007" "NVO VO-CLI Project" +.SH NAME +vodirectory \- NVO Directory search client +.SH SYNOPSIS +\fBvodirectory\fP [\-\fI<flags>\fP] [ \fI<keywords>\fP | <\fIterm\fP> ] [ ... ] + +.SH OPTIONS +The \fIvodirectory\fP task accepts the following options: +.TP 8 +.B \-h,--help +Print a help summary to the terminal and exit. No processing is done +following this flag. +.TP 8 +.B \-v,--verbose +Verbose output. The output will be more verbose than normal but exactly +what is printed depends on whether other flags are enabled to changed the +basic task behavior. +.TP 8 +.B \--vverbose +Very-verbose output. Even more output. +.TP 0 +The following flags control the major behavior of the task, i.e. the type +of output to present. +.TP 8 +.B \-c, --count +Print a count of matching records. For each of the search terms, a simple +count of matching resources will be printed. A breakdown by service type +will be printed if the verbose flag is enabled. +.TP 8 +.B \-e, --exact +Match exactly the search term (resolve mode only). The \fIterm\fP in this +case will normally be an IVO identifier, this flag can be used to match the +identifier exactly rather than as a potential substring. This option will +return an empty string if no exact match is found. +.TP 8 +.B \-l, --list +List the full resource record for each matching resource. For each matching +resource, all (well, most) of the information available about a resource +will be printed to the screen. Additional information may be available from +the Directory web interface. +.TP 8 +.B \-m, --meta +List the metadata for the data services associated with the resource. For +each resource found, the table metadata (i.e. the column UCD values) +associated with the resource will be printed. Currently only those DAL +services supported by VOClient may be queried. +.TP 8 +.B \-r, --resolve +\fIResolve\fP the search term to a specified resource. In \fIresolve mode\fP +the search terms are assumed to be either the resource \fIShortName\fP or +\fIIdentifier\fP and the match will be done using only these two fields in +the Directory resource record. The default output is simply the +\fIServiceURL\fP for all matching records (i.e. resources where the search +string is part of the \fIShortName\fP or \fIIdentifier\fP fields) unless +the \fI-f\fP flag is given to select other fields. +.TP 8 +.B \-s, --search +Do a full search of the keywords and/or search terms. This is the default +mode and will output a list of matching resources containing at a minimum the +service \fIType\fP, \fITitle\fP, \fIShortName\fP and \fISubject\fP. +Additional information is printed depending on the \fIverbose\fP level. +.TP 0 +Shorthand Convenience Options: +.TP 8 +.B \-I, --Id +Print only the \fIIdentifier\fP field for the resolved resource. +.TP 8 +.B \-L, --long +Suppress the linebreaks imposed for output fields that would wrap around the +normal 80-character output and allow long lines. This allows tasks to parse +the output more predictably. +.TP 8 +.B \-R, --Resolve +Print the \fIShortName\fP, \fIServiceType\fP and \fIIdentifier\fP fields for +the resolved resource. +.TP 8 +.B \-S, --SName +Print only the \fIShortName\fP field for the resolved resource. +.TP 8 +.B \-T, --Title +Print only the \fITitle\fP for the resolved resources. +.TP 0 +Constraint Options: +.PP +The list of allowed constraint strings is generally specified in the +\fIResource Metadata for the Virtual Observatory\fP document available on +the IVOA document repository. These flags provide a convenient method to +limit a result list to resources that explicitly specify a value for the +given constraint. +.TP 8 +.B \-b <bpass> or --bandpass=<bpass> +Constrain the search to the specified bandpass string. +The text argument following the -f flag +will be matched against the \fISpectralCoverage\fP field of the resource +record. Directory resources allow a list of values, however only a single +argument may be used to constrain the search. Permitted values include: +"Radio", "Millimeter", "Infrared" (IR), "Optical", "Ultraviolet" (UV), +"X-Ray" (XRay), and "Gamma-Ray" (GR). The match is case insensitive, values +shown in parentheses may be given and will be substituted automatically. +.TP 8 +.B \-C <content> or --clevel=<content> +Constrain the search to the specified ContentLevel string. The Directory +may contain data for a variety of intended audiences; Most often this +constraint will be used to limit the results to 'Research' grade data. +.TP 8 +.B \-t <type> or --type=<type> +Constrain the search to the specified ResourceType string. The Directory +records may contain any user-specified string, however unless you know +specifically how a specific resource is defined, this constraint should +use the values 'catalog' (for Cone services), 'image' (for SIAP +services), 'spectra' (for SSAP services), 'table' (for Vizier tables), +or a literal string which appears in the +resource record. Additional aliases will be added as new +data services are supported. +.TP 8 +.B \--new <time> or --new=<time> +Constrain the search to those resources that have been newly created during +the specified <time>. By default, <time> is an integer value assumed to be +a number of days, the last character may contain one of the qualifying +characters to change the time period: 'h' for hours, 'd' for days, +'w' for weeks, and 'm' for months. For example, the <time> string "6m" +refers to the last siz months. If no search term is given, all results +for that period will be returned, otherwise only those results that match +both the search terms and the time constraint will be listed. +.TP 8 +.B \--updated <time> or --updated=<time> +Constrain the search to those resource records that have been updated during +the specified time period. +.TP 0 +Output Control Options: +.TP 8 +.B \-a, --all +Output all matching records (default). When used with the constraint flags +above, this flag will allow those constraint strings to be matched as a +substring, e.g. using "-t siap" will exactly match resources with type +'siap', but using "-a -t siap" will also match 'siap/cutout' services. +.TP 8 +.B \-f <fields> or --fields=<fields> +Output the specified fields from the resource record (used in Resolve Mode +only). The list of available fields is given below, an 'INDEF' string is +printed for invalid field names or when no information is available. +.TP 8 +.B \-o, --or +Logically OR the search terms. By default, all terms will be used when +matching resource records. +.TP 8 +.B \-n <index> or --index=<index> +Output only the results for the matchng \fIindex\fP. Results are 1-indexed, +i.e. the first result is index 1 (one). + +.SH DESCRIPTION +The \fIvodirectory\fP task provides a command-line interface to the \fINVO +Directory\fP at STScI/JHU. The task also provides a basic search capability +for the Directory, as well as a "Resolve Mode" that can be used to lookup +resource records given some familiar name (e.g. 'USNO-B1'). Constraint +parameters allow the search to be restricted to resources declaring a +specific type (the \fI-t\fP flag), spectral coverage (the \fI-b\fP flag), or +content level (the \fI-C\fP flag). +.PP +Search terms may be provided on the +command-line, in a filename specified on the commandline, or read from the +standard input (e.g. redirected from a file or other command). Advanced +users can submit a quoted ADQL string to access specific fields of a resource +record. This is similar to using the "Advanced Search" capability on the +NVO Directory web page. ADQL strings are required to be in double quotes +when given on the command line, the quotes are needed when query strings +come from a file. Standard SQL operators apply for comparison and boolean +operations, the 'like' operator is used to match strings (which must be in +single quotes), one or more '%' metacharacters may be used in the string +to indicate a wildcard match. +.PP +In the default search mode, keywords given on the command line will all be +used to match resource records. The \fI-o\fR flag may be used to logically +OR the keyword terms, e.g. to allow a search of 'galaxy' or 'galaxies'. The +minimal output provides the resource title, type, subject and the 'ShortName' +that can be used in the resolve mode or be passed to other tasks such as +vodata(1). Additional output can be had with the \fI-v\fR or \fI-vv\fP +verbose flags. A simple count of the resources will be printed if the +\fI-c\fP flag is set (e.g. the command "vodirectory -oc chandra spitzer" +will print a count of how many records match each term rather than display +them directly, without the -o flag a count of resources mentioning both +keywords will be printed). +.PP +The "Resolve mode" is activated by the \fI-r\fR flag; In this mode the +keywords will only be matched against the Directory \fIShortName\fP and +\fIIdentifier\fR fields. The default output is simply the \fIServiceURL\fR, +adding the verbose flags will instead print the ShortName, ResourceType and +Title (with "-v") or Description (with "-vv"). The user can select specific +fields to be printed using the \fI-f\fP flag followed by a comma-delimited +list of fields. The allowed fields are shown with the \fI-h\fP help flag. +.PP +The \fI-list\fP flag implies Resolve Mode and will cause all fields of the +matching resource to be printed. Unless the \fI-a\fP flag is set, the +search term will be matched exactly, otherwise it will be considered to be +a substring of the ShortName or Identifier fields. For example, searching +with the term '2mass' will list only 2MASS image service, but using the +\fI-a\fP flag will list all services where '2mass' appears in the ShortName. +.PP +The \fI-meta\fP flag likewise assumes the command line arg is a resource +ShortName to be resolved and will query the DAL service associated with it +using a \fIFORMAT=METADATA\fP query. The default position will be (0.0,0.0) +with a search size of 0.1 degrees, the response will be a list of the column +UCDs returned by the query (note that adding \fI-v\fP flags will likewise +increase the VERBOSE of the query and may return additional columns). + +.SH RETURN STATUS +The task will exit with a status of 0 if at least one search term could +be successfully resolved, otherwise the status will be 1. + +.SH VOCLIENT DAEMON PROCESSING +All VO-CLI tasks are built upon the VOClient interface an rely on a +separate \fIvoclientd\fP process to provide the VO functionality. The +voclientd task is distributed as part of VO-CLI and will be started +automatically by each task if it is not already running. If problems +are encountered, you may want to manually start the voclientd in a separate +window before running the task so you can monitor the output for error +messages. + +.SH RESOURCE CACHING +Directory resolution is a common activity of VO-CLI tasks and so results +will be cached in the $HOME/.voclient/cache/regResolver directory based +on the search term, service type and bandpass parameters. Defining the +\fIVOC_NO_CACHE\fP environment variable will cause the task to ignore the +cache. + + +.SH EXAMPLES + +.TP 4 +1) +Get a count of all the SIAP services available in the Directory, then +list more information about each one: +.nf + + % vodirectory -count -t image + 142 + % vodirectory -rv -t image + +.fi +.TP 4 +2) +Find all catalog (i.e. Cone) services using the search words 'radio' +and 'galaxies': +.nf + + % vodirectory -t catalog radio galaxies + +.fi +.TP 4 +3) +Print the full resource record of the GSC2.2 catalog at STScI: +.nf + + % vodirectory -list GSC2.2 + +.fi +.TP 4 +4) +Find all services with radio data of Abell clusters. Then print the +full description of the first record associated with one of the matching +Vizier tables: +.nf + + % vodirectory -b radio abell + % vodirectory -rvv -n 1 J/A+A/446/97/tab + +.fi +.TP 4 +5) +Find all image services that have WFPC data: +.nf + + % vodirectory -v -t image wfpc + +.fi +.TP 4 +6) +Print a breakdown of VO services having Keck data: +.nf + + % vodirectory -cv keck + keck 122 (Cat: 2 Tab: 117 SNode: 1 Other: 2) + +.fi +.TP 4 +7) +Print a count of services having all of Chandra, HST and Spitzer data, +then break it down by each mission: +.nf + + % vodirectory -c chandra hst spitzer + chandra hst spitzer 3 + % vodirectory -co chandra hst spitzer + chandra 323 + hst 443 + spitzer 31 + +.fi +.TP 4 +8) +Print the column metadata returned by the GSC2.2 service: +.nf + + % vodirectory -meta gsc2.2 + +.fi +.TP 4 +9) +Use the ADQL query format to find services in which HST was the used, +and not simply a match of 'HST' in the resource record: +.nf + + % vodirectory "Facility like 'HST'" + +.fi +Note that use assumed knowledge of the Directory being queried, specifically +that there exists a 'Facility' field with this information and that the +syntax of the query requires the string to be in quotes. + +.TP 4 +10) Use the ADQL query format to find services in which 'Keck' appears in +the Title of the resource: +.nf + + % vodirectory "Title like '%Keck%'" + + or + + % cat query.txt + Title like '%Keck%' + % cat query.txt | vodirectory + +.fi +Note that here we use the '%' operator around the string so that we perform +a substring match on the entire title. As before, the ADQL string itself +must be enclosed in double quotes. + +.TP 4 +11) Find all resources that are newly registered in the last 3 months, then +find only those resources dealing with "cool stars", and finally just print +a count of resources updated in the last year: +.nf + + % vodirectory --new 3m + % vodirectory --new 3m cool stars + % vodirectory --updated 12m --count + +.fi + +.SH BUGS +Some services don't repond properly to the metadata query and will print +a "no attributes found" message. +.SH Revision History +June 2007 - This task is new. +.SH Author +Michael Fitzpatrick (fitz@noao.edu), July 2007 +.SH "SEE ALSO" +voclient(1), voclientd(1), vosesame(1), vodata(1) diff --git a/vendor/voclient/doc/OLD/vodirectory.pdf b/vendor/voclient/doc/OLD/vodirectory.pdf Binary files differnew file mode 100644 index 00000000..3413f27a --- /dev/null +++ b/vendor/voclient/doc/OLD/vodirectory.pdf diff --git a/vendor/voclient/doc/OLD/vodirectory.ps b/vendor/voclient/doc/OLD/vodirectory.ps new file mode 100644 index 00000000..fa002cbc --- /dev/null +++ b/vendor/voclient/doc/OLD/vodirectory.ps @@ -0,0 +1,777 @@ +%!PS-Adobe-3.0 +%%Creator: groff version 1.18.1 +%%CreationDate: Thu May 21 13:46:31 2009 +%%DocumentNeededResources: font Times-Roman +%%+ font Times-Bold +%%+ font Times-Italic +%%DocumentSuppliedResources: procset grops 1.18 1 +%%Pages: 5 +%%PageOrder: Ascend +%%Orientation: Portrait +%%EndComments +%%BeginProlog +%%BeginResource: procset grops 1.18 1 +/setpacking where{ +pop +currentpacking +true setpacking +}if +/grops 120 dict dup begin +/SC 32 def +/A/show load def +/B{0 SC 3 -1 roll widthshow}bind def +/C{0 exch ashow}bind def +/D{0 exch 0 SC 5 2 roll awidthshow}bind def +/E{0 rmoveto show}bind def +/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def +/G{0 rmoveto 0 exch ashow}bind def +/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/I{0 exch rmoveto show}bind def +/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def +/K{0 exch rmoveto 0 exch ashow}bind def +/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/M{rmoveto show}bind def +/N{rmoveto 0 SC 3 -1 roll widthshow}bind def +/O{rmoveto 0 exch ashow}bind def +/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/Q{moveto show}bind def +/R{moveto 0 SC 3 -1 roll widthshow}bind def +/S{moveto 0 exch ashow}bind def +/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/SF{ +findfont exch +[exch dup 0 exch 0 exch neg 0 0]makefont +dup setfont +[exch/setfont cvx]cvx bind def +}bind def +/MF{ +findfont +[5 2 roll +0 3 1 roll +neg 0 0]makefont +dup setfont +[exch/setfont cvx]cvx bind def +}bind def +/level0 0 def +/RES 0 def +/PL 0 def +/LS 0 def +/MANUAL{ +statusdict begin/manualfeed true store end +}bind def +/PLG{ +gsave newpath clippath pathbbox grestore +exch pop add exch pop +}bind def +/BP{ +/level0 save def +1 setlinecap +1 setlinejoin +72 RES div dup scale +LS{ +90 rotate +}{ +0 PL translate +}ifelse +1 -1 scale +}bind def +/EP{ +level0 restore +showpage +}bind def +/DA{ +newpath arcn stroke +}bind def +/SN{ +transform +.25 sub exch .25 sub exch +round .25 add exch round .25 add exch +itransform +}bind def +/DL{ +SN +moveto +SN +lineto stroke +}bind def +/DC{ +newpath 0 360 arc closepath +}bind def +/TM matrix def +/DE{ +TM currentmatrix pop +translate scale newpath 0 0 .5 0 360 arc closepath +TM setmatrix +}bind def +/RC/rcurveto load def +/RL/rlineto load def +/ST/stroke load def +/MT/moveto load def +/CL/closepath load def +/Fr{ +setrgbcolor fill +}bind def +/Fk{ +setcmykcolor fill +}bind def +/Fg{ +setgray fill +}bind def +/FL/fill load def +/LW/setlinewidth load def +/Cr/setrgbcolor load def +/Ck/setcmykcolor load def +/Cg/setgray load def +/RE{ +findfont +dup maxlength 1 index/FontName known not{1 add}if dict begin +{ +1 index/FID ne{def}{pop pop}ifelse +}forall +/Encoding exch def +dup/FontName exch def +currentdict end definefont pop +}bind def +/DEFS 0 def +/EBEGIN{ +moveto +DEFS begin +}bind def +/EEND/end load def +/CNT 0 def +/level1 0 def +/PBEGIN{ +/level1 save def +translate +div 3 1 roll div exch scale +neg exch neg exch translate +0 setgray +0 setlinecap +1 setlinewidth +0 setlinejoin +10 setmiterlimit +[]0 setdash +/setstrokeadjust where{ +pop +false setstrokeadjust +}if +/setoverprint where{ +pop +false setoverprint +}if +newpath +/CNT countdictstack def +userdict begin +/showpage{}def +}bind def +/PEND{ +clear +countdictstack CNT sub{end}repeat +level1 restore +}bind def +end def +/setpacking where{ +pop +setpacking +}if +%%EndResource +%%IncludeResource: font Times-Roman +%%IncludeResource: font Times-Bold +%%IncludeResource: font Times-Italic +grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 +def/PL 841.89 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron +/Zcaron/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef +/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef +/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef +/.notdef/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent +/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen +/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon +/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O +/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex +/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y +/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft +/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl +/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut +/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash +/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen +/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft +/logicalnot/minus/registered/macron/degree/plusminus/twosuperior +/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior +/ordmasculine/guilsinglright/onequarter/onehalf/threequarters +/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE +/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex +/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis +/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn +/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla +/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis +/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash +/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def +/Times-Italic@0 ENC0/Times-Italic RE/Times-Bold@0 ENC0/Times-Bold RE +/Times-Roman@0 ENC0/Times-Roman RE +%%EndProlog +%%Page: 1 1 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S<444952454354>.4 E<4f52>-.18 E +301.32<592831292056>-.65 F<4f444952454354>-.4 E<4f52>-.18 E<59283129> +-.65 E/F1 10.95/Times-Bold@0 SF -.219<4e41>72 84 S<4d45>.219 E F0 -.2 +<766f>108 96 S<6469726563746f727920ad204e56>.2 E 2.5<4f44>-.4 G +<69726563746f72792073656172636820636c69656e74>-2.5 E F1 +<53594e4f50534953>72 112.8 Q/F2 10/Times-Bold@0 SF -.1<766f>108 124.8 S +<646972>.1 E<6563746f7279>-.18 E F0<5bad>2.5 E/F3 10/Times-Italic@0 SF +<3c8d61>A<67733e>-.1 E F0 2.5<5d5b>C F3<3c6b>A -.3<6579>-.1 G<776f72>.3 +E<64733e>-.37 E F0 2.5<7c3c>2.5 G F3<7465726d>-2.5 E F0 2.5<3e5d5b2e>C +<2e2e205d>-2.5 E F1<4f5054494f4e53>72 153.6 Q F0<546865>108 165.6 Q F3 +<766f646972>2.5 E<6563746f7279>-.37 E F0 +<7461736b20616363657074732074686520666f6c6c6f>2.5 E +<77696e67206f7074696f6e733a>-.25 E F2<ad682c2d2d68656c70>108 182.4 Q F0< +5072696e7420612068656c702073756d6d61727920746f20746865207465726d696e616c +20616e642065>148 194.4 Q 2.5<7869742e204e6f>-.15 F +<70726f63657373696e6720697320646f6e6520666f6c6c6f>2.5 E +<77696e672074686973208d61672e>-.25 E F2<ad76>108 211.2 Q<2c2d2d76>-.55 E +<6572626f7365>-.1 E F0 -1.11<5665>148 223.2 S .004 +<72626f7365206f75747075742e>1.11 F .004 +<546865206f75747075742077696c6c206265206d6f72652076>5.004 F .003 +<6572626f7365207468616e206e6f726d616c2062>-.15 F .003<75742065>-.2 F +.003<786163746c792077686174206973207072696e74656420646570656e6473>-.15 F +<6f6e2077686574686572206f74686572208d6167732061726520656e61626c65642074 +6f206368616e67656420746865206261736963207461736b2062656861>148 235.2 Q +<76696f72>-.2 E<2e>-.55 E F2<ad2d7676>108 252 Q<6572626f7365>-.1 E F0 +-1.11<5665>148 264 S<72792d76>1.11 E<6572626f7365206f75747075742e>-.15 E +<4576>5 E<656e206d6f7265206f75747075742e>-.15 E<54686520666f6c6c6f>108 +280.8 Q +<77696e67208d61677320636f6e74726f6c20746865206d616a6f722062656861>-.25 E +<76696f72206f6620746865207461736b2c20692e652e207468652074797065>-.2 E +<6f66206f757470757420746f2070726573656e742e>108 292.8 Q F2 +<ad632c202d2d636f756e74>108 309.6 Q F0 1.51 +<5072696e74206120636f756e74206f66206d61746368696e67207265636f7264732e> +148 321.6 R -.15<466f>6.51 G 4.01<7265>.15 G 1.51<616368206f662074686520 +736561726368207465726d732c20612073696d706c6520636f756e74206f66206d617463 +68696e67>-4.01 F 1.544 +<7265736f75726365732077696c6c206265207072696e7465642e>148 333.6 R 4.043 +<4162>6.543 G<7265616b646f>-4.043 E 1.543<776e20627920736572766963652074 +7970652077696c6c206265207072696e746564206966207468652076>-.25 F 1.543 +<6572626f7365208d6167206973>-.15 F<656e61626c65642e>148 345.6 Q F2 +<ad652c202d2d6578616374>108 362.4 Q F0 1.085<4d617463682065>148 374.4 R +1.085<786163746c792074686520736561726368207465726d20287265736f6c76>-.15 +F 3.585<656d>-.15 G 1.086<6f6465206f6e6c79292e>-3.585 F<546865>6.086 E +F3<7465726d>3.586 E F0 1.086 +<696e207468697320636173652077696c6c206e6f726d616c6c7920626520616e>3.586 +F<4956>148 386.4 Q 2.972<4f69>-.4 G<64656e74698c6572>-2.972 E 2.972 +<2c74>-.4 G .471<686973208d61672063616e206265207573656420746f206d617463 +6820746865206964656e74698c65722065>-2.972 F .471<786163746c792072617468 +6572207468616e206173206120706f74656e7469616c207375622d>-.15 F 2.5 +<737472696e672e2054686973>148 398.4 R<6f7074696f6e2077696c6c207265747572 +6e20616e20656d70747920737472696e67206966206e6f2065>2.5 E +<78616374206d6174636820697320666f756e642e>-.15 E F2 +<ad6c2c202d2d6c697374>108 415.2 Q F0 .796<4c697374207468652066756c6c2072 +65736f75726365207265636f726420666f722065616368206d61746368696e6720726573 +6f757263652e>7.08 F -.15<466f>5.797 G 3.297<7265>.15 G .797 +<616368206d61746368696e67207265736f757263652c20616c6c202877656c6c2c> +-3.297 F 1.688<6d6f737429206f662074686520696e666f726d6174696f6e2061>148 +427.2 R -.25<7661>-.2 G 1.687<696c61626c652061626f75742061207265736f7572 +63652077696c6c206265207072696e74656420746f207468652073637265656e2e>.25 F +<4164646974696f6e616c>6.687 E<696e666f726d6174696f6e206d61792062652061> +148 439.2 Q -.25<7661>-.2 G<696c61626c652066726f6d2074686520446972656374 +6f72792077656220696e74657266>.25 E<6163652e>-.1 E F2 +<ad6d2c202d2d6d657461>108 456 Q F0 .261<4c69737420746865206d657461646174 +6120666f72207468652064617461207365727669636573206173736f6369617465642077 +69746820746865207265736f757263652e>148 468 R -.15<466f>5.262 G 2.762 +<7265>.15 G .262<616368207265736f7572636520666f756e642c20746865>-2.762 F +.895<7461626c65206d657461646174612028692e652e2074686520636f6c756d6e2055 +43442076>148 480 R .894<616c75657329206173736f63696174656420776974682074 +6865207265736f757263652077696c6c206265207072696e7465642e>-.25 F<437572> +5.894 E<2d>-.2 E<72656e746c79206f6e6c792074686f73652044>148 492 Q +<414c20736572766963657320737570706f727465642062792056>-.4 E +<4f436c69656e74206d617920626520717565726965642e>-.4 E F2<ad72>108 508.8 +Q 2.5<2c2d>-.92 G<2d72>-2.5 E<65736f6c76>-.18 E<65>-.1 E F3 +<5265736f6c7665>148 520.8 Q F0 .328<74686520736561726368207465726d20746f +20612073706563698c6564207265736f757263652e>2.828 F<496e>5.329 E F3 -.37 +<7265>2.829 G .329<736f6c7665206d6f6465>.37 F F0 .329 +<74686520736561726368207465726d732061726520617373756d656420746f>2.829 F +.83<62652065697468657220746865207265736f75726365>148 532.8 R F3 +<53686f72744e616d65>3.33 E F0<6f72>3.33 E F3<4964656e74698c6572>3.33 E +F0 .829<616e6420746865206d617463682077696c6c20626520646f6e65207573696e67 +206f6e6c79207468657365207477>3.329 F<6f>-.1 E 1.98<8c656c647320696e2074 +6865204469726563746f7279207265736f75726365207265636f72642e>148 544.8 R +1.98<54686520646566>6.98 F 1.98 +<61756c74206f75747075742069732073696d706c7920746865>-.1 F F3 +<5365727669636555524c>4.48 E F0 1.98<666f7220616c6c>4.48 F 1.379<6d6174 +6368696e67207265636f7264732028692e652e207265736f757263657320776865726520 +7468652073656172636820737472696e672069732070617274206f6620746865>148 +556.8 R F3<53686f72744e616d65>3.879 E F0<6f72>3.879 E F3 +<4964656e74698c6572>3.879 E F0<8c656c64732920756e6c65737320746865>148 +568.8 Q F3<2d66>2.5 E F0<8d6167206973206769>2.5 E -.15<7665>-.25 G 2.5 +<6e74>.15 G 2.5<6f73>-2.5 G<656c656374206f74686572208c656c64732e>-2.5 E +F2<ad732c202d2d73656172>108 585.6 Q<6368>-.18 E F0 .386 +<446f20612066756c6c20736561726368206f6620746865206b>148 597.6 R -.15 +<6579>-.1 G -.1<776f>.15 G .387 +<72647320616e642f6f7220736561726368207465726d732e>.1 F .387 +<546869732069732074686520646566>5.387 F .387 +<61756c74206d6f646520616e642077696c6c206f75747075742061>-.1 F .634<6c69 +7374206f66206d61746368696e67207265736f757263657320636f6e7461696e696e6720 +61742061206d696e696d756d207468652073657276696365>148 609.6 R F3 -.74 +<5479>3.134 G<7065>.74 E F0<2c>A F3 -.55<5469>3.134 G<746c65>.55 E F0 +<2c>A F3<53686f72744e616d65>3.134 E F0<616e64>3.134 E F3<5375622d>3.134 +E<6a656374>148 621.6 Q F0 5<2e41>C<64646974696f6e616c20696e666f726d6174 +696f6e206973207072696e74656420646570656e64696e67206f6e20746865>-5 E F3 +<766572626f7365>2.5 E F0<6c65>2.5 E -.15<7665>-.25 G<6c2e>.15 E +<53686f727468616e6420436f6e>108 638.4 Q -.15<7665>-.4 G +<6e69656e6365204f7074696f6e733a>.15 E F2<ad492c202d2d4964>108 655.2 Q F0 +<5072696e74206f6e6c7920746865>9.3 E F3<4964656e74698c6572>2.5 E F0 +<8c656c6420666f7220746865207265736f6c76>2.5 E<6564207265736f757263652e> +-.15 E F2<ad4c2c202d2d6c6f6e67>108 672 Q F0 .487<5375707072657373207468 +65206c696e65627265616b7320696d706f73656420666f72206f7574707574208c656c64 +7320746861742077>148 684 R .487<6f756c6420777261702061726f756e6420746865 +206e6f726d616c2038302d6368617261632d>-.1 F +<746572206f757470757420616e6420616c6c6f>148 696 Q 2.5<776c>-.25 G +<6f6e67206c696e65732e>-2.5 E<5468697320616c6c6f>5 E<7773207461736b732074 +6f20706172736520746865206f7574707574206d6f7265207072656469637461626c79> +-.25 E<2e>-.65 E<4e56>72 768 Q 2.5<4f56>-.4 G +<4f2d434c492050726f6a656374>-2.9 E<4a756c792032303037>126.345 E<31> +209.415 E 0 Cg EP +%%Page: 2 2 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S<444952454354>.4 E<4f52>-.18 E +301.32<592831292056>-.65 F<4f444952454354>-.4 E<4f52>-.18 E<59283129> +-.65 E/F1 10/Times-Bold@0 SF<ad522c202d2d5265736f6c76>108 84 Q<65>-.1 E +F0<5072696e7420746865>148 96 Q/F2 10/Times-Italic@0 SF +<53686f72744e616d65>2.5 E F0<2c>A F2<5365727669636554>2.5 E<797065>-.74 +E F0<616e64>2.5 E F2<4964656e74698c6572>2.5 E F0 +<8c656c647320666f7220746865207265736f6c76>2.5 E +<6564207265736f757263652e>-.15 E F1<ad532c202d2d534e616d65>108 112.8 Q +F0<5072696e74206f6e6c7920746865>148 124.8 Q F2<53686f72744e616d65>2.5 E +F0<8c656c6420666f7220746865207265736f6c76>2.5 E +<6564207265736f757263652e>-.15 E F1<ad54>108 141.6 Q 2.5<2c2d>-.74 G +<2d54>-2.5 E<69746c65>-.18 E F0<5072696e74206f6e6c7920746865>148 153.6 Q +F2 -.55<5469>2.5 G<746c65>.55 E F0<666f7220746865207265736f6c76>2.5 E +<6564207265736f75726365732e>-.15 E +<436f6e73747261696e74204f7074696f6e733a>108 170.4 Q .295 +<546865206c697374206f6620616c6c6f>108 187.2 R .294<77656420636f6e737472 +61696e7420737472696e67732069732067656e6572616c6c792073706563698c65642069 +6e20746865>-.25 F F2<5265736f7572>2.794 E .294 +<6365204d6574616461746120666f72207468652056>-.37 F .294 +<69727475616c204f62736572>-.74 F<2d>-.2 E<7661746f7279>108 199.2 Q F0 +.488<646f63756d656e742061>2.988 F -.25<7661>-.2 G .488 +<696c61626c65206f6e20746865204956>.25 F 1.188 -.35<4f412064>-.4 H .489 +<6f63756d656e74207265706f7369746f7279>.35 F 5.489<2e54>-.65 G .489 +<68657365208d6167732070726f>-5.489 F .489<76696465206120636f6e>-.15 F +-.15<7665>-.4 G .489<6e69656e74206d6574686f6420746f>.15 F<6c696d69742061 +20726573756c74206c69737420746f207265736f757263657320746861742065>108 +211.2 Q<78706c696369746c79207370656369667920612076>-.15 E +<616c756520666f7220746865206769>-.25 E -.15<7665>-.25 G 2.5<6e63>.15 G +<6f6e73747261696e742e>-2.5 E F1 +<ad62203c62706173733e206f72202d2d62616e64706173733d3c62706173733e>108 +228 Q F0 .12<436f6e73747261696e207468652073656172636820746f207468652073 +706563698c65642062616e647061737320737472696e672e>148 240 R .119 +<546865207465>5.119 F .119<7874206172>-.15 F .119 +<67756d656e7420666f6c6c6f>-.18 F .119 +<77696e6720746865202d66208d61672077696c6c>-.25 F .481 +<6265206d617463686564206167>148 252 R .481<61696e737420746865>-.05 F F2 +<537065637472>2.981 E<616c436f>-.15 E<766572>-.1 E -.1<616765>-.15 G F0 +.482<8c656c64206f6620746865207265736f75726365207265636f72642e>3.082 F +.482<4469726563746f7279207265736f757263657320616c6c6f>5.482 F<77>-.25 E +3.165<616c>148 264 S .665<697374206f662076>-3.165 F .665 +<616c7565732c20686f>-.25 F<7765>-.25 E -.15<7665>-.25 G 3.165<726f>.15 G +.665<6e6c7920612073696e676c65206172>-3.165 F .665<67756d656e74206d617920 +6265207573656420746f20636f6e73747261696e20746865207365617263682e>-.18 F +<5065726d6974746564>5.665 E -.25<7661>148 276 S 1.629<6c75657320696e636c +7564653a2022526164696f222c20224d696c6c696d65746572222c2022496e6672617265 +642220284952292c20224f70746963616c222c2022556c747261>.25 F 1.629 +<76696f6c65742220285556292c2022582d52617922>-.2 F 1.327 +<2858526179292c20616e64202247616d6d612d5261792220284752292e>148 288 R +1.327<546865206d61746368206973206361736520696e73656e73697469>6.327 F +-.15<7665>-.25 G 3.826<2c76>.15 G 1.326<616c7565732073686f>-4.076 F +1.326<776e20696e20706172656e746865736573>-.25 F<6d6179206265206769>148 +300 Q -.15<7665>-.25 G 2.5<6e61>.15 G<6e642077696c6c20626520737562737469 +7475746564206175746f6d61746963616c6c79>-2.5 E<2e>-.65 E F1 +<ad43203c636f6e74656e743e206f72202d2d636c65>108 316.8 Q -.1<7665>-.15 G +<6c3d3c636f6e74656e743e>.1 E F0 .692<436f6e73747261696e2074686520736561 +72636820746f207468652073706563698c656420436f6e74656e744c65>148 328.8 R +-.15<7665>-.25 G 3.192<6c73>.15 G 3.192<7472696e672e20546865>-3.192 F +.692<4469726563746f7279206d617920636f6e7461696e206461746120666f722061> +3.192 F -.25<7661>148 340.8 S 1.892 +<7269657479206f6620696e74656e6465642061756469656e6365733b>.25 F 1.892<4d +6f7374206f6674656e207468697320636f6e73747261696e742077696c6c206265207573 +656420746f206c696d69742074686520726573756c747320746f>6.892 F +<2752657365617263682720677261646520646174612e>148 352.8 Q F1 +<ad74203c747970653e206f72202d2d747970653d3c747970653e>108 369.6 Q F0 +1.258<436f6e73747261696e207468652073656172636820746f20746865207370656369 +8c6564205265736f7572636554>148 381.6 R 1.258<79706520737472696e672e>-.8 +F 1.259 +<546865204469726563746f7279207265636f726473206d617920636f6e7461696e> +6.258 F<616e>148 393.6 Q 5.275<7975>-.15 G<736572>-5.275 E 2.775 +<2d73706563698c656420737472696e672c20686f>-.2 F<7765>-.25 E -.15<7665> +-.25 G 5.274<7275>.15 G 2.774<6e6c65737320796f75206b6e6f>-5.274 F 5.274 +<7773>-.25 G 2.774<706563698c63616c6c7920686f>-5.274 F 5.274<776173>-.25 +G 2.774<706563698c63207265736f75726365206973>-5.274 F .101<64658c6e6564 +2c207468697320636f6e73747261696e742073686f756c6420757365207468652076>148 +405.6 R .102<616c7565732027636174616c6f67272028666f7220436f6e6520736572 +7669636573292c2027696d616765272028666f72205349415020736572>-.25 F<2d>-.2 +E .044<7669636573292c2027>148 417.6 R .044 +<73706563747261272028666f722053534150207365727669636573292c2027>-.55 F +.044<7461626c65272028666f722056>-.18 F .044<697a696572207461626c6573292c +206f722061206c69746572616c20737472696e6720776869636820617070656172732069 +6e>-.6 F<746865207265736f75726365207265636f72642e>148 429.6 Q<4164646974 +696f6e616c20616c69617365732077696c6c206265206164646564206173206e65>5 E +2.5<7764>-.25 G<6174612073657276696365732061726520737570706f727465642e> +-2.5 E F1<ad2d6e6577203c74696d653e206f72202d2d6e65773d3c74696d653e>108 +446.4 Q F0 .199<436f6e73747261696e207468652073656172636820746f2074686f73 +65207265736f75726365732074686174206861>148 458.4 R .499 -.15<76652062> +-.2 H .199<65656e206e65>.15 F .2<776c79206372656174656420647572696e6720 +7468652073706563698c6564203c74696d653e2e>-.25 F 1.04<427920646566>148 +470.4 R 1.04<61756c742c203c74696d653e20697320616e20696e7465>-.1 F 1.04 +<6765722076>-.15 F 1.04<616c756520617373756d656420746f2062652061206e756d +626572206f6620646179732c20746865206c61737420636861726163746572206d6179> +-.25 F 1.082<636f6e7461696e206f6e65206f6620746865207175616c696679696e67 +206368617261637465727320746f206368616e6765207468652074696d6520706572696f +643a>148 482.4 R 1.082<27682720666f7220686f7572732c2027>6.082 F 1.082 +<642720666f7220646179732c>-.5 F .086 +<72656665727320746f20746865206c6173742073697a206d6f6e7468732e>148 494.4 +R .086<4966206e6f20736561726368207465726d206973206769>5.086 F -.15<7665> +-.25 G .086<6e2c20616c6c20726573756c747320666f72207468617420706572696f64 +2077696c6c2062652072657475726e65642c>.15 F 1.636<6f7468657277697365206f +6e6c792074686f736520726573756c74732074686174206d6174636820626f7468207468 +6520736561726368207465726d7320616e64207468652074696d6520636f6e7374726169 +6e742077696c6c206265>148 506.4 R<6c69737465642e>148 518.4 Q F1<ad2d7570 +6461746564203c74696d653e206f72202d2d757064617465643d3c74696d653e>108 +535.2 Q F0 .888<436f6e73747261696e207468652073656172636820746f2074686f73 +65207265736f75726365207265636f7264732074686174206861>148 547.2 R 1.188 +-.15<76652062>-.2 H .888<65656e207570646174656420647572696e672074686520 +73706563698c65642074696d65>.15 F<706572696f642e>148 559.2 Q +<4f757470757420436f6e74726f6c204f7074696f6e733a>108 576 Q F1 +<ad612c202d2d616c6c>108 592.8 Q F0 .829 +<4f757470757420616c6c206d61746368696e67207265636f7264732028646566>7.08 F +3.329<61756c74292e205768656e>-.1 F .829 +<7573656420776974682074686520636f6e73747261696e74208d6167732061626f> +3.329 F -.15<7665>-.15 G 3.33<2c74>.15 G .83<686973208d61672077696c6c> +-3.33 F<616c6c6f>148 604.8 Q 2.785<7774>-.25 G .284<686f736520636f6e7374 +7261696e7420737472696e677320746f206265206d617463686564206173206120737562 +737472696e672c20652e672e207573696e6720222d742073696170222077696c6c2065> +-2.785 F .284<786163746c79206d61746368>-.15 F +<7265736f757263657320776974682074797065>148 616.8 Q F1 +<ad66203c8c656c64733e206f72202d2d8c656c64733d3c8c656c64733e>108 633.6 Q +F0 1.276<4f7574707574207468652073706563698c6564208c656c64732066726f6d20 +746865207265736f75726365207265636f726420287573656420696e205265736f6c76> +148 645.6 R 3.777<654d>-.15 G 1.277<6f6465206f6e6c79292e>-3.777 F 1.277 +<546865206c697374206f66>6.277 F -.2<6176>148 657.6 S .92 +<61696c61626c65208c656c6473206973206769>-.05 F -.15<7665>-.25 G 3.42 +<6e62>.15 G<656c6f>-3.42 E 2.22 -.65<772c2061>-.25 H 3.42<6e27>.65 G .92 +<494e4445462720737472696e67206973207072696e74656420666f7220696e>-3.42 F +-.25<7661>-.4 G .92<6c6964208c656c64206e616d6573206f72207768656e206e6f> +.25 F<696e666f726d6174696f6e2069732061>148 669.6 Q -.25<7661>-.2 G +<696c61626c652e>.25 E F1<ad6f2c202d2d6f72>108 686.4 Q F0 2.118 +<4c6f676963616c6c79204f522074686520736561726368207465726d732e>8.2 F +2.118<427920646566>7.118 F 2.119<61756c742c20616c6c207465726d732077696c +6c2062652075736564207768656e206d61746368696e67207265736f75726365>-.1 F +<7265636f7264732e>148 698.4 Q<4e56>72 768 Q 2.5<4f56>-.4 G +<4f2d434c492050726f6a656374>-2.9 E<4a756c792032303037>126.345 E<32> +209.415 E 0 Cg EP +%%Page: 3 3 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S<444952454354>.4 E<4f52>-.18 E +301.32<592831292056>-.65 F<4f444952454354>-.4 E<4f52>-.18 E<59283129> +-.65 E/F1 10/Times-Bold@0 SF +<ad6e203c696e6465783e206f72202d2d696e6465783d3c696e6465783e>108 84 Q F0 +.06<4f7574707574206f6e6c792074686520726573756c747320666f7220746865206d61 +7463686e67>148 96 R/F2 10/Times-Italic@0 SF<696e6465>2.56 E<78>-.2 E F0 +5.06<2e52>C .06<6573756c74732061726520312d696e6465>-5.06 F -.15<7865> +-.15 G .06 +<642c20692e652e20746865208c72737420726573756c7420697320696e6465>.15 F +2.56<7831>-.15 G<286f6e65292e>148 108 Q/F3 10.95/Times-Bold@0 SF +<4445534352495054494f4e>72 136.8 Q F0<546865>108 148.8 Q F2<766f646972> +2.594 E<6563746f7279>-.37 E F0 .094<7461736b2070726f>2.594 F .094 +<7669646573206120636f6d6d616e642d6c696e6520696e74657266>-.15 F .095 +<61636520746f20746865>-.1 F F2<4e56>2.595 E 2.595<4f44>-.3 G<6972>-2.595 +E<6563746f7279>-.37 E F0 .095<61742053545363492f4a48552e>2.595 F .095 +<546865207461736b20616c736f>5.095 F<70726f>108 160.8 Q .111<766964657320 +6120626173696320736561726368206361706162696c69747920666f7220746865204469 +726563746f7279>-.15 F 2.611<2c61>-.65 G 2.611<7377>-2.611 G .11 +<656c6c206173206120225265736f6c76>-2.611 F 2.61<654d>-.15 G .11 +<6f64652220746861742063616e206265207573656420746f206c6f6f6b7570>-2.61 F +.005<7265736f75726365207265636f726473206769>108 172.8 R -.15<7665>-.25 G +2.505<6e73>.15 G .005<6f6d652066>-2.505 F .006 +<616d696c696172206e616d652028652e672e202755534e4f2d423127292e>-.1 F .006 +<436f6e73747261696e7420706172616d657465727320616c6c6f>5.006 F 2.506 +<7774>-.25 G .006<68652073656172636820746f206265>-2.506 F .379<72657374 +72696374656420746f207265736f7572636573206465636c6172696e6720612073706563 +698c6320747970652028746865>108 184.8 R F2<2d74>2.878 E F0 .378 +<8d6167292c20737065637472616c20636f>2.878 F -.15<7665>-.15 G .378 +<726167652028746865>.15 F F2<2d62>2.878 E F0 .378 +<8d6167292c206f7220636f6e74656e74206c65>2.878 F -.15<7665>-.25 G<6c>.15 +E<28746865>108 196.8 Q F2<2d43>2.5 E F0<8d6167292e>2.5 E .694 +<536561726368207465726d73206d61792062652070726f>108 213.6 R .694<766964 +6564206f6e2074686520636f6d6d616e642d6c696e652c20696e2061208c6c656e616d65 +2073706563698c6564206f6e2074686520636f6d6d616e646c696e652c206f7220726561 +64>-.15 F 1.778<66726f6d20746865207374616e6461726420696e7075742028652e67 +2e20726564697265637465642066726f6d2061208c6c65206f72206f7468657220636f6d +6d616e64292e>108 225.6 R<416476>6.778 E 1.778 +<616e6365642075736572732063616e207375626d69742061>-.25 F .632<71756f7465 +64204144514c20737472696e6720746f206163636573732073706563698c63208c656c64 +73206f662061207265736f75726365207265636f72642e>108 237.6 R .632 +<546869732069732073696d696c617220746f207573696e67207468652022416476> +5.632 F<616e636564>-.25 E 1.29 +<53656172636822206361706162696c697479206f6e20746865204e56>108 249.6 R +3.79<4f44>-.4 G 1.29<69726563746f72792077656220706167652e>-3.79 F 1.289< +4144514c20737472696e67732061726520726571756972656420746f20626520696e2064 +6f75626c652071756f746573>6.289 F 1.06<7768656e206769>108 261.6 R -.15 +<7665>-.25 G 3.56<6e6f>.15 G 3.56<6e74>-3.56 G 1.061<686520636f6d6d616e +64206c696e652c207468652071756f74657320617265206e6565646564207768656e2071 +7565727920737472696e677320636f6d652066726f6d2061208c6c652e>-3.56 F +<5374616e64617264>6.061 E 1.114<53514c206f70657261746f7273206170706c7920 +666f7220636f6d70617269736f6e20616e6420626f6f6c65616e206f7065726174696f6e +732c207468652027>108 273.6 R<6c696b>-.1 E 1.114<6527206f70657261746f7220 +6973207573656420746f206d6174636820737472696e6773>-.1 F .753<287768696368 +206d75737420626520696e2073696e676c652071756f746573292c206f6e65206f72206d +6f726520272527206d65746163686172616374657273206d617920626520757365642069 +6e2074686520737472696e6720746f20696e6469636174652061>108 285.6 R +<77696c6463617264206d617463682e>108 297.6 Q .009<496e2074686520646566> +108 314.4 R .009<61756c7420736561726368206d6f64652c206b>-.1 F -.15<6579> +-.1 G -.1<776f>.15 G .009<726473206769>.1 F -.15<7665>-.25 G 2.509<6e6f> +.15 G 2.509<6e74>-2.509 G .009<686520636f6d6d616e64206c696e652077696c6c +20616c6c206265207573656420746f206d61746368207265736f75726365207265636f72 +64732e>-2.509 F<546865>108 326.4 Q F2<2d6f>2.695 E F0 .195<8d6167206d61 +79206265207573656420746f206c6f676963616c6c79204f5220746865206b>2.695 F +-.15<6579>-.1 G -.1<776f>.15 G .195 +<7264207465726d732c20652e672e20746f20616c6c6f>.1 F 2.695<776173>-.25 G +.195<6561726368206f66202767>-2.695 F .195<616c61787927206f72202767>-.05 +F<616c6178696573272e>-.05 E .767 +<546865206d696e696d616c206f75747075742070726f>108 338.4 R .767<76696465 +7320746865207265736f75726365207469746c652c20747970652c207375626a65637420 +616e6420746865202753686f72744e616d652720746861742063616e2062652075736564 +20696e20746865>-.15 F<7265736f6c76>108 350.4 Q 2.705<656d>-.15 G .205<6f +6465206f722062652070617373656420746f206f74686572207461736b73207375636820 +61732076>-2.705 F 2.705<6f646174612831292e204164646974696f6e616c>-.2 F +.205<6f75747075742063616e20626520686164207769746820746865>2.705 F F2 +<2d76>2.705 E F0<6f72>2.705 E F2<2d7676>2.705 E F0 -.15<7665>108 362.4 S +.306<72626f7365208d6167732e>.15 F 2.806<4173>5.306 G .306<696d706c652063 +6f756e74206f6620746865207265736f75726365732077696c6c206265207072696e7465 +6420696620746865>-2.806 F F2<2d63>2.805 E F0 .305 +<8d6167206973207365742028652e672e2074686520636f6d6d616e64202276>2.805 F +<6f64692d>-.2 E 1.034<726563746f7279202d6f63206368616e64726120737069747a +6572222077696c6c207072696e74206120636f756e74206f6620686f>108 374.4 R +3.535<776d>-.25 G<616e>-3.535 E 3.535<7972>-.15 G 1.035<65636f726473206d +617463682065616368207465726d20726174686572207468616e20646973706c6179> +-3.535 F<7468656d206469726563746c79>108 386.4 Q 2.5<2c77>-.65 G<6974686f +757420746865202d6f208d6167206120636f756e74206f66207265736f7572636573206d +656e74696f6e696e6720626f7468206b>-2.5 E -.15<6579>-.1 G -.1<776f>.15 G +<7264732077696c6c206265207072696e746564292e>.1 E .085 +<54686520225265736f6c76>108 403.2 R 2.585<656d>-.15 G .085 +<6f6465222069732061637469>-2.585 F -.25<7661>-.25 G .084 +<74656420627920746865>.25 F F2<2d72>2.584 E F0 2.584<8d61673b20496e> +2.584 F .084<74686973206d6f646520746865206b>2.584 F -.15<6579>-.1 G -.1 +<776f>.15 G .084<7264732077696c6c206f6e6c79206265206d617463686564206167> +.1 F .084<61696e737420746865>-.05 F<4469726563746f7279>108 415.2 Q F2 +<53686f72744e616d65>3.392 E F0<616e64>3.392 E F2<4964656e74698c6572> +3.393 E F0 3.393<8c656c64732e20546865>3.393 F<646566>3.393 E .893 +<61756c74206f75747075742069732073696d706c7920746865>-.1 F F2 +<5365727669636555524c>5.893 E F0 3.393<2c61>C .893 +<6464696e67207468652076>-3.393 F<6572>-.15 E<2d>-.2 E 2.126<626f7365208d +6167732077696c6c20696e7374656164207072696e74207468652053686f72744e616d65 +2c205265736f7572636554>108 427.2 R 2.126<79706520616e642054>-.8 F 2.125< +69746c6520287769746820222d762229206f72204465736372697074696f6e2028776974 +68>-.35 F 2.668<222d767622292e20546865>108 439.2 R .168<757365722063616e +2073656c6563742073706563698c63208c656c647320746f206265207072696e74656420 +7573696e6720746865>2.668 F F2<2d66>2.668 E F0 .169<8d616720666f6c6c6f> +2.669 F .169<776564206279206120636f6d6d612d64656c696d69746564206c697374> +-.25 F<6f66208c656c64732e>108 451.2 Q<54686520616c6c6f>5 E +<776564208c656c6473206172652073686f>-.25 E<776e207769746820746865>-.25 E +F2<2d68>2.5 E F0<68656c70208d61672e>2.5 E<546865>108 468 Q F2 +<2d6c697374>2.653 E F0 .153<8d616720696d706c696573205265736f6c76>2.653 F +2.653<654d>-.15 G .153<6f646520616e642077696c6c20636175736520616c6c208c +656c6473206f6620746865206d61746368696e67207265736f7572636520746f20626520 +7072696e7465642e>-2.653 F<556e6c657373>5.152 E<746865>108 480 Q F2<2d61> +2.976 E F0 .476<8d6167206973207365742c2074686520736561726368207465726d20 +77696c6c206265206d6174636865642065>2.976 F<786163746c79>-.15 E 2.977 +<2c6f>-.65 G .477<74686572776973652069742077696c6c20626520636f6e73696465 +72656420746f206265206120737562737472696e67>-2.977 F .51<6f66207468652053 +686f72744e616d65206f72204964656e74698c6572208c656c64732e>108 492 R -.15 +<466f>5.51 G 3.01<7265>.15 G .51<78616d706c652c20736561726368696e672077 +69746820746865207465726d2027326d617373272077696c6c206c697374206f6e6c7920 +324d415353>-3.16 F<696d61676520736572766963652c2062>108 504 Q +<7574207573696e6720746865>-.2 E F2<2d61>2.5 E F0<8d61672077696c6c206c69 +737420616c6c2073657276696365732077686572652027326d6173732720617070656172 +7320696e207468652053686f72744e616d652e>2.5 E<546865>108 520.8 Q F2 +<2d6d657461>3.625 E F0 1.126<8d6167206c696b>3.625 F -.25<6577>-.1 G +1.126<69736520617373756d65732074686520636f6d6d616e64206c696e65206172>.25 +F 3.626<6769>-.18 G 3.626<736172>-3.626 G 1.126 +<65736f757263652053686f72744e616d6520746f206265207265736f6c76>-3.626 F +1.126<656420616e642077696c6c>-.15 F .69<7175657279207468652044>108 532.8 +R .689<414c2073657276696365206173736f6369617465642077697468206974207573 +696e672061>-.4 F F2<464f524d41>3.189 E<543d4d4554>-.37 E<4144>-.5 E -.37 +<4154>-.35 G<41>-.13 E F0<7175657279>3.189 E 5.689<2e54>-.65 G .689 +<686520646566>-5.689 F .689<61756c7420706f736974696f6e2077696c6c>-.1 F +.681<62652028302e302c302e302920776974682061207365617263682073697a65206f +6620302e31206465>108 544.8 R .681<67726565732c2074686520726573706f6e7365 +2077696c6c2062652061206c697374206f662074686520636f6c756d6e20554344732072 +657475726e6564206279>-.15 F .228 +<74686520717565727920286e6f7465207468617420616464696e67>108 556.8 R F2 +<2d76>2.727 E F0 .227<8d6167732077696c6c206c696b>2.727 F -.25<6577>-.1 G +.227<69736520696e6372656173652074686520564552424f5345206f66207468652071 +7565727920616e64206d61792072657475726e20616464692d>.25 F +<74696f6e616c20636f6c756d6e73292e>108 568.8 Q F3<52455455524e205354>72 +597.6 Q -1.04<4154>-.986 G<5553>1.04 E F0 .188 +<546865207461736b2077696c6c2065>108 609.6 R .188<7869742077697468206120 +737461747573206f662030206966206174206c65617374206f6e65207365617263682074 +65726d20636f756c64206265207375636365737366756c6c79207265736f6c76>-.15 F +.188<65642c206f746865727769736520746865>-.15 F +<7374617475732077696c6c20626520312e>108 621.6 Q F3 -.493<564f>72 650.4 S +<434c49454e542044>.493 E<41454d4f4e205052>-.383 E<4f43455353494e47>-.329 +E F0 .605<416c6c2056>108 662.4 R .605 +<4f2d434c49207461736b73206172652062>-.4 F .605 +<75696c742075706f6e207468652056>-.2 F .605<4f436c69656e7420696e74657266> +-.4 F .605<61636520616e2072656c79206f6e2061207365706172617465>-.1 F F2 +<766f636c69656e7464>3.104 E F0 .604<70726f6365737320746f2070726f>3.104 F +<76696465>-.15 E .382<7468652056>108 674.4 R 2.882<4f66>-.4 G +<756e6374696f6e616c697479>-2.882 E 5.382<2e54>-.65 G .382<68652076> +-5.382 F .382<6f636c69656e7464207461736b2069732064697374726962>-.2 F +.383<757465642061732070617274206f662056>-.2 F .383<4f2d434c4920616e6420 +77696c6c2062652073746172746564206175746f6d61746963616c6c79>-.4 F .524<62 +792065616368207461736b206966206974206973206e6f7420616c72656164792072756e +6e696e672e>108 686.4 R .524<49662070726f626c656d732061726520656e636f756e +74657265642c20796f75206d61792077>5.524 F .523 +<616e7420746f206d616e75616c6c7920737461727420746865>-.1 F -.2<766f>108 +698.4 S<636c69656e746420696e20612073657061726174652077696e646f>.2 E 2.5 +<7762>-.25 G<65666f72652072756e6e696e6720746865207461736b20736f20796f75 +2063616e206d6f6e69746f7220746865206f757470757420666f72206572726f72206d65 +7373616765732e>-2.5 E<4e56>72 768 Q 2.5<4f56>-.4 G +<4f2d434c492050726f6a656374>-2.9 E<4a756c792032303037>126.345 E<33> +209.415 E 0 Cg EP +%%Page: 4 4 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S<444952454354>.4 E<4f52>-.18 E +301.32<592831292056>-.65 F<4f444952454354>-.4 E<4f52>-.18 E<59283129> +-.65 E/F1 10.95/Times-Bold@0 SF<5245534f55524345204341>72 84 Q +<4348494e47>-.602 E F0 3.363<4469726563746f7279207265736f6c7574696f6e20 +6973206120636f6d6d6f6e2061637469>108 96 R 3.363<76697479206f662056>-.25 +F 3.363<4f2d434c49207461736b7320616e6420736f20726573756c74732077696c6c20 +62652063616368656420696e20746865>-.4 F<24484f4d452f2e76>108 108 Q +<6f636c69656e742f63616368652f7265>-.2 E<675265736f6c76>-.15 E .364<6572 +206469726563746f7279206261736564206f6e2074686520736561726368207465726d2c +2073657276696365207479706520616e642062616e647061737320706172616d2d>-.15 +F 2.5<65746572732e2044658c6e696e67>108 120 R<746865>2.5 E/F2 10 +/Times-Italic@0 SF -.3<564f>2.5 G<435f4e4f5f4341>.3 E<434845>-.3 E F0 +<656e>2.5 E<7669726f6e6d656e742076>-.4 E<61726961626c652077696c6c206361 +75736520746865207461736b20746f2069676e6f7265207468652063616368652e>-.25 +E F1<4558414d504c4553>72 160.8 Q F0 9.17<312920476574>108 172.8 R 3.111 +<6163>3.111 G .611 +<6f756e74206f6620616c6c2074686520534941502073657276696365732061>-3.111 F +-.25<7661>-.2 G .611<696c61626c6520696e20746865204469726563746f7279>.25 +F 3.111<2c74>-.65 G .612<68656e206c697374206d6f726520696e666f726d617469 +6f6e2061626f75742065616368>-3.111 F<6f6e653a>128 184.8 Q 2.5<2576>164 +208.8 S<6f6469726563746f7279202d636f756e74202d7420696d616765>-2.7 E +<313432>164 220.8 Q 2.5<2576>164 232.8 S +<6f6469726563746f7279202d7276202d7420696d616765>-2.7 E 9.17 +<32292046696e64>108 261.6 R<616c6c20636174616c6f672028692e652e20436f6e65 +29207365727669636573207573696e6720746865207365617263682077>2.5 E +<6f7264732027>-.1 E<726164696f2720616e64202767>-.5 E<616c6178696573273a> +-.05 E 2.5<2576>164 285.6 S +<6f6469726563746f7279202d7420636174616c6f6720726164696f2067>-2.7 E +<616c6178696573>-.05 E 9.17<3329205072696e74>108 314.4 R<7468652066756c +6c207265736f75726365207265636f7264206f662074686520475343322e322063617461 +6c6f672061742053545363493a>2.5 E 2.5<2576>164 338.4 S +<6f6469726563746f7279202d6c69737420475343322e32>-2.7 E 9.17 +<34292046696e64>108 367.2 R .954<616c6c20736572766963657320776974682072 +6164696f2064617461206f66204162656c6c20636c7573746572732e>3.455 F .954<54 +68656e207072696e74207468652066756c6c206465736372697074696f6e206f66207468 +65208c727374207265636f7264>5.954 F<6173736f6369617465642077697468206f6e +65206f6620746865206d61746368696e672056>128 379.2 Q +<697a696572207461626c65733a>-.6 E 2.5<2576>164 403.2 S +<6f6469726563746f7279202d6220726164696f206162656c6c>-2.7 E 2.5<2576>164 +415.2 S<6f6469726563746f7279202d727676202d6e2031204a2f412b412f3434362f39 +372f746162>-2.7 E 9.17<35292046696e64>108 444 R +<616c6c20696d6167652073657276696365732074686174206861>2.5 E .3 -.15 +<76652057>-.2 H<46504320646174613a>.15 E 2.5<2576>164 468 S +<6f6469726563746f7279202d76202d7420696d6167652077667063>-2.7 E 9.17 +<3629205072696e74>108 496.8 R 2.5<6162>2.5 G<7265616b646f>-2.5 E +<776e206f662056>-.25 E 2.5<4f73>-.4 G<65727669636573206861>-2.5 E +<76696e67204b>-.2 E<65636b20646174613a>-.25 E 2.5<2576>164 520.8 S +<6f6469726563746f7279202d6376206b>-2.7 E<65636b>-.1 E -.1<6b65>164 532.8 +S 25<636b20313232>.1 F<284361743a2032>7.5 E -.8<5461>5 G +<623a2031313720534e6f64653a2031>.8 E<4f746865723a203229>5 E 9.17 +<3729205072696e74>108 561.6 R 2.617<6163>2.617 G .118 +<6f756e74206f66207365727669636573206861>-2.617 F .118<76696e6720616c6c20 +6f66204368616e6472612c2048535420616e6420537069747a657220646174612c207468 +656e20627265616b20697420646f>-.2 F .118<776e2062792065616368206d69732d> +-.25 F<73696f6e3a>128 573.6 Q 2.5<2576>164 597.6 S +<6f6469726563746f7279202d63206368616e6472612068737420737069747a6572>-2.7 +E<6368616e6472612068737420737069747a6572>164 609.6 Q<33>22.5 E 2.5<2576> +164 621.6 S +<6f6469726563746f7279202d636f206368616e6472612068737420737069747a6572> +-2.7 E 45<6368616e64726120333233>164 633.6 R 55<68737420343433>164 645.6 +R 47.5<737069747a6572203331>164 657.6 R 9.17<3829205072696e74>108 686.4 +R<74686520636f6c756d6e206d657461646174612072657475726e656420627920746865 +20475343322e3220736572766963653a>2.5 E 2.5<2576>164 710.4 S +<6f6469726563746f7279202d6d65746120677363322e32>-2.7 E<4e56>72 768 Q 2.5 +<4f56>-.4 G<4f2d434c492050726f6a656374>-2.9 E<4a756c792032303037>126.345 +E<34>209.415 E 0 Cg EP +%%Page: 5 5 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S<444952454354>.4 E<4f52>-.18 E +301.32<592831292056>-.65 F<4f444952454354>-.4 E<4f52>-.18 E<59283129> +-.65 E 9.17<392920557365>108 84 R .669<746865204144514c2071756572792066 +6f726d617420746f208c6e6420736572766963657320696e207768696368204853542077> +3.169 F .669<61732074686520757365642c20616e64206e6f742073696d706c792061 +206d61746368206f66>-.1 F +<274853542720696e20746865207265736f75726365207265636f72643a>128 96 Q 2.5 +<2576>164 120 S<6f6469726563746f7279202246>-2.7 E +<6163696c697479206c696b>-.15 E 2.5<6527>-.1 G<4853542722>-2.5 E .064 +<4e6f746520746861742075736520617373756d6564206b6e6f>128 144 R .064<776c +65646765206f6620746865204469726563746f7279206265696e6720717565726965642c +2073706563698c63616c6c7920746861742074686572652065>-.25 F .064 +<78697374732061202746>-.15 F<6163696c2d>-.15 E<69747927208c656c64207769 +7468207468697320696e666f726d6174696f6e20616e642074686174207468652073796e +746178206f66207468652071756572792072657175697265732074686520737472696e67 +20746f20626520696e2071756f7465732e>128 156 Q<31302920557365207468652041 +44514c20717565727920666f726d617420746f208c6e6420736572766963657320696e20 +776869636820274b>108 184.8 Q<65636b27206170706561727320696e>-.25 E +<7468652054>128 196.8 Q<69746c65206f6620746865207265736f757263653a>-.35 +E 2.5<2576>164 220.8 S<6f6469726563746f7279202254>-2.7 E +<69746c65206c696b>-.35 E 2.5<6527>-.1 G<254b>-2.5 E<65636b252722>-.25 E +<6f72>200 244.8 Q 2.5<2563>164 268.8 S<6174207175657279>-2.5 E<2e747874> +-.65 E -.35<5469>164 280.8 S<746c65206c696b>.35 E 2.5<6527>-.1 G<254b> +-2.5 E<65636b2527>-.25 E 2.5<2563>164 292.8 S<6174207175657279>-2.5 E +<2e747874207c2076>-.65 E<6f6469726563746f7279>-.2 E .475<4e6f7465207468 +61742068657265207765207573652074686520272527206f70657261746f722061726f75 +6e642074686520737472696e6720736f207468617420776520706572666f726d20612073 +7562737472696e67206d61746368206f6e20746865>128 316.8 R +<656e74697265207469746c652e>128 328.8 Q<4173206265666f72652c207468652041 +44514c20737472696e6720697473656c66206d75737420626520656e636c6f7365642069 +6e20646f75626c652071756f7465732e>5 E +<3131292046696e6420616c6c207265736f7572636573207468617420617265206e65> +108 357.6 Q<776c79207265>-.25 E +<676973746572656420696e20746865206c6173742033206d6f6e7468732c207468656e> +-.15 E .538<8c6e64206f6e6c792074686f7365207265736f7572636573206465616c69 +6e6720776974682022636f6f6c207374617273222c20616e64208c6e616c6c79206a7573 +74207072696e74206120636f756e74206f66207265736f75726365732075706461746564> +128 369.6 R<696e20746865206c61737420796561723a>128 381.6 Q 2.5<2576>164 +405.6 S<6f6469726563746f7279202d2d6e65>-2.7 E 2.5<7733>-.25 G<6d>-2.5 E +2.5<2576>164 417.6 S<6f6469726563746f7279202d2d6e65>-2.7 E 2.5<7733>-.25 +G 2.5<6d63>-2.5 G<6f6f6c207374617273>-2.5 E 2.5<2576>164 429.6 S +<6f6469726563746f7279202d2d757064617465642031326d202d2d636f756e74>-2.7 E +/F1 10.95/Times-Bold@0 SF -.11<4255>72 470.4 S<4753>.11 E F0 +<536f6d6520736572766963657320646f6e27>108 482.4 Q 2.5<7472>-.18 G<65706f +6e642070726f7065726c7920746f20746865206d6574616461746120717565727920616e +642077696c6c207072696e74206120226e6f20617474726962>-2.5 E +<7574657320666f756e6422206d6573736167652e>-.2 E F1<5265>72 499.2 Q +<766973696f6e20486973746f7279>-.164 E F0 +<4a756e652032303037202d2054686973207461736b206973206e65>108 511.2 Q -.65 +<772e>-.25 G F1 -.548<4175>72 528 S<74686f72>.548 E F0<4d69636861656c20 +4669747a7061747269636b20288c747a406e6f616f2e656475292c204a756c7920323030 +37>108 540 Q F1<53454520414c534f>72 556.8 Q F0 -.2<766f>108 568.8 S +<636c69656e742831292c2076>.2 E<6f636c69656e74642831292c2076>-.2 E +<6f736573616d652831292c2076>-.2 E<6f64617461283129>-.2 E<4e56>72 768 Q +2.5<4f56>-.4 G<4f2d434c492050726f6a656374>-2.9 E<4a756c792032303037> +126.345 E<35>209.415 E 0 Cg EP +%%Trailer +end +%%EOF diff --git a/vendor/voclient/doc/OLD/vosamp.man b/vendor/voclient/doc/OLD/vosamp.man new file mode 100644 index 00000000..7f7e328e --- /dev/null +++ b/vendor/voclient/doc/OLD/vosamp.man @@ -0,0 +1,342 @@ +.\" @(#)vosamp.1 1.0 Feb-2013 MJF +.TH VOSAMP 1 "Feb 2013" "VOClient Package" +.SH NAME +vosamp \- command-line SAMP utility task + +.SH SYNOPSIS +\fBvosamp\fP [-t to] [-p pattern] [-f file] <cmd> [args ...] + +.SH OPTIONS +The \fIvosamp\fP application accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.TP 6 +.B -i, --interact +Interactive mode. If enabled, a command prompt will be printed allowing +users to enter commands interactively until an <EOF> is encountered. +.TP 6 +.B -m, --many +Handle multiple messages when in listening mode. If not enabled, +\fIvosamp\fP can be called to wait for a specific message and will exit when +it is received, otherwise the task will continue to run and process +multiple messages. +.TP 6 +.B -s \fISENDER\fP, --sender \fISENDER\fP +Handle only messages from \fIsender\fP. +.TP 6 +.B -q, --quiet +Suppress all output. + +.TP 6 +.B -t \fITO\fP, --to \fITO\fP +Send to specified app (or all apps if not given). The \fITO\fP argument +may be given as either an application public ID or the application name. +.TP 6 +.B -p \fIPATTERN\fP, --pattern \fIPATTERN\fP +Messaging pattern to use when sending messages. The default mode +is 'async' to send messages asychrnously, other allowed values are 'sync' +for syncronous messages and 'notify' to broadcast without expecting a +response. +.TP 6 +.B -f \fIFILE\fP, --file \fIFILE\fP +Send all commands in the \fIFILE\fP argument. This mode allows the task to +take command input from a text file to process multiple commands with a +single invocation. +.TP 6 +.B -n, --nokeepalive +Disable \fIkeep_alive\fP feature of the task. If the \fI-n\fP flag is used, +a separate connection to the SAMP Hub will be made for each command processed. + +.TP 6 +.B -P \fIIP\fP, --proxy \fIIP\fP +Use specfied IP as the proxy connection. See the discussion below about the +\fIkeep_alive\fP feature for details on how to use this flag. +.TP 6 +.B -T \fIN\fP, --timeout \fIN\fP +Keepalive timeout in seconds. If no new command is received after \fIN\fP +seconds the application will disconnect from the Hub automatically. +.TP 6 +.B -S \fINAME\fP, --session \fINAME\fP +Name of the SAMP session. See below for a description of sessions. + +.SH DESCRIPTION +The \fIvosamp\fP task may be used to send and receive SAMP (Simple +Application Messaging Protocol) messages from the command-line or within a +script. It provides a user-friendly command interface that hides the details +of the message construction and delivery for common tasks. By default, +a message will be broadcast to all other SAMP-enabled applications, the +\fI-t\fP (or \fI--to\fP) flag can be used to name a specific receipient by +either the public ID or the application name, the \fI-p\fP flag will accept +a 'sync' or 'notify' argument to change the default message pattern of +asynchronous delivery. +.PP +In order to minimize the overhead of connecting with the Hub on each command, +\fIvosamp\fP will spawn a proxy process that remains connected to the Hub and +will process subsequent commands transparently. This proxy process will +timeout after some period of inactivity and may be accessed from remote +machines (see below for more information). + + +.SH COMMAND SUMMARY +.PP +The \fIvosamp\fP task accepts the following commands, specified either on +the command-line argument list or in interactive mode: + +.in 10 +.B snoop +.in 16 +Print all received messages. + +.in 10 +.B send <mtype> [<args>...] +.in 16 +Generalized message send. The <mtype> parameter can be either one of +the well-known SAMP mtypes or an ad hoc mtype that can be expected to be +recognized by other apps in the session. The \fI<args>\fP parameter refers +to any of the arguments necessary for the specifed mtype. The \fI<args>\fP +may be specified as a sequence of values and will be delivered using +parameter names of the form "argN", to send named parameters the argument +must be specified as "<name>:<value>". + +.in 10 +.B status +.in 16 +Print Hub availability. + +.in 10 +.B list +.in 16 +List all registered clients. + +.in 10 +.B access <appName> +.in 16 +Print <appName> availability. The \fIappName\fP may be specified as either +the public ID or application name. + +.in 10 +.B handle <mtype> +.in 16 +Wait for <mtype> message to be received. This command will subscribe the task +to the specified <mtype> and when it is received will print the contents of +the message to the stdout stream. If the \fI--verbose\fP flag is used the +first value printed will be the sender-id, otherwise the first value will be +the <mtype> followed by the message parameters in the form "<name>=<value>". +Using the \fI--quiet\fP argument will suppress output and simply cause the +task to exit. Use of this command implicitly sets the \fI--nokeepalive\fP +flag. + +.in 10 +.B load <url> +.in 16 +Load the image or table given by \fI<url>\fP. The type of file and the +appropriate SAMP \fImtype\fP are determined automatically. + +.in 10 +.B loadImage <url> +.in 16 +Load the named image. The \fIimage.load.fits\fP mtype will be used for +the message. + +.in 10 +.B loadVOTable <url> +.in 16 +Load the named VOTable. The \fItable.load.votable\fP mtype will be used for +the message. + +.in 10 +.B loadFITS <url> +.in 16 +Load the named FITS bintable. The \fItable.load.fits\fP mtype will be used +for the message. + +.in 10 +.B loadSpec <url> +.in 16 +Load the named spectrum. The \fIspectrum.load.ssa-generic\fP mtype will be +used for the message. + +.in 10 +In the above commands, the \fI<url>\fP may be an explicit URI containing +an 'http' or 'file' prefix, if a filename or directory path is specified +the URL will be constructed internally when sending the message. + +.in 10 +.B pointAt <ra> <dec> +.in 16 +Point at given coords. The <ra> and <dec> parameters are assumed to be ICRS +coordinates in decimal degrees, the \fIcoord.pointAt.sky\fP mtype is used. + +.in 10 +.B showRow [<url>] [<id>] <row> +.in 16 +Highlight specified <row> (zero-indexed). The table may be specified using +either a <url> or a table <id> if one was specified at the time the table +was loaded, the \fItable.highlight.row\fP mtype is used. + +.in 10 +.B selectRows [<url>] [<id>] <rows> +.in 16 +Select specified rows. (zero-indexed) The table may be specified using +either a <url> or a table <id> if one was specified at the time the table +was loaded, the \fItable.select.rowList\fP mtype is used. The <rows> +argument is specified as a comma-delimited list of row numbers or ranges, +where \fIranges\fP are hyphen-delimited strings (e.g. "1,3,5-9,11-15"). + +.in 10 +.B bibcode <bibcode> +.in 16 +Load the specified bibcode. The \fIbibcode.load\fP mtype is used. + + +.in 10 +.B exec <cmd> +.in 16 +Execute a client command. The <cmd> string is sent to the client unchanged, +it is up to the client to interpret the command properly. +The \fIclient.cmd.exec\fP mtype is used. + +.in 10 +.B setenv <name> <value> +.in 16 +Set an environment value. The \fIclient.env.set\fP mtype is used. + +.in 10 +.B getenv <name> +.in 16 +Get an environment value. The value of the requested variable is printed. +The \fIclient.env.get\fP mtype is used. + +.in 10 +.B setparam <name> <value> +.in 16 +Set a parameter value. The \fIclient.param.set\fP mtype is used. + +.in 10 +.B getparam <name> +.in 16 +Get a parameter value. The value of the requested variable is printed. +The \fIclient.param.get\fP mtype is used. + + +.in 10 +.B session list +.in 16 +List nodes in current session. + +.in 10 +.B session leave|exit|logout +.in 16 +Leave the current session. + +.in 10 +.B session <name> +.in 16 +Join the named session. + + +.SH KEEP-ALIVE CONNECTIONS AND SESSIONS +.PP +In the standard SAMP interaction, and application is required to first +register with the \fIHub\fP before sending or receiving messages. This +registration can add significant overhead to an application that may only +send a single message, significantly slowing it's use within a scripting +environment. Unless the \fI-n\fP (or \fI--nokeepalive\fP) flag is set, +the first time VOSAMP is started it will execute the specified command +and then fork a child process that stays connected to the Hub. Subsequent +VOSAMP calls will simply forward the command to this child proxy process, +thereby avoiding a new Hub registration. +.PP +The proxy process by default will listen on inet port 3999 (as of this writing +there is no option to change it) for new commands, however there is no +restriction that the only application that can connect to it must be running +on the same host. The \fI-P\fP (or \fI--proxy\fP) flag can be used to +specify an alternate proxy to be used; the argument is of the form +.in 15 +\fInode\fP [ ':' \fIport\fP ] +.PP +where \fInode\fP can be a simple host name, a fully-qualified domain name or +and IP address, and \fIport\fP number number is optional. The proxy will +run for up to an hour if no new commands are received before disconnecting +from the Hub, this timeout value may be changed by using the \fI-T\fP flag +to specify the timeout in seconds. + +.PP +SAMP \fISessions\fP are an experimental concept in which \fIvosamp\fP +tasks on separate machines register independently with their local Hub, +but also register with the \fIvosession\fP task running elsewhere. Commands +which are sent to the local child proxy are also forwarded to the +\fIvosession\fP instance and then on to other vosamp clients registered in +the same session. The \fIsession\fP commands allow a vosamp client to +register with a new session, list the other machines involved in the session +and later leave the sessions. Commands which require a URL will upload +local data to the \fIvosession\fP manager and rewrite the URL appropiately +so it may be served to the other vosamp clients. Since SAMP is designed +only for local desktop messaging, this approach provides a means to share +messages and data between desktops (e.g. when working collaboratively with +colleagues). See the \fIvosession\fP man page or contact the author for +further information on using this feature. + + +.SH RETURN STATUS +On exit the \fBvosamp\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Load a VOTable to Topcat: + +.nf + % vosamp load /path/example.xml + % vosamp load http://foo.edu/example.xml + % vosamp load http://foo.edu/query?RA=0.0&DEC=0.0&SR=0.1 +.fi +.TP 4 +2) Send a command string to IRAF: + +.nf + % vosamp -t iraf exec "display dev$pix 1" +.fi +.TP 4 +3) List all clients in a SAMP session: + +.nf + % vosamp list +.fi +.TP 4 +4) Check whether a Hub is available from a script: + +.nf + set isHub = `vosamp access Hub` + if ($isHub == "no") then + echo "No Hub available, quitting ....." + exit $status + endif +.fi + + + +.SH BUGS +No known bugs with this release. +.SH KNOWN SHORTCOMINGS +No known bugs with this release. +.in 4 +- The 'handle' command should allow a command to be executed with message argument substitution. +.in 4 +- A flag is needed to change the child proxy port being used + +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +vosession +.PP +The description of commonly used SAMP mtypes is gen at + +.in 9 +http://wiki.ivoa.net/twiki/bin/view/IVOA/SampMTypes + diff --git a/vendor/voclient/doc/OLD/vosesame.html b/vendor/voclient/doc/OLD/vosesame.html new file mode 100644 index 00000000..f15a2e57 --- /dev/null +++ b/vendor/voclient/doc/OLD/vosesame.html @@ -0,0 +1,348 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOSESAME</TITLE> +</HEAD><BODY> +<H1>VOSESAME</H1> +Section: User Commands (1)<BR>Updated: July 2007<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +vosesame - call the Sesame name resolver service +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>vosesame</B> [-<I>adefhinstACHT</I>] [<I>file</I> | <I>target</I> ] [ ... ] +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>vosesame</I> task accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<DT><B>-q, --quiet</B> + +<DD> +Quiet mode (suppress warning output). +<DT><B>-v, --verbose</B> + +<DD> +Verbose output. Normally used to print warnings when an object could not be +resolved. +<DT>The following flags may be combined as a single option to indicate the<DD> +desired output fields. The order of the flags implies the order of the +output values, e.g. "-dnt" prints the decimal position, name and type in +that order. +<DT><B>-a, --all</B> + +<DD> +Output all available information about the object. +<DT><B>-d, --decimal</B> + +<DD> +Output the position as J2000 decimal degrees. This is the default output if +no format flags are specified. +<DT><B>-e, --errors</B> + +<DD> +Output the estimated position errors. +<DT><B>-n, --name</B> + +<DD> +Output the object name. +<DT><B>-t, --type</B> + +<DD> +Output the object type. +<DT><B>-s, --sex</B> + +<DD> +Output the position as sexagesimal RA and Dec. +<P> +<DT>Control Flags:<DD> +<DT><B>-c <ra> <dec> or -c <ra>,<dec> or --coord-<ra>,<dec></B> + +<DD> +Specify a coordinate to be explicitly used. If set an RA and DEC are +expected as either the next argument if they are a comma-separated string, +or as the next two arguments. Values may be input as floating point +decimal or sexagesimal strings. Upon receipt, the task will create an +artifical record for the object and output the values requested with the +output flags described above. Multiple <I>-c</I> options may be specified +may be specified and mixed with object names, user coordinates are processed +before the object names are resolved in the order they occur on the command +line. +<DT><B>-i, --invert</B> + +<DD> +Invert the sense of the search and print only objects which cannot be +resolved to coordinates. +<DT><B>-f, --force</B> + +<DD> +Force the object(s) to be resolved even if it is cached. This option will +cause the task to call the Sesame service rather than output a previously +cached value, however the result will still be cached unless the VOC_NO_CACHE +environment variable is defined. +<DT><B>-o <name> or --output=<name></B> + +<DD> +Specify the output file. The default is to write the results to the +standard output. +<P> +<DT>Formatting Flags:<DD> +<DT><B>-A, --ascii</B> + +<DD> +Print the results as a whitespace delimited ascii table. If an output file +is specified it will have a ".txt" extension appended automatically. +<DT><B>-C, --csv</B> + +<DD> +Print the results as a comma-separated-value (CSV) table. If an output file +is specified it will have a ".csv" extension appended automatically. +<DT><B>-H, --header</B> + +<DD> +Print a table header. The table header will be a single line beginning with +a '#' character to indicate a comment, and followed by the name of each +column in the specified format. +<DT><B>-T, --tsv</B> + +<DD> +Print the results as a tab-separated-value (TSV) table. If an output file +is specified it will have a ".csv" extension appended automatically. +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>vosesame</I> task provides a command-line interface to the +<I>Sesame</I> name +resolver service at CDS that convert a familiar object name to the J2000 +coordinates required by VO services. Additional information +such such as the object type is also available. The <I>Sesame</I> service +queries NED, Simbad and Vizier databases for this information. If no +flags are provided, the default output is simply the RA and Dec of the +object in decimal degrees (this is what most VO services expect), however +command-line flags provide a method to specify the desired output and +the order in which they are printed. +<P> + +Object names may be specified on the commandline individually (multiple +arguments are allowed), as the name of a file containing a list of +objects to be resolved, or both. If no object or file names are given on +the command line the task will read from the standard input, allowing the +task to be used as a command filter or interactively from the keyboard. +Files containing object names are assumed +to list the name of one object-per-line where whitespace in the object name +is allowed on the line (e.g. "M 51"). From the command line, most shell +interpreters will require that the whitespace be escaped (e.g. "M 51") +so it is interpreted properly. A warning will be printed if an object name +cannot be resolved and the <I>-v</I> verbose flag is set, otherwise no +output will be printed for the failed request. +<P> + +The <I>OPTIONS</I> section describes the formatting options available. +For each of these options, the order in which it appears controls the order of +where it appears in the output string for the object. Output format +flags control how the values are printed. Supported formats include +comma-separated-values (CSV, the <I>-C</I> flag), tab-separated-values (TSV, +the <I>-T</I> flag), whitespace-delimited values (the <I>-A</I> default), +and may include an optional head (the <I>-H</I>) flag) that precedes the +output with a line of text listing the output colums where the first +character of the header is a '#' to indicate a comment. +<P> +<A NAME="lbAF"> </A> +<H2>VOCLIENT DAEMON PROCESSING</H2> + +All VO-CLI tasks are built upon the VOClient interface an rely on a +separate <I>voclientd</I> process to provide the VO functionality. The +voclientd task is distributed as part of VO-CLI and will be started +automatically by each task if it is not already running. If problems +are encountered, you may want to manually start the voclientd in a separate +window before running the task so you can monitor the output for error +messages. +<P> +<A NAME="lbAG"> </A> +<H2>OBJECT CACHING</H2> + +The <B>Sesame</B> service at CDS is normally fairly reliable, however there +are times when it is either unavailable, or simply returns a null result +without indicating an error. Additionally, the access time is on the +order of ~1 sec/object and so resolving many objects creates an overhead +for applications using this service. +<P> + +The <B>vosesame</B> task's only function is to resolve objects, however it +still uses the object caching capability in the VOClient interface. Once +an object is resolved, it will automatically be cached unless the +<B>VOC_NO_CACHE</B> environment variable is defined. The <I>-f</I> +command-line option can be used to override any existing cached values and +force the Sesame service to be invoked. The object cache may be initialized +completely by deleting the $HOME/.voclient/cache/sesame directory. +<P> +<A NAME="lbAH"> </A> +<H2>RETURN STATUS</H2> + +If all objects were successfully resolved the task will exit with a +status code of 0. If one or more of the objects failed to be resolved for +any reason, the exit status will be the number of unresolved objects. +<P> +<P> +<A NAME="lbAI"> </A> +<H2>EXAMPLES</H2> + +<P> +<DL COMPACT> +<DT>1)<DD> +Print the coordinates of NGC4456, first in decimal degrees and +then as sexagesimal values: +<P> +<PRE> + % vosesame ngc4456 + 186.960000 -30.120000 + % vosesame -s ngc4456 + 12:27.8 -30:07 +</PRE> + +<P> +<DT>2)<DD> +Print the sexagesimal coordinates of multiple objects, include the type: +<P> +<PRE> + % vosesame -st m31 m51 m99 + 00:42:44.31 +41:16:09.4 LINER + 13:29:52.36 +47:11:40.8 Seyfert_2 + 12:18:49.51 +14:25:00.4 HII_G +</PRE> + +<P> +<DT>3)<DD> +Print the decimal coordinates of those same objects listed in +the file 'myobjs.txt', output as CSV, include a header, and print +the id, coords, and type: +<P> +<PRE> + % vosesame -CHndt myobjs.txt + #Name,DRA,DDEC,Type, + m31,10.684625,41.269278,LINER + m51,202.468208,47.194667,Seyfert_2 + m99,184.706333,14.416778,HII_G + : : : : +</PRE> + +<P> +<DT>4)<DD> +Extract the object names from column 17-25 of a file and pipe the +list to vosesame to create a new table of id, ra and dec: +<P> +<PRE> + % cut -c17-25 data.txt | vosesame -ns + m51 13:29:52.36 +47:11:40.8 + m23 17:57:00.00 -18:58:59.9 + m67 08:51:17.99 +11:48:00.0 + : : : +</PRE> + +<P> +<DT>5)<DD> +Interactively resolve coordinates by enterying object names on the +standard input: +<PRE> + + % vosesame -a + m98 + m98 12:13:48.37 +14:53:57.9 183.45154 14.89944 10.0 10.0 LINER + [EOF] + +</PRE> + +Type the EOF character (typically Ctrl-D or Ctrl-Z) to quit. +<P> +<P> +<DT>6)<DD> +Print the sexagesimal and decimal values for multiple user coords: +<PRE> + + % vosesame -sd -c 12:30:0.0 -45:00:0.0 -c 187.5 2.05 + 12:30:00.0 -45:00:00.0 12.500000 -45.000000 + 12:30:00.0 02:03:00.0 187.500000 2.050000 + +</PRE> + +<P> +<P> +</DL> +<A NAME="lbAJ"> </A> +<H2>BUGS</H2> + +The Sesame service can sometimes respond without resolving the object. In +this case all values are returned as zero or a null string. <I>Vosesame</I> +will sense this as a non-response and not print a result. If the +<I>verbose</I> flag is set a warning message will be printed. +<A NAME="lbAK"> </A> +<H2>Revision History</H2> + +June 2007 - This task is new. +<A NAME="lbAL"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), July 2007 +<A NAME="lbAM"> </A> +<H2>SEE ALSO</H2> + +<A HREF="http://localhost/cgi-bin/man/man2html?1+voclient">voclient</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+voclientd">voclientd</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+vodirectory">vodirectory</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+vodata">vodata</A>(1) +<A NAME="lbAN"> </A> +<H2>BUGS</H2> + +The Sesame service can sometimes respond without resolving the object. In +this case all values are returned as zero or a null string. <I>Vosesame</I> +will sense this as a non-response and not print a result. If the +<I>verbose</I> flag is set a warning message will be printed. +<A NAME="lbAO"> </A> +<H2>Revision History</H2> + +June 2007 - This task is new. +<A NAME="lbAP"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), July 2007 +<A NAME="lbAQ"> </A> +<H2>SEE ALSO</H2> + +<A HREF="http://localhost/cgi-bin/man/man2html?1+voclient">voclient</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+voclientd">voclientd</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+vodirectory">vodirectory</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+vodata">vodata</A>(1) +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">VOCLIENT DAEMON PROCESSING</A><DD> +<DT><A HREF="#lbAG">OBJECT CACHING</A><DD> +<DT><A HREF="#lbAH">RETURN STATUS</A><DD> +<DT><A HREF="#lbAI">EXAMPLES</A><DD> +<DT><A HREF="#lbAJ">BUGS</A><DD> +<DT><A HREF="#lbAK">Revision History</A><DD> +<DT><A HREF="#lbAL">Author</A><DD> +<DT><A HREF="#lbAM">SEE ALSO</A><DD> +<DT><A HREF="#lbAN">BUGS</A><DD> +<DT><A HREF="#lbAO">Revision History</A><DD> +<DT><A HREF="#lbAP">Author</A><DD> +<DT><A HREF="#lbAQ">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 20:46:31 GMT, May 21, 2009 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/OLD/vosesame.man b/vendor/voclient/doc/OLD/vosesame.man new file mode 100644 index 00000000..4e5d5f5c --- /dev/null +++ b/vendor/voclient/doc/OLD/vosesame.man @@ -0,0 +1,260 @@ +.\" @(#)vosesame.1 1.0 June-07 MJF +.TH VOSESAME 1 "July 2007" "NVO VO-CLI Project" +.SH NAME +vosesame \- call the Sesame name resolver service +.SH SYNOPSIS +\fBvosesame\fP [\-\fIadefhinstACHT\fP] [\fIfile\fP | \fItarget\fP ] [ ... ] + +.SH OPTIONS +The \fIvosesame\fP task accepts the following options: +.TP 8 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. +.TP 8 +.B \-q, --quiet +Quiet mode (suppress warning output). +.TP 8 +.B \-v, --verbose +Verbose output. Normally used to print warnings when an object could not be +resolved. +.TP 0 +The following flags may be combined as a single option to indicate the +desired output fields. The order of the flags implies the order of the +output values, e.g. "-dnt" prints the decimal position, name and type in +that order. +.TP 8 +.B \-a, --all +Output all available information about the object. +.TP 8 +.B \-d, --decimal +Output the position as J2000 decimal degrees. This is the default output if +no format flags are specified. +.TP 8 +.B \-e, --errors +Output the estimated position errors. +.TP 8 +.B \-n, --name +Output the object name. +.TP 8 +.B \-t, --type +Output the object type. +.TP 8 +.B \-s, --sex +Output the position as sexagesimal RA and Dec. + +.TP 0 +Control Flags: +.TP 8 +.B \-c <ra> <dec> or \-c <ra>,<dec> or \--coord-<ra>,<dec> +Specify a coordinate to be explicitly used. If set an RA and DEC are +expected as either the next argument if they are a comma-separated string, +or as the next two arguments. Values may be input as floating point +decimal or sexagesimal strings. Upon receipt, the task will create an +artifical record for the object and output the values requested with the +output flags described above. Multiple \fI-c\fP options may be specified +may be specified and mixed with object names, user coordinates are processed +before the object names are resolved in the order they occur on the command +line. +.TP 8 +.B \-i, --invert +Invert the sense of the search and print only objects which cannot be +resolved to coordinates. +.TP 8 +.B \-f, --force +Force the object(s) to be resolved even if it is cached. This option will +cause the task to call the Sesame service rather than output a previously +cached value, however the result will still be cached unless the VOC_NO_CACHE +environment variable is defined. +.TP 8 +.B \-o <name> or --output=<name> +Specify the output file. The default is to write the results to the +standard output. + +.TP 0 +Formatting Flags: +.TP 8 +.B \-A, --ascii +Print the results as a whitespace delimited ascii table. If an output file +is specified it will have a ".txt" extension appended automatically. +.TP 8 +.B \-C, --csv +Print the results as a comma-separated-value (CSV) table. If an output file +is specified it will have a ".csv" extension appended automatically. +.TP 8 +.B \-H, --header +Print a table header. The table header will be a single line beginning with +a '#' character to indicate a comment, and followed by the name of each +column in the specified format. +.TP 8 +.B \-T, --tsv +Print the results as a tab-separated-value (TSV) table. If an output file +is specified it will have a ".csv" extension appended automatically. + +.SH DESCRIPTION +The \fIvosesame\fP task provides a command-line interface to the +\fISesame\fP name +resolver service at CDS that convert a familiar object name to the J2000 +coordinates required by VO services. Additional information +such such as the object type is also available. The \fISesame\fP service +queries NED, Simbad and Vizier databases for this information. If no +flags are provided, the default output is simply the RA and Dec of the +object in decimal degrees (this is what most VO services expect), however +command-line flags provide a method to specify the desired output and +the order in which they are printed. +.PP +Object names may be specified on the commandline individually (multiple +arguments are allowed), as the name of a file containing a list of +objects to be resolved, or both. If no object or file names are given on +the command line the task will read from the standard input, allowing the +task to be used as a command filter or interactively from the keyboard. +Files containing object names are assumed +to list the name of one object-per-line where whitespace in the object name +is allowed on the line (e.g. "M 51"). From the command line, most shell +interpreters will require that the whitespace be escaped (e.g. "M\ 51") +so it is interpreted properly. A warning will be printed if an object name +cannot be resolved and the \fI-v\fP verbose flag is set, otherwise no +output will be printed for the failed request. +.PP +The \fIOPTIONS\fP section describes the formatting options available. +For each of these options, the order in which it appears controls the order of +where it appears in the output string for the object. Output format +flags control how the values are printed. Supported formats include +comma-separated-values (CSV, the \fI-C\fP flag), tab-separated-values (TSV, +the \fI-T\fP flag), whitespace-delimited values (the \fI-A\fP default), +and may include an optional head (the \fI-H\fP) flag) that precedes the +output with a line of text listing the output colums where the first +character of the header is a '#' to indicate a comment. + +.SH VOCLIENT DAEMON PROCESSING +All VO-CLI tasks are built upon the VOClient interface an rely on a +separate \fIvoclientd\fP process to provide the VO functionality. The +voclientd task is distributed as part of VO-CLI and will be started +automatically by each task if it is not already running. If problems +are encountered, you may want to manually start the voclientd in a separate +window before running the task so you can monitor the output for error +messages. + +.SH OBJECT CACHING +The \fBSesame\fP service at CDS is normally fairly reliable, however there +are times when it is either unavailable, or simply returns a null result +without indicating an error. Additionally, the access time is on the +order of ~1 sec/object and so resolving many objects creates an overhead +for applications using this service. +.PP +The \fBvosesame\fP task's only function is to resolve objects, however it +still uses the object caching capability in the VOClient interface. Once +an object is resolved, it will automatically be cached unless the +\fBVOC_NO_CACHE\fP environment variable is defined. The \fI-f\fP +command-line option can be used to override any existing cached values and +force the Sesame service to be invoked. The object cache may be initialized +completely by deleting the $HOME/.voclient/cache/sesame directory. + +.SH RETURN STATUS +If all objects were successfully resolved the task will exit with a +status code of 0. If one or more of the objects failed to be resolved for +any reason, the exit status will be the number of unresolved objects. + + +.SH EXAMPLES + +.TP 4 +1) +Print the coordinates of NGC4456, first in decimal degrees and +then as sexagesimal values: + +.nf + % vosesame ngc4456 + 186.960000 -30.120000 + % vosesame -s ngc4456 + 12:27.8 -30:07 +.fi + +.TP 4 +2) +Print the sexagesimal coordinates of multiple objects, include the type: + +.nf + % vosesame -st m31 m51 m99 + 00:42:44.31 +41:16:09.4 LINER + 13:29:52.36 +47:11:40.8 Seyfert_2 + 12:18:49.51 +14:25:00.4 HII_G +.fi + +.TP 4 +3) +Print the decimal coordinates of those same objects listed in +the file 'myobjs.txt', output as CSV, include a header, and print +the id, coords, and type: + +.nf + % vosesame -CHndt myobjs.txt + #Name,DRA,DDEC,Type, + m31,10.684625,41.269278,LINER + m51,202.468208,47.194667,Seyfert_2 + m99,184.706333,14.416778,HII_G + : : : : +.fi + +.TP 4 +4) +Extract the object names from column 17-25 of a file and pipe the +list to vosesame to create a new table of id, ra and dec: + +.nf + % cut -c17-25 data.txt | vosesame -ns + m51 13:29:52.36 +47:11:40.8 + m23 17:57:00.00 -18:58:59.9 + m67 08:51:17.99 +11:48:00.0 + : : : +.fi + +.TP 4 +5) +Interactively resolve coordinates by enterying object names on the +standard input: +.nf + + % vosesame -a + m98 + m98 12:13:48.37 +14:53:57.9 183.45154 14.89944 10.0 10.0 LINER + [EOF] + +.fi +Type the EOF character (typically Ctrl-D or Ctrl-Z) to quit. + + +.TP 4 +6) +Print the sexagesimal and decimal values for multiple user coords: +.nf + + % vosesame -sd -c 12:30:0.0 -45:00:0.0 -c 187.5 2.05 + 12:30:00.0 -45:00:00.0 12.500000 -45.000000 + 12:30:00.0 02:03:00.0 187.500000 2.050000 + +.fi + + +.SH BUGS +The Sesame service can sometimes respond without resolving the object. In +this case all values are returned as zero or a null string. \fIVosesame\fP +will sense this as a non-response and not print a result. If the +\fIverbose\fP flag is set a warning message will be printed. +.SH Revision History +June 2007 - This task is new. +.SH Author +Michael Fitzpatrick (fitz@noao.edu), July 2007 +.SH "SEE ALSO" +voclient(1), voclientd(1), vodirectory(1), vodata(1) +.SH BUGS +The Sesame service can sometimes respond without resolving the object. In +this case all values are returned as zero or a null string. \fIVosesame\fP +will sense this as a non-response and not print a result. If the +\fIverbose\fP flag is set a warning message will be printed. +.SH Revision History +June 2007 - This task is new. +.SH Author +Michael Fitzpatrick (fitz@noao.edu), July 2007 +.SH "SEE ALSO" +voclient(1), voclientd(1), vodirectory(1), vodata(1) diff --git a/vendor/voclient/doc/OLD/vosesame.pdf b/vendor/voclient/doc/OLD/vosesame.pdf Binary files differnew file mode 100644 index 00000000..8fa23edc --- /dev/null +++ b/vendor/voclient/doc/OLD/vosesame.pdf diff --git a/vendor/voclient/doc/OLD/vosesame.ps b/vendor/voclient/doc/OLD/vosesame.ps new file mode 100644 index 00000000..b852749e --- /dev/null +++ b/vendor/voclient/doc/OLD/vosesame.ps @@ -0,0 +1,604 @@ +%!PS-Adobe-3.0 +%%Creator: groff version 1.18.1 +%%CreationDate: Thu May 21 13:46:31 2009 +%%DocumentNeededResources: font Times-Roman +%%+ font Times-Bold +%%+ font Times-Italic +%%DocumentSuppliedResources: procset grops 1.18 1 +%%Pages: 4 +%%PageOrder: Ascend +%%Orientation: Portrait +%%EndComments +%%BeginProlog +%%BeginResource: procset grops 1.18 1 +/setpacking where{ +pop +currentpacking +true setpacking +}if +/grops 120 dict dup begin +/SC 32 def +/A/show load def +/B{0 SC 3 -1 roll widthshow}bind def +/C{0 exch ashow}bind def +/D{0 exch 0 SC 5 2 roll awidthshow}bind def +/E{0 rmoveto show}bind def +/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def +/G{0 rmoveto 0 exch ashow}bind def +/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/I{0 exch rmoveto show}bind def +/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def +/K{0 exch rmoveto 0 exch ashow}bind def +/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/M{rmoveto show}bind def +/N{rmoveto 0 SC 3 -1 roll widthshow}bind def +/O{rmoveto 0 exch ashow}bind def +/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/Q{moveto show}bind def +/R{moveto 0 SC 3 -1 roll widthshow}bind def +/S{moveto 0 exch ashow}bind def +/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def +/SF{ +findfont exch +[exch dup 0 exch 0 exch neg 0 0]makefont +dup setfont +[exch/setfont cvx]cvx bind def +}bind def +/MF{ +findfont +[5 2 roll +0 3 1 roll +neg 0 0]makefont +dup setfont +[exch/setfont cvx]cvx bind def +}bind def +/level0 0 def +/RES 0 def +/PL 0 def +/LS 0 def +/MANUAL{ +statusdict begin/manualfeed true store end +}bind def +/PLG{ +gsave newpath clippath pathbbox grestore +exch pop add exch pop +}bind def +/BP{ +/level0 save def +1 setlinecap +1 setlinejoin +72 RES div dup scale +LS{ +90 rotate +}{ +0 PL translate +}ifelse +1 -1 scale +}bind def +/EP{ +level0 restore +showpage +}bind def +/DA{ +newpath arcn stroke +}bind def +/SN{ +transform +.25 sub exch .25 sub exch +round .25 add exch round .25 add exch +itransform +}bind def +/DL{ +SN +moveto +SN +lineto stroke +}bind def +/DC{ +newpath 0 360 arc closepath +}bind def +/TM matrix def +/DE{ +TM currentmatrix pop +translate scale newpath 0 0 .5 0 360 arc closepath +TM setmatrix +}bind def +/RC/rcurveto load def +/RL/rlineto load def +/ST/stroke load def +/MT/moveto load def +/CL/closepath load def +/Fr{ +setrgbcolor fill +}bind def +/Fk{ +setcmykcolor fill +}bind def +/Fg{ +setgray fill +}bind def +/FL/fill load def +/LW/setlinewidth load def +/Cr/setrgbcolor load def +/Ck/setcmykcolor load def +/Cg/setgray load def +/RE{ +findfont +dup maxlength 1 index/FontName known not{1 add}if dict begin +{ +1 index/FID ne{def}{pop pop}ifelse +}forall +/Encoding exch def +dup/FontName exch def +currentdict end definefont pop +}bind def +/DEFS 0 def +/EBEGIN{ +moveto +DEFS begin +}bind def +/EEND/end load def +/CNT 0 def +/level1 0 def +/PBEGIN{ +/level1 save def +translate +div 3 1 roll div exch scale +neg exch neg exch translate +0 setgray +0 setlinecap +1 setlinewidth +0 setlinejoin +10 setmiterlimit +[]0 setdash +/setstrokeadjust where{ +pop +false setstrokeadjust +}if +/setoverprint where{ +pop +false setoverprint +}if +newpath +/CNT countdictstack def +userdict begin +/showpage{}def +}bind def +/PEND{ +clear +countdictstack CNT sub{end}repeat +level1 restore +}bind def +end def +/setpacking where{ +pop +setpacking +}if +%%EndResource +%%IncludeResource: font Times-Roman +%%IncludeResource: font Times-Bold +%%IncludeResource: font Times-Italic +grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 +def/PL 841.89 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron +/Zcaron/scaron/zcaron/Ydieresis/trademark/quotesingle/Euro/.notdef +/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef +/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef +/.notdef/.notdef/.notdef/space/exclam/quotedbl/numbersign/dollar/percent +/ampersand/quoteright/parenleft/parenright/asterisk/plus/comma/hyphen +/period/slash/zero/one/two/three/four/five/six/seven/eight/nine/colon +/semicolon/less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N/O +/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright/circumflex +/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q/r/s/t/u/v/w/x/y +/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase/guillemotleft +/guillemotright/bullet/florin/fraction/perthousand/dagger/daggerdbl +/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut +/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash +/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen +/brokenbar/section/dieresis/copyright/ordfeminine/guilsinglleft +/logicalnot/minus/registered/macron/degree/plusminus/twosuperior +/threesuperior/acute/mu/paragraph/periodcentered/cedilla/onesuperior +/ordmasculine/guilsinglright/onequarter/onehalf/threequarters +/questiondown/Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE +/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex +/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis +/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn +/germandbls/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla +/egrave/eacute/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis +/eth/ntilde/ograve/oacute/ocircumflex/otilde/odieresis/divide/oslash +/ugrave/uacute/ucircumflex/udieresis/yacute/thorn/ydieresis]def +/Times-Italic@0 ENC0/Times-Italic RE/Times-Bold@0 ENC0/Times-Bold RE +/Times-Roman@0 ENC0/Times-Roman RE +%%EndProlog +%%Page: 1 1 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S 335.2<534553414d452831292056>.4 +F<4f534553414d45283129>-.4 E/F1 10.95/Times-Bold@0 SF -.219<4e41>72 84 S +<4d45>.219 E F0 -.2<766f>108 96 S<736573616d6520ad2063616c6c207468652053 +6573616d65206e616d65207265736f6c76>.2 E<65722073657276696365>-.15 E F1 +<53594e4f50534953>72 112.8 Q/F2 10/Times-Bold@0 SF -.1<766f>108 124.8 S +<736573616d65>.1 E F0<5bad>2.5 E/F3 10/Times-Italic@0 SF +<6164656668696e737441>A<434854>-.3 E F0 2.5<5d5b>C F3<8c6c65>-2.5 E F0 +<7c>2.5 E F3<746172>2.5 E -.1<6765>-.37 G<74>.1 E F0 2.5<5d5b2e>2.5 G +<2e2e205d>-2.5 E F1<4f5054494f4e53>72 153.6 Q F0<546865>108 165.6 Q F3 +<766f736573616d65>2.5 E F0<7461736b20616363657074732074686520666f6c6c6f> +2.5 E<77696e67206f7074696f6e733a>-.25 E F2<ad682c202d2d68656c70>108 +182.4 Q F0<5072696e7420612068656c702073756d6d61727920746f20746865207465 +726d696e616c20616e642065>148 194.4 Q 2.5<7869742e204e6f>-.15 F +<70726f63657373696e6720697320646f6e6520666f6c6c6f>2.5 E +<77696e672074686973208d61672e>-.25 E F2<ad712c202d2d7175696574>108 211.2 +Q F0<5175696574206d6f6465202873757070726573732077>148 223.2 Q +<61726e696e67206f7574707574292e>-.1 E F2<ad76>108 240 Q 2.5<2c2d>-.55 G +<2d76>-2.5 E<6572626f7365>-.1 E F0 -1.11<5665>148 252 S +<72626f7365206f75747075742e>1.11 E +<4e6f726d616c6c79207573656420746f207072696e742077>5 E<61726e696e67732077 +68656e20616e206f626a65637420636f756c64206e6f74206265207265736f6c76>-.1 E +<65642e>-.15 E<54686520666f6c6c6f>108 268.8 Q<77696e67208d616773206d6179 +20626520636f6d62696e656420617320612073696e676c65206f7074696f6e20746f2069 +6e64696361746520746865>-.25 E 1.079 +<64657369726564206f7574707574208c656c64732e>108 280.8 R 1.078<546865206f +72646572206f6620746865208d61677320696d706c69657320746865206f72646572206f +6620746865206f75747075742076>6.079 F 1.078 +<616c7565732c20652e672e20222d646e7422207072696e747320746865>-.25 F<6465 +63696d616c20706f736974696f6e2c206e616d6520616e64207479706520696e20746861 +74206f72646572>108 292.8 Q<2e>-.55 E F2<ad612c202d2d616c6c>108 309.6 Q +F0<4f757470757420616c6c2061>7.08 E -.25<7661>-.2 G<696c61626c6520696e66 +6f726d6174696f6e2061626f757420746865206f626a6563742e>.25 E F2 +<ad642c202d2d646563696d616c>108 326.4 Q F0 1.045<4f75747075742074686520 +706f736974696f6e206173204a3230303020646563696d616c206465>148 338.4 R +3.546<67726565732e2054686973>-.15 F 1.046<69732074686520646566>3.546 F +1.046 +<61756c74206f7574707574206966206e6f20666f726d6174208d61677320617265>-.1 +F<73706563698c65642e>148 350.4 Q F2<ad652c202d2d657272>108 367.2 Q +<6f7273>-.18 E F0<4f75747075742074686520657374696d6174656420706f73697469 +6f6e206572726f72732e>148 379.2 Q F2<ad6e2c202d2d6e616d65>108 396 Q F0 +<4f757470757420746865206f626a656374206e616d652e>148 408 Q F2 +<ad742c202d2d74797065>108 424.8 Q F0 +<4f757470757420746865206f626a65637420747970652e>148 436.8 Q F2 +<ad732c202d2d736578>108 453.6 Q F0 +<4f75747075742074686520706f736974696f6e206173207365>5.42 E +<7861676573696d616c20524120616e64204465632e>-.15 E +<436f6e74726f6c20466c6167733a>108 482.4 Q F2<ad63203c72613e203c6465633e +206f7220ad63203c72613e2c3c6465633e206f7220ad2d636f6f72642d3c72613e2c3c64 +65633e>108 499.2 Q F0 .45 +<53706563696679206120636f6f7264696e61746520746f2062652065>148 511.2 R +.45<78706c696369746c7920757365642e>-.15 F .449 +<49662073657420616e20524120616e6420444543206172652065>5.45 F .449 +<787065637465642061732065697468657220746865206e65>-.15 F<7874>-.15 E +<6172>148 523.2 Q 1.374<67756d656e7420696620746865>-.18 F 3.874<7961> +-.15 G 1.375<7265206120636f6d6d612d73657061726174656420737472696e672c20 +6f7220617320746865206e65>-3.874 F 1.375<7874207477>-.15 F 3.875<6f61>-.1 +G -.18<7267>-3.875 G 3.875<756d656e74732e2056>.18 F 1.375 +<616c756573206d6179206265>-1.11 F .184<696e707574206173208d6f6174696e67 +20706f696e7420646563696d616c206f72207365>148 535.2 R .183 +<7861676573696d616c20737472696e67732e>-.15 F .183<55706f6e20726563656970 +742c20746865207461736b2077696c6c2063726561746520616e20617274698c2d>5.183 +F .952<63616c207265636f726420666f7220746865206f626a65637420616e64206f75 +74707574207468652076>148 547.2 R .953<616c756573207265717565737465642077 +69746820746865206f7574707574208d616773206465736372696265642061626f>-.25 +F -.15<7665>-.15 G<2e>.15 E<4d756c7469706c65>148 559.2 Q F3<2d63>2.721 E +F0 .221<6f7074696f6e73206d61792062652073706563698c6564206d61792062652073 +706563698c656420616e64206d6978>2.721 F .22 +<65642077697468206f626a656374206e616d65732c207573657220636f6f7264692d> +-.15 F .255<6e61746573206172652070726f636573736564206265666f726520746865 +206f626a656374206e616d657320617265207265736f6c76>148 571.2 R .255 +<656420696e20746865206f7264657220746865>-.15 F 2.755<796f>-.15 G .255 +<63637572206f6e2074686520636f6d6d616e64>-2.755 F<6c696e652e>148 583.2 Q +F2<ad692c202d2d696e>108 600 Q -.1<7665>-.4 G<7274>.1 E F0<496e>148 612 Q +-.15<7665>-.4 G<7274207468652073656e7365206f6620746865207365617263682061 +6e64207072696e74206f6e6c79206f626a656374732077686963682063616e6e6f742062 +65207265736f6c76>.15 E<656420746f20636f6f7264696e617465732e>-.15 E F2 +<ad66>108 628.8 Q 2.5<2c2d>-.15 G<2d66>-2.5 E<6f72>-.25 E<6365>-.18 E F0 +-.15<466f>148 640.8 S .54 +<72636520746865206f626a65637428732920746f206265207265736f6c76>.15 F .54 +<65642065>-.15 F -.15<7665>-.25 G 3.04<6e69>.15 G 3.04<6669>-3.04 G 3.04 +<7469>-3.04 G 3.04<7363>-3.04 G 3.04<61636865642e2054686973>-3.04 F .54< +6f7074696f6e2077696c6c20636175736520746865207461736b20746f2063616c6c2074 +6865>3.04 F 1.837<536573616d65207365727669636520726174686572207468616e20 +6f7574707574206120707265>148 652.8 R 1.837 +<76696f75736c79206361636865642076>-.25 F 1.837<616c75652c20686f>-.25 F +<7765>-.25 E -.15<7665>-.25 G 4.337<7274>.15 G 1.837 +<686520726573756c742077696c6c207374696c6c206265>-4.337 F +<63616368656420756e6c657373207468652056>148 664.8 Q<4f435f4e4f5f4341>-.4 +E<43484520656e>-.4 E<7669726f6e6d656e742076>-.4 E +<61726961626c652069732064658c6e65642e>-.25 E F2 +<ad6f203c6e616d653e206f72202d2d6f75747075743d3c6e616d653e>108 681.6 Q F0 +<5370656369667920746865206f7574707574208c6c652e>148 693.6 Q +<54686520646566>5 E<61756c7420697320746f2077726974652074686520726573756c +747320746f20746865207374616e64617264206f75747075742e>-.1 E<4e56>72 768 Q +2.5<4f56>-.4 G<4f2d434c492050726f6a656374>-2.9 E<4a756c792032303037> +126.345 E<31>209.415 E 0 Cg EP +%%Page: 2 2 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S 335.2<534553414d452831292056>.4 +F<4f534553414d45283129>-.4 E -.15<466f>108 84 S +<726d617474696e6720466c6167733a>.15 E/F1 10/Times-Bold@0 SF +<ad412c202d2d6173636969>108 100.8 Q F0 .596<5072696e74207468652072657375 +6c7473206173206120776869746573706163652064656c696d6974656420617363696920 +7461626c652e>148 112.8 R .595<496620616e206f7574707574208c6c652069732073 +706563698c65642069742077696c6c206861>5.596 F .895 -.15<76652061>-.2 H +<222e747874222065>148 124.8 Q +<7874656e73696f6e20617070656e646564206175746f6d61746963616c6c79>-.15 E +<2e>-.65 E F1<ad432c202d2d637376>108 141.6 Q F0 1.356<5072696e7420746865 +20726573756c7473206173206120636f6d6d612d7365706172617465642d76>148 153.6 +R 1.357<616c7565202843535629207461626c652e>-.25 F 1.357<496620616e206f75 +74707574208c6c652069732073706563698c65642069742077696c6c>6.357 F<6861> +148 165.6 Q .3 -.15<766520612022>-.2 H<2e637376222065>.15 E +<7874656e73696f6e20617070656e646564206175746f6d61746963616c6c79>-.15 E +<2e>-.65 E F1<ad482c202d2d686561646572>108 182.4 Q F0 .309 +<5072696e742061207461626c6520686561646572>148 194.4 R 5.309<2e54>-.55 G +.309<6865207461626c65206865616465722077696c6c20626520612073696e676c6520 +6c696e65206265>-5.309 F .309<67696e6e696e672077697468206120272327206368 +6172616374657220746f20696e64692d>-.15 F +<63617465206120636f6d6d656e742c20616e6420666f6c6c6f>148 206.4 Q<77656420 +627920746865206e616d65206f66206561636820636f6c756d6e20696e20746865207370 +6563698c656420666f726d61742e>-.25 E F1<ad54>108 223.2 Q 2.5<2c2d>-.74 G +<2d747376>-2.5 E F0 .597<5072696e742074686520726573756c7473206173206120 +7461622d7365706172617465642d76>148 235.2 R .597 +<616c7565202854535629207461626c652e>-.25 F .598<496620616e206f7574707574 +208c6c652069732073706563698c65642069742077696c6c206861>5.598 F .898 -.15 +<76652061>-.2 H<222e637376222065>148 247.2 Q +<7874656e73696f6e20617070656e646564206175746f6d61746963616c6c79>-.15 E +<2e>-.65 E/F2 10.95/Times-Bold@0 SF<4445534352495054494f4e>72 276 Q F0 +<546865>108 288 Q/F3 10/Times-Italic@0 SF<766f736573616d65>3.796 E F0 +1.296<7461736b2070726f>3.796 F 1.296 +<7669646573206120636f6d6d616e642d6c696e6520696e74657266>-.15 F 1.296 +<61636520746f20746865>-.1 F F3<536573616d65>3.796 E F0 1.296 +<6e616d65207265736f6c76>3.796 F 1.296 +<65722073657276696365206174204344532074686174>-.15 F<636f6e>108 300 Q +-.15<7665>-.4 G .957<727420612066>.15 F .957<616d696c696172206f626a6563 +74206e616d6520746f20746865204a3230303020636f6f7264696e617465732072657175 +697265642062792056>-.1 F 3.457<4f73>-.4 G .958 +<657276696365732e204164646974696f6e616c20696e666f726d6174696f6e>-3.457 F +2.158<73756368207375636820617320746865206f626a65637420747970652069732061 +6c736f2061>108 312 R -.25<7661>-.2 G 4.657<696c61626c652e20546865>.25 F +F3<536573616d65>4.657 E F0 2.157 +<736572766963652071756572696573204e45442c2053696d62616420616e642056> +4.657 F<697a696572>-.6 E .296 +<64617461626173657320666f72207468697320696e666f726d6174696f6e2e>108 324 +R .297<4966206e6f208d616773206172652070726f>5.297 F .297 +<76696465642c2074686520646566>-.15 F .297<61756c74206f757470757420697320 +73696d706c792074686520524120616e6420446563206f6620746865>-.1 F .906 +<6f626a65637420696e20646563696d616c206465>108 336 R .905 +<67726565732028746869732069732077686174206d6f73742056>-.15 F 3.405<4f73> +-.4 G .905<657276696365732065>-3.405 F .905<7870656374292c20686f>-.15 F +<7765>-.25 E -.15<7665>-.25 G 3.405<7263>.15 G .905 +<6f6d6d616e642d6c696e65208d6167732070726f>-3.405 F .905<766964652061> +-.15 F<6d6574686f6420746f2073706563696679207468652064657369726564206f75 +7470757420616e6420746865206f7264657220696e20776869636820746865>108 348 Q +2.5<7961>-.15 G<7265207072696e7465642e>-2.5 E .691<4f626a656374206e616d +6573206d61792062652073706563698c6564206f6e2074686520636f6d6d616e646c696e +6520696e6469>108 364.8 R .692 +<76696475616c6c7920286d756c7469706c65206172>-.25 F .692 +<67756d656e74732061726520616c6c6f>-.18 F .692<776564292c20617320746865> +-.25 F .138<6e616d65206f662061208c6c6520636f6e7461696e696e672061206c6973 +74206f66206f626a6563747320746f206265207265736f6c76>108 376.8 R .138 +<65642c206f7220626f74682e>-.15 F .138 +<4966206e6f206f626a656374206f72208c6c65206e616d657320617265206769>5.138 +F -.15<7665>-.25 G 2.637<6e6f>.15 G 2.637<6e74>-2.637 G<6865>-2.637 E +.559<636f6d6d616e64206c696e6520746865207461736b2077696c6c20726561642066 +726f6d20746865207374616e6461726420696e7075742c20616c6c6f>108 388.8 R .56 +<77696e6720746865207461736b20746f2062652075736564206173206120636f6d6d61 +6e64208c6c746572>-.25 F 1.594<6f7220696e74657261637469>108 400.8 R -.15 +<7665>-.25 G 1.593<6c792066726f6d20746865206b>.15 F -.15<6579>-.1 G +4.093<626f6172642e2046696c6573>.15 F 1.593<636f6e7461696e696e67206f626a +656374206e616d65732061726520617373756d656420746f206c69737420746865206e61 +6d65206f66206f6e65>4.093 F<6f626a6563742d706572>108 412.8 Q .763<2d6c69 +6e65207768657265207768697465737061636520696e20746865206f626a656374206e61 +6d6520697320616c6c6f>-.2 F .764 +<776564206f6e20746865206c696e652028652e672e20224d20353122292e>-.25 F +.764<46726f6d2074686520636f6d2d>5.764 F .944<6d616e64206c696e652c206d6f +7374207368656c6c20696e746572707265746572732077696c6c20726571756972652074 +68617420746865207768697465737061636520626520657363617065642028652e672e20 +224d>108 424.8 R .944<3531222920736f20697420697320696e746572>2.5 F<2d> +-.2 E .501<7072657465642070726f7065726c79>108 436.8 R 5.501<2e41>-.65 G +-.1<7761>-2.5 G .501<726e696e672077696c6c206265207072696e74656420696620 +616e206f626a656374206e616d652063616e6e6f74206265207265736f6c76>.1 F .502 +<656420616e6420746865>-.15 F F3<2d76>3.002 E F0 -.15<7665>3.002 G .502 +<72626f7365208d6167206973>.15 F<7365742c206f7468657277697365206e6f206f75 +747075742077696c6c206265207072696e74656420666f72207468652066>108 448.8 Q +<61696c656420726571756573742e>-.1 E<546865>108 465.6 Q F3 +<4f5054494f4e53>3.418 E F0 .918<73656374696f6e20646573637269626573207468 +6520666f726d617474696e67206f7074696f6e732061>3.418 F -.25<7661>-.2 G +3.418<696c61626c652e2046>.25 F .918<6f722065616368206f66207468657365206f +7074696f6e732c20746865206f7264657220696e>-.15 F .887<776869636820697420 +6170706561727320636f6e74726f6c7320746865206f72646572206f6620776865726520 +6974206170706561727320696e20746865206f757470757420737472696e6720666f7220 +746865206f626a6563742e>108 477.6 R .887<4f757470757420666f726d6174>5.887 +F .637<8d61677320636f6e74726f6c20686f>108 489.6 R 3.137<7774>-.25 G .637 +<68652076>-3.137 F .637<616c75657320617265207072696e7465642e20537570706f +7274656420666f726d61747320696e636c75646520636f6d6d612d736570617261746564 +2d76>-.25 F .637<616c7565732028435356>-.25 F 3.137<2c74>-1.29 G<6865> +-3.137 E F3<2d43>3.136 E F0 .071 +<8d6167292c207461622d7365706172617465642d76>108 501.6 R .071 +<616c7565732028545356>-.25 F 2.571<2c74>-1.29 G<6865>-2.571 E F3<2d54> +2.571 E F0 .071 +<8d6167292c20776869746573706163652d64656c696d697465642076>2.571 F .072 +<616c7565732028746865>-.25 F F3<2d41>2.572 E F0<646566>2.572 E .072 +<61756c74292c20616e64206d617920696e636c756465>-.1 F .599 +<616e206f7074696f6e616c20686561642028746865>108 513.6 R F3<2d48>3.099 E +F0 3.099<298d>C .598<616729207468617420707265636564657320746865206f7574 +70757420776974682061206c696e65206f66207465>-3.099 F .598 +<7874206c697374696e6720746865206f757470757420636f6c756d73207768657265> +-.15 F<746865208c72737420636861726163746572206f662074686520686561646572 +20697320612027232720746f20696e646963617465206120636f6d6d656e742e>108 +525.6 Q F2 -.493<564f>72 554.4 S<434c49454e542044>.493 E +<41454d4f4e205052>-.383 E<4f43455353494e47>-.329 E F0 .604<416c6c2056> +108 566.4 R .604<4f2d434c49207461736b73206172652062>-.4 F .605 +<75696c742075706f6e207468652056>-.2 F .605<4f436c69656e7420696e74657266> +-.4 F .605<61636520616e2072656c79206f6e2061207365706172617465>-.1 F F3 +<766f636c69656e7464>3.105 E F0 .605<70726f6365737320746f2070726f>3.105 F +<76696465>-.15 E .383<7468652056>108 578.4 R 2.883<4f66>-.4 G +<756e6374696f6e616c697479>-2.883 E 5.383<2e54>-.65 G .383<68652076> +-5.383 F .383<6f636c69656e7464207461736b2069732064697374726962>-.2 F +.382<757465642061732070617274206f662056>-.2 F .382<4f2d434c4920616e6420 +77696c6c2062652073746172746564206175746f6d61746963616c6c79>-.4 F .523<62 +792065616368207461736b206966206974206973206e6f7420616c72656164792072756e +6e696e672e>108 590.4 R .524<49662070726f626c656d732061726520656e636f756e +74657265642c20796f75206d61792077>5.524 F .524 +<616e7420746f206d616e75616c6c7920737461727420746865>-.1 F -.2<766f>108 +602.4 S<636c69656e746420696e20612073657061726174652077696e646f>.2 E 2.5 +<7762>-.25 G<65666f72652072756e6e696e6720746865207461736b20736f20796f75 +2063616e206d6f6e69746f7220746865206f757470757420666f72206572726f72206d65 +7373616765732e>-2.5 E F2<4f424a454354204341>72 631.2 Q<4348494e47>-.602 +E F0<546865>108 643.2 Q F1<536573616d65>3.315 E F0 .814 +<7365727669636520617420434453206973206e6f726d616c6c792066>3.315 F .814 +<6169726c792072656c6961626c652c20686f>-.1 F<7765>-.25 E -.15<7665>-.25 G +3.314<7274>.15 G .814<68657265206172652074696d6573207768656e206974206973 +2065697468657220756e61>-3.314 F -.25<7661>-.2 G<696c2d>.25 E .026<61626c +652c206f722073696d706c792072657475726e732061206e756c6c20726573756c742077 +6974686f757420696e6469636174696e6720616e206572726f72>108 655.2 R 5.026 +<2e41>-.55 G<64646974696f6e616c6c79>-5.026 E 2.526<2c74>-.65 G .026 +<6865206163636573732074696d65206973206f6e20746865206f72646572>-2.526 F< +6f66207e31207365632f6f626a65637420616e6420736f207265736f6c76696e67206d61 +6e>108 667.2 Q 2.5<796f>-.15 G<626a65637473206372656174657320616e206f> +-2.5 E -.15<7665>-.15 G<726865616420666f72206170706c69636174696f6e732075 +73696e67207468697320736572766963652e>.15 E<546865>108 684 Q F1 -.1<766f> +3.119 G<736573616d65>.1 E F0<7461736b27>3.119 E 3.118<736f>-.55 G .618 +<6e6c792066756e6374696f6e20697320746f207265736f6c76>-3.118 F 3.118<656f> +-.15 G .618<626a656374732c20686f>-3.118 F<7765>-.25 E -.15<7665>-.25 G +3.118<7269>.15 G 3.118<7473>-3.118 G .618<74696c6c207573657320746865206f +626a6563742063616368696e67206361706162696c697479>-3.118 F 3.218 +<696e207468652056>108 696 R 3.218<4f436c69656e7420696e74657266>-.4 F +5.718<6163652e204f6e6365>-.1 F 3.218 +<616e206f626a656374206973207265736f6c76>5.718 F 3.218<65642c206974207769 +6c6c206175746f6d61746963616c6c792062652063616368656420756e6c657373207468 +65>-.15 F F1 -.45<564f>108 708 S<435f4e4f5f4341>.45 E<434845>-.55 E F0 +<656e>3.001 E .501<7669726f6e6d656e742076>-.4 F .501 +<61726961626c652069732064658c6e65642e>-.25 F<546865>5.501 E F3<2d66> +3.001 E F0 .501<636f6d6d616e642d6c696e65206f7074696f6e2063616e2062652075 +73656420746f206f>3.001 F -.15<7665>-.15 G<7272696465>.15 E<616e>108 720 +Q 2.582<7965>-.15 G .083<78697374696e67206361636865642076>-2.732 F .083< +616c75657320616e6420666f7263652074686520536573616d6520736572766963652074 +6f20626520696e>-.25 F -.2<766f>-.4 G -.1<6b65>.2 G 2.583<642e20546865>.1 +F .083<6f626a656374206361636865206d617920626520696e697469616c697a6564> +2.583 F<4e56>72 768 Q 2.5<4f56>-.4 G<4f2d434c492050726f6a656374>-2.9 E +<4a756c792032303037>126.345 E<32>209.415 E 0 Cg EP +%%Page: 3 3 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S 335.2<534553414d452831292056>.4 +F<4f534553414d45283129>-.4 E +<636f6d706c6574656c792062792064656c6574696e67207468652024484f4d452f2e76> +108 84 Q<6f636c69656e742f63616368652f736573616d65206469726563746f7279> +-.2 E<2e>-.65 E/F1 10.95/Times-Bold@0 SF<52455455524e205354>72 112.8 Q +-1.04<4154>-.986 G<5553>1.04 E F0 1<496620616c6c206f626a6563747320776572 +65207375636365737366756c6c79207265736f6c76>108 124.8 R 1 +<656420746865207461736b2077696c6c2065>-.15 F .999 +<786974207769746820612073746174757320636f6465206f6620302e>-.15 F .999 +<4966206f6e65206f72206d6f7265206f6620746865>5.999 F<6f626a656374732066> +108 136.8 Q<61696c656420746f206265207265736f6c76>-.1 E +<656420666f7220616e>-.15 E 2.5<7972>-.15 G<6561736f6e2c207468652065>-2.5 +E<786974207374617475732077696c6c20626520746865206e756d626572206f6620756e +7265736f6c76>-.15 E<6564206f626a656374732e>-.15 E F1<4558414d504c4553>72 +177.6 Q F0 9.17<3129205072696e74>108 189.6 R<74686520636f6f7264696e6174 +6573206f66204e4743343435362c208c72737420696e20646563696d616c206465>2.5 E +<677265657320616e64207468656e206173207365>-.15 E<7861676573696d616c2076> +-.15 E<616c7565733a>-.25 E 2.5<2576>164 213.6 S +<6f736573616d65206e676334343536>-2.7 E +<3138362e393630303030202d33302e313230303030>164 225.6 Q 2.5<2576>164 +237.6 S<6f736573616d65202d73206e676334343536>-2.7 E 10 +<31323a32372e38202d33303a3037>164 249.6 R 9.17<3229205072696e74>108 +278.4 R<746865207365>2.5 E<7861676573696d616c20636f6f7264696e6174657320 +6f66206d756c7469706c65206f626a656374732c20696e636c7564652074686520747970 +653a>-.15 E 2.5<2576>164 302.4 S +<6f736573616d65202d7374206d3331206d3531206d3939>-2.7 E +<30303a34323a34342e3331202b34313a31363a30392e34204c494e4552>164 314.4 Q +<31333a32393a35322e3336202b34373a31313a34302e38205365>164 326.4 Q +<79666572745f32>-.15 E +<31323a31383a34392e3531202b31343a32353a30302e34204849495f47>164 338.4 Q +9.17<3329205072696e74>108 367.2 R 1.739<74686520646563696d616c20636f6f72 +64696e61746573206f662074686f73652073616d65206f626a65637473206c6973746564 +20696e20746865208c6c6520276d796f626a732e747874272c206f757470757420617320 +435356>4.238 F<2c>-1.29 E<696e636c756465206120686561646572>128 379.2 Q +2.5<2c61>-.4 G +<6e64207072696e74207468652069642c20636f6f7264732c20616e6420747970653a> +-2.5 E 2.5<2576>164 403.2 S +<6f736573616d65202d43486e6474206d796f626a732e747874>-2.7 E +<234e616d652c4452412c444445432c54>164 415.2 Q<7970652c>-.8 E +<6d33312c31302e3638343632352c34312e3236393237382c4c494e4552>164 427.2 Q +<6d35312c3230322e3436383230382c34372e3139343636372c5365>164 439.2 Q +<79666572745f32>-.15 E +<6d39392c3138342e3730363333332c31342e3431363737382c4849495f47>164 451.2 +Q -10 15<3a3a203a>171.5 463.2 T<3a>5 E 9.17<34292045787472616374>108 492 +R .349<746865206f626a656374206e616d65732066726f6d20636f6c756d6e2031372d +3235206f662061208c6c6520616e64207069706520746865206c69737420746f2076> +2.849 F .348<6f736573616d6520746f206372656174652061206e65>-.2 F 2.848 +<7774>-.25 G<612d>-2.848 E<626c65206f662069642c20726120616e64206465633a> +128 504 Q 2.5<2563>164 528 S +<7574202d6331372d323520646174612e747874207c2076>-2.5 E +<6f736573616d65202d6e73>-.2 E +<6d35312031333a32393a35322e3336202b34373a31313a34302e38>164 540 Q +<6d32332031373a35373a30302e3030202d31383a35383a35392e39>164 552 Q +<6d36372030383a35313a31372e3939202b31313a34383a30302e30>164 564 Q -5 15 +<3a3a203a>166.5 576 T 9.17<352920496e74657261637469>108 604.8 R -.15 +<7665>-.25 G<6c79207265736f6c76>.15 E 2.5<6563>-.15 G<6f6f7264696e617465 +7320627920656e74657279696e67206f626a656374206e616d6573206f6e207468652073 +74616e6461726420696e7075743a>-2.5 E 2.5<2576>164 628.8 S +<6f736573616d65202d61>-2.7 E<6d3938>164 640.8 Q<6d39382031323a31333a3438 +2e3337202b31343a35333a35372e39203138332e3435313534>164 652.8 Q +<31342e38393934342031302e302031302e30204c494e4552>5 E<5b454f465d>164 +664.8 Q -.8<5479>128 688.8 S<70652074686520454f462063686172616374657220 +287479706963616c6c79204374726c2d44206f72204374726c2d5a2920746f2071756974 +2e>.8 E<4e56>72 768 Q 2.5<4f56>-.4 G<4f2d434c492050726f6a656374>-2.9 E +<4a756c792032303037>126.345 E<33>209.415 E 0 Cg EP +%%Page: 4 4 +%%BeginPageSetup +BP +%%EndPageSetup +/F0 10/Times-Roman@0 SF -.4<564f>72 48 S 335.2<534553414d452831292056>.4 +F<4f534553414d45283129>-.4 E 9.17<3629205072696e74>108 84 R +<746865207365>2.5 E<7861676573696d616c20616e6420646563696d616c2076>-.15 +E<616c75657320666f72206d756c7469706c65207573657220636f6f7264733a>-.25 E +2.5<2576>164 108 S<6f736573616d65202d7364202d632031323a33303a302e30202d +34353a30303a302e30202d63203138372e3520322e3035>-2.7 E +<31323a33303a30302e30202d34353a30303a30302e30>164 120 Q +<31322e353030303030202d34352e303030303030>5 E 2.5 +<31323a33303a30302e302030323a30333a30302e30>164 132 R 5 +<3138372e35303030303020322e303530303030>2.5 F/F1 10.95/Times-Bold@0 SF +-.11<4255>72 184.8 S<4753>.11 E F0 2.321<54686520536573616d652073657276 +6963652063616e20736f6d6574696d657320726573706f6e6420776974686f7574207265 +736f6c76696e6720746865206f626a6563742e>108 196.8 R 2.322 +<496e2074686973206361736520616c6c2076>7.321 F 2.322<616c75657320617265> +-.25 F .687 +<72657475726e6564206173207a65726f206f722061206e756c6c20737472696e672e> +108 208.8 R/F2 10/Times-Italic@0 SF -1.11<566f>5.687 G<736573616d65>1.11 +E F0 .687<77696c6c2073656e736520746869732061732061206e6f6e2d726573706f6e +736520616e64206e6f74207072696e74206120726573756c742e>3.187 F .687 +<496620746865>5.687 F F2<766572626f7365>108 220.8 Q F0 +<8d61672069732073657420612077>2.5 E +<61726e696e67206d6573736167652077696c6c206265207072696e7465642e>-.1 E F1 +<5265>72 237.6 Q<766973696f6e20486973746f7279>-.164 E F0 +<4a756e652032303037202d2054686973207461736b206973206e65>108 249.6 Q -.65 +<772e>-.25 G F1 -.548<4175>72 266.4 S<74686f72>.548 E F0<4d69636861656c +204669747a7061747269636b20288c747a406e6f616f2e656475292c204a756c79203230 +3037>108 278.4 Q F1<53454520414c534f>72 295.2 Q F0 -.2<766f>108 307.2 S +<636c69656e742831292c2076>.2 E<6f636c69656e74642831292c2076>-.2 E +<6f6469726563746f72792831292c2076>-.2 E<6f64617461283129>-.2 E F1 -.11 +<4255>72 324 S<4753>.11 E F0 2.321<54686520536573616d652073657276696365 +2063616e20736f6d6574696d657320726573706f6e6420776974686f7574207265736f6c +76696e6720746865206f626a6563742e>108 336 R 2.322 +<496e2074686973206361736520616c6c2076>7.321 F 2.322<616c75657320617265> +-.25 F .687 +<72657475726e6564206173207a65726f206f722061206e756c6c20737472696e672e> +108 348 R F2 -1.11<566f>5.687 G<736573616d65>1.11 E F0 .687<77696c6c2073 +656e736520746869732061732061206e6f6e2d726573706f6e736520616e64206e6f7420 +7072696e74206120726573756c742e>3.187 F .687<496620746865>5.687 F F2 +<766572626f7365>108 360 Q F0<8d61672069732073657420612077>2.5 E +<61726e696e67206d6573736167652077696c6c206265207072696e7465642e>-.1 E F1 +<5265>72 376.8 Q<766973696f6e20486973746f7279>-.164 E F0 +<4a756e652032303037202d2054686973207461736b206973206e65>108 388.8 Q -.65 +<772e>-.25 G F1 -.548<4175>72 405.6 S<74686f72>.548 E F0<4d69636861656c +204669747a7061747269636b20288c747a406e6f616f2e656475292c204a756c79203230 +3037>108 417.6 Q F1<53454520414c534f>72 434.4 Q F0 -.2<766f>108 446.4 S +<636c69656e742831292c2076>.2 E<6f636c69656e74642831292c2076>-.2 E +<6f6469726563746f72792831292c2076>-.2 E<6f64617461283129>-.2 E<4e56>72 +768 Q 2.5<4f56>-.4 G<4f2d434c492050726f6a656374>-2.9 E +<4a756c792032303037>126.345 E<34>209.415 E 0 Cg EP +%%Trailer +end +%%EOF diff --git a/vendor/voclient/doc/OLD/vosloanspec.html b/vendor/voclient/doc/OLD/vosloanspec.html new file mode 100644 index 00000000..bd89781f --- /dev/null +++ b/vendor/voclient/doc/OLD/vosloanspec.html @@ -0,0 +1,236 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOSLOANSPEC</TITLE> +</HEAD><BODY> +<H1>VOSLOANSPEC</H1> +Section: User Commands (1)<BR>Updated: Feb 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +vosloanspec - Query for SDSS spectra +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>vosloanspec</B> [<opts>] <obj> | {<ra> <dec>} | {<ra> <dec> <radius>} +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>vosloanspec</I> application accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<P> +<DT><B>-P </B><I>RA</I>,<I>DEC</I>, --pos=<I>RA</I>,<I>DEC</I> + +<DD> +Set the query position (dec degrees). +<DT><B>-R </B><I>REL</I>, --release=<I>REL</I> + +<DD> +Data release to query, allowed values are 'dr8' or 'dr9', the default is +to use whatever version is defined by the service as 'current'. +<DT><B>-s </B><I>RADIUS</I>, --size=<I>RADIUS</I> + +<DD> +Set query radius (dec degrees). The service imposes a max query radius of 10 +degrees. +<DT><B>-t </B><I>TYPE</I>, --type=<I>TYPE</I> + +<DD> +Object type constraint. If not specified then all available spectra will +be returned, allowed values for the constraint are 'galaxy', 'qso' and 'star'. +<DT><B>-z </B><I>ZRANGE</I>, --redshift=<I>ZRANGE</I> + +<DD> +Select by redshift range string(s). A range is specified as two values +separated by a hyphen character (e.g. "0.1-0.3"), multiple ranges may be +specified in a comma-delimited list (e.g. "0.1-0.3,1.0-1.5"). +<P> +<DT><B>-c, --count</B> + +<DD> +Return only count of results available. +<DT><B>-m, --meta</B> + +<DD> +Print result position metadata. +<DT><B>-D, --delete</B> + +<DD> +Delete spectra after printing metadata. In order to obtain the metadata, the +data are actually downloaded and then read, this option will delete these +files once the task exits. +<DT><B>-l </B><I>N</I>, --limit=<I>N</I> + +<DD> +Limit to top <I>N</I> results. +<DT><B>-u, --urls</B> + +<DD> +Get urls to spectra only. +<P> +<DT><B>-S, --samp</B> + +<DD> +Broadcase urls as a SAMP spectrum message. +<DT><B>-T, --table</B> + +<DD> +Broadcase urls as SAMP load VOTable message. +<DT><B>-N </B><I>N</I>, --num=<I>N</I> + +<DD> +Number of download threads to run in parallel (default: 12). +<P> +<DT><B>-f </B><I>FILE</I>, --file=<I>FILE</I> + +<DD> +Input file of positions. +<DT><B>-b </B><I>FILE</I>, --base=<I>FILE</I> + +<DD> +Base filename of downloaded files. +<DT><B>-O </B><I>FILE</I>, --output=<I>FILE</I> + +<DD> +Output file for results. +<DT><B>-o </B><I>OBJ</I>, --object=<I>OBJ</I> + +<DD> +Object name to resolve to query position. +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>vosloanspec</I> task provides access to Data Release 9 of +the SDSS III Spectral Data. This dataset contains over 1.5 million galaxies, +230,000 quasars, and 670,000 stars covering 14,500 square degrees of the sky. +<P> + +Queries by position may be done using either a resolvable object name or an +explicit (RA,Dec) position given in ICRS decimal degrees. The <I>-P</I> flag +can be used to specify the position as a single argument. The default query +size is 0.25 degrees and may be changed using the <I>-s</I> flag. If the +DR8 release of the dataset is desired the <I>-R dr8</I> option may be used, +by default the task will use whichever data release is deemed 'current' y +the service (DR9 as of this writing). Spectra may be limited to a selection +of just 'galaxy', 'qso' or 'star' objects using the <I>-t</I> option. The +<I>-z</I> option may be used to constrain the search by range of redshift +values. +<P> + +Unless otherwise modified, the task will automatically download FITS spectra +for all objects within the query region. The <I>-m</I> flag will print the +positions of each object found (e.g. for marking an overlay), the <I>-u</I> +flag will print the access URLs for the spectra. In the case of position +metadata the FITS files must actually be downloaded to the local machine +since the service doesn't provide this in a query return, the <I>-D</I> +flag will delete these images after the information is obtained. +<P> + +To broadcast the spectra to SAMP-enabled applications using the +<I>spectrum.load.ssa-generic</I> message type, the <I>-S</I> option may be used. +The spectrum may be broadcast as a <I>table.load.FITS</I> message by specifying +the <I>-T</I> flag. +<P> +<A NAME="lbAF"> </A> +<H2>REFERENCES</H2> + +This task is based on the API available from +<P> +<PRE> + <A HREF="http://api.sdss3.org/">http://api.sdss3.org/</A> +</PRE> + +See the documentation at this site for additional information about +parameters. The <I>vosloanspec</I> task attempts to provide a useful data +client using a non-VO interface and will eventually be replaced by a +task with similar functionality using standard SSA services. +<P> +<A NAME="lbAG"> </A> +<H2>RETURN STATUS</H2> + +On exit the <B>votcnv</B> task will return a zero indicating success, or a +one indicating an error. +<P> +<A NAME="lbAH"> </A> +<H2>EXAMPLES</H2> + +<DL COMPACT> +<DT>1) Download all galaxy spectra w/in 0.1 deg of the Hubble Ultra Deep Field:<DD> +<P> +<PRE> + % vosloanspec -s 0.1 -t galaxy HUDF + % vosloanspec --size=0.1 --type=galaxy HUDF +</PRE> + +<DT>2) Get only the positions of the SDSS spectra around a point:<DD> +<P> +<PRE> + % vosloanspec -m -D m51 + % vosloanspec --meta --delete m51 +</PRE> + +<DT>3) Broadcast 5 spectra around 3c273 to SAMP-enabled apps:<DD> +<P> +<PRE> + % vosloanspec -l 5 --samp 3c273 # as a spectrum msg + % vosloanspec -l 5 --samp --table 3c273 # as a table msg +</PRE> + +<DT>4) Get all QSO spectra with a redshift > 0.3 (Note an upper range must be specified for the redshift range for a valid query):<DD> +<P> +<PRE> + % vosloanspec --redshift=0.3-1.0 +</PRE> + +<P> +</DL> +<A NAME="lbAI"> </A> +<H2>BUGS</H2> + +No known bugs with this release. +<A NAME="lbAJ"> </A> +<H2>Revision History</H2> + +Feb 2013 - First public release +<A NAME="lbAK"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), Feb 2013 +<A NAME="lbAL"> </A> +<H2>SEE ALSO</H2> + +vodata, vospectra, voregistry, votopic +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">REFERENCES</A><DD> +<DT><A HREF="#lbAG">RETURN STATUS</A><DD> +<DT><A HREF="#lbAH">EXAMPLES</A><DD> +<DT><A HREF="#lbAI">BUGS</A><DD> +<DT><A HREF="#lbAJ">Revision History</A><DD> +<DT><A HREF="#lbAK">Author</A><DD> +<DT><A HREF="#lbAL">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 05:13:25 GMT, April 14, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/OLD/vosloanspec.man b/vendor/voclient/doc/OLD/vosloanspec.man new file mode 100644 index 00000000..1b49258c --- /dev/null +++ b/vendor/voclient/doc/OLD/vosloanspec.man @@ -0,0 +1,158 @@ +.\" @(#)vosloanspec.1 1.0 Feb-2013 MJF +.TH VOSLOANSPEC 1 "Feb 2013" "VOClient Package" +.SH NAME +vosloanspec \- Query for SDSS spectra + +.SH SYNOPSIS +\fBvosloanspec\fP [<opts>] <obj> | {<ra> <dec>} | {<ra> <dec> <radius>} + +.SH OPTIONS +The \fIvosloanspec\fP application accepts the following options: +.TP 8 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.TP 6 +.B \-P \fIRA\fP,\fIDEC\fP, --pos=\fIRA\fP,\fIDEC\fP +Set the query position (dec degrees). +.TP 6 +.B \-R \fIREL\fP, --release=\fIREL\fP +Data release to query, allowed values are 'dr8' or 'dr9', the default is +to use whatever version is defined by the service as 'current'. +.TP 6 +.B \-s \fIRADIUS\fP, --size=\fIRADIUS\fP +Set query radius (dec degrees). The service imposes a max query radius of 10 +degrees. +.TP 6 +.B \-t \fITYPE\fP, --type=\fITYPE\fP +Object type constraint. If not specified then all available spectra will +be returned, allowed values for the constraint are 'galaxy', 'qso' and 'star'. +.TP 6 +.B \-z \fIZRANGE\fP, --redshift=\fIZRANGE\fP +Select by redshift range string(s). A range is specified as two values +separated by a hyphen character (e.g. "0.1-0.3"), multiple ranges may be +specified in a comma-delimited list (e.g. "0.1-0.3,1.0-1.5"). + +.TP 6 +.B \-c, --count +Return only count of results available. +.TP 6 +.B \-m, --meta +Print result position metadata. +.TP 6 +.B \-D, --delete +Delete spectra after printing metadata. In order to obtain the metadata, the +data are actually downloaded and then read, this option will delete these +files once the task exits. +.TP 6 +.B \-l \fIN\fP, --limit=\fIN\fP +Limit to top \fIN\fP results. +.TP 6 +.B \-u, --urls +Get urls to spectra only. + +.TP 6 +.B \-S, --samp +Broadcase urls as a SAMP spectrum message. +.TP 6 +.B \-T, --table +Broadcase urls as SAMP load VOTable message. +.TP 6 +.B \-N \fIN\fP, --num=\fIN\fP +Number of download threads to run in parallel (default: 12). + +.TP 6 +.B \-f \fIFILE\fP, --file=\fIFILE\fP +Input file of positions. +.TP 6 +.B \-b \fIFILE\fP, --base=\fIFILE\fP +Base filename of downloaded files. +.TP 6 +.B \-O \fIFILE\fP, --output=\fIFILE\fP +Output file for results. +.TP 6 +.B \-o \fIOBJ\fP, --object=\fIOBJ\fP +Object name to resolve to query position. + +.SH DESCRIPTION +The \fIvosloanspec\fP task provides access to Data Release 9 of +the SDSS III Spectral Data. This dataset contains over 1.5 million galaxies, +230,000 quasars, and 670,000 stars covering 14,500 square degrees of the sky. +.PP +Queries by position may be done using either a resolvable object name or an +explicit (RA,Dec) position given in ICRS decimal degrees. The \fI-P\fP flag +can be used to specify the position as a single argument. The default query +size is 0.25 degrees and may be changed using the \fI-s\fP flag. If the +DR8 release of the dataset is desired the \fI-R dr8\fP option may be used, +by default the task will use whichever data release is deemed 'current' y +the service (DR9 as of this writing). Spectra may be limited to a selection +of just 'galaxy', 'qso' or 'star' objects using the \fI-t\fP option. The +\fI-z\fP option may be used to constrain the search by range of redshift +values. +.PP +Unless otherwise modified, the task will automatically download FITS spectra +for all objects within the query region. The \fI-m\fP flag will print the +positions of each object found (e.g. for marking an overlay), the \fI-u\fP +flag will print the access URLs for the spectra. In the case of position +metadata the FITS files must actually be downloaded to the local machine +since the service doesn't provide this in a query return, the \fI-D\fP +flag will delete these images after the information is obtained. +.PP +To broadcast the spectra to SAMP-enabled applications using the +\fIspectrum\.load\.ssa-generic\fP message type, the \fI-S\fP option may be used. +The spectrum may be broadcast as a \fItable.load.FITS\fP message by specifying +the \fI-T\fP flag. + +.SH REFERENCES +This task is based on the API available from + +.nf + http://api.sdss3.org/ +.fi +See the documentation at this site for additional information about +parameters. The \fIvosloanspec\fP task attempts to provide a useful data +client using a non-VO interface and will eventually be replaced by a +task with similar functionality using standard SSA services. + +.SH RETURN STATUS +On exit the \fBvotcnv\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Download all galaxy spectra w/in 0.1 deg of the Hubble Ultra Deep Field: + +.nf + % vosloanspec -s 0.1 -t galaxy HUDF + % vosloanspec --size=0.1 --type=galaxy HUDF +.fi +.TP 4 +2) Get only the positions of the SDSS spectra around a point: + +.nf + % vosloanspec -m -D m51 + % vosloanspec --meta --delete m51 +.fi +.TP 4 +3) Broadcast 5 spectra around 3c273 to SAMP-enabled apps: + +.nf + % vosloanspec -l 5 --samp 3c273 # as a spectrum msg + % vosloanspec -l 5 --samp --table 3c273 # as a table msg +.fi +.TP 4 +4) Get all QSO spectra with a redshift > 0.3 (Note an upper range must be specified for the redshift range for a valid query): + +.nf + % vosloanspec --redshift=0.3-1.0 +.fi + +.SH BUGS +No known bugs with this release. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +vodata, vospectra, voregistry, votopic diff --git a/vendor/voclient/doc/OLD/vosloanspec.pdf b/vendor/voclient/doc/OLD/vosloanspec.pdf Binary files differnew file mode 100644 index 00000000..d1161343 --- /dev/null +++ b/vendor/voclient/doc/OLD/vosloanspec.pdf diff --git a/vendor/voclient/doc/README b/vendor/voclient/doc/README new file mode 100644 index 00000000..e234465a --- /dev/null +++ b/vendor/voclient/doc/README @@ -0,0 +1,3 @@ + + This directory contains the troff source files for the VOAPPS tasks. +Help pages in other formats are included in the named subdirectories. diff --git a/vendor/voclient/doc/TODO b/vendor/voclient/doc/TODO new file mode 100644 index 00000000..e255e054 --- /dev/null +++ b/vendor/voclient/doc/TODO @@ -0,0 +1,36 @@ + + Task Help Examples Tests + ---- ---- -------- ----- +Data Access Tasks: + voatlas Y Y Y - + vocatalog Y Y Y - + vodata Y Y Y - + voimage Y Y Y - + voiminfo Y Y Y - + vosloanspec Y - Y - + vospectra Y Y Y - + votopic Y Y Y - + +Registry Tasks: + voregistry Y Y Y - + +VOTable Utility Tasks: + votcnv Y Y Y - + votget Y Y Y - + votinfo Y Y Y - + votpos Y Y Y - + votsort Y Y Y - + votstat Y Y Y - + +SAMP Tasks: + vosamp Y - - - + +Name Resolution + vosesame Y Y Y - + + + (1) Online help missing examples + (2) Online help missing options + (3) Help page missing examples + (4) Help page missing options + (5) No test cases in task source diff --git a/vendor/voclient/doc/Test.iraf b/vendor/voclient/doc/Test.iraf new file mode 100644 index 00000000..70d4de06 --- /dev/null +++ b/vendor/voclient/doc/Test.iraf @@ -0,0 +1,432 @@ + + 9/1/11 + + IRAF/VO Integration Testing + + +Test Machine, Sample Data Files/URLs +==================================== + + The test machine to be used is vaotest4.tuc.noao.edu (140.252.6.84) +which is a 32-bit Ubunto 10.10 Linux system. IRAF is installed for use +by all users, any needed support programs (STILTS, Topcat, etc) are all +available from the /usr/local/lib directory. Logins for testing should +be done using the 'iraftest' account on the machine (contact me for the +passwd). + + A directory of sample data files is inlcude in the ~iraftest/data +directory and may also be accessed at + + http://iraf.noao.edu/votest/ + +Sample data includes: + + sia.xml Sample SIA service result from MAST + sia2.xml Same result but with URLs pointing to NOAO + h_n5194-*.fits FITS files in the SIA file + + LGA_I_m32.xml Another SIA service result from IPAC + + sif.fits Standard dev$pix test image as a Simple FITS + mef.fits Standard dev$pix test image as a Multi-Extn FITS + + usno-b.xml Cone search table result from USNO-B + usno-b.fits Same file but as a FITS bintable + +Prefixing the above URL to these files should produce results the same +as if the local file were accessed. Using the e.g. 'sia2.xml' file as +an SIA result will have faster download times from the vaotest4 machine +but is otherwise the same. + + + +VOTable Support in Tasks +======================== + + The first phase of development adds support for VOTable documents to +any task expecting tabular data in one of the currently supported formats +(i.e. FITS tables, ascii tables, or ".tab" files). Typically these are +tasks in the NTTOOLS package (formerly the TABLES.TTOOLS package) but also +includes tasks in the DIGIPHOT package. The goal is that any task example +will work if the input file is a VOTable, for instance the commands + + cl> tlcol usno-b.xml + cl> tlcol usno-b.fits + +should produce identical results. + + Output tables cannot be written in VOTable format (yet), their use +is strictly input at this point. In the final VO package a task will +be provided that can be used to write tables out to VOTable. + + +Known Issues: + + - Req 1.1 cannot yet be satisfied due to the current implementation of + the internal conversion from XML to FITS. This now uses STILTS + as a stopgap, the code will be replaced with a native CFITSIO + conversion that will carry the PARAM/INFO fields into the PHU. + This also explains the brief delay when first opening a votable + (and imposes a dependency on STILTS that must be removed). + + - Req 1.2.1 refers to selection of a table column in the image list + enhancements. Addressing a column by a variety of XML attributes + is possible with some enhancements to the nttools$lib/tctexp.x + column template code but can't be done until the new conversion + code is in place. + + +URL Support in Tasks +==================== + + URL support is not a specific deliverable of the VO integration, but is +needed for the "seamless" aspects of the project (e.g. SAMP messages tend +to pass around URLs, data access references are URLs, etc). Thus, +modifications were made to each of the 'open' procedures used for image, +table and general file I/O to permit the argument to be an HTTP url. The +first time a URL is accessed it will be downloaded and put into the general +file cache, thereafter it will be the cache file that is opened. As with +VOTable support, URLs may be used for input arguments only (i.e. a URL +used as an output parameter name will not POST the file to the URL, an +error will be printed instead). + + The caching mechanism means that a URL such as an access reference +(or service query) may be used repeatedly without hitting the server +multiple times, but it also means there is no clear method of determining +when a URL would return new a different result, and that modifying the +cache file on the desktop means it no longer exactly represents the URL +source. In some cases this problem can be mitigated by setting a short +expiration time on the cache to force a refresh of the URL, otherwise we +put the burden on the user/developer to copy the URL file to a local name +for persistent use. + + Typical example command that would use a URL are things like + + cl> type http://iraf.noao.edu/index.html # files + cl> imstat http://iraf.noao.edu/votest/dpix.fits # images + cl> tlcol http://iraf.noao.edu/vo/testusno-b.xml # tables + +Note that in some output what gets printed in the cached filename and not +the URL. + + +File Caching +------------ + + A new FCACHE task is available in the main SYSTEM package for listing +and managing the file cache. Similarly, a 'cache' logical variable defines +the location of the cache directory itself. A few handy commands: + + cl> fcache init # initialize the cache + cl> fcache purge age=7 # remove files older than a week + cl> fcache list # list contents of cache$ and the src + +See the help page for details. Source for the FCACHE task is in +system$fcache.x and the task itself can/should be tested to make sure +it manipulates the files properly. Otherwise, the cache interface is +used by both the VOTable and URL support code to hide the details of +how the foreign files/formats are managed by the system. + + + +Image List Expansion +-------------------- + + The image list interface in IRAF was enhanced to allow for greater +selection capabilities and to expand the concept of what represents and +"image list" to include MEF files (the file itself is a list of the image +extensions it contains) and VOTables (the accessReference column is +inherently a list of URLs representing FITS files). Selectability is a +key new component since it is at the heart of the DAL philosophy of +query-then-access. + + Not all features of the image list expansion have yet been implemented, +in particular, selection-by-column-value when using VOTables is also +awaiting a proper VOTable conversion code. + + See iraf$sys/imio/imt/README for details. + + + +Known Issues: + + - The URL mechanism must also be made to support file:// prefixes + - The FCACHE task help page is not yet completed ..... + + + +SAMP Integration +================ + + SAMP interoperability is one of the promised deliverables and is meant +to allow CL scripts/tasks to send SAMP messages to other SAMP-enabled apps, +and for the CL to receive messages that make it useful in a SAMP workflow. +This requires an extension to the currently recognized list of SAMP mtypes +to include the following: + + Mtype Args Meaning + ----- ---- ------- + client.env.get <var> get an environment variable + client.env.set <var> <value> set an environment variable + client.param.get <param> get a parameter value + client.param.set <param> <value> set a parameter value + client.cmd.exec <cmd> execute a command + +These mtypes are supported by the SAMP library used by the system and so +the test application in the library can be used to exercise the IRAF +implementation. In this case, a <param> argument is expected to be in +the format "<task>.<param>', e.g. as "implot.image" to refer to the 'image' +parameter of the 'implot' task. Similarly, the <cmd> argument is a string +expected to contain a fully valid iraf command string. + + A valid SAMP Hub must be running for messages to be sent or received. +We rely on either an external standalone Hub being available or that some +other SAMP app has a builtin Hub running. Demonstrating the requirements +have been met for SAMP interoperability should be easy to do. + + +Sending Messages from IRAF +-------------------------- + + Sending messages is done using the following builtin CL functions: + + sampLoadImage (file|url [, recip [, name [, tag ]]]) + sampLoadFITS (file|url [, recip [, name [, tag ]]]) + sampLoadVOTable (file|url [, recip [, name [, tag ]]]) + +These functions map directly to the most commonly used SAMP mtypes, +additional (or generalized) functions could be added but it isn't clear +these are necessary for an IRAF application. Examples would include: + + 1) Broadcast the message to all subscribed clients: + + cl> = sampLoadImage ("http://iraf.noao.edu/votest/sif.fits") + + 2) Send the message to a named client: + + cl> = sampLoadImage ("data$foo.fits", "aladin") + + 3) Load the image with a given name: + + cl> = sampLoadFITS ("/data/image001.fits", "aladin", "image1") + +Each function returns either an "ok" string or an error message. + + + +Receiving Messages in IRAF +-------------------------- + + The VOCL will connect to a SAMP Hub on startup and is already +configured to handle the above 5 mtypes. The env and parameter +set/get methods don't cause any output to the terminal window, however +a client.cmd.exec message will echo the command string to the prompt +line just as if the user had typed it. + + The intent of receiving messages like this is that an IRAF command +can be invoked from SAMP, however no attempt is currently made to use +SAMP messaging to drive the application itself (e.g to allow subsequent +SAMP messages to provide cursor input). + + Dummy handlers are currently in place to accept other mtypes but +just silently consumes the message. The last step is to implement a +function such as + + sampHandler (mtype, cmd_string) + +to the CL the allow a particular command string to be called when a +message of the given mtype is received. This would allow users to post +commands they wish to call in response to e.g. an image.load.fits message. +Expect this functionality very soon. + + +Sending Test Messages +--------------------- + +The SAMP library test apps can be used to send specific messages to IRAF +for testing. In particular, the 'send' command is installed in +/usr/local/bin and can be used as e.g. + + % send -r iraf client.cmd.exec imstat dev\$pix + +where the "-r iraf" says the recipient is 'iraf' (the name broadcast by +the VOCL when it connects to the Hub), the 'client.cmd.exec' mtype should +be sent, and the remaining args make up the command itself (in this case, +a "imstat dev$pix" command -- note the '$' must be escaped from the unix +shell to be passed in this way). + + The '-h' flag will print a help summary for the 'send' command. Source +code for the SAMP library used is in the 'libsamp' subdirectory of the +iraftest account for inspection, see the libsamp/examples directory for +the send.c source. + + +Starting the VOCL +----------------- + + The VOCL (VO-enabled CL) is not yet configured to be the default CL +for the v2.16 release and so must be started using the alternative command + + % cl -vo + +For the 'iraftest' account this has been alias to just the plain 'cl' +command for convenience, a decision will be made following testing as +to whether this version is stable enough to be made the distribution +default. + + +Starting the SAMP Hub +--------------------- + + In order to test either the sending/receiving of messages, a Hub +must be running on the machine. This can be a builtin hub such as that +found in Topcat (installed on vaotest4), or using the standalone JSamp +Hub. To start a JSAmp hub, in a separate window on vaotest4 type: + + % /usr/local/bin/hub +or % /usr/local/bin/topcat + +Note that in either case you'll need to have an X11 DISPLAY set. + + + +Known Issues: + + - Discovery of a Hub needs to be automated, i.e. if there is no Hub + running when a VOCL session starts, it is never searched for again. + What we'd like is for the VOCL to watch for a Hub to appear and + then connect automatically so subsequent commands in the same VOCL + session can begin messaging. + - Must still implement + sampShowRow () sampSelectRowList () + sampPointAt () sampSpecLoad () + + + + +------------------------------------------------------------------------------- + +Automated Tests +=============== + + The following is taken directly from the /iraf/iraf/vo/votest/README +file and is intended to explain how the automated test system works. The +idea is that once the VOCL is started, the VOTEST package can be loaded +to run a series of regression tests. These tests are comprised of whatever +scripts are available in the votest$tests directory (which has been made +publically writeable on the vaotest4 machine). We expect that as the +VO/IRAF testing progresses, additional tests will be added to this directory. + + + + VO Test Package + + The VOTEST package allows users and developers to create simple scripts +that can be used to run a regression test on the package after changes to +system interfaces, test for specific problems to be sure they done recur, +and the ensure that the help examples continue to function as specified. + +This directory contains the following: + + README This file + + data/ Sample data directory + tests/ Test script directory + + run_test.cl Utility task to execute a single test + test.cl Main test script + + votest.cl Standard package files + votest.hd + votest.men + votest.par + doc/ Task documentation directory + + +Test Script Usage: +------------------ + + The package defines a single (visible) task call TEST with the following +usage: + + cl> test [<module>] [list] [verbose] + +where + module Either 'all' or the name of a specific test module + list If set, list available tests only + verbose Print verbose output + +If no parameters are specified, all tests are run. + + +To Add A New Test: +------------------ + + Test scripts are placed in the 'tests' subdirectory and are expected to +follow the following conventions: + + 1) A description of tests in a "module" is contained in a file 'module.men' + and should contain something like + + # Module Tests -- Tests of the stuff needing testing + + module_001 -- test 1 description + module_002 -- test 2 description + : : : : + module_NNN -- test N description + + Lines beginning with a '#' will be used to comment the tests being run. + + 2) A module test script contains commands to be executes. It *should* + also set the "votest.descr" parameter to be some short description + of the test, this text is printed when the test is run. Test scripts + should be named using the convention 'module_NNN.cl' where "module" is + the common module name, "NNN" is some running number for the test, and + the script is expected to have a ".cl" filename extension. + + 3) A module test script that produces any form of output should have the + expected output in a file called "module_NNN.out". A test is deemed to + have passed when a diff of this file with the output of the test script + produces no output (i.e. no differences). + + 4) A "test module" is comprised of all the above ".men", ".cl" and ".out" + files. Typically tests will be grouped by some common these, e.g. a + particular task or feature of the system to be tested. + +The TEST task will automatically execute any scripts in the 'tests' directory, +minimizing the amount of changes required to add a new test. + + + + + +------------------------------------------------------------------------------- + + +Requirements Summary: +===================== + +VOTable Support: + 1. Users shall be able to use a VOTable in places where tasks accept + tabular data in other formats (ASCII files, FITS bintables, .tab + files, etc) for input. + 1.1 Users shall be able to access the <PARAM> and <INFO> elements of a + VOTable as standard table header information. + 1.2 Users shall be able to select specific rows and/or columns of a + VOTable using the existing task functionality. + 1.2.1 Users shall be able to identify a column in a VOTable by the 'id', + 'name' or 'ucd' attribute of a <FIELD> or by column number. + 1.3 Users shall be able to select a column in a VOTable for use in tasks + that expect a list of values. + 1.4 VOTable Interface code will support the IVOA Standard specification + of the VOTable format at time of release. + + +SAMP Interoperability + 2. Users shall be able to interoperate with other SAMP (or WebSAMP) + enabled applications. + 2.1 Users shall be able to send messages to specific clients or + broadcast to all available clients. + 2.2 Users shall be able to execute IRAF tasks and set/retrieve + information in/from the IRAF environment via SAMP messaging from + clients that implement the required message types. diff --git a/vendor/voclient/doc/_deploy b/vendor/voclient/doc/_deploy new file mode 100755 index 00000000..c6940658 --- /dev/null +++ b/vendor/voclient/doc/_deploy @@ -0,0 +1,5 @@ +#!/bin/csh -f + +scp -p *.man tucana:voc/doc/ +scp -p *.man tucana:vao/voc.svn/doc/ +scp -p *.man tucana:vao/voc.svn/../rel/1.0/doc/ diff --git a/vendor/voclient/doc/_menu b/vendor/voclient/doc/_menu new file mode 100644 index 00000000..180b848c --- /dev/null +++ b/vendor/voclient/doc/_menu @@ -0,0 +1,18 @@ + + voatlas - Query the SkyView Image service for an all-sky image + vocatalog - Query VO catalog services for data + vodata - query and access VO data services + voimage - Query VO image services for data + votiminfo - Print/Get information about a FITS file's structure + voregistry - VO Registry search client + vosesame - call the Sesame name resolver service + vosloanspec - Query for SDSS spectra + vospectra - Query VO spectral services for data + votcnv - Convert from VOTable to another format + votget - Download URLs or access references in a VOTable + votinfo - Get information about a VOTable + votopic - Query for data from resources specified by topic keyword + votpos - Extract the main positional columns from a VOTable + votsort - Extract the main positional columns from a VOTable + votstat - Compute statistics for numeric columns of a VOTable. + diff --git a/vendor/voclient/doc/_mkdoc b/vendor/voclient/doc/_mkdoc new file mode 100755 index 00000000..5b0615ee --- /dev/null +++ b/vendor/voclient/doc/_mkdoc @@ -0,0 +1,12 @@ +#!/bin/csh -f +# +# MKDOC -- Utility script to convert man pages to other formats [MACHDEP] +# +# Mike Fitzpatrick, NOAO, Nov 2011 + + +foreach doc (*.man) + groff -man -T ps ${doc}.man > ${doc}.ps + ps2pdf ${doc}.ps + man2html ${doc}.man > ${doc}.html +end diff --git a/vendor/voclient/doc/_mktemp b/vendor/voclient/doc/_mktemp new file mode 100755 index 00000000..285024a9 --- /dev/null +++ b/vendor/voclient/doc/_mktemp @@ -0,0 +1,60 @@ +#!/bin/csh -f +# +# MKTEMP -- Utility script to make a template man page. +# +# Usage: % mktemp <taskname> +# +# Mike Fitzpatrick, NOAO, Nov 2011 + + +set tlc = $1 +set Tlc = `echo $1 | tr a-z A-Z` + +cat << EOF_TEMPLATE > /tmp/t$$ +.\" @(#)task.1 1.0 Feb-2013 MJF +.TH TASK 1 "Feb 2013" "VOClient Package" +.SH NAME +task \- short description +.SH SYNOPSIS +\fBtask\fP [\-\fopts\fP] file + +.SH OPTIONS +The \fItask\fP application accepts the following options: +.TP 8 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.SH DESCRIPTION +The \fItask\fP application ...... +.PP +More descriptions ..... + +.SH SUB-DESCRIPTION +More useful stuff ....... + +.SH RETURN STATUS +On exit the \fBtask\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Queury for .... +.nf + % task ..... +.fi + +.SH BUGS +No known bugs with this release. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +voregistry, votinfo, votpos, votsort, votstat + +EOF_TEMPLATE + + +cat /tmp/t$$ | sed -e "s/task/${tlc}/g" -e "s/TASK/${Tlc}/g" > $1.man +/bin/rm -rf /tmp/t$$ diff --git a/vendor/voclient/doc/_tests b/vendor/voclient/doc/_tests new file mode 100644 index 00000000..ec7d89c6 --- /dev/null +++ b/vendor/voclient/doc/_tests @@ -0,0 +1,167 @@ +# voatlas + voatlas -S m83 or + voatlas --samp m83 + + voatlas -o gal.jpg -n 256 --graphic sombrero + voatlas -s 20m --survey=wise22 m101 + voatlas --band=radio 3c273 + voatlas --survey=list -v ngc1234 + +# vocatalog + vocatalog gsc2.3 ngc1234 (a) + vocatalog gsc2.3 pos.txt (b) + vocatalog gsc2.3 m31,m51,m93 (c) + vocatalog svcs.txt pos.txt (d) + vocatalog hst,chandra,gsc2.3 pos.txt (e) + vocatalog -count -b x-ray any abell2712\n\ + +# vodata + vodata gsc2.3 ngc1234 (a) + vodata gsc2.3 pos.txt (b) + vodata gsc2.3 m31,m51,m93 (c) + vodata svcs.txt pos.txt (d) + vodata hst,chandra,gsc2.3 pos.txt (e) + + vodata -c -t image any IC10 + vodata --count --type=image any IC10 + vodata -c -t catalog -b x-ray any abell2712 + vodata --count --type=catalog --bandpass=x-ray any abell2712 + + vodata --meta rc3 or vodata -m rc3 + + voregistry cooling flow + vodata -O white97 -all J/MNRAS/292/419 + vodata --output=white97 --all J/MNRAS/292/419 + + voregistry -rv -t image xmm + vodata -cq xmm-newton 3c273 + vodata --count --quiet xmm-newton 3c273 + vodata --get xmm-newton 3c273 + + vodata -e -O 2mass -t image 2mass 12:34:56.7 -23:12:45.2 + vodata -e --output=2mass --type=image 2mass 12:34:56.7 -23:12:45.2 + grep fits 2mass_I_001_15998.urls > images.txt + vodata images.txt + grep fits 2mass_I_001_15998.urls | vodata -i - + + vodata -t image -s http://localhost/siap.pl 180.0 0.0 + vodata --type=image --svc=http://localhost/siap.pl 180.0 0.0 + + voregistry -v -v --type=catalog abell | less + vodata -e ivo://nasa.heasarc/abell 0.0 0.0 180.0 + vodata --extract ivo://nasa.heasarc/abell 0.0 0.0 180.0 + + cut -c6- *.pos | vodata ivo://nasa.heasarc/chanmaster -p - + cut -c6- *.pos | vodata ivo://nasa.heasarc/chanmaster --pos=- + vodata -cq chandra -i - + stilts tpipe ifmt=votable qso_survey.vot \ + + wcsinfo *.fits | vodata 2mass-psc -i - + wcsinfo -pos_only *.fits > centers.txt + vodata --sr=25m 2mass-psc centers.txt + + cat cmds.txt + vodata -i cmds.txt + + vodata -a galex M51 + vodata --all galex M51 + + vodata gsc2.3 positions.txt + vodata --cols=2,3,1 --hskip=5 gsc2.3 positions.txt + +# voimage + voimage -b x-ray any m51 + voimage -c HSTAEC IC10 + +# voiminfo + votiminfo -n mef.fits + voiminfo -b -s image.fits + voiminfo -c image.fits\n" + voiminfo -b -f pos.txt mef.fits\n" + +# voregistry + voregistry -count -t image + voregistry -rv -t image + voregistry -t catalog radio galaxies + voregistry -list GSC2.2 + voregistry -b radio abell + voregistry -rvv -n 1 J/A+A/446/97/tab + voregistry -v -t image wfpc + voregistry -cv keck + voregistry -c chandra hst spitzer + voregistry -co chandra hst spitzer + voregistry -meta gsc2.2 + voregistry "Facility like 'HST'" + voregistry "Title like '%Keck%'" + cat query.txt + cat query.txt | voregistry + voregistry --new 3m + voregistry --new 3m cool stars + voregistry --updated 12m --count + +# vosamp + vosamp load /path/example.xml + vosamp load http://foo.edu/example.xml + vosamp load http://foo.edu/query?RA=0.0&DEC=0.0&SR=0.1 + vosamp -t iraf exec "display dev$pix 1" + vosamp list + +# vosesame + vosesame ngc4456 + vosesame -s ngc4456 + vosesame -st m31 m51 m99 + vosesame -CHndt myobjs.txt + cut -c17-25 data.txt | vosesame -ns + vosesame -a + vosesame -sd -c 12:30:0.0 -45:00:0.0 -c 187.5 2.05 + +# vosloanspec + vosloanspec -s 0.1 -t galaxy 'Hubble Deep Field' + vosloanspec --size=0.1 --type=galaxy 'Hubble Deep Field' + vosloanspec -m -d m51 + vosloanspec --meta --delete m51 + vosloanspec -l 5 --samp 3c273 # as a spectrum msg + vosloanspec -l 5 --samp --table 3c273 # as a table msg + vosloanspec --redshift=0.3-1.0 + +# vospectra + vospectra any 3c273 + +# votcnv + votcnv --fmt=csv test.xml + votcnv -f vot -i 2 test.xml + votcnv -f vot -i 0 test.xml + +# votget + votget -N 3 results.xml + votget -b foo -e fits -S + votget -b foo urls.txt + votget -x results.xml + +# votinfo + votinfo -v test.xml + votinfo -p test.xml + votinfo --numberOf=param test.xml + votinfo -q test.xml + +# votopic + votopic -t catalog lens A2712 + voregistry -t catalog -d -o lens.xml lens + vodata lens.xml A2712 + +# votpos + votpos test.xml # un-numbered + votpos -n test.xml # numbered + cat test.xml | votpos # un-numbered + votpos -o pos.txt test.xml + +# votsort + votsort test.xml + votsort http://generic.edu/test.xml + cat test.xml | votsort -o sort_test.xml + votsort --name=V test.xml + votsort --name=V --desc --top=10 test.xml + votsort -s -f csv test.xml + votsort --string --fmt=csv test.xml + votstat test.xml + votsort -a -o stats test.xml diff --git a/vendor/voclient/doc/mkdoc b/vendor/voclient/doc/mkdoc new file mode 100755 index 00000000..c6ab4278 --- /dev/null +++ b/vendor/voclient/doc/mkdoc @@ -0,0 +1,11 @@ +#!/bin/csh -f + + +foreach d ( $1 ) + echo -n "$d .... " + set doc = $d:r + groff -man -T ps ${doc}.man > ${doc}.ps + ps2pdf ${doc}.ps ; /bin/rm -f ${doc}.ps + man2html ${doc}.man > ${doc}.html + echo "done" +end diff --git a/vendor/voclient/doc/mkpage b/vendor/voclient/doc/mkpage new file mode 100755 index 00000000..285024a9 --- /dev/null +++ b/vendor/voclient/doc/mkpage @@ -0,0 +1,60 @@ +#!/bin/csh -f +# +# MKTEMP -- Utility script to make a template man page. +# +# Usage: % mktemp <taskname> +# +# Mike Fitzpatrick, NOAO, Nov 2011 + + +set tlc = $1 +set Tlc = `echo $1 | tr a-z A-Z` + +cat << EOF_TEMPLATE > /tmp/t$$ +.\" @(#)task.1 1.0 Feb-2013 MJF +.TH TASK 1 "Feb 2013" "VOClient Package" +.SH NAME +task \- short description +.SH SYNOPSIS +\fBtask\fP [\-\fopts\fP] file + +.SH OPTIONS +The \fItask\fP application accepts the following options: +.TP 8 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.SH DESCRIPTION +The \fItask\fP application ...... +.PP +More descriptions ..... + +.SH SUB-DESCRIPTION +More useful stuff ....... + +.SH RETURN STATUS +On exit the \fBtask\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Queury for .... +.nf + % task ..... +.fi + +.SH BUGS +No known bugs with this release. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +voregistry, votinfo, votpos, votsort, votstat + +EOF_TEMPLATE + + +cat /tmp/t$$ | sed -e "s/task/${tlc}/g" -e "s/TASK/${Tlc}/g" > $1.man +/bin/rm -rf /tmp/t$$ diff --git a/vendor/voclient/doc/voatlas.html b/vendor/voclient/doc/voatlas.html new file mode 100644 index 00000000..a0458197 --- /dev/null +++ b/vendor/voclient/doc/voatlas.html @@ -0,0 +1,222 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOATLAS</TITLE> +</HEAD><BODY> +<H1>VOATLAS</H1> +Section: User Commands (1)<BR>Updated: Feb 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +voatlas - Query the SkyView Image service for an all-sky image +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>voatlas</B> [<opts>] [<field> | <pos>] +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>voatlas</I> application accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<P> +<DT><B>-b </B><I>BPASS</I>,--band <I>BPASS</I> + +<DD> +Bandpass of image to retrieve. Allowed values are 'optical', 'infrared' (or + +bandpass name is used. +<DT><B>-p,--survey </B><I>SURVEY</I> + +<DD> +Survey program name. The list of available surveys is described at +<I><A HREF="http://skyview.gsfc.nasa.gov/cgi-bin/survey.pl">http://skyview.gsfc.nasa.gov/cgi-bin/survey.pl</A></I>. +<DT><B>-g,--graphic</B> + +<DD> +Get a graphic image (i.e. a JPEG), the default is to get a FITS image. +<DT><B>-n,--naxis </B><I>NPIX</I> + +<DD> +Set returned image size. The default image size returned is 512x512. +<P> +<DT><B>-s,--size </B><I>SIZE</I> + +<DD> +Field size to generate. The SIZE value may be appended with an 's', + +(default) respectively. The default size is 0.25 degrees. +<DT><B>-F,--field </B><I>FIELD</I> + +<DD> +Name of the field (e.g. an object name like 'M33') to query. The object +name must be resolvable with a task like VOSESAME, the position returned +will be the center of the query. +<DT><B>-R </B><I>RA</I>,--ra <I>RA</I> + +<DD> +The RA position of the query. +<DT><B>-D </B><I>DEC</I>,--dec <I>DEC</I> + +<DD> +The Dec position of the query. +<DT><B>-P </B><I>RA,DEC</I>,--pos <I>RA,DEC</I> + +<DD> +Specify the query position as a comma-delimited string of RA and DEC. +<DT><B>-S,--samp</B> + +<DD> +Broadcast resulting image as a SAMP message. The image will be broadcast +using the 'image.load.fits' mtype. +<DT><B>-v,--verbose</B> + +<DD> +Print verbose output during execution. +<DT><B>-o </B><I>NAME</I>, --output <I>output</I> + +<DD> +Specify the filename of the downloaded image. If not specified a name +created from the field name or position will be used. +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>voatlas</I> task queries the NASA SkyView all-sky survey data for +an image of the requested sky position in the requested bandpass. The +position may be given as the name of an object who's coordinate can be +resolved, or as an explicit position in RA and Dec (ICRS decimal degrees). +The default field of view will be 0.25 degrees but may be changed using +the <I>-s</I> option (with an optional 's', 'm' or 'd' on the value to +specify arcseconds, arcminutes or degrees respectively). The default +image will be in FITS format unless the <I>-g</I> option is set to request +a graphic such as a JPEG, the default size will be 512x512 pixels unless the +<I>-n</I> option is used to set a different size (the image will always +be square so only one value is required). The resulting image may be +broadcast using the SAMP 'image.load.FITS' mtype by setting the <I>-S</I> +option. +<P> + +The <I>-b</I> flag is used to select the desired bandpass, if not set then +and optical image from the DSS2B survey is used by default. Allowed values +for the bandpass string and their corresponding survey names are: +<P> + +<I>Bandpass<TT> </TT> ShortName<TT> </TT>Title</I><BR> + +optical<TT> </TT> DSS<TT> </TT><TT> </TT>Digital Sky Survey<BR> + +infrared<TT> </TT> 2MASSK<TT> </TT>Two-micron All Sky Survey (K-band)<BR> + +x-ray<TT> </TT> PSPC2INT<TT> </TT>ROSAT PSPC (2-deg cutoff)<BR> + +euv<TT> </TT><TT> </TT> EUV83<TT> </TT><TT> </TT>EUV Explorer83A<BR> + +gamma-ray<TT> </TT> EGRET1000<TT> </TT>Energetic Gamma-Ray Event Telescope: Hard<BR> + +radio<TT> </TT> 4850MHZ<TT> </TT>4850 MHz Survey - GB6/PMN<BR> +<P> + +If the <I>-p</I> option is used to specify a particular survey program, the +bandpass parameter is ignored. The <I>-p</I> flag reserves the name 'list' +as a means to have the task return a list of available data for the field. +This list contains the survey name and the mime-type of the available image. +Script tasks can use this information to determine the best available +image for the field. +<P> + +If no input file is specified the VOTable will be read from the stdin, +results will be written to stdout unless the <I>-o</I> (or <I>--output</I>) +names an output file. The task will only process a single VOTable and may +not be used to convert multiple files in a single call. +<P> +<A NAME="lbAF"> </A> +<H2>RETURN STATUS</H2> + +On exit the <B>voatlas</B> task will return a zero indicating success, or a +one indicating an error. +<P> +<A NAME="lbAG"> </A> +<H2>EXAMPLES</H2> + +<DL COMPACT> +<DT>1) Display an image of M83 on Aladin using SAMP<DD> +<P> +<PRE> + % voatlas -S m83 or % voatlas --samp m83 +</PRE> + +<DT>2) Get a 256x256 JPEG image of the Sombrero galaxy<DD> +<P> +<PRE> + % voatlas -o gal.jpg -n 256 --graphic sombrero +</PRE> + +<DT>3) Get a 20 arcmin Wise 2.2micron survey image of m101<DD> +<P> +<PRE> + % voatlas -s 20m --survey=wise22 m101 +</PRE> + +<DT>4) Get a radio image of 3c273, image will be '3c273.fits'<DD> +<P> +<BR> % voatlas --band=radio 3c273 + +<DT>5) List (verbose) the survey images available for ngc1234<DD> +<P> +<PRE> + % voatlas --survey=list -v ngc1234 +</PRE> + +</DL> +<A NAME="lbAH"> </A> +<H2>BUGS</H2> + +1) There is currently no convenient way to get a list of surveys without +specifying a position, this is due to the way Skyview is implemented. +<P> +2) There is currently no convenient way to select other than the first +available image. +<A NAME="lbAI"> </A> +<H2>Revision History</H2> + +Feb 2013 - First public release +<A NAME="lbAJ"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), Feb 2013 +<A NAME="lbAK"> </A> +<H2>SEE ALSO</H2> + +vodata, vocatalog, voimage, vospectra +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">RETURN STATUS</A><DD> +<DT><A HREF="#lbAG">EXAMPLES</A><DD> +<DT><A HREF="#lbAH">BUGS</A><DD> +<DT><A HREF="#lbAI">Revision History</A><DD> +<DT><A HREF="#lbAJ">Author</A><DD> +<DT><A HREF="#lbAK">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 05:13:22 GMT, April 14, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/voatlas.man b/vendor/voclient/doc/voatlas.man new file mode 100644 index 00000000..2e0c5eca --- /dev/null +++ b/vendor/voclient/doc/voatlas.man @@ -0,0 +1,155 @@ +.\" @(#)voatlas.1 1.0 Feb-2013 MJF +.TH VOATLAS 1 "Feb 2013" "VOClient Package" +.SH NAME +voatlas \- Query the SkyView Image service for an all-sky image + +.SH SYNOPSIS +\fBvoatlas\fP [<opts>] [<field> | <pos>] + +.SH OPTIONS +The \fIvoatlas\fP application accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.TP 6 +.B \-b \fIBPASS\fP,--band \fIBPASS\fP +Bandpass of image to retrieve. Allowed values are 'optical', 'infrared' (or +'ir'), 'x-ray', 'euv', 'gamma-ray', or 'radio'. A minimal match to the +bandpass name is used. +.TP 6 +.B \-p,--survey \fISURVEY\fP +Survey program name. The list of available surveys is described at +\fIhttp://skyview.gsfc.nasa.gov/cgi-bin/survey.pl\fP. +.TP 6 +.B \-g,--graphic +Get a graphic image (i.e. a JPEG), the default is to get a FITS image. +.TP 6 +.B \-n,--naxis \fINPIX\fP +Set returned image size. The default image size returned is 512x512. + +.TP 6 +.B \-s,--size \fISIZE\fP +Field size to generate. The SIZE value may be appended with an 's', +'m' or 'd' to specify the size in arcseconds, arcminutes or degrees +(default) respectively. The default size is 0.25 degrees. +.TP 6 +.B \-F,--field \fIFIELD\fP +Name of the field (e.g. an object name like 'M33') to query. The object +name must be resolvable with a task like VOSESAME, the position returned +will be the center of the query. +.TP 6 +.B \-R \fIRA\fP,--ra \fIRA\fP +The RA position of the query. +.TP 6 +.B \-D \fIDEC\fP,--dec \fIDEC\fP +The Dec position of the query. +.TP 6 +.B \-P \fIRA,DEC\fP,--pos \fIRA,DEC\fP +Specify the query position as a comma-delimited string of RA and DEC. +.TP 6 +.B \-S,--samp +Broadcast resulting image as a SAMP message. The image will be broadcast +using the 'image.load.fits' mtype. +.TP 6 +.B \-v,--verbose +Print verbose output during execution. +.TP 6 +.B \-o \fINAME\fP, --output \fIoutput\fP +Specify the filename of the downloaded image. If not specified a name +created from the field name or position will be used. + +.SH DESCRIPTION +The \fIvoatlas\fP task queries the NASA SkyView all-sky survey data for +an image of the requested sky position in the requested bandpass. The +position may be given as the name of an object who's coordinate can be +resolved, or as an explicit position in RA and Dec (ICRS decimal degrees). +The default field of view will be 0.25 degrees but may be changed using +the \fI-s\fP option (with an optional 's', 'm' or 'd' on the value to +specify arcseconds, arcminutes or degrees respectively). The default +image will be in FITS format unless the \fI-g\fP option is set to request +a graphic such as a JPEG, the default size will be 512x512 pixels unless the +\fI-n\fP option is used to set a different size (the image will always +be square so only one value is required). The resulting image may be +broadcast using the SAMP 'image.load.FITS' mtype by setting the \fI-S\fP +option. +.PP +The \fI-b\fP flag is used to select the desired bandpass, if not set then +and optical image from the DSS2B survey is used by default. Allowed values +for the bandpass string and their corresponding survey names are: + +.in 9 +\fIBandpass ShortName Title\fP +.in 9 +optical DSS Digital Sky Survey +.in 9 +infrared 2MASSK Two-micron All Sky Survey (K-band) +.in 9 +x-ray PSPC2INT ROSAT PSPC (2-deg cutoff) +.in 9 +euv EUV83 EUV Explorer83A +.in 9 +gamma-ray EGRET1000 Energetic Gamma-Ray Event Telescope: Hard +.in 9 +radio 4850MHZ 4850 MHz Survey - GB6/PMN + +.in 7 +If the \fI-p\fP option is used to specify a particular survey program, the +bandpass parameter is ignored. The \fI-p\fP flag reserves the name 'list' +as a means to have the task return a list of available data for the field. +This list contains the survey name and the mime-type of the available image. +Script tasks can use this information to determine the best available +image for the field. +.PP +If no input file is specified the VOTable will be read from the stdin, +results will be written to stdout unless the \fI\-o\fP (or \fI\--output\fP) +names an output file. The task will only process a single VOTable and may +not be used to convert multiple files in a single call. + +.SH RETURN STATUS +On exit the \fBvoatlas\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Display an image of M83 on Aladin using SAMP + +.nf + % voatlas -S m83 or % voatlas --samp m83 +.fi +.TP 4 +2) Get a 256x256 JPEG image of the Sombrero galaxy + +.nf + % voatlas -o gal.jpg -n 256 --graphic sombrero +.fi +.TP 4 +3) Get a 20 arcmin Wise 2.2micron survey image of m101 + +.nf + % voatlas -s 20m --survey=wise22 m101 +.fi +.TP 4 +4) Get a radio image of 3c273, image will be '3c273.fits' + + % voatlas --band=radio 3c273 +.fi +.TP 4 +5) List (verbose) the survey images available for ngc1234 + +.nf + % voatlas --survey=list -v ngc1234 +.fi +.SH BUGS +1) There is currently no convenient way to get a list of surveys without +specifying a position, this is due to the way Skyview is implemented. + +2) There is currently no convenient way to select other than the first +available image. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +vodata, vocatalog, voimage, vospectra diff --git a/vendor/voclient/doc/voatlas.pdf b/vendor/voclient/doc/voatlas.pdf Binary files differnew file mode 100644 index 00000000..856fa1d2 --- /dev/null +++ b/vendor/voclient/doc/voatlas.pdf diff --git a/vendor/voclient/doc/vocatalog.html b/vendor/voclient/doc/vocatalog.html new file mode 100644 index 00000000..72a16152 --- /dev/null +++ b/vendor/voclient/doc/vocatalog.html @@ -0,0 +1,113 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOCATALOG</TITLE> +</HEAD><BODY> +<H1>VOCATALOG</H1> +Section: User Commands (1)<BR>Updated: Feb 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +vocatalog - Query VO catalog services for data +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>vocatalog</B> [<opts>] <service> [ <object> | <ra> <dec> ] [ <size> ] +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>vocatalog</I> application accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<P> +<DT><B>All VODATA task options</B> + +<DD> +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>vocatalog</I> task is a convenience application built on top of the +<I>vodata</I> application, logically it will only query for catalog data and +will set the appropriate flags when calling <I>vodata</I>. +<P> + +For a complete list of options and a description of the task behavior, see +the <I>VODATA</I> man page. +<P> +<A NAME="lbAF"> </A> +<H2>RETURN STATUS</H2> + +On exit the <B>vocatalog</B> task will return a zero indicating success, or a +one indicating an error. +<P> +<A NAME="lbAG"> </A> +<H2>EXAMPLES</H2> + +<DL COMPACT> +<DT>1) Query the GSC 2.3 catalog for stars a) within the 0.1 degree default search size around NGC 1234: b) around all positions contained in file 'pos.txt': c) for the list of objects given on the command line: d) query a list of services for a list of positions: e) print a count of results that would be returned from 3 services for each position in a file:<DD> +<P> +<PRE> + % vocatalog gsc2.3 ngc1234 (a) + % vocatalog gsc2.3 pos.txt (b) + % vocatalog gsc2.3 m31,m51,m93 (c) + % vocatalog svcs.txt pos.txt (d) + % vocatalog hst,chandra,gsc2.3 pos.txt (e) +</PRE> + +<DT>2) Print a count of X-ray catalog data around Abell2712:<DD> +<P> +<PRE> + % vocatalog -c -b x-ray any abell2712 + % vocatalog --count -b x-ray any abell2712 +</PRE> + +<P> +</DL> +<A NAME="lbAH"> </A> +<H2>BUGS</H2> + +No known bugs with this release. +<A NAME="lbAI"> </A> +<H2>Revision History</H2> + +Feb 2013 - First public release +<A NAME="lbAJ"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), Feb 2013 +<A NAME="lbAK"> </A> +<H2>SEE ALSO</H2> + +vodata, voimage, vospectrum +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">RETURN STATUS</A><DD> +<DT><A HREF="#lbAG">EXAMPLES</A><DD> +<DT><A HREF="#lbAH">BUGS</A><DD> +<DT><A HREF="#lbAI">Revision History</A><DD> +<DT><A HREF="#lbAJ">Author</A><DD> +<DT><A HREF="#lbAK">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 05:13:22 GMT, April 14, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/vocatalog.man b/vendor/voclient/doc/vocatalog.man new file mode 100644 index 00000000..400892df --- /dev/null +++ b/vendor/voclient/doc/vocatalog.man @@ -0,0 +1,57 @@ +.\" @(#)vocatalog.1 1.0 Feb-2013 MJF +.TH VOCATALOG 1 "Feb 2013" "VOClient Package" +.SH NAME +vocatalog \- Query VO catalog services for data + +.SH SYNOPSIS +\fBvocatalog\fP [<opts>] <service> [ <object> | <ra> <dec> ] [ <size> ] + +.SH OPTIONS +The \fIvocatalog\fP application accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.TP 6 +.B All VODATA task options + +.SH DESCRIPTION +The \fIvocatalog\fP task is a convenience application built on top of the +\fIvodata\fP application, logically it will only query for catalog data and +will set the appropriate flags when calling \fIvodata\fP. +.PP +For a complete list of options and a description of the task behavior, see +the \fIVODATA\fP man page. + +.SH RETURN STATUS +On exit the \fBvocatalog\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Query the GSC 2.3 catalog for stars a) within the 0.1 degree default search size around NGC 1234: b) around all positions contained in file 'pos.txt': c) for the list of objects given on the command line: d) query a list of services for a list of positions: e) print a count of results that would be returned from 3 services for each position in a file: + +.nf + % vocatalog gsc2.3 ngc1234 (a) + % vocatalog gsc2.3 pos.txt (b) + % vocatalog gsc2.3 m31,m51,m93 (c) + % vocatalog svcs.txt pos.txt (d) + % vocatalog hst,chandra,gsc2.3 pos.txt (e) +.fi +.TP 4 +2) Print a count of X-ray catalog data around Abell2712: + +.nf + % vocatalog -c -b x-ray any abell2712 + % vocatalog --count -b x-ray any abell2712 +.fi + +.SH BUGS +No known bugs with this release. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +vodata, voimage, vospectrum diff --git a/vendor/voclient/doc/vocatalog.pdf b/vendor/voclient/doc/vocatalog.pdf Binary files differnew file mode 100644 index 00000000..07eb6d87 --- /dev/null +++ b/vendor/voclient/doc/vocatalog.pdf diff --git a/vendor/voclient/doc/voclient.html b/vendor/voclient/doc/voclient.html new file mode 100644 index 00000000..ec31de4b --- /dev/null +++ b/vendor/voclient/doc/voclient.html @@ -0,0 +1,394 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOCLIENT</TITLE> +</HEAD><BODY> +<H1>VOCLIENT</H1> +Section: User Commands (1)<BR>Updated: May 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +VOClient - Virtual Observatory (VO) Libraries and Desktop Applications +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>VOClient</B> is a collection of programming APIs and +command-line tools that provide a user-ready VO software distribution for +both scientists and developers. The initial release of the package is +intended primarily to distribute the completed CLI tools, additional tasks +are planned as new functionality is added to the libraries and as new +standards come on-line in the VO. +<P> + +The VOClient package includes a number of command-line utilities +built from the underlying interfaces. These tasks can be scripted from any +number of environments or used in a standalone manner. Tasks distributed +in this release include: +<P> +<A NAME="lbAD"> </A> +<H2>Command-Line Tools</H2> + +<P> + +<B>Data Access Tools</B> + +<DL COMPACT> +<DT> +<I>voatlas<TT> </TT><TT> </TT></I> + +<DD>Query the SkyView Image service for an all-sky image<BR> +<DT> +<I>vocatalog<TT> </TT></I> + +<DD>Query VO catalog services for data<BR> +<DT> +<I>vodata<TT> </TT><TT> </TT></I> + +<DD>Query and access VO data services<BR> +<DT> +<I>voimage<TT> </TT><TT> </TT></I> + +<DD>Query VO image services for data<BR> +<DT> +<I>voiminfo<TT> </TT><TT> </TT></I> + +<DD>Print/Get information about a FITS file's structure<BR> +<DT> +<I>vospectra<TT> </TT></I> + +<DD>Query VO spectral services for data<BR> +<P> +</DL> +<P> + +<B>Utility Tools</B> + +<DL COMPACT> +<DT> +<I>voregistry<TT> </TT></I> + +<DD>VO Registry search client<BR> +<DT> +<I>vosesame<TT> </TT></I> + +<DD>Call the Sesame name resolver service<BR> +<DT> +<I>vosamp<TT> </TT><TT> </TT></I> + +<DD>Command-line SAMP tool<BR> +<P> +</DL> +<P> + +<B>VOTable Tools</B> + +<DL COMPACT> +<DT> +<I>votcnv<TT> </TT><TT> </TT></I> + +<DD>Convert from VOTable to another format<BR> +<DT> +<I>votget<TT> </TT><TT> </TT></I> + +<DD>Download URLs or access references in a VOTable<BR> +<DT> +<I>votinfo<TT> </TT><TT> </TT></I> + +<DD>Get information about a VOTable<BR> +<DT> +<I>votopic<TT> </TT><TT> </TT></I> + +<DD>Query data resources specified by topic keyword<BR> +<DT> +<I>votpos<TT> </TT><TT> </TT></I> + +<DD>Extract the main positional columns from a VOTable<BR> +<DT> +<I>votsort<TT> </TT><TT> </TT></I> + +<DD>Extract the main positional columns from a VOTable<BR> +<DT> +<I>votstat<TT> </TT><TT> </TT></I> + +<DD>Compute statistics for numeric columns of a VOTable.<BR> +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>Programming Interfaces</H2> + +<DL COMPACT> +<DT> +<I>libsamp</I> + +<DD>SAMP interface. This interface allows an application to send and receive +SAMP messages but does NOT (at this time) provide a local Hub implementation. +Applications can register their own functions to be used as callbacks in +response to a message, the API provides only the middle-ware needed to +handle the SAMP protocol. +<DT> +<I>libvoclient</I> + +<DD>Client-side VO interface. This interface uses the VOClient Daemon to access +a variety of VO web services (Registry, Sesame, DAL services, etc) which +then communicate to the API to pass information back to the application. +<DT> +<I>libvotable</I> + +<DD>VOTable parser interface. The interface provides both read (lax parsing) +and write (strict compliance) capabilities. Reference is VOTable v1.2. +<DT> +<I>libvoapps</I> + +<DD>VO Applications interface. High-level interface to application functionality. +Tasks are built on these routines to provide the cmdline user interface, +but are encapsulated in an API to provide this functionality to other +environments easily (as opposed to having that functionality +be re-implemented using the low-level interfaces). +<P> +</DL> +<A NAME="lbAF"> </A> +<H3>Dependency Libraries</H3> + +<DL COMPACT> +<DT> +<I>libcurl<TT> </TT><TT> </TT></I> + +<DD>SAMP interface<BR> +<DT> +<I>libcfitsio<TT> </TT><TT> </TT></I> + +<DD>C FITSIO interface<BR> +<DT> +<I>libexpat<TT> </TT><TT> </TT></I> + +<DD>XML parser<BR> +<DT> +<I>libxmlrpc-c<TT> </TT></I> + +<DD>XML-RPC interface<BR> +<P> +</DL> +<A NAME="lbAG"> </A> +<H2>INSTALLATION</H2> + +<P> + +<B>Using Pre-Built Binaries</B> + +<P> + +Pre-built binary distributions are available containg both source and +binaries for a specific platform. These distribution names are of the form +<PRE> +<DL COMPACT><DT><DD> + <I>voclient-<version>-bin.<arch>.tar.gz</I> +</DL> +</PRE> + +<P> + +where <I><arch></I> is one of +<DL COMPACT><DT><DD> +<DL COMPACT> +<DT> +<I>linux<TT> </TT></I> + +<DD>32-bit Linux systems (Fedora, Ubuntu, Debian, etc).<BR> +<DT> +<I>linux64<TT> </TT></I> + +<DD>64-bit Linux systems (Fedora, Ubuntu, Debian, etc).<BR> +<DT> +<I>macosx<TT> </TT></I> + +<DD>32-bit OSX 10.6 and higher systems for Mac.<BR> +<DT> +<I>macintel<TT> </TT></I> + +<DD>64-bit OSX 10.6 and higher systems for Mac.<BR> +</DL> +</DL> + +<P> +<P> + +The distribution file may be unpacked with the command +<PRE> +<DL COMPACT><DT><DD> +tar zxf /<I><path></I>/voclient-<I><version></I>-bin.<I><arch></I>.tar.gz + +</DL> +</PRE> + +<P> + +This will produce a '<I>voclient</I>' subdirectory containing the unpacked +distribution. Within that directory you'll find the following important +directories needed to install the package on the system: +<P> +<DL COMPACT> +<DT> +<I>bin/ </I> + +<DD>Task binaries +<DT> +<I>lib/ </I> + +<DD>API library files +<DT> +<I>include/ </I> + +<DD>Program header files +<P> +</DL> +<P> + +The contents of these directories should be copied to some system directory +available in the normal user paths. For example, to install in /usr/local +<PRE> +<DL COMPACT><DT><DD> +% cd /<path>/voclient +% sudo cp bin/* /usr/local/bin +% sudo cp lib/* /usr/local/lib +% sudo cp include/* /usr/local/include +</DL> +</PRE> + +<P> + +When compiling new applications the appropriate '-I' and '-L' flags will +need to be set to find the libraries and include files needed. The binary +installation directory should be some directory in the normal $PATH +environment setting. +<P> +<B>Building VOClient from Source</B> + +<P> + +The source distribution of the release is containe in the file +<PRE> +<DL COMPACT><DT><DD> +<I>voclient-src.tar.gz</I> + +</DL> +</PRE> + +<P> + +It may be unpacked with the command +<PRE> +<DL COMPACT><DT><DD> +<I>tar zxf /<path>/voclient-src.tar.gz</I> + +</DL> +</PRE> + +<P> + +This will produce a 'voclient' subdirectory containing the unpacked +distribution. Utility scripts are used throughout the system to do the +platform configuration necessary, therefore the only command needed to +build the package is: +<PRE> +<DL COMPACT><DT><DD>% cd /<path>/voclient +% make +</DL> +</PRE> + +<P> + +As with the pre-built binary described above, the following important +directories are needed to install the package on the system: +<PRE> +<DL COMPACT><DT><DD> +bin/ Task binaries +lib/ API library files +include/ Program header files +</DL> +</PRE> + +<P> +<P> + +In a successful build the libraries and binaries are installed in the +package 'bin' and 'lib' directories, header files needed for program +development are put in the 'include' directory. The contents of these +directories should be copied to some system directory available in the +normal user paths. For example, to install in /usr/local +<PRE> +<DL COMPACT><DT><DD>% cd /<path>/voclient +% sudo cp bin/* /usr/local/bin +% sudo cp lib/* /usr/local/lib +% sudo cp include/* /usr/local/include +</DL> +</PRE> + +<P> + +When compiling new applications the appropriate '-I' and '-L' flags will +need to be set to find the libraries and include files needed. The binary +installation directory should be some directory in the normal $PATH +environment setting. +<P> +<B>Supported Platforms</B> + +<P> + +This release currently supports the following platforms: +<PRE> +<DL COMPACT><DT><DD> + Mac OSX 32-bit and 64-bit Intel, OSX 10.6 and later + Linux 32-bit 32-bit Linux systems (Fedora, Redhat, Ubuntu, etc) + Linux 64-bit 64-bit Linux systems (Fedora, Redhat, Ubuntu, etc) +</DL> +</PRE> + +<P> + +Additional platforms will be added as needed. +<P> +<A NAME="lbAH"> </A> +<H2>BUGS</H2> + +This is the first public release +<A NAME="lbAI"> </A> +<H2>REVISION HISTORY</H2> + +May 2013 - First public release +<A NAME="lbAJ"> </A> +<H2>AUTHOR</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), May 2013 +<A NAME="lbAK"> </A> +<H2>SEE ALSO</H2> + +voatlas, vocatalog, vodata, voimage, votiminfo, voregistry, vosesame, vospectra, votcnv, votget, votinfo, votopic, votpos, votsort, votstat, vosamp +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">Command-Line Tools</A><DD> +<DT><A HREF="#lbAE">Programming Interfaces</A><DD> +<DL> +<DT><A HREF="#lbAF">Dependency Libraries</A><DD> +</DL> +<DT><A HREF="#lbAG">INSTALLATION</A><DD> +<DT><A HREF="#lbAH">BUGS</A><DD> +<DT><A HREF="#lbAI">REVISION HISTORY</A><DD> +<DT><A HREF="#lbAJ">AUTHOR</A><DD> +<DT><A HREF="#lbAK">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 04:49:15 GMT, May 24, 2013 + +</BODY> +</HTML> + diff --git a/vendor/voclient/doc/voclient.man b/vendor/voclient/doc/voclient.man new file mode 100644 index 00000000..b0331368 --- /dev/null +++ b/vendor/voclient/doc/voclient.man @@ -0,0 +1,270 @@ +.\" @(#)voclient.1 1.0 Feb-2013 MJF +.TH VOCLIENT 1 "May 2013" "VOClient Package" +.SH NAME +VOClient \- Virtual Observatory (VO) Libraries and Desktop Applications + +.SH SYNOPSIS +\fBVOClient\fP is a collection of programming APIs and +command-line tools that provide a user-ready VO software distribution for +both scientists and developers. The initial release of the package is +intended primarily to distribute the completed CLI tools, additional tasks +are planned as new functionality is added to the libraries and as new +standards come on-line in the VO. +.PP +The VOClient package includes a number of command-line utilities +built from the underlying interfaces. These tasks can be scripted from any +number of environments or used in a standalone manner. Tasks distributed +in this release include: + +.SH Command-Line Tools +.PP +.B Data Access Tools +.HP 16 +.I voatlas +Query the SkyView Image service for an all-sky image +.HP 16 +.I vocatalog +Query VO catalog services for data +.HP 16 +.I vodata +Query and access VO data services +.HP 16 +.I voimage +Query VO image services for data +.HP 16 +.I voiminfo +Print/Get information about a FITS file's structure +.HP 16 +.I vospectra +Query VO spectral services for data + +.PP +.B Utility Tools +.HP 16 +.I voregistry +VO Registry search client +.HP 16 +.I vosesame +Call the Sesame name resolver service +.HP 16 +.I vosamp +Command-line SAMP tool + +.PP +.B VOTable Tools +.HP 16 +.I votcnv +Convert from VOTable to another format +.HP 16 +.I votget +Download URLs or access references in a VOTable +.HP 16 +.I votinfo +Get information about a VOTable +.HP 16 +.I votopic +Query data resources specified by topic keyword +.HP 16 +.I votpos +Extract the main positional columns from a VOTable +.HP 16 +.I votsort +Extract the main positional columns from a VOTable +.HP 16 +.I votstat +Compute statistics for numeric columns of a VOTable. + +.SH Programming Interfaces +.HP 9 +.I libsamp +SAMP interface. This interface allows an application to send and receive +SAMP messages but does NOT (at this time) provide a local Hub implementation. +Applications can register their own functions to be used as callbacks in +response to a message, the API provides only the middle-ware needed to +handle the SAMP protocol. +.HP 9 +.I libvoclient +Client-side VO interface. This interface uses the VOClient Daemon to access +a variety of VO web services (Registry, Sesame, DAL services, etc) which +then communicate to the API to pass information back to the application. +.HP 9 +.I libvotable +VOTable parser interface. The interface provides both read (lax parsing) +and write (strict compliance) capabilities. Reference is VOTable v1.2. +.HP 9 +.I libvoapps +VO Applications interface. High-level interface to application functionality. +Tasks are built on these routines to provide the cmdline user interface, +but are encapsulated in an API to provide this functionality to other +environments easily (as opposed to having that functionality +be re-implemented using the low-level interfaces). + +.SS Dependency Libraries +.HP 16 +.I libcurl +SAMP interface +.HP 16 +.I libcfitsio +C FITSIO interface +.HP 16 +.I libexpat +XML parser +.HP 16 +.I libxmlrpc-c +XML-RPC interface + +.SH INSTALLATION +.PP +.B Using Pre-Built Binaries +.PP +Pre-built binary distributions are available containg both source and +binaries for a specific platform. These distribution names are of the form +.nf +.RS + + \fIvoclient-<version>-bin.<arch>.tar.gz\fP +.RE +.fi +.PP +where \fI<arch>\fP is one of +.RS +.HP 16 +.I linux +32-bit Linux systems (Fedora, Ubuntu, Debian, etc). +.HP 16 +.I linux64 +64-bit Linux systems (Fedora, Ubuntu, Debian, etc). +.HP 16 +.I macosx +32-bit OSX 10.6 and higher systems for Mac. +.HP 16 +.I macintel +64-bit OSX 10.6 and higher systems for Mac. +.RE + +.PP +The distribution file may be unpacked with the command +.nf +.RS + +tar zxf /\fI<path>\fP/voclient-\fI<version>\fP-bin.\fI<arch>\fP.tar.gz + +.RE +.fi +.PP +This will produce a '\fIvoclient\fP' subdirectory containing the unpacked +distribution. Within that directory you'll find the following important +directories needed to install the package on the system: + +.HP 12 +.I bin/ +Task binaries +.HP 12 +.I lib/ +API library files +.HP 12 +.I include/ +Program header files + +.PP +The contents of these directories should be copied to some system directory +available in the normal user paths. For example, to install in /usr/local +.nf +.RS + +% cd /<path>/voclient +% sudo cp bin/* /usr/local/bin +% sudo cp lib/* /usr/local/lib +% sudo cp include/* /usr/local/include +.RE +.fi +.PP +When compiling new applications the appropriate '-I' and '-L' flags will +need to be set to find the libraries and include files needed. The binary +installation directory should be some directory in the normal $PATH +environment setting. + +.B Building VOClient from Source +.PP +The source distribution of the release is containe in the file +.nf +.RS + +\fIvoclient-src.tar.gz\fP + +.RE +.fi +.PP +It may be unpacked with the command +.nf +.RS + +\fItar zxf /<path>/voclient-src.tar.gz\fP + +.RE +.fi +.PP +This will produce a 'voclient' subdirectory containing the unpacked +distribution. Utility scripts are used throughout the system to do the +platform configuration necessary, therefore the only command needed to +build the package is: +.nf +.RS +% cd /<path>/voclient +% make +.RE +.fi +.PP +As with the pre-built binary described above, the following important +directories are needed to install the package on the system: +.nf +.RS + +bin/ Task binaries +lib/ API library files +include/ Program header files +.RE +.fi + +.PP +In a successful build the libraries and binaries are installed in the +package 'bin' and 'lib' directories, header files needed for program +development are put in the 'include' directory. The contents of these +directories should be copied to some system directory available in the +normal user paths. For example, to install in /usr/local +.nf +.RS +% cd /<path>/voclient +% sudo cp bin/* /usr/local/bin +% sudo cp lib/* /usr/local/lib +% sudo cp include/* /usr/local/include +.RE +.fi +.PP +When compiling new applications the appropriate '-I' and '-L' flags will +need to be set to find the libraries and include files needed. The binary +installation directory should be some directory in the normal $PATH +environment setting. + +.B Supported Platforms +.PP +This release currently supports the following platforms: +.nf +.RS + + Mac OSX 32-bit and 64-bit Intel, OSX 10.6 and later + Linux 32-bit 32-bit Linux systems (Fedora, Redhat, Ubuntu, etc) + Linux 64-bit 64-bit Linux systems (Fedora, Redhat, Ubuntu, etc) +.RE +.fi +.PP +Additional platforms will be added as needed. + +.SH BUGS +This is the first public release +.SH REVISION HISTORY +May 2013 - First public release +.SH AUTHOR +Michael Fitzpatrick (fitz@noao.edu), May 2013 +.SH "SEE ALSO" +voatlas, vocatalog, vodata, voimage, votiminfo, voregistry, vosesame, vospectra, votcnv, votget, votinfo, votopic, votpos, votsort, votstat, vosamp diff --git a/vendor/voclient/doc/voclient.pdf b/vendor/voclient/doc/voclient.pdf Binary files differnew file mode 100644 index 00000000..1289108c --- /dev/null +++ b/vendor/voclient/doc/voclient.pdf diff --git a/vendor/voclient/doc/vodata.html b/vendor/voclient/doc/vodata.html new file mode 100644 index 00000000..6f4ddffb --- /dev/null +++ b/vendor/voclient/doc/vodata.html @@ -0,0 +1,1171 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VODATA</TITLE> +</HEAD><BODY> +<H1>VODATA</H1> +Section: User Commands (1)<BR>Updated: July 2007<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +vodata - query and access VO data services +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>vodata</B> [<I><flags></I>] [ <<I>resource</I>> [[ <<I>objname</I>> [ <<I>sr</I>> ]]] ] +<P> +<B>vodata</B> [<I><flags></I>] [ <<I>resource</I>> [[ <<I>ra</I>> <<I>dec</I>> [ <<I>sr</I>> ]]] ] +<P> +<B>vodata</B> [<I><flags></I>] [ <<I>url</I>> ] +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>vodata</I> task accepts the following options: +<DL COMPACT> +<DT><B>-h,--help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<DT><B>-v,--verbose</B> + +<DD> +Verbose output. The output will be more verbose than normal but exactly +what is printed depends on whether other flags are enabled to changed the +basic task behavior. Sets the <I>VERBOSE</I> query parameter to its highest +level. +<DT><B>--vverbose</B> + +<DD> +Very-verbose output. Sets the <I>VERBOSE</I> query parameter to its highest +level. +<P> +<DT>The following flags control the major behavior of the task, i.e. the type <DD> +of output to present. +<DT><B>-a, --all</B> + +<DD> +Perform an action based on all available data. When used as part of a +data query, this flag causes the <<I>resource</I>> argument to be used in +a substring match of Registry <I>ShortName</I> or <I>Identifier</I> fields +to create the actual list of resources to be queried. If the <I>ShortName</I> +of a <I>TABULARSKYSERVICE</I> from Vizier is given, the <<I>resource</I>> +will typically expand to include all tables associated with the paper, +and providing a means to access all of these tables from a single query. +<DT><B>-c, --count</B> + +<DD> +Print only a count of the matching records found and do not save any +results. The standard output for the task is to echo some of the input +parameters and print a table of results showing progress and the number +of matching records. If this flag is set, the output written to the +screen will be the same, however the data will not be saved locally. +<DT><B>-g, --get</B> + +<DD> +Get the data referenced by the results of a data query. This typically +only applies to Simple Image Access service in which the result of a +query include a column of "<I>access references</I>" to the actual data +that must be resolved separately. Setting this flag will cause all data +references to be resolved by the task once all of the data queries have +been completed. +<P> +Access references are appended to a master "access list" as each query +completes. In general the order in which these are retrieved cannot be +guaranteed. Data downloads can be done in parallel by setting the number +of concurrent max downloads using the <I>--maxdownloads=<N></I> flag, the +default is to download one file at a time. If this flag is followed +with a comma-delimited list of numbers, only those rows in the result +table will be accessed. +<DT><B>-m, --meta</B> + +<DD> +Print only the column metadata for the named services. The output will be +a list of the columns return by a data query to the service, but will not +save the actual data. A default position and search size will be used for +the query: In the case of Cone services a negative size is used, for SIAP +services the FORMAT=METADATA flag is used in the query, and for tabular +Vizier services the entire table is accessed. Compliant VO services will +respond quickly with only the column metadata, tabular services may respond +more slowly due to the need to transfer the data. Adding the <I>-v</I> or +<I>--verbose-<N></I> options will increment the VERBOSE level of services +and may return more metadata if available, to access these extra columns +the same level of verbosity must be set during a data query. +<P> +<DT>The following flags specify data query options:<DD> +<DT><B>-b <bpass> or --bandpass=<bpass></B> + +<DD> +Constrain the query by bandpass. The argument following the flag must +be one of the allowed bandpass specification string. Setting the flag +will constrain any Registry search used to only those resources where +the spectral coverage matches the given bandpass. Aliases for bandpasses +are allowed, see below. +<DT><B>-i <file> or --input=<file></B> + +<DD> +Specify a file containing the remaining positional command-line input. The +command line is thought of as having the following components: the options +beginning with a '-' character and their associated arguments, one or more +<<I>resource</I>> names giving the service to invoke, an object name or +position, and an optional query size. The '-i' flag allows everything +except the options to be specified from a file (or the standard input if +the '-' argument is used), creating in effect a means to interactively +specify the e.g. resource/object without restarting the task, or to take +these values from a file or input stream to create multiple independent +queries. If either the resource or object name/position has already been +specified they do not need to be specified again. +<P> +The format for the command file is the same as for the <<I>resource</I>>, +<<I>objname</I>>, <<I>ra</I>> <<I>dec</I>>, <<I>url</I>>, or <<I>sr</I>> described +below and as they would appear on the command line, all input lines are +terminated with a newline, the file or input stream is terminated with an +EOF. An example of how this +may be used would be the using a command file such as: +<P> +<PRE> + 2mass-psc m31,m51 0.5 + chandra ngc4258,m51 0.25 +</PRE> + +<P> +The task will process this file as if the two lines had been invoked as +separate commands. The advantage is that this input can be created +dynamically by another task, and we can group resource and object lists +into independent queries. See the <I>Examples</I> below for other uses. +<DT><B>-o <obj|file> or --object=<obj|file></B> + +<DD> +Specify the object name to use in a query. Object names are resolved +automatically to J2000 equatorial coordinates. The argument to this +flag may be the name of a single object, a comma-delimited list of +object names, the name of a file containing object names, or the +reserved value '-'. +<P> +The reserved value '-' tells the task to take this information from the +standard input, processing doesn't begin until the object list has been +fully read. +<DT><B>-p <pos|file> or --pos=<pos|file></B> + +<DD> +Specify the position to use in a query. Positions are composed of two +values assumed to be equatorial J2000 coordinates. +Values specified as a floating-point decimal are assumed to be in units +of degrees, sexagesimal values may also be used and are assumed to be +equatorial RA and Dec. If the <I><pos></I> arg is used only one set of +coordinates may be given on the command-line and must be delimited by a comma, +however the argument may also be the name of a file containing coordinates +to be processed, or the reserved value '-'. +<P> +The reserved value '-' tells the task to take this information from the +standard input, processing doesn't begin until the position list has been +fully read. +<DT><B>-r <radius> or --sr=<radius>[<units>]</B> + +<DD> +Set the search radius. The default search size is 0.1 degrees unless +specified on the command-line and argument are assumed to be +in degrees, setting the size in other units is permitted using the +<I>-sr</I> flag. To specify the <units> for the <I>--sr</I> flag, the +argument should be suffixed by an 's' to specify arcseconds, an 'm' to set +arcminutes, and 'd' to set the size in degrees. By default, all +queries will be done using the same search size. Variable search +sizes accomplished using the '-i' flag described above. +<DT><B>-s <service> or --svc=<service></B> + +<DD> +Specify the service or url to invoke. In most cases the service, i.e. +the <<I>resource</I>> argument will be taken from the commandline based on +it's position. The exception is when the user want to specify a service +URL directly (e.g. to test a local service) because it isn't known to the +Registry, or to use the reserved values '-' or 'any'. Use of '-' tells +the task to read the service list from the standard input; use of +the word 'any' is a means to telling the task to dynamically create the +resource list from other options (e.g. "any image service" by using the + +<DT><B>-t <type> or --type=<type></B> + +<DD> +Constrain the query by service type. The list of allowed service types +is given below. The actual string used in a Registry resource record +may be used if known, otherwise common use is to specify 'image' to +access Simple Image Access (SIAP) services, 'catalog' for Cone searches, +or 'table' for Vizier tabular data. +<P> +<DT>The following flags are specific to the writing of HTML or KML files:<DD> +<DT><B>--webborder</B> + +<DD> +Enable the shaded border drawn around an HTML table (default). +<DT><B>--webcolor</B> + +<DD> +Enable the coloring for an HTML table (default). +<DT><B>--webheader</B> + +<DD> +Enable the HTML page header written to the output file (default). +<DT><B>--wb, --webnoborder</B> + +<DD> +Disable the shaded border drawn around an HTML table. +<DT><B>--wc, --webnocolor</B> + +<DD> +Disable the coloring for an HTML table. +<DT><B>--wh, --webnoheader</B> + +<DD> +Disable the HTML page header written to the output file. +<P> +<DT><B>--kmlmax=<N></B> + +<DD> +Specify the max number of placemarks to write. The default is 50, ordering +is not guaranteed. Setting the sampling will automatically increase the +maximum number of results returned. +<DT><B>--kmlsample=<N></B> + +<DD> +Specify the sampling of the result to be every <I><N></I> rows. The +default is to write all rows to the output file. If set, this value will +be used as a multiplier for the max number of placemarks automatically. +<DT><B>--kmlgroup=object </B> + +<DD> +Group the results of a multi-resource/multi-object query into a single +hierarchical KML file grouped by the object or position index (default); +<DT><B>--kmlgroup=service </B> + +<DD> +Group the results of a multi-resource/multi-object query into a single +hierarchical KML file grouped by the service name. +<DT><B>--kmlgroup=both </B> + +<DD> +Groups the results of a multi-resource/multi-object query into a single +hierarchical KML file. The two top-level folders will be 'By Source' and + +<DT><B>--kmlnolabel</B> + +<DD> +Disable the labelling of placemarks. By default, the ID_MAIN ucd for +each point will be used as a label. +<DT><B>--kmlnoregion</B> + +<DD> +Disable the drawing of the region bounding box in a KML file. +<DT><B>--kmlnoverbose</B> + +<DD> +Disable the writing of verbose information to the KML placemarks. By +default, each placemark will contain all information from that result. +<P> +<P> +<DT>Input Options:<DD> +<DT><B>--cols=</B><I>col_str</I> + +<DD> +Use columns specified in <I>col_str</I> to read the <I>ra</I>, <I>dec</I> +and <I>id</I> values respectively. <I>col_str</I> is a comma-delimited +list where the <I>id</I> column is optional and will not be used if not +present as the third element in the list. Other columns may be given as +a single integer or as a range of the form <I>start</I>-<I>end</I> indicating +the values in the <I>start</I> thru <I>end</I> columns should be combined +into a single value. +<DT><B>-d, --delim=</B><I>delim</I> + +<DD> +Use the <I>delim</I> as the input table delimiter. By default, a space, tab, +comma, vertical bar ('|'), or semicolon may be used as a delimiter for the +input table. If no explicit delimiter is specified, the first occurance of +any one of these will be used. The reserved words <I>comma</I>, +<I>space</I>, <I>tab</I>, or <I>bar</I> may be used in place of a specific +character. +<P> +<DT><B>--ecols=</B><I>col_str</I> +<DT><B>--ecols=</B><I>col_str</I> + +<DD> +Use the explicit columns specified in <I>col_str</I> in the input table. This +option should only be used with formatted text tables where the desired +values will always be in the same columns of the file. Note that 'column' in +this case refers to a specific character column in a text file. Columns +may be a single integer or a range, and is a comma-delimited list as with +the <I>--cols</I> option. +<DT><B>-f, --force</B> + +<DD> +Force the input table to be used even in the number of columns varies on +each line. The assumption here is that any variation (e.g empty columns) +occurs after the <I>ra</I>, <I>dec</I> and <I>id</I> columns in the table. +<DT><B>--hskip=</B><I><N></I> + +<DD> +Skip <I><N></I> header lines in the input file. This option is only needed +when the lines to be skipped do not begin with the normal '#' comment +character. +<DT><B>--nlines=</B><I><N></I> + +<DD> +Use only <I><N></I> lines of the input table. +<DT><B>--sample=</B><I><N></I> + +<DD> +Sample the table every <I><N></I> lines. Setting the sample will not affect +the <I>nlines</I> used. +<P> +<P> +<DT>Output Options:<DD> +<DT><B>-1,--one</B> + +<DD> +Save the results into a single file regardless of format. This option will +be set automatically if the output is being written to the standard output. +If the output format is something other than KML or XML, all results will +be concatenated into individual files of the form +"<svc>_<pid>.<extn>" so that each file will contain the object results from +each service where the columns will be the same. +<DT><B>-A,--ascii</B> + +<DD> +Save the results as a whitespace delimited ascii table. If an output file +is created it will have a ".txt" extension appended automatically. +<DT><B>-C,--csv</B> + +<DD> +Save the results as a comma-separated-value (CSV) table. If an output file +is created it will have a ".csv" extension appended automatically. +<DT><B>-H,--html</B> + +<DD> +Save the results as an HTML table. If an output file +is created it will have a ".html" extension appended automatically. See +above for the <I>--webnoheader</I> option that can be used to disable the HTML page +header. +<DT><B>-I,--inventory</B> + +<DD> +Query the <I>Inventory Service</I> rather than the data services directly. +This will return simply a count of the results found, but when presented +with a table of resources and sources can be used to do a simple +crossmatch of the sources found in the catalogs available through the +service. +<DT><B>-K,--KML</B> + +<DD> +Save the results as a Google Earth/Sky KML placemark file. If an output file +is created it will have a ".kml" extension appended automatically. See +above for additional options that control the content of the file. +<DT><B>-R, -V or --raw, --votable</B> + +<DD> +Save the results as a raw VOTable. If an output file is created it will +have a ".vot" extension appended automatically. +<DT><B>-T,--tsv</B> + +<DD> +Save the results as a tab-separated-value (TSV) table. If an output file +is created it will have a ".tsv" extension appended automatically. +<DT><B>-O <root> or --output=<root></B> + +<DD> +Set the root of the output name. The reserved value '-' tells the task to +write to the standard output. +<DT><B>-X,--xml</B> + +<DD> +Save the results wrapped XML file of the raw VOTable results. If an output +file is created it will have a ".xml" extension appended automatically. The +XML document will gather all the individual VOTable result files to a single +XML document, where each entry is wrapped by the element <I><VOTABLE_ENTRY></I>. +There will be three attributes: <I>svc</I> will be the data service name, +<I>obj</I> will be the object name (if supplied), and the <I>index</I> attribute +giving an index into the results. This index list is created by looping over +each service, and for each service, looping over the object/position list. +<DT><B>-e,--extract[=<type>]</B> + +<DD> +Extract positional or access information to extra output files. By +default both files will be written, using <I>--extract=pos</I> will write +only the positional information file, using <I>--extract=urls</I> will write +the access URLs only. Access URLs are written one-per-line to a file with +the same root name as the main output but with a ".urls" extension; +Positional information is written to a file with a ".pos" extension and +will contain three columns made up of the identifier (the column with +the <I>ID_MAIN</I> ucd), RA and Dec (the <I>POS_EQ_RA_MAIN</I> +and <I>POS_EQ_DEC_MAIN</I> ucd columns respectively). If these ucds appear +more than once in a table, the first occurrance will be used. +<P> +Additionally, the <I>--extract=headers</I> and <I>--extract=kml</I> flags may +used be to to specify the HTML and KML output be written to files with +".html" and ".kml" extensions respectively. The <I>--extract=KML</I> flag +will cause multi-resource and/or multi-object queries to be collected into +a single KML file. The format-specific <I>--kml<opt></I> and <I>--web<opt></I> +flags will apply to these files. A <I>--extract=xml</I> flag will force the +output format to be raw VOTable and gather the results to a single XML +document (see the <I>-X</I> option). +<P> +Note that the URLs file can be used to later access the data (perhaps +after sub-selecting from the table based on some criteria) by calling +the task again using the filename as the only argument. +<P> +If no argument is given to the <I>--extract</I> flag then all possible +options will be enabled. +<DT><B>-n,--nosave</B> + +<DD> +If enabled, this flag tells the task not to save results to local disk. +Status and result information will continue to be printed to the screen, +but no data are saved to disk. +<DT><B>-q,--quiet</B> + +<DD> +Quiet mode. Suppress any extraneous output and warning messages. +<DT><B>-u,--url</B> + +<DD> +Force the specified URL to be downloaded. +<P> +<P> +<DT>DAL2 Query Options:<DD> +<DT><B>--band=</B><I>band_string</I> + +<DD> +The spectral bandpass is given in range-list format. For a numerical +bandpass the units are wavelength in vacuum in units of meters. +The spectral rest frame may optionally be qualified as either +<I>source</I> or observer, specified as a range-list +qualifier. Bandpass names are often not useful for spectra (they are +probably more useful for image or time series data) but there are cases where +they are useful for spectra, for example for a velocity spectrum of a +specific emission line. +<DT><B>--time=</B><I>time_string</I> + +<DD> +The time coverage (epoch) specified in range-list form as defined in section +8.7.2, in ISO 8601 format. If the time system used is not specified UTC is +assumed. The value specified may be a single value or an open or closed +range. If a single value is specified it matches any spectrum for which the +time coverage includes the specified value. If a two valued range is given, a +dataset matches if any portion of it overlaps the given temporal region. +<P> +<P> +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <B>vodata</B> task allows a user to query and access VO data for multiple +resources and objects from a desktop or scripting environment. By design, +the task interface is meant to provide the following features: +<P> +<DL COMPACT> +<DT><B>-</B> + +<DD> +Resources (i.e. data services) may be referred to using a more familiar +<I>ShortName</I> designation, or an IVO identifier, either of which will be +resolved to a specific <I>ServiceURL</I> internally using the Registry. +<DT><B>-</B> + +<DD> +Object names may be used to specify the location of a data query, the +position will be resolved internally using the <I>Sesame</I> web service. +<DT><B>-</B> + +<DD> +Output files may be created in a variety of common formats easily manipulated +with other desktop tools. +<DT><B>-</B> + +<DD> +Multiple resources and objects shall be queried in parallel when possible to +optimize the task. +<DT><B>-</B> + +<DD> +Data referenced in a query response should be accessible by the task +automatically. +<DT><B>-</B> + +<DD> +The command-line interface should be as friendly and as flexible as possible +to allow the task to be used in multiple ways. +<P> +</DL> +<P> + +The task should quickly become familiar to users and is meant operate in +concert with the <B>voregistry</B> and <B>vosesame</B> tasks to allow novice +users to begin to explore for data resources to be used in the final query. +Some of the flexibility of the task is shown in the Examples section below. +Major concepts of the task are detailed below as well. +<P> +<BR> +<A NAME="lbAF"> </A> +<H3>Argument Parsing</H3> + +<P> + +The meaning of the various command-line arguments is detailed below: +<P> +<DL COMPACT> +<DT><B></B><I><resource></I> + +<DD> +The <I>ShortName</I> or <I>Identifier</I> of a data resource to be queried, a +comma-delimited list of either, or the name of a file containing either. +These names will be resolved to a data service URL using the Registry. The +<I>-s</I> option may be used to specify a non-registered <I>ServiceURL</I> that +the task may use, however the <I>-t</I> option is then also required to +specify the type of service. +<DT><B></B><I><objname></I> + +<DD> +The name of an object, a comma-delimited list of object names, or the name of +a file containing object names. The coordinates of each object will be +resolved to a position prior to processing using the <I>Sesame</I> name +resolver service. An error will be returned if an object name cannot be +resolved, and that object will be skipped. +<DT><B></B><I><ra> <dec></I> + +<DD> +The J2000 equatorial RA and Dec position to the searched. Values given as +floating point values are assumed to be in decimal degrees, sexagesimal +values are assumed to be equatorial RA/Dec positions. Sexagesimal values may +be of the form <I>hh:mm:ss.s</I> or <I>hh:mm.m</I> for RA, or +<I>dd:mm:ss.s</I> or <I>dd:mm.m</I> for Dec. Only one coordinate pair may be +specified on the commandline. +<DT><B></B><I><sr></I> + +<DD> +The search size for the data query specified in decimal degrees. The default +size of 0.1 degrees will be used if this is not specified on the command line. +The <I>-rs</I> and +<I>-rm</I> options may be used specify the size in arc seconds and minutes +respectively. The <I>-i</I> option may be used to specify command-line input +options, where each command-line can include a different value for the search +size, otherwise only one value is allowed. +<DT><B></B><I><url></I> + +<DD> +A single URL, or the name of a file containing URLs listed one per line. +<P> +<P> +</DL> +<A NAME="lbAG"> </A> +<H3>Multi-Thread and Multi-Process Data Querying</H3> + +<P> + +All data queries require at least one <I>resource</I> and one <I>source</I> +to be successful. The <I>resource</I> defines a specific data service to be +queried, and the <I>source</I> is either an explicit position on the sky or +the name of an object that can be resolved to a position. Additional +parameters to the query are used to specify other options, but in essence +each data query is translated to a single URL that must be accessed by the +client task. In a complex query, lists of resource and/or objects create a +potentially large matrix of queries that must be made (i.e. +<I>N-services</I> by <I>N-objects</I> in total). Because a large fraction of +the time spent in waiting for a query to finish is in waiting for the +server to respond, we are able to run multiple queries simultaneously +without saturating our network bandwidth in most cases. +<P> + +The <B>vodata</B> task will parallelize the list of services to be queried +by running a separate processing <I>thread</I> (i.e. a lightweight process +running in parallel within the main application) for each of the services +to be called. This allows queries to different servers to be run in +parallel, and since these servers will often reside on multiple machines +the client won't impact any one data provider too badly. In addition, +the list of objects to be queried at each service will be broken up into +multiple child processes and called simultaneously. This allows, for +example, 10 objects to be queried from 3 services (a total of 30 queries) +simultaneously. +<P> + +The <I>--maxthreads=<N>mt</I> option can be used to set the max number of threads to be +created for processing the resource list (the default is 20). If the +resource list is larger than this value, the list will be processed with no +more than the max number running at any one time until all resources have +been queried. Similarly, the <I>--maxprocs=<N></I> option can be used to set the +number of child processes to be created to process the object list (the +default is 10). When setting these values it is important to remember that +the total number of <I>potential</I> processes running on your machine will +be the product of these to values. The default values were empirically found +to work reasonably well on most modern machines. +<P> + +Additionally, it is worth considering the potential strain that can be put +on data providers' machines before changing these settings. The large +majority of Cone services for example come from a single server at HEASARC +and overloading the server with hundreds of requests to multiple resources +it provides may result in a failed request and what would appear to be no +data. One should consider using the <I>-i</I> flag as a means to query a +large object list against a resource list such that only the object +processing is parallelized and the server load is minimized (See the example +below). +<P> +<P> +<A NAME="lbAH"> </A> +<H3>Output Filename Generation</H3> + +<P> + +The <I>-O</I> option may be used to specify the root part of output files +created by a data query. However, to guarantee that a multi-service, and/or +multi-object query doesn't overwrite a single output file, the filename root +will also include the <I>pid</I> (process ID) of the task that created it. +For a single service and object query no <I>pid</I> will be used as part of +the filename. This scheme guarantees unique output files across the various +processing scenarios, with similar root names for multiple files associated +with a specific query. +<P> +Output tables may be created in a number of formats and will likewise have +extensions indicating the table type. The <I>--extract</I> option +may create additional files for each query, and the <I>-g</I>/<I>--get</I> +option to access data will similarly create additional files. The structure +of an output filename is: +<P> +<PRE> + + <I><root>[_<pid>].<extn></I> + +</PRE> + +The meaning of <I><pid></I> and <I><extn></I> have been discussed above. If +the <I>-O</I> option was set then the <I><root></I> part of the name will +simply be the argument given to set the root name. Otherwise, the <I><root></I> +element will be of the form: +<PRE> + + <I><svc>_<type>_<objname></I> + <I><svc>_<type>_<index></I> + +</PRE> + +The <I><svc></I> is derived from the service name used, the <I><type></I> is +a single-character code to indicate the type of service used ('I' for image, + +object name or the index in a list of positions of no object was specified. +<P> +<A NAME="lbAI"> </A> +<H3>Verbosity</H3> + +<P> + +The <I>-v</I> and <I>--vverbose</I> options serve a dual purpose: within the +task they set the level of output verbosity in terms of what is reported during +processing (Similarly, the <I>-q</I> option can be used to turn off output +reporting entirely). These flags will however also increase the value of the +<B>VERBOSE</B> parameter sent to services during a data query. The default +value is at least 1, with the highest level being 3. Using the <I>-v</I> flag +sets <B>VERBOSE=2</B> and <I>--vverbose</I> sets <B>VERBOSE=3</B>. +<P> + +The VERBOSE level can be important in accessing result columns that may only +be returned at the highest level. When using the <I>-m</I> +(or <I>--meta</I>) flag to print +the column metadata, the verbose options will also affect the results and it +is important that the same verbosity be set when doing the actual data +query and access. +<P> +<A NAME="lbAJ"> </A> +<H3>Bandpass and Service Type Aliases</H3> + +<P> + +The type constraint (<I>-t</I> or <I>--type</I>) accepts only the +following arguments: +<PRE> + + catalog Cone search services + image Simple Image Access services + spectra Simple Spectral Access services + table Vizier services + <literal> ResourceType from Registry record + +</PRE> + +<P> + +The bandpass constraint (<I>-b</I> or <I>--bandpass</I>) accepts only +the following arguments: +<PRE> + + Radio Millimeter Infrared (IR) + Optical Ultraviolet (UV) X-Ray (xray) + Gamma-Ray (GR) + +</PRE> + +Values in parenthese are acceptable aliases. All matches are cases +insensitive. +<P> +<P> +<A NAME="lbAK"> </A> +<H3>Range-List Parameters</H3> + +<P> + +Some parameters (for example BAND and TIME) may allow a parameter value to be +specified as a numeric range. Such range-valued parameters use the forward +slash (<I>/</I>) character as the separator between elements of the +range specification (as in the ISO 8601 date specification after which this +convention is patterned). For example, <I>5E-7/8E-7</I> would +specify a range consisting of all values from 5E-7 to 8E-7, inclusive. If a +third field is specified it is a step size for traversing the indicated +range. If a parameter permits a step size the semantics of the step size are +defined by the specific parameter. +<P> + +An open range may be specified by omitting either range value. If the first +value is omitted the range is open toward lower values. If the second value +is omitted the range is open toward higher values. Omitting both values +indicates an infinite range which accepts all values. For example, +<I>/5</I> is an open range which accepts all values less than or +equal to 5. To specify all values less than 5, <I>/4</I> would be +used (for an integer valued range). Range values are limited to numeric +values or ISO dates. +<P> + +A list may be qualified by appending the character <I>;</I> (semicolon) +followed by a qualifier string. For example <I>1E-7/3E-6;source</I> could +specify a spectral bandpass in the rest frame of the source. List and +range syntax may be combined, e.g., to indicate a list of scalar or +range-valued parameter values. Such a range list may be ordered or +unordered, and may contain either numeric or string data. An ordered +list is one which requires values to be processed in a specified order, +and to ensure this the range list is sorted or ordered by the service as +necessary before being used. It is the responsibility of the service to +sort an ordered range list, hence the client can input ranges or range +values in any order for an ordered range list and the result will be +the same. The sequence in which items in an unordered list occur on the +other hand is significant, as since there is no intrinsic ordering for +the list which can be enforced by the service, items will be processed +by the service in the order they are input by the client. +<P> + +TIME and BAND are typical examples of ordered range lists. Since a dataset +matches the query if it contains data in any of the specified ranges, +logically it does not matter in what order the ranges are given, or whether +the first element of a range is less than the second, or whether ranges +overlap; the result should be the same in all cases. Hence the range list has +an intrinsic ordering irrespective of how ranges are input. Unless otherwise +specified in the definition of a given parameter, range lists are assumed to +be ordered. +<P> +<BR> +<P> +<A NAME="lbAL"> </A> +<H2>VOCLIENT DAEMON PROCESSING</H2> + +All VO-CLI tasks are built upon the VOClient interface an rely on a +separate <I>voclientd</I> process to provide the VO functionality. The +voclientd task is distributed as part of VO-CLI and will be started +automatically by each task if it is not already running. If problems are +encountered, you may want to manually start the voclientd in a separate +window before running the task so you can monitor the output for error +messages. +<P> +<A NAME="lbAM"> </A> +<H2>RESOURCE CACHING</H2> + +Registry resolution is a common activity of VO-CLI tasks and so results +will be cached in the $HOME/.voclient/cache/regResolver directory based on +the search term, service type and bandpass parameters. Defining the +<I>VOC_NO_CACHE</I> environment variable will cause the task to ignore the +cache. +<P> +<A NAME="lbAN"> </A> +<H2>EXAMPLES</H2> + +<P> +<DL COMPACT> +<DT>1)<DD> +Query the GSC 2.3 catalog for stars a) within the 0.1 degree +default search size around NGC 1234: b) around all positions +contained in file 'pos.txt': c) for the list of objects given +on the command line: d) query a list of services for a list +of positions: e) print a count of results that would be returned +from 3 services for each position in a file: +<PRE> + + % vodata gsc2.3 ngc1234 (a) + % vodata gsc2.3 pos.txt (b) + % vodata gsc2.3 m31,m51,m93 (c) + % vodata svcs.txt pos.txt (d) + % vodata hst,chandra,gsc2.3 pos.txt (e) + +</PRE> + +<P> +<DT>2)<DD> +Query all (142) image services having data of the subdwarf galaxy +IC 10, print a count of the results only: +<PRE> + + % vodata -c -t image any IC10 + % vodata --count --type=image any IC10 + +</PRE> + +Note that we use the reserved word '<I>any</I>' for the service name and +constrain by image type. The task will automatically query the Registry to +create the list of services to be queried. +<P> +<DT>3)<DD> +Print a count of X-ray catalog data around Abell2712: +<PRE> + + % vodata -c -t catalog -b x-ray any abell2712 + % vodata --count --type=catalog --bandpass=x-ray any abell2712 + +</PRE> + +In this case we constrain both the service type as well as the spectral +coverage published for the resource in the Registry. We use the reserved +<I> +any</I>' service name to query multiple services and use the '<I>-c</I>' +flag to print a count without saving results. The object name is resolved +to coordinates internally. (Note: this example may take a while to run). +<P> +<P> +<DT>4)<DD> +Print the column metadata returned by the RC3 catalog service: +<PRE> + + % vodata --meta rc3 or vodata -m rc3 + +</PRE> + +The output will print the result using the default VERBOSE level, adding +the <I>-v</I> will set the query parameter VERBOSE=2, adding <I>--verbose</I> +will set VERBOSE=3 (to print all available columns). When accessing data the +same <I>-v</I> flags will be required to retrieve columns at that +<I>VERBOSE</I> level. +<P> +<P> +<DT>5)<DD> +Use the Registry to query for resources using the search terms +"cooling flow". Upon examining the output the user notices a +Vizier paper titled "<I>Cooling Flows in 207 clusters of Galaxies</I>" +that looks interesting. Use the <B>vodata</B> task to download all +tables associated with this paper, save tables in the default +CSV format: +<PRE> + + % voregistry cooling flow + % vodata -O white97 -all J/MNRAS/292/419 + % vodata --output=white97 --all J/MNRAS/292/419 + +</PRE> + +All 7 tables will be written to the current directory to files +having a root name 'white97' (chosen based on the author and +publication date). +<P> +<P> +<DT>6)<DD> +Find a suitable XMM image service, get a (brief) count of the +XMM images available for 3c273, and if there aren't too many, +download the images and save the extracted access URLs: +<PRE> + + % voregistry -rv -t image xmm + ShortName ResourceType Title + ------------------------------------------------------.... + XMM-Newton SIAP/ARCHIVE XMM-Newton Archive .... + + % vodata -cq xmm-newton 3c273 + xmm-newton 27 I XMM-Newton Archive .... + + % vodata --count --quiet xmm-newton 3c273 + xmm-newton 27 I XMM-Newton Archive .... + + % vodata --get xmm-newton 3c273 + .... will query and download 27 images. + +</PRE> + +<P> +<DT>7)<DD> +Query for the images available from 2MASS at a given position, +extract the positions and service URLs to separate files: +<PRE> + + % vodata -e -O 2mass -t image 2mass 12:34:56.7 -23:12:45.2 + % vodata -e --output=2mass --type=image 2mass 12:34:56.7 -23:12:45.2 + +</PRE> + +The query produces files with the root name '2mass', and exten- sions of +"<I>.csv</I>" (the main response), "<I>.pos</I>" (the extracted pos- itions), +and "<I>.urls</I>" (the access references). The user inspects the files and +notices that the references return both FITS and HTML files, but she only +wants the FITS image date and uses <B>vodata</B> to download only those: +<PRE> + + % grep fits 2mass_I_001_15998.urls > images.txt + % vodata images.txt + or + % grep fits 2mass_I_001_15998.urls | vodata -i - + +</PRE> + +In both cases we pass URLs to the task which bypasses the query and directly +access the images. However, in the first case we process the entire list +and are able to take advantage of the <I>-maxdownloads=<N></I> option to +increase the number of simultaneous downloads. In the second case, the +<I>-i</I> flag causes the task to interpret each line of the input stream +as a separate command and so the data are always downloaded one at a time +(which is the default download behavior anyway). +<P> +<DT>8)<DD> +Use <B>vodata</B> as a test client for a locally-installed SIAP service: +<PRE> + + % vodata -t image -s <A HREF="http://localhost/siap.pl">http://localhost/siap.pl</A> 180.0 0.0 + % vodata --type=image --svc=<A HREF="http://localhost/siap.pl">http://localhost/siap.pl</A> 180.0 0.0 + +</PRE> + +In this case we force the ServiceURL using the '<I>-s</I>' flag, but since we +can't do a Registry query to discover what type of service this is, we must +use the '<I>-t</I>' flag to indicate it is an image service. +<P> +<P> +<DT>9)<DD> +Create a local table containing the Abell catalog. Begin with a +Registry query to find likely services using the <B>voregistry</B> task, print +a verbose description of each resource and page the results with <I>less</I>: +<PRE> + + % voregistry -v -v --type=catalog abell | less + +</PRE> + +The verbose results indicate a number of services with differing +requirements for what is included. We decide to use the service from +HEASARC since it contains southern hemisphere data and constraints we are +interested in. Try an all-sky query to retrieve the entire catalog, use +the service identifier to be specific about where we want to go: +<PRE> + + % vodata -e <A HREF="ivo://nasa.heasarc/abell">ivo://nasa.heasarc/abell</A> 0.0 0.0 180.0 + % vodata --extract <A HREF="ivo://nasa.heasarc/abell">ivo://nasa.heasarc/abell</A> 0.0 0.0 180.0 + +</PRE> + +We use the '<I>-e</I>' flag to extract the positions to a separate file with +a "<I>.pos</I>" extension so that we can use these in later queries. +However, the <I>.pos</I> file additionally contains the ID from the original +catalog in column 1. Strip this column so we're left with only RA and DEC +and query for Chandra observations at each position: +<PRE> + + % cut -c6- *.pos | vodata <A HREF="ivo://nasa.heasarc/chanmaster">ivo://nasa.heasarc/chanmaster</A> -p - + % cut -c6- *.pos | vodata <A HREF="ivo://nasa.heasarc/chanmaster">ivo://nasa.heasarc/chanmaster</A> --pos=- + +</PRE> + +Here we used the unix '<I>cut</I>' utility to remove the first column and +pipe the resulting positions to the task, using the '<I>-p -</I>' option to +indicate positions should be read from stding, and the IVO identifier of +the Chandra observation master log we also discovered from the Registry. +<P> +<P> +<DT>10)<DD> +Interactively query for a count of Chandra observations of Messier +objects: +<PRE> + + % vodata -cq chandra -i - + m31 + chandra 335 I Chandra X-Ray Observatory Data Archive + : : : : : + +</PRE> + +Note that by using the '<I>-i</I>' flag we execute each query as if we'd put +the object name on the command line. Using the '<I>-o</I>' flag would +instead read all of the objects from the stdin but then execute the queries +in parallel following an EOF to terminate the input. +<P> +<P> +<DT>11)<DD> +Use the <I>STILTS</I> task '<I>tpipe</I>' to select rows from a VOTable +of QSOs (made with an earlier query) where the redshift is > 0.2. Output +only the positions and pipe this to <B>vodata</B> to generate a new query to +see whether HST has observed any of these objects: +<PRE> + + % stilts tpipe ifmt=votable qso_survey.vot + cmd='select "Z > 0.2"' + cmd='keepcols "RA DEC"' | vodata -p - hstpaec + +</PRE> + +Note that we use the '<I>-p -</I>' flag to tell the task to take it's list of +positions from the piped input. The positions are used to query the HST +Planned and Archived Exposure Catalog (<I>hstpaec</I>) +<P> +<P> +<DT>12)<DD> +The user has a task called '<I>wcsinfo</I>' that takes a list of images +and outputs a text table containing the plate center and size in degrees. +Use this task as part of a query for 2MASS point sources contained in each +image: +<PRE> + + % wcsinfo *.fits | vodata 2mass-psc -i - + +</PRE> + +Here we specify the desired service (<I>2mass-psc</I>) on the commandline as +usual, and allow the remainder of the args (i.e. the position and search +size) to be read from the stdin. This allows for variable search sizes but +processes the positions serially. If the sizes are all the same (say 25 +arcmin), multiple queries can be done simultaneously using just a position +file, e.g. +<PRE> + + % wcsinfo -pos_only *.fits > centers.txt + % vodata --sr=25m 2mass-psc centers.txt + +</PRE> + +<P> +<P> +<P> +<DT>13)<DD> +Query a large list of objects against a number of ASCA resources. +Because the ASCA catalogs are served by the same machine, use the <I>'-i'</I> +option and a command file to process only each resource sequentially while +still parallelizing the object lists: +<P> +<PRE> + % cat cmds.txt + ASCA survey.tbl + ASCA\ GIS survey.tbl + ASCA\ GPS survey.tbl + : : + + % vodata -i cmds.txt +</PRE> + +</DL> +<P> + +Note that we've needed to escape the space in the resource name in some +cases. To avoid this, use of the IVO identifier for each resource is usually +preferred. +<P> +<DL COMPACT> +<DT>14)<DD> +Query the VO for GALEX data of M51. Because the <I>ShortName</I> GALEX +is not unique, we must either specify the IVO identifier of a +specific service to query, or if we're interested in results from all +supported data services with <I>galex</I> in the name: +<PRE> + + % vodata -a galex M51 + % vodata --all galex M51 + +</PRE> + +The results come from the Cone and SIAP services both called <I>GALEX</I>, +as well as an additional SIAP service called 'GALEX_Atlas'. Note that the +service names are case insensitive in either case. +<P> +<P> +<DT>15)<DD> +Process a list of hundreds of positions against the GSC2.3 catalog: +<PRE> + + % vodata gsc2.3 positions.txt + +</PRE> + +<P> +<P> +<DT>16)<DD> +Process a list of hundreds of positions against the GSC2.3 catalog, assume +that the input table has a 5 line header of text and three columns +(id,ra,dec). Note that the <I>cols</I> option requires the optional id +be specified last: +<PRE> + + % vodata --cols=2,3,1 --hskip=5 gsc2.3 positions.txt + +</PRE> + +<P> +</DL> +<A NAME="lbAO"> </A> +<H2>BUGS</H2> + +Some services don't repond properly to the metadata query and will print +a "no attributes found" message. +<P> +<A NAME="lbAP"> </A> +<H2>TODO</H2> + +<P> + +- Additional command-line options should be allowed to be specified in a +command file. +<P> + +- Support for SSAP, SAMP, TAP +<P> +<P> +<A NAME="lbAQ"> </A> +<H2>Revision History</H2> + +June 2007 - This task is new. +<A NAME="lbAR"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), June 2007 +<A NAME="lbAS"> </A> +<H2>SEE ALSO</H2> + +voclient, voclientd, vosesame, voregistry +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DL> +<DT><A HREF="#lbAF">Argument Parsing</A><DD> +<DT><A HREF="#lbAG">Multi-Thread and Multi-Process Data Querying</A><DD> +<DT><A HREF="#lbAH">Output Filename Generation</A><DD> +<DT><A HREF="#lbAI">Verbosity</A><DD> +<DT><A HREF="#lbAJ">Bandpass and Service Type Aliases</A><DD> +<DT><A HREF="#lbAK">Range-List Parameters</A><DD> +</DL> +<DT><A HREF="#lbAL">VOCLIENT DAEMON PROCESSING</A><DD> +<DT><A HREF="#lbAM">RESOURCE CACHING</A><DD> +<DT><A HREF="#lbAN">EXAMPLES</A><DD> +<DT><A HREF="#lbAO">BUGS</A><DD> +<DT><A HREF="#lbAP">TODO</A><DD> +<DT><A HREF="#lbAQ">Revision History</A><DD> +<DT><A HREF="#lbAR">Author</A><DD> +<DT><A HREF="#lbAS">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 02:52:33 GMT, June 28, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/vodata.man b/vendor/voclient/doc/vodata.man new file mode 100644 index 00000000..97e974d8 --- /dev/null +++ b/vendor/voclient/doc/vodata.man @@ -0,0 +1,1002 @@ +.\" @(#)vodata.1 1.0 June-07 MJF +.TH VODATA 1 "July 2007" "VOClient Project" +.SH NAME +vodata \- query and access VO data services + +.SH SYNOPSIS +\fBvodata\fP [\fI<flags>\fP] [ <\fIresource\fP> [[ <\fIobjname\fP> [ <\fIsr\fP> ]]] ] + +\fBvodata\fP [\fI<flags>\fP] [ <\fIresource\fP> [[ <\fIra\fP> <\fIdec\fP> [ <\fIsr\fP> ]]] ] + +\fBvodata\fP [\fI<flags>\fP] [ <\fIurl\fP> ] + +.SH OPTIONS +The \fIvodata\fP task accepts the following options: +.TP 8 +.B \-h,\--help +Print a help summary to the terminal and exit. No processing is done +following this flag. +.TP 8 +.B \-v,\--verbose +Verbose output. The output will be more verbose than normal but exactly +what is printed depends on whether other flags are enabled to changed the +basic task behavior. Sets the \fIVERBOSE\fR query parameter to its highest +level. +.TP 8 +.B \--vverbose +Very-verbose output. Sets the \fIVERBOSE\fR query parameter to its highest +level. + +.TP 0 +The following flags control the major behavior of the task, i.e. the type +of output to present. +.TP 8 +.B \-a, --all +Perform an action based on all available data. When used as part of a +data query, this flag causes the <\fIresource\fP> argument to be used in +a substring match of Registry \fIShortName\fR or \fIIdentifier\fR fields +to create the actual list of resources to be queried. If the \fIShortName\fP +of a \fITABULARSKYSERVICE\fP from Vizier is given, the <\fIresource\fP> +will typically expand to include all tables associated with the paper, +and providing a means to access all of these tables from a single query. +.TP 8 +.B \-c, --count +Print only a count of the matching records found and do not save any +results. The standard output for the task is to echo some of the input +parameters and print a table of results showing progress and the number +of matching records. If this flag is set, the output written to the +screen will be the same, however the data will not be saved locally. +.TP 8 +.B \-g, --get +Get the data referenced by the results of a data query. This typically +only applies to Simple Image Access service in which the result of a +query include a column of "\fIaccess references\fP" to the actual data +that must be resolved separately. Setting this flag will cause all data +references to be resolved by the task once all of the data queries have +been completed. + +Access references are appended to a master "access list" as each query +completes. In general the order in which these are retrieved cannot be +guaranteed. Data downloads can be done in parallel by setting the number +of concurrent max downloads using the \fI--maxdownloads=<N>\fP flag, the +default is to download one file at a time. If this flag is followed +with a comma-delimited list of numbers, only those rows in the result +table will be accessed. +.TP 8 +.B \-m, --meta +Print only the column metadata for the named services. The output will be +a list of the columns return by a data query to the service, but will not +save the actual data. A default position and search size will be used for +the query: In the case of Cone services a negative size is used, for SIAP +services the FORMAT=METADATA flag is used in the query, and for tabular +Vizier services the entire table is accessed. Compliant VO services will +respond quickly with only the column metadata, tabular services may respond +more slowly due to the need to transfer the data. Adding the \fI-v\fP or +\fI--verbose-<N>\fP options will increment the VERBOSE level of services +and may return more metadata if available, to access these extra columns +the same level of verbosity must be set during a data query. + +.TP 0 +The following flags specify data query options: +.TP 8 +.B \-b <bpass> or --bandpass=<bpass> +Constrain the query by bandpass. The argument following the flag must +be one of the allowed bandpass specification string. Setting the flag +will constrain any Registry search used to only those resources where +the spectral coverage matches the given bandpass. Aliases for bandpasses +are allowed, see below. +.TP 8 +.B \-i <file> or --input=<file> +Specify a file containing the remaining positional command-line input. The +command line is thought of as having the following components: the options +beginning with a '-' character and their associated arguments, one or more +<\fIresource\fP> names giving the service to invoke, an object name or +position, and an optional query size. The '-i' flag allows everything +except the options to be specified from a file (or the standard input if +the '-' argument is used), creating in effect a means to interactively +specify the e.g. resource/object without restarting the task, or to take +these values from a file or input stream to create multiple independent +queries. If either the resource or object name/position has already been +specified they do not need to be specified again. + +The format for the command file is the same as for the <\fIresource\fP>, +<\fIobjname\fP>, <\fIra\fP> <\fIdec\fP>, <\fIurl\fP>, or <\fIsr\fP> described +below and as they would appear on the command line, all input lines are +terminated with a newline, the file or input stream is terminated with an +EOF. An example of how this +may be used would be the using a command file such as: + +.nf + 2mass-psc m31,m51 0.5 + chandra ngc4258,m51 0.25 +.fi + +The task will process this file as if the two lines had been invoked as +separate commands. The advantage is that this input can be created +dynamically by another task, and we can group resource and object lists +into independent queries. See the \fIExamples\fP below for other uses. +.TP 8 +.B \-o <obj|file> or --object=<obj|file> +Specify the object name to use in a query. Object names are resolved +automatically to J2000 equatorial coordinates. The argument to this +flag may be the name of a single object, a comma-delimited list of +object names, the name of a file containing object names, or the +reserved value '-'. + +The reserved value '-' tells the task to take this information from the +standard input, processing doesn't begin until the object list has been +fully read. +.TP 8 +.B \-p <pos|file> or --pos=<pos|file> +Specify the position to use in a query. Positions are composed of two +values assumed to be equatorial J2000 coordinates. +Values specified as a floating-point decimal are assumed to be in units +of degrees, sexagesimal values may also be used and are assumed to be +equatorial RA and Dec. If the \fI<pos>\fP arg is used only one set of +coordinates may be given on the command-line and must be delimited by a comma, +however the argument may also be the name of a file containing coordinates +to be processed, or the reserved value '-'. + +The reserved value '-' tells the task to take this information from the +standard input, processing doesn't begin until the position list has been +fully read. +.TP 8 +.B \-r <radius> or --sr=<radius>[<units>] +Set the search radius. The default search size is 0.1 degrees unless +specified on the command-line and argument are assumed to be +in degrees, setting the size in other units is permitted using the +\fI-sr\fP flag. To specify the <units> for the \fI--sr\fP flag, the +argument should be suffixed by an 's' to specify arcseconds, an 'm' to set +arcminutes, and 'd' to set the size in degrees. By default, all +queries will be done using the same search size. Variable search +sizes accomplished using the '-i' flag described above. +.TP 8 +.B \-s <service> or --svc=<service> +Specify the service or url to invoke. In most cases the service, i.e. +the <\fIresource\fP> argument will be taken from the commandline based on +it's position. The exception is when the user want to specify a service +URL directly (e.g. to test a local service) because it isn't known to the +Registry, or to use the reserved values '-' or 'any'. Use of '-' tells +the task to read the service list from the standard input; use of +the word 'any' is a means to telling the task to dynamically create the +resource list from other options (e.g. "any image service" by using the +'-t image' option). +.TP 8 +.B \-t <type> or --type=<type> +Constrain the query by service type. The list of allowed service types +is given below. The actual string used in a Registry resource record +may be used if known, otherwise common use is to specify 'image' to +access Simple Image Access (SIAP) services, 'catalog' for Cone searches, +or 'table' for Vizier tabular data. + +.TP 0 +The following flags are specific to the writing of HTML or KML files: +.TP 8 +.B \--webborder +Enable the shaded border drawn around an HTML table (default). +.TP 8 +.B \--webcolor +Enable the coloring for an HTML table (default). +.TP 8 +.B \--webheader +Enable the HTML page header written to the output file (default). +.TP 8 +.B --wb, \--webnoborder +Disable the shaded border drawn around an HTML table. +.TP 8 +.B --wc, \--webnocolor +Disable the coloring for an HTML table. +.TP 8 +.B --wh, \--webnoheader +Disable the HTML page header written to the output file. + +.TP 8 +.B \--kmlmax=<N> +Specify the max number of placemarks to write. The default is 50, ordering +is not guaranteed. Setting the sampling will automatically increase the +maximum number of results returned. +.TP 8 +.B \--kmlsample=<N> +Specify the sampling of the result to be every \fI<N>\fP rows. The +default is to write all rows to the output file. If set, this value will +be used as a multiplier for the max number of placemarks automatically. +.TP 8 +.B \--kmlgroup=object +Group the results of a multi-resource/multi-object query into a single +hierarchical KML file grouped by the object or position index (default); +.TP 8 +.B \--kmlgroup=service +Group the results of a multi-resource/multi-object query into a single +hierarchical KML file grouped by the service name. +.TP 8 +.B \--kmlgroup=both +Groups the results of a multi-resource/multi-object query into a single +hierarchical KML file. The two top-level folders will be 'By Source' and +'By Object' indicating the grouping of the results. +.TP 8 +.B \--kmlnolabel +Disable the labelling of placemarks. By default, the ID_MAIN ucd for +each point will be used as a label. +.TP 8 +.B \--kmlnoregion +Disable the drawing of the region bounding box in a KML file. +.TP 8 +.B \--kmlnoverbose +Disable the writing of verbose information to the KML placemarks. By +default, each placemark will contain all information from that result. + + +.TP 0 +Input Options: +.TP 8 +.B \--cols=\fIcol_str\fP +Use columns specified in \fIcol_str\fP to read the \fIra\fP, \fIdec\fP +and \fIid\fP values respectively. \fIcol_str\fP is a comma-delimited +list where the \fIid\fP column is optional and will not be used if not +present as the third element in the list. Other columns may be given as +a single integer or as a range of the form \fIstart\fP-\fIend\fP indicating +the values in the \fIstart\fP thru \fIend\fP columns should be combined +into a single value. +.TP 8 +.B \-d, --delim=\fIdelim\fP +Use the \fIdelim\fP as the input table delimiter. By default, a space, tab, +comma, vertical bar ('|'), or semicolon may be used as a delimiter for the +input table. If no explicit delimiter is specified, the first occurance of +any one of these will be used. The reserved words \fIcomma\fP, +\fIspace\fP, \fItab\fP, or \fIbar\fP may be used in place of a specific +character. + +<DT><B>--ecols=</B><I>col_str</I> +.TP 8 +.B \--ecols=\fIcol_str\fP +Use the explicit columns specified in \fIcol_str\fP in the input table. This +option should only be used with formatted text tables where the desired +values will always be in the same columns of the file. Note that 'column' in +this case refers to a specific character column in a text file. Columns +may be a single integer or a range, and is a comma-delimited list as with +the \fI--cols\fP option. +.TP 8 +.B \-f, --force +Force the input table to be used even in the number of columns varies on +each line. The assumption here is that any variation (e.g empty columns) +occurs after the \fIra\fP, \fIdec\fP and \fIid\fP columns in the table. +.TP 8 +.B \--hskip=\fI<N>\fP +Skip \fI<N>\fP header lines in the input file. This option is only needed +when the lines to be skipped do not begin with the normal '#' comment +character. +.TP 8 +.B \--nlines=\fI<N>\fP +Use only \fI<N>\fP lines of the input table. +.TP 8 +.B \--sample=\fI<N>\fP +Sample the table every \fI<N>\fP lines. Setting the sample will not affect +the \fInlines\fP used. + + +.TP 0 +Output Options: +.TP 8 +.B \-1,--one +Save the results into a single file regardless of format. This option will +be set automatically if the output is being written to the standard output. +If the output format is something other than KML or XML, all results will +be concatenated into individual files of the form +"<svc>_<pid>.<extn>" so that each file will contain the object results from +each service where the columns will be the same. +.TP 8 +.B \-A,--ascii +Save the results as a whitespace delimited ascii table. If an output file +is created it will have a ".txt" extension appended automatically. +.TP 8 +.B \-C,--csv +Save the results as a comma-separated-value (CSV) table. If an output file +is created it will have a ".csv" extension appended automatically. +.TP 8 +.B \-H,--html +Save the results as an HTML table. If an output file +is created it will have a ".html" extension appended automatically. See +above for the \fI--webnoheader\fP option that can be used to disable the HTML page +header. +.TP 8 +.B \-I,--inventory +Query the \fIInventory Service\fP rather than the data services directly. +This will return simply a count of the results found, but when presented +with a table of resources and sources can be used to do a simple +crossmatch of the sources found in the catalogs available through the +service. +.TP 8 +.B \-K,--KML +Save the results as a Google Earth/Sky KML placemark file. If an output file +is created it will have a ".kml" extension appended automatically. See +above for additional options that control the content of the file. +.TP 8 +.B \-R, \-V or --raw, --votable +Save the results as a raw VOTable. If an output file is created it will +have a ".vot" extension appended automatically. +.TP 8 +.B \-T,--tsv +Save the results as a tab-separated-value (TSV) table. If an output file +is created it will have a ".tsv" extension appended automatically. +.TP 8 +.B \-O <root> or --output=<root> +Set the root of the output name. The reserved value '-' tells the task to +write to the standard output. +.TP 8 +.B \-X,--xml +Save the results wrapped XML file of the raw VOTable results. If an output +file is created it will have a ".xml" extension appended automatically. The +XML document will gather all the individual VOTable result files to a single +XML document, where each entry is wrapped by the element \fI<VOTABLE_ENTRY>\fP. +There will be three attributes: \fIsvc\fP will be the data service name, +\fIobj\fP will be the object name (if supplied), and the \fIindex\fP attribute +giving an index into the results. This index list is created by looping over +each service, and for each service, looping over the object/position list. +.TP 8 +.B \-e,--extract[=<type>] +Extract positional or access information to extra output files. By +default both files will be written, using \fI--extract=pos\fP will write +only the positional information file, using \fI--extract=urls\fP will write +the access URLs only. Access URLs are written one-per-line to a file with +the same root name as the main output but with a ".urls" extension; +Positional information is written to a file with a ".pos" extension and +will contain three columns made up of the identifier (the column with +the \fIID_MAIN\fP ucd), RA and Dec (the \fIPOS_EQ_RA_MAIN\fP +and \fIPOS_EQ_DEC_MAIN\fP ucd columns respectively). If these ucds appear +more than once in a table, the first occurrance will be used. + +Additionally, the \fI--extract=headers\fP and \fI--extract=kml\fP flags may +used be to to specify the HTML and KML output be written to files with +".html" and ".kml" extensions respectively. The \fI--extract=KML\fP flag +will cause multi-resource and/or multi-object queries to be collected into +a single KML file. The format-specific \fI--kml<opt>\fP and \fI--web<opt>\fP +flags will apply to these files. A \fI--extract=xml\fP flag will force the +output format to be raw VOTable and gather the results to a single XML +document (see the \fI-X\fP option). + +Note that the URLs file can be used to later access the data (perhaps +after sub-selecting from the table based on some criteria) by calling +the task again using the filename as the only argument. + +If no argument is given to the \fI--extract\fP flag then all possible +options will be enabled. +.TP 8 +.B \-n,--nosave +If enabled, this flag tells the task not to save results to local disk. +Status and result information will continue to be printed to the screen, +but no data are saved to disk. +.TP 8 +.B \-q,--quiet +Quiet mode. Suppress any extraneous output and warning messages. +.TP 8 +.B \-u,--url +Force the specified URL to be downloaded. + + +.TP 0 +DAL2 Query Options: +.TP 8 +.B \--band=\fIband_string\fP +The spectral bandpass is given in range-list format. For a numerical +bandpass the units are wavelength in vacuum in units of meters. +The spectral rest frame may optionally be qualified as either +\fIsource\fP or \fPobserver\fP, specified as a range-list +qualifier. Bandpass names are often not useful for spectra (they are +probably more useful for image or time series data) but there are cases where +they are useful for spectra, for example for a velocity spectrum of a +specific emission line. +.TP 8 +.B \--time=\fItime_string\fP +The time coverage (epoch) specified in range-list form as defined in section +8.7.2, in ISO 8601 format. If the time system used is not specified UTC is +assumed. The value specified may be a single value or an open or closed +range. If a single value is specified it matches any spectrum for which the +time coverage includes the specified value. If a two valued range is given, a +dataset matches if any portion of it overlaps the given temporal region. + + + +.SH DESCRIPTION +The \fBvodata\fP task allows a user to query and access VO data for multiple +resources and objects from a desktop or scripting environment. By design, +the task interface is meant to provide the following features: + +.TP 4 +.B \- +Resources (i.e. data services) may be referred to using a more familiar +\fIShortName\fP designation, or an IVO identifier, either of which will be +resolved to a specific \fIServiceURL\fR internally using the Registry. +.TP 4 +.B \- +Object names may be used to specify the location of a data query, the +position will be resolved internally using the \fISesame\fR web service. +.TP 4 +.B \- +Output files may be created in a variety of common formats easily manipulated +with other desktop tools. +.TP 4 +.B \- +Multiple resources and objects shall be queried in parallel when possible to +optimize the task. +.TP 4 +.B \- +Data referenced in a query response should be accessible by the task +automatically. +.TP 4 +.B \- +The command-line interface should be as friendly and as flexible as possible +to allow the task to be used in multiple ways. + +.PP +The task should quickly become familiar to users and is meant operate in +concert with the \fBvoregistry\fP and \fBvosesame\fP tasks to allow novice +users to begin to explore for data resources to be used in the final query. +Some of the flexibility of the task is shown in the Examples section below. +Major concepts of the task are detailed below as well. + + +.SS Argument Parsing +.PP +The meaning of the various command-line arguments is detailed below: + +.TP 8 +.B \fI<resource>\fP +The \fIShortName\fP or \fIIdentifier\fP of a data resource to be queried, a +comma-delimited list of either, or the name of a file containing either. +These names will be resolved to a data service URL using the Registry. The +\fI-s\fP option may be used to specify a non-registered \fIServiceURL\fP that +the task may use, however the \fI-t\fP option is then also required to +specify the type of service. +.TP 8 +.B \fI<objname>\fP +The name of an object, a comma-delimited list of object names, or the name of +a file containing object names. The coordinates of each object will be +resolved to a position prior to processing using the \fISesame\fR name +resolver service. An error will be returned if an object name cannot be +resolved, and that object will be skipped. +.TP 8 +.B \fI<ra> <dec>\fP +The J2000 equatorial RA and Dec position to the searched. Values given as +floating point values are assumed to be in decimal degrees, sexagesimal +values are assumed to be equatorial RA/Dec positions. Sexagesimal values may +be of the form \fIhh:mm:ss.s\fP or \fIhh:mm.m\fP for RA, or +\fIdd:mm:ss.s\fP or \fIdd:mm.m\fP for Dec. Only one coordinate pair may be +specified on the commandline. +.TP 8 +.B \fI<sr>\fP +The search size for the data query specified in decimal degrees. The default +size of 0.1 degrees will be used if this is not specified on the command line. +The \fI-rs\fP and +\fI-rm\fP options may be used specify the size in arc seconds and minutes +respectively. The \fI-i\fP option may be used to specify command-line input +options, where each command-line can include a different value for the search +size, otherwise only one value is allowed. +.TP 8 +.B \fI<url>\fP +A single URL, or the name of a file containing URLs listed one per line. + + +.SS Multi-Thread and Multi-Process Data Querying +.PP +All data queries require at least one \fIresource\fP and one \fIsource\fP +to be successful. The \fIresource\fP defines a specific data service to be +queried, and the \fIsource\fR is either an explicit position on the sky or +the name of an object that can be resolved to a position. Additional +parameters to the query are used to specify other options, but in essence +each data query is translated to a single URL that must be accessed by the +client task. In a complex query, lists of resource and/or objects create a +potentially large matrix of queries that must be made (i.e. +\fIN-services\fP by \fIN-objects\fP in total). Because a large fraction of +the time spent in waiting for a query to finish is in waiting for the +server to respond, we are able to run multiple queries simultaneously +without saturating our network bandwidth in most cases. +.PP +The \fBvodata\fP task will parallelize the list of services to be queried +by running a separate processing \fIthread\fP (i.e. a lightweight process +running in parallel within the main application) for each of the services +to be called. This allows queries to different servers to be run in +parallel, and since these servers will often reside on multiple machines +the client won't impact any one data provider too badly. In addition, +the list of objects to be queried at each service will be broken up into +multiple child processes and called simultaneously. This allows, for +example, 10 objects to be queried from 3 services (a total of 30 queries) +simultaneously. +.PP +The \fI--maxthreads=<N>mt\fP option can be used to set the max number of threads to be +created for processing the resource list (the default is 20). If the +resource list is larger than this value, the list will be processed with no +more than the max number running at any one time until all resources have +been queried. Similarly, the \fI--maxprocs=<N>\fP option can be used to set the +number of child processes to be created to process the object list (the +default is 10). When setting these values it is important to remember that +the total number of \fIpotential\fP processes running on your machine will +be the product of these to values. The default values were empirically found +to work reasonably well on most modern machines. +.PP +Additionally, it is worth considering the potential strain that can be put +on data providers' machines before changing these settings. The large +majority of Cone services for example come from a single server at HEASARC +and overloading the server with hundreds of requests to multiple resources +it provides may result in a failed request and what would appear to be no +data. One should consider using the \fI-i\fP flag as a means to query a +large object list against a resource list such that only the object +processing is parallelized and the server load is minimized (See the example +below). + + +.SS Output Filename Generation +.PP +The \fI-O\fP option may be used to specify the root part of output files +created by a data query. However, to guarantee that a multi-service, and/or +multi-object query doesn't overwrite a single output file, the filename root +will also include the \fIpid\fP (process ID) of the task that created it. +For a single service and object query no \fIpid\fP will be used as part of +the filename. This scheme guarantees unique output files across the various +processing scenarios, with similar root names for multiple files associated +with a specific query. + +Output tables may be created in a number of formats and will likewise have +extensions indicating the table type. The \fI--extract\fP option +may create additional files for each query, and the \fI-g\fP/\fI--get\fP +option to access data will similarly create additional files. The structure +of an output filename is: + +.nf + + \fI<root>[_<pid>].<extn>\fP + +.fi +The meaning of \fI<pid>\fP and \fI<extn>\fP have been discussed above. If +the \fI-O\fP option was set then the \fI<root>\fP part of the name will +simply be the argument given to set the root name. Otherwise, the \fI<root>\fP +element will be of the form: +.nf + + \fI<svc>_<type>_<objname>\fP + \fI<svc>_<type>_<index>\fP + +.fi +The \fI<svc>\fP is derived from the service name used, the \fI<type>\fP is +a single-character code to indicate the type of service used ('I' for image, +'C' for catalog, and 'T' for table). The final element will either be the +object name or the index in a list of positions of no object was specified. + +.SS Verbosity +.PP +The \fI-v\fP and \fI--vverbose\fP options serve a dual purpose: within the +task they set the level of output verbosity in terms of what is reported during +processing (Similarly, the \fI-q\fP option can be used to turn off output +reporting entirely). These flags will however also increase the value of the +\fBVERBOSE\fP parameter sent to services during a data query. The default +value is at least 1, with the highest level being 3. Using the \fI-v\fP flag +sets \fBVERBOSE=2\fP and \fI--vverbose\fP sets \fBVERBOSE=3\fP. +.PP +The VERBOSE level can be important in accessing result columns that may only +be returned at the highest level. When using the \fI-m\fR +(or \fI--meta\fR) flag to print +the column metadata, the verbose options will also affect the results and it +is important that the same verbosity be set when doing the actual data +query and access. + +.SS Bandpass and Service Type Aliases +.PP +The type constraint (\fI-t\fP or \fI--type\fP) accepts only the +following arguments: +.nf + + catalog Cone search services + image Simple Image Access services + spectra Simple Spectral Access services + table Vizier services + <literal> ResourceType from Registry record + +.fi +.PP +The bandpass constraint (\fI-b\fP or \fI--bandpass\fP) accepts only +the following arguments: +.nf + + Radio Millimeter Infrared (IR) + Optical Ultraviolet (UV) X-Ray (xray) + Gamma-Ray (GR) + +.fi +Values in parenthese are acceptable aliases. All matches are cases +insensitive. + + +.SS Range-List Parameters +.PP +Some parameters (for example BAND and TIME) may allow a parameter value to be +specified as a numeric range. Such range-valued parameters use the forward +slash (\fI/\fP) character as the separator between elements of the +range specification (as in the ISO 8601 date specification after which this +convention is patterned). For example, \fI5E-7/8E-7\fP would +specify a range consisting of all values from 5E-7 to 8E-7, inclusive. If a +third field is specified it is a step size for traversing the indicated +range. If a parameter permits a step size the semantics of the step size are +defined by the specific parameter. +.PP +An open range may be specified by omitting either range value. If the first +value is omitted the range is open toward lower values. If the second value +is omitted the range is open toward higher values. Omitting both values +indicates an infinite range which accepts all values. For example, +\fI/5\fP is an open range which accepts all values less than or +equal to 5. To specify all values less than 5, \fI/4\fP would be +used (for an integer valued range). Range values are limited to numeric +values or ISO dates. +.PP +A list may be qualified by appending the character \fI;\fP (semicolon) +followed by a qualifier string. For example \fI1E-7/3E-6;source\fP could +specify a spectral bandpass in the rest frame of the source. List and +range syntax may be combined, e.g., to indicate a list of scalar or +range-valued parameter values. Such a range list may be ordered or +unordered, and may contain either numeric or string data. An ordered +list is one which requires values to be processed in a specified order, +and to ensure this the range list is sorted or ordered by the service as +necessary before being used. It is the responsibility of the service to +sort an ordered range list, hence the client can input ranges or range +values in any order for an ordered range list and the result will be +the same. The sequence in which items in an unordered list occur on the +other hand is significant, as since there is no intrinsic ordering for +the list which can be enforced by the service, items will be processed +by the service in the order they are input by the client. +.PP +TIME and BAND are typical examples of ordered range lists. Since a dataset +matches the query if it contains data in any of the specified ranges, +logically it does not matter in what order the ranges are given, or whether +the first element of a range is less than the second, or whether ranges +overlap; the result should be the same in all cases. Hence the range list has +an intrinsic ordering irrespective of how ranges are input. Unless otherwise +specified in the definition of a given parameter, range lists are assumed to +be ordered. + + + +.SH VOCLIENT DAEMON PROCESSING +All VO-CLI tasks are built upon the VOClient interface an rely on a +separate \fIvoclientd\fP process to provide the VO functionality. The +voclientd task is distributed as part of VO-CLI and will be started +automatically by each task if it is not already running. If problems are +encountered, you may want to manually start the voclientd in a separate +window before running the task so you can monitor the output for error +messages. + +.SH RESOURCE CACHING +Registry resolution is a common activity of VO-CLI tasks and so results +will be cached in the $HOME/.voclient/cache/regResolver directory based on +the search term, service type and bandpass parameters. Defining the +\fIVOC_NO_CACHE\fP environment variable will cause the task to ignore the +cache. + +.SH EXAMPLES + +.TP 4 +1) +Query the GSC 2.3 catalog for stars a) within the 0.1 degree +default search size around NGC 1234: b) around all positions +contained in file 'pos.txt': c) for the list of objects given +on the command line: d) query a list of services for a list +of positions: e) print a count of results that would be returned +from 3 services for each position in a file: +.nf + + % vodata gsc2.3 ngc1234 (a) + % vodata gsc2.3 pos.txt (b) + % vodata gsc2.3 m31,m51,m93 (c) + % vodata svcs.txt pos.txt (d) + % vodata hst,chandra,gsc2.3 pos.txt (e) + +.fi + +.TP 4 +2) +Query all (142) image services having data of the subdwarf galaxy +IC 10, print a count of the results only: +.nf + + % vodata -c -t image any IC10 + % vodata --count --type=image any IC10 + +.fi +Note that we use the reserved word '\fIany\fP' for the service name and +constrain by image type. The task will automatically query the Registry to +create the list of services to be queried. + +.TP 4 +3) +Print a count of X-ray catalog data around Abell2712: +.nf + + % vodata -c -t catalog -b x-ray any abell2712 + % vodata --count --type=catalog --bandpass=x-ray any abell2712 + +.fi +In this case we constrain both the service type as well as the spectral +coverage published for the resource in the Registry. We use the reserved +'\fIany\fP' service name to query multiple services and use the '\fI-c\fP' +flag to print a count without saving results. The object name is resolved +to coordinates internally. (Note: this example may take a while to run). + + +.TP 4 +4) +Print the column metadata returned by the RC3 catalog service: +.nf + + % vodata --meta rc3 or vodata -m rc3 + +.fi +The output will print the result using the default VERBOSE level, adding +the \fI-v\fP will set the query parameter VERBOSE=2, adding \fI--verbose\fP +will set VERBOSE=3 (to print all available columns). When accessing data the +same \fI-v\fP flags will be required to retrieve columns at that +\fIVERBOSE\fP level. + + +.TP 4 +5) +Use the Registry to query for resources using the search terms +"cooling flow". Upon examining the output the user notices a +Vizier paper titled "\fICooling Flows in 207 clusters of Galaxies\fP" +that looks interesting. Use the \fBvodata\fP task to download all +tables associated with this paper, save tables in the default +CSV format: +.nf + + % voregistry cooling flow + % vodata -O white97 -all J/MNRAS/292/419 + % vodata --output=white97 --all J/MNRAS/292/419 + +.fi +All 7 tables will be written to the current directory to files +having a root name 'white97' (chosen based on the author and +publication date). + + +.TP 4 +6) +Find a suitable XMM image service, get a (brief) count of the +XMM images available for 3c273, and if there aren't too many, +download the images and save the extracted access URLs: +.nf + + % voregistry -rv -t image xmm + ShortName ResourceType Title + ------------------------------------------------------.... + XMM-Newton SIAP/ARCHIVE XMM-Newton Archive .... + + % vodata -cq xmm-newton 3c273 + xmm-newton 27 I XMM-Newton Archive .... + + % vodata --count --quiet xmm-newton 3c273 + xmm-newton 27 I XMM-Newton Archive .... + + % vodata --get xmm-newton 3c273 + .... will query and download 27 images. + +.fi + +.TP 4 +7) +Query for the images available from 2MASS at a given position, +extract the positions and service URLs to separate files: +.nf + + % vodata -e -O 2mass -t image 2mass 12:34:56.7 -23:12:45.2 + % vodata -e --output=2mass --type=image 2mass 12:34:56.7 -23:12:45.2 + +.fi +The query produces files with the root name '2mass', and exten- sions of +"\fI.csv\fP" (the main response), "\fI.pos\fP" (the extracted pos- itions), +and "\fI.urls\fP" (the access references). The user inspects the files and +notices that the references return both FITS and HTML files, but she only +wants the FITS image date and uses \fBvodata\fP to download only those: +.nf + + % grep fits 2mass_I_001_15998.urls > images.txt + % vodata images.txt + or + % grep fits 2mass_I_001_15998.urls | vodata -i - + +.fi +In both cases we pass URLs to the task which bypasses the query and directly +access the images. However, in the first case we process the entire list +and are able to take advantage of the \fI-maxdownloads=<N>\fR option to +increase the number of simultaneous downloads. In the second case, the +\fI-i\fP flag causes the task to interpret each line of the input stream +as a separate command and so the data are always downloaded one at a time +(which is the default download behavior anyway). + +.TP 4 +8) +Use \fBvodata\fP as a test client for a locally-installed SIAP service: +.nf + + % vodata -t image -s http://localhost/siap.pl 180.0 0.0 + % vodata --type=image --svc=http://localhost/siap.pl 180.0 0.0 + +.fi +In this case we force the ServiceURL using the '\fI-s\fP' flag, but since we +can't do a Registry query to discover what type of service this is, we must +use the '\fI-t\fP' flag to indicate it is an image service. + + +.TP 4 +9) +Create a local table containing the Abell catalog. Begin with a +Registry query to find likely services using the \fBvoregistry\fP task, print +a verbose description of each resource and page the results with \fIless\fP: +.nf + + % voregistry -v -v --type=catalog abell | less + +.fi +The verbose results indicate a number of services with differing +requirements for what is included. We decide to use the service from +HEASARC since it contains southern hemisphere data and constraints we are +interested in. Try an all-sky query to retrieve the entire catalog, use +the service identifier to be specific about where we want to go: +.nf + + % vodata -e ivo://nasa.heasarc/abell 0.0 0.0 180.0 + % vodata --extract ivo://nasa.heasarc/abell 0.0 0.0 180.0 + +.fi +We use the '\fI-e\fP' flag to extract the positions to a separate file with +a "\fI.pos\fP" extension so that we can use these in later queries. +However, the \fI.pos\fP file additionally contains the ID from the original +catalog in column 1. Strip this column so we're left with only RA and DEC +and query for Chandra observations at each position: +.nf + + % cut -c6- *.pos | vodata ivo://nasa.heasarc/chanmaster -p - + % cut -c6- *.pos | vodata ivo://nasa.heasarc/chanmaster --pos=- + +.fi +Here we used the unix '\fIcut\fP' utility to remove the first column and +pipe the resulting positions to the task, using the '\fI-p -\fP' option to +indicate positions should be read from stding, and the IVO identifier of +the Chandra observation master log we also discovered from the Registry. + + +.TP 4 +10) +Interactively query for a count of Chandra observations of Messier +objects: +.nf + + % vodata -cq chandra -i - + m31 + chandra 335 I Chandra X-Ray Observatory Data Archive + : : : : : + +.fi +Note that by using the '\fI-i\fP' flag we execute each query as if we'd put +the object name on the command line. Using the '\fI-o\fP' flag would +instead read all of the objects from the stdin but then execute the queries +in parallel following an EOF to terminate the input. + + +.TP 4 +11) +Use the \fISTILTS\fP task '\fItpipe\fP' to select rows from a VOTable +of QSOs (made with an earlier query) where the redshift is > 0.2. Output +only the positions and pipe this to \fBvodata\fP to generate a new query to +see whether HST has observed any of these objects: +.nf + + % stilts tpipe ifmt=votable qso_survey.vot \ + cmd='select "Z > 0.2"' \ + cmd='keepcols "RA DEC"' | vodata -p - hstpaec + +.fi +Note that we use the '\fI-p -\fP' flag to tell the task to take it's list of +positions from the piped input. The positions are used to query the HST +Planned and Archived Exposure Catalog (\fIhstpaec\fP) + + +.TP 4 +12) +The user has a task called '\fIwcsinfo\fP' that takes a list of images +and outputs a text table containing the plate center and size in degrees. +Use this task as part of a query for 2MASS point sources contained in each +image: +.nf + + % wcsinfo *.fits | vodata 2mass-psc -i - + +.fi +Here we specify the desired service (\fI2mass-psc\fP) on the commandline as +usual, and allow the remainder of the args (i.e. the position and search +size) to be read from the stdin. This allows for variable search sizes but +processes the positions serially. If the sizes are all the same (say 25 +arcmin), multiple queries can be done simultaneously using just a position +file, e.g. +.nf + + % wcsinfo -pos_only *.fits > centers.txt + % vodata --sr=25m 2mass-psc centers.txt + +.fi + + + +.TP 4 +13) +Query a large list of objects against a number of ASCA resources. +Because the ASCA catalogs are served by the same machine, use the \fI'-i'\fP +option and a command file to process only each resource sequentially while +still parallelizing the object lists: + +.nf + % cat cmds.txt + ASCA survey.tbl + ASCA\\ GIS survey.tbl + ASCA\\ GPS survey.tbl + : : + + % vodata -i cmds.txt +.fi +.PP +Note that we've needed to escape the space in the resource name in some +cases. To avoid this, use of the IVO identifier for each resource is usually +preferred. + +.TP 4 +14) +Query the VO for GALEX data of M51. Because the \fIShortName\fP GALEX +is not unique, we must either specify the IVO identifier of a +specific service to query, or if we're interested in results from all +supported data services with \fIgalex\fP in the name: +.nf + + % vodata -a galex M51 + % vodata --all galex M51 + +.fi +The results come from the Cone and SIAP services both called \fIGALEX\fP, +as well as an additional SIAP service called 'GALEX_Atlas'. Note that the +service names are case insensitive in either case. + + +.TP 4 +15) +Process a list of hundreds of positions against the GSC2.3 catalog: +.nf + + % vodata gsc2.3 positions.txt + +.fi + + +.TP 4 +16) +Process a list of hundreds of positions against the GSC2.3 catalog, assume +that the input table has a 5 line header of text and three columns +(id,ra,dec). Note that the \fIcols\fP option requires the optional id +be specified last: +.nf + + % vodata --cols=2,3,1 --hskip=5 gsc2.3 positions.txt + +.fi + +.SH BUGS +Some services don't repond properly to the metadata query and will print +a "no attributes found" message. + +.SH TODO +.PP +- Additional command-line options should be allowed to be specified in a +command file. +.PP +- Support for SSAP, SAMP, TAP + + +.SH Revision History +June 2007 - This task is new. +.SH Author +Michael Fitzpatrick (fitz@noao.edu), June 2007 +.SH "SEE ALSO" +voclient, voclientd, vosesame, voregistry diff --git a/vendor/voclient/doc/vodata.pdf b/vendor/voclient/doc/vodata.pdf Binary files differnew file mode 100644 index 00000000..693f5706 --- /dev/null +++ b/vendor/voclient/doc/vodata.pdf diff --git a/vendor/voclient/doc/voimage.html b/vendor/voclient/doc/voimage.html new file mode 100644 index 00000000..7742b22e --- /dev/null +++ b/vendor/voclient/doc/voimage.html @@ -0,0 +1,109 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOIMAGE</TITLE> +</HEAD><BODY> +<H1>VOIMAGE</H1> +Section: User Commands (1)<BR>Updated: Feb 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +voimage - Query VO image services for data +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>voimage</B> [<opts>] <service> [ <object> | <ra> <dec> ] [ <size> ] +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>voimage</I> application accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<P> +<DT><B>All VODATA task options</B> + +<DD> +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>voimage</I> task is a convenience application built on top of the +<I>vodata</I> application, logically it will only query for image data and will +set the appropriate flags when calling <I>vodata</I>. +<P> + +For a complete list of options and a description of the task behavior, see +the <I>VODATA</I> man page. +<P> +<A NAME="lbAF"> </A> +<H2>RETURN STATUS</H2> + +On exit the <B>voimage</B> task will return a zero indicating success, or a +one indicating an error. +<P> +<A NAME="lbAG"> </A> +<H2>EXAMPLES</H2> + +<DL COMPACT> +<DT>1) Query for all X-ray image data of M51:<DD> +<P> +<PRE> + % voimage -b x-ray any m51 +</PRE> + +<DT>2) Query an HST service having data of the subdwarf galaxy IC 10, print a <DD> +count of the results only: +<P> +<PRE> + % voimage -c CADC/HST IC10 +</PRE> + +<P> +</DL> +<A NAME="lbAH"> </A> +<H2>BUGS</H2> + +No known bugs with this release. +<A NAME="lbAI"> </A> +<H2>Revision History</H2> + +Feb 2013 - First public release +<A NAME="lbAJ"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), Feb 2013 +<A NAME="lbAK"> </A> +<H2>SEE ALSO</H2> + +vodata, vocatalog, vospectrum +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">RETURN STATUS</A><DD> +<DT><A HREF="#lbAG">EXAMPLES</A><DD> +<DT><A HREF="#lbAH">BUGS</A><DD> +<DT><A HREF="#lbAI">Revision History</A><DD> +<DT><A HREF="#lbAJ">Author</A><DD> +<DT><A HREF="#lbAK">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 05:13:24 GMT, April 14, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/voimage.man b/vendor/voclient/doc/voimage.man new file mode 100644 index 00000000..0e9b2d2e --- /dev/null +++ b/vendor/voclient/doc/voimage.man @@ -0,0 +1,53 @@ +.\" @(#)voimage.1 1.0 Feb-2013 MJF +.TH VOIMAGE 1 "Feb 2013" "VOClient Package" +.SH NAME +voimage \- Query VO image services for data + +.SH SYNOPSIS +\fBvoimage\fP [<opts>] <service> [ <object> | <ra> <dec> ] [ <size> ] + +.SH OPTIONS +The \fIvoimage\fP application accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.TP 6 +.B All VODATA task options + +.SH DESCRIPTION +The \fIvoimage\fP task is a convenience application built on top of the +\fIvodata\fP application, logically it will only query for image data and will +set the appropriate flags when calling \fIvodata\fP. +.PP +For a complete list of options and a description of the task behavior, see +the \fIVODATA\fP man page. + +.SH RETURN STATUS +On exit the \fBvoimage\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Query for all X-ray image data of M51: + +.nf + % voimage -b x-ray any m51 +.fi +.TP 4 +2) Query an HST service having data of the subdwarf galaxy IC 10, print a +count of the results only: + +.nf + % voimage -c CADC/HST IC10 +.fi + +.SH BUGS +No known bugs with this release. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +vodata, vocatalog, vospectrum diff --git a/vendor/voclient/doc/voimage.pdf b/vendor/voclient/doc/voimage.pdf Binary files differnew file mode 100644 index 00000000..7e6bb637 --- /dev/null +++ b/vendor/voclient/doc/voimage.pdf diff --git a/vendor/voclient/doc/voiminfo.html b/vendor/voclient/doc/voiminfo.html new file mode 100644 index 00000000..68edaf4d --- /dev/null +++ b/vendor/voclient/doc/voiminfo.html @@ -0,0 +1,164 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOTIMINFO</TITLE> +</HEAD><BODY> +<H1>VOTIMINFO</H1> +Section: User Commands (1)<BR>Updated: Feb 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +votiminfo - Print/Get information about a FITS file's structure +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>votiminfo</B> [<I>-opts</I>] <file> [ <file> .... ] +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>votiminfo</I> task accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<P> +<DT><B>-a, --all</B> + +<DD> +Print information for the entire field in an MEF file, e.g. from a mosaic +camera. If not specified, information for each image extension is printed. +<DT><B>-b, --box</B> + +<DD> +Print the LL and UR corners of the image along with the rotation. +<DT><B>-c, --corners</B> + +<DD> +Print all four WCS image corners in the image. The ordering of the +corners is LL, UL, UR, LR. +<DT><B>-i, --info</B> + +<DD> +Print all know image information. +<DT><B>-n, --naxes</B> + +<DD> +Print the pixel dimensions of an image. +<DT><B>-o </B><I>NAME</I>, --output <I>NAME</I> + +<DD> +Write the result to the file <I>NAME</I>. +<DT><B>-s, --sex</B> + +<DD> +Print values in sexagesimal format. +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>votiminfo</I> task is used to get information about the structure of +FITS files, e.g. to get the center and radius values that might be used in +a VO data query, the corner positions needed to draw a footprint overlay, +or simply the dimensionality of a FITS file (or the extensions in an MEF +file). If no information options are specified the default is to print +the center position and a radius (in decimal degrees if a WCS is present, +or in pixels otherwise). In all cases, in no WCS is present in the image +header, zero will be printed. +<P> + +If the <I>-b</I> option is used the LL and UR corner positions are printed +along with a rotation of the box that represents. The <I>-c</I> flag may be +used to explicitly print all four corner positions starting at the LL and +moving clockwise. The <I>-n</I> flag can be used to print the dimensionality +of an image, similarly the <I>-i</I> flag may be used to print all information +about an image determined by the task. +<P> + +By default, and MEF file will cause information about each extension to be +printed. If the <I>-a</I> flag is used the requested information for all +extensions in an MEF (e.g from a mosaic camera) will be printed. This allows +the user the option of getting information about individual rasters within +an MEF or the footprint of the entire FOV. CFITSIO is used to read the file +and so the syntax to specify an extension number or image section (see the +CFITSIO documentation) is allowed by the task. +<P> +<A NAME="lbAF"> </A> +<H2>RETURN STATUS</H2> + +On exit the <B>votiminfo</B> task will return a zero indicating success, or a +one indicating an error. +<P> +<A NAME="lbAG"> </A> +<H2>EXAMPLES</H2> + +<DL COMPACT> +<DT>1) Print the size of each image extension in an MEF file:<DD> +<P> +<PRE> + % votiminfo -n mef.fits +</PRE> + +<DT>2) Print the LL and UR positions of an image as sexigesimal:<DD> +<P> +<PRE> + % voiminfo -b -s image.fits +</PRE> + +<DT>3) Print the corner positions of an image as decimal degrees:<DD> +<P> +<PRE> + % voiminfo -c image.fits +</PRE> + +<DT>4) Print the box values for an entire mosaic MEF file:n"<DD> +<P> +<PRE> + % voiminfo -b mef.fits +</PRE> + +</DL> +<A NAME="lbAH"> </A> +<H2>BUGS</H2> + +No known bugs with this release. +<A NAME="lbAI"> </A> +<H2>Revision History</H2> + +Feb 2013 - First public release +<A NAME="lbAJ"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), Feb 2013 +<A NAME="lbAK"> </A> +<H2>SEE ALSO</H2> + +votinfo +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">RETURN STATUS</A><DD> +<DT><A HREF="#lbAG">EXAMPLES</A><DD> +<DT><A HREF="#lbAH">BUGS</A><DD> +<DT><A HREF="#lbAI">Revision History</A><DD> +<DT><A HREF="#lbAJ">Author</A><DD> +<DT><A HREF="#lbAK">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 05:13:24 GMT, April 14, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/voiminfo.man b/vendor/voclient/doc/voiminfo.man new file mode 100644 index 00000000..7cb1e6ee --- /dev/null +++ b/vendor/voclient/doc/voiminfo.man @@ -0,0 +1,101 @@ +.\" @(#)votiminfo.1 1.0 Feb-2013 MJF +.TH VOTIMINFO 1 "Feb 2013" "VOClient Package" +.SH NAME +votiminfo \- Print/Get information about a FITS file's structure + +.SH SYNOPSIS +\fBvotiminfo\fP [\fI-opts\fP] <file> [ <file> .... ] + +.SH OPTIONS +The \fIvotiminfo\fP task accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.TP 6 +.B \-a, --all +Print information for the entire field in an MEF file, e.g. from a mosaic +camera. If not specified, information for each image extension is printed. +.TP 6 +.B \-b, --box +Print the LL and UR corners of the image along with the rotation. +.TP 6 +.B \-c, --corners +Print all four WCS image corners in the image. The ordering of the +corners is LL, UL, UR, LR. +.TP 6 +.B \-i, --info +Print all know image information. +.TP 6 +.B \-n, --naxes +Print the pixel dimensions of an image. +.TP 6 +.B \-o \fINAME\fP, --output \fINAME\fP +Write the result to the file \fINAME\fP. +.TP 6 +.B \-s, --sex +Print values in sexagesimal format. + +.SH DESCRIPTION +The \fIvotiminfo\fP task is used to get information about the structure of +FITS files, e.g. to get the center and radius values that might be used in +a VO data query, the corner positions needed to draw a footprint overlay, +or simply the dimensionality of a FITS file (or the extensions in an MEF +file). If no information options are specified the default is to print +the center position and a radius (in decimal degrees if a WCS is present, +or in pixels otherwise). In all cases, in no WCS is present in the image +header, zero will be printed. +.PP +If the \fI-b\fP option is used the LL and UR corner positions are printed +along with a rotation of the box that represents. The \fI-c\fP flag may be +used to explicitly print all four corner positions starting at the LL and +moving clockwise. The \fI-n\fP flag can be used to print the dimensionality +of an image, similarly the \fI-i\fP flag may be used to print all information +about an image determined by the task. +.PP +By default, and MEF file will cause information about each extension to be +printed. If the \fI-a\fP flag is used the requested information for all +extensions in an MEF (e.g from a mosaic camera) will be printed. This allows +the user the option of getting information about individual rasters within +an MEF or the footprint of the entire FOV. CFITSIO is used to read the file +and so the syntax to specify an extension number or image section (see the +CFITSIO documentation) is allowed by the task. + +.SH RETURN STATUS +On exit the \fBvotiminfo\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Print the size of each image extension in an MEF file: + +.nf + % votiminfo -n mef.fits +.fi +.TP 4 +2) Print the LL and UR positions of an image as sexigesimal: + +.nf + % voiminfo -b -s image.fits +.fi +.TP 4 +3) Print the corner positions of an image as decimal degrees: + +.nf + % voiminfo -c image.fits\n" +.fi +.TP 4 +4) Print the box values for an entire mosaic MEF file:\n\n" + +.nf + % voiminfo -b mef.fits\n" +.fi +.SH BUGS +No known bugs with this release. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +votinfo diff --git a/vendor/voclient/doc/voiminfo.pdf b/vendor/voclient/doc/voiminfo.pdf Binary files differnew file mode 100644 index 00000000..acf8708e --- /dev/null +++ b/vendor/voclient/doc/voiminfo.pdf diff --git a/vendor/voclient/doc/voregistry.html b/vendor/voclient/doc/voregistry.html new file mode 100644 index 00000000..b99bbfb6 --- /dev/null +++ b/vendor/voclient/doc/voregistry.html @@ -0,0 +1,476 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOREGISTRY</TITLE> +</HEAD><BODY> +<H1>VOREGISTRY</H1> +Section: User Commands (1)<BR>Updated: July 2007<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +voregistry - VO Registry search client +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>voregistry</B> [-<I><flags></I>] [ <I><keywords></I> | <<I>term</I>> ] [ ... ] +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>voregistry</I> task accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<DT><B>-v, --verbose</B> + +<DD> +Verbose output. The output will be more verbose than normal but exactly +what is printed depends on whether other flags are enabled to changed the +basic task behavior. +<DT><B>--vverbose</B> + +<DD> +Very-verbose output. Even more output. +<DT>The following flags control the major behavior of the task, i.e. the type<DD> +of output to present. +<DT><B>-c, --count</B> + +<DD> +Print a count of matching records. For each of the search terms, a simple +count of matching resources will be printed. A breakdown by service type +will be printed if the verbose flag is enabled. +<DT><B>-e, --exact</B> + +<DD> +Match exactly the search term (resolve mode only). The <I>term</I> in this +case will normally be an IVO identifier, this flag can be used to match the +identifier exactly rather than as a potential substring. This option will +return an empty string if no exact match is found. +<DT><B>-l, --list</B> + +<DD> +List the full resource record for each matching resource. For each matching +resource, all (well, most) of the information available about a resource +will be printed to the screen. Additional information may be available from +the Registry web interface. +<DT><B>-m, --meta</B> + +<DD> +List the metadata for the data services associated with the resource. For +each resource found, the table metadata (i.e. the column UCD values) +associated with the resource will be printed. Currently only those DAL +services supported by VOClient may be queried. +<DT><B>-r, --resolve</B> + +<DD> +<I>Resolve</I> the search term to a specified resource. In <I>resolve mode</I> +the search terms are assumed to be either the resource <I>ShortName</I> or +<I>Identifier</I> and the match will be done using only these two fields in +the Registry resource record. The default output is simply the +<I>ServiceURL</I> for all matching records (i.e. resources where the search +string is part of the <I>ShortName</I> or <I>Identifier</I> fields) unless +the <I>-f</I> flag is given to select other fields. +<DT>Shorthand Convenience Options:<DD> +<DT><B>-I, --id</B> + +<DD> +Print only the <I>Identifier</I> field for the resolved resource. +<DT><B>-L, --long </B> + +<DD> +Suppress the linebreaks imposed for output fields that would wrap around the +normal 80-character output and allow long lines. This allows tasks to parse +the output more predictably. +<DT><B>-R, --Resolve</B> + +<DD> +Print the <I>ShortName</I>, <I>ServiceType</I> and <I>Identifier</I> fields for +the resolved resource. +<DT><B>-S, --SName</B> + +<DD> +Print only the <I>ShortName</I> field for the resolved resource. +<DT><B>-T, --Title</B> + +<DD> +Print only the <I>Title</I> for the resolved resources. +<DT>Constraint Options:<DD> +</DL> +<P> + +The list of allowed constraint strings is generally specified in the +<I>Resource Metadata for the Virtual Observatory</I> document available on +the IVOA document repository. These flags provide a convenient method to +limit a result list to resources that explicitly specify a value for the +given constraint. +<DL COMPACT> +<DT><B>-b, --bandpass <bpass></B> + +<DD> +Constrain the search to the specified bandpass string. +The text argument following the -f flag +will be matched against the <I>SpectralCoverage</I> field of the resource +record. Registry resources allow a list of values, however only a single +argument may be used to constrain the search. Permitted values include: +"Radio", "Millimeter", "Infrared" (IR), "Optical", "Ultraviolet" (UV), +"X-Ray" (XRay), and "Gamma-Ray" (GR). The match is case insensitive, values +shown in parentheses may be given and will be substituted automatically. +<DT><B>-C, --clevel <content></B> + +<DD> +Constrain the search to the specified ContentLevel string. The Registry +may contain data for a variety of intended audiences; Most often this +constraint will be used to limit the results to 'Research' grade data. +<DT><B>-d, --dal</B> + +<DD> +Constrain the search to only standard DAL services. A general keyword search will +normally return all resources, including those referring to custom services or +non data-access entries. Use of the <I>-d</I> flag will restrict results to only +those resource records describing a standard VO data-access service. +<DT><B>-g, --group</B> + +<DD> +Group the search terms to form a single query. +<DT><B>-s, --subject <subject></B> + +<DD> +Constrain the search to the specified Subject string. Note that multi-word +subjects (e.g. "cool stars") must either be quoted or have the space escaped +for the subject to be queried correctly. A substring, case-insensitive search +of the Subject field is performed. +<DT><B>-t, --type <type></B> + +<DD> +Constrain the search to the specified ResourceType string. The Registry +records may contain any user-specified string, however unless you know +specifically how a specific resource is defined, this constraint should +use the values 'catalog' (for Cone services), 'image' (for SIAP +services), 'spectra' (for SSAP services), 'table' (for Vizier tables), +or a literal string which appears in the +resource record. Additional aliases will be added as new +data services are supported. +<DT><B>-N, --new <time></B> + +<DD> +Constrain the search to those resources that have been newly created during +the specified <time>. By default, <time> is an integer value assumed to be +a number of days, the last character may contain one of the qualifying +characters to change the time period: 'h' for hours, 'd' for days, + +refers to the last siz months. If no search term is given, all results +for that period will be returned, otherwise only those results that match +both the search terms and the time constraint will be listed. +<DT><B>-U, --updated <time></B> + +<DD> +Constrain the search to those resource records that have been updated during +the specified time period. +<DT>Output Control Options:<DD> +<DT><B>-a, --all</B> + +<DD> +Output all matching records (default). When used with the constraint flags +above, this flag will allow those constraint strings to be matched as a +substring, e.g. using "-t siap" will exactly match resources with type + +<DT><B>-f, --fields <fields></B> + +<DD> +Output the specified fields from the resource record (used in Resolve Mode +only). The list of available fields is given below, an 'INDEF' string is +printed for invalid field names or when no information is available. +<DT><B>-O, --or</B> + +<DD> +Logically OR the search terms. By default, all terms will be used when +matching resource records. +<DT><B>-n, --index <index></B> + +<DD> +Output only the results for the matchng <I>index</I>. Results are 1-indexed, +i.e. the first result is index 1 (one). +<DT><B>-o, --output <oname></B> + +<DD> +Save the results in VOTable format to the file name <I>oname</I>. The +verbose level of the query is increased when using this option. +<DT><B>-B, --samp</B> + +<DD> +Broadcast the results as a SAMP message using a <I>table.load.votable</I> +message type. +<DT><B>-V, --votable</B> + +<DD> +Write results in VOTable format. +<DT><B>-X, --xml</B> + +<DD> +Write results in VOTable format. +<P> +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>voregistry</I> task provides a command-line interface to the <I>NVO +Registry</I> at STScI/JHU. The task also provides a basic search capability +for the Registry, as well as a "Resolve Mode" that can be used to lookup +resource records given some familiar name (e.g. 'USNO-B1'). Constraint +parameters allow the search to be restricted to resources declaring a +specific type (the <I>-t</I> flag), spectral coverage (the <I>-b</I> flag), or +content level (the <I>-C</I> flag). +<P> + +Search terms may be provided on the +command-line, in a filename specified on the commandline, or read from the +standard input (e.g. redirected from a file or other command). Advanced +users can submit a quoted ADQL string to access specific fields of a resource +record. This is similar to using the "Advanced Search" capability on the +NVO Registry web page. ADQL strings are required to be in double quotes +when given on the command line, the quotes are needed when query strings +come from a file. Standard SQL operators apply for comparison and boolean +operations, the 'like' operator is used to match strings (which must be in +single quotes), one or more '%' metacharacters may be used in the string +to indicate a wildcard match. +<P> + +In the default search mode, keywords given on the command line will all be +used to match resource records. The <I>-o</I> flag may be used to logically +OR the keyword terms, e.g. to allow a search of 'galaxy' or 'galaxies'. The +minimal output provides the resource title, type, subject and the 'ShortName' +that can be used in the resolve mode or be passed to other tasks such as +<A HREF="http://localhost/cgi-bin/man/man2html?1+vodata">vodata</A>(1). Additional output can be had with the <I>-v</I> or <I>-vv</I> +verbose flags. A simple count of the resources will be printed if the +<I>-c</I> flag is set (e.g. the command "voregistry -oc chandra spitzer" +will print a count of how many records match each term rather than display +them directly, without the -o flag a count of resources mentioning both +keywords will be printed). +<P> + +The "Resolve mode" is activated by the <I>-r</I> flag; In this mode the +keywords will only be matched against the Registry <I>ShortName</I> and +<I>Identifier</I> fields. The default output is simply the <I>ServiceURL</I>, +adding the verbose flags will instead print the ShortName, ResourceType and +Title (with "-v") or Description (with "-vv"). The user can select specific +fields to be printed using the <I>-f</I> flag followed by a comma-delimited +list of fields. The allowed fields are shown with the <I>-h</I> help flag. +<P> + +The <I>-list</I> flag implies Resolve Mode and will cause all fields of the +matching resource to be printed. Unless the <I>-a</I> flag is set, the +search term will be matched exactly, otherwise it will be considered to be +a substring of the ShortName or Identifier fields. For example, searching +with the term '2mass' will list only 2MASS image service, but using the +<I>-a</I> flag will list all services where '2mass' appears in the ShortName. +<P> + +The <I>-meta</I> flag likewise assumes the command line arg is a resource +ShortName to be resolved and will query the DAL service associated with it +using a <I>FORMAT=METADATA</I> query. The default position will be (0.0,0.0) +with a search size of 0.1 degrees, the response will be a list of the column +UCDs returned by the query (note that adding <I>-v</I> flags will likewise +increase the VERBOSE of the query and may return additional columns). +<P> +<A NAME="lbAF"> </A> +<H2>RETURN STATUS</H2> + +The task will exit with a status of 0 if at least one search term could +be successfully resolved, otherwise the status will be 1. +<P> +<A NAME="lbAG"> </A> +<H2>VOCLIENT DAEMON PROCESSING</H2> + +All VO-CLI tasks are built upon the VOClient interface an rely on a +separate <I>voclientd</I> process to provide the VO functionality. The +voclientd task is distributed as part of VO-CLI and will be started +automatically by each task if it is not already running. If problems +are encountered, you may want to manually start the voclientd in a separate +window before running the task so you can monitor the output for error +messages. +<P> +<A NAME="lbAH"> </A> +<H2>RESOURCE CACHING</H2> + +Registry resolution is a common activity of VO-CLI tasks and so results +will be cached in the $HOME/.voclient/cache/regResolver directory based +on the search term, service type and bandpass parameters. Defining the +<I>VOC_NO_CACHE</I> environment variable will cause the task to ignore the +cache. +<P> +<P> +<A NAME="lbAI"> </A> +<H2>EXAMPLES</H2> + +<P> +<DL COMPACT> +<DT>1)<DD> +Get a count of all the SIAP services available in the Registry, then +list more information about each one: +<PRE> + + % voregistry -count -t image + 142 + % voregistry -rv -t image + +</PRE> + +<DT>2)<DD> +Find all catalog (i.e. Cone) services using the search words 'radio' +and 'galaxies': +<PRE> + + % voregistry -t catalog radio galaxies + +</PRE> + +<DT>3)<DD> +Print the full resource record of the GSC2.2 catalog at STScI: +<PRE> + + % voregistry -list GSC2.2 + +</PRE> + +<DT>4)<DD> +Find all services with radio data of Abell clusters. Then print the +full description of the first record associated with one of the matching +Vizier tables: +<PRE> + + % voregistry -b radio abell + % voregistry -rvv -n 1 J/A+A/446/97/tab + +</PRE> + +<DT>5)<DD> +Find all image services that have WFPC data: +<PRE> + + % voregistry -v -t image wfpc + +</PRE> + +<DT>6)<DD> +Print a breakdown of VO services having Keck data: +<PRE> + + % voregistry -cv keck + keck 122 (Cat: 2 Tab: 117 SNode: 1 Other: 2) + +</PRE> + +<DT>7)<DD> +Print a count of services having all of Chandra, HST and Spitzer data, +then break it down by each mission: +<PRE> + + % voregistry -c chandra hst spitzer + chandra hst spitzer 3 + % voregistry -co chandra hst spitzer + chandra 323 + hst 443 + spitzer 31 + +</PRE> + +<DT>8)<DD> +Print the column metadata returned by the GSC2.2 service: +<PRE> + + % voregistry -meta gsc2.2 + +</PRE> + +<DT>9)<DD> +Use the ADQL query format to find services in which HST was the used, +and not simply a match of 'HST' in the resource record: +<PRE> + + % voregistry "Facility like 'HST'" + +</PRE> + +Note that use assumed knowledge of the Registry being queried, specifically +that there exists a 'Facility' field with this information and that the +syntax of the query requires the string to be in quotes. +<P> +<DT>10) Use the ADQL query format to find services in which 'Keck' appears in<DD> +the Title of the resource: +<PRE> + + % voregistry "Title like '%Keck%'" + + or + + % cat query.txt + Title like '%Keck%' + % cat query.txt | voregistry + +</PRE> + +Note that here we use the '%' operator around the string so that we perform +a substring match on the entire title. As before, the ADQL string itself +must be enclosed in double quotes. +<P> +<DT>11) Find all resources that are newly registered in the last 3 months, then<DD> +find only those resources dealing with "cool stars", and finally just print +a count of resources updated in the last year: +<PRE> + + % voregistry --new 3m + % voregistry --new 3m cool stars + % voregistry --updated 12m --count + +</PRE> + +<P> +</DL> +<A NAME="lbAJ"> </A> +<H2>BUGS</H2> + +Some services don't repond properly to the metadata query and will print +a "no attributes found" message. +<A NAME="lbAK"> </A> +<H2>Revision History</H2> + +June 2007 - This task is new. +<A NAME="lbAL"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), July 2007 +<A NAME="lbAM"> </A> +<H2>SEE ALSO</H2> + +<A HREF="http://localhost/cgi-bin/man/man2html?1+voclient">voclient</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+voclientd">voclientd</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+vosesame">vosesame</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+vodata">vodata</A>(1) +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">RETURN STATUS</A><DD> +<DT><A HREF="#lbAG">VOCLIENT DAEMON PROCESSING</A><DD> +<DT><A HREF="#lbAH">RESOURCE CACHING</A><DD> +<DT><A HREF="#lbAI">EXAMPLES</A><DD> +<DT><A HREF="#lbAJ">BUGS</A><DD> +<DT><A HREF="#lbAK">Revision History</A><DD> +<DT><A HREF="#lbAL">Author</A><DD> +<DT><A HREF="#lbAM">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 05:13:24 GMT, April 14, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/voregistry.man b/vendor/voclient/doc/voregistry.man new file mode 100644 index 00000000..e4a16de2 --- /dev/null +++ b/vendor/voclient/doc/voregistry.man @@ -0,0 +1,384 @@ +.\" @(#)voregistry.1 1.0 June-07 MJF +.TH VOREGISTRY 1 "July 2007" "VOClient Project" +.SH NAME +voregistry \- VO Registry search client + +.SH SYNOPSIS +\fBvoregistry\fP [\-\fI<flags>\fP] [ \fI<keywords>\fP | <\fIterm\fP> ] [ ... ] + +.SH OPTIONS +The \fIvoregistry\fP task accepts the following options: +.TP 8 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. +.TP 8 +.B \-v, --verbose +Verbose output. The output will be more verbose than normal but exactly +what is printed depends on whether other flags are enabled to changed the +basic task behavior. +.TP 8 +.B \--vverbose +Very-verbose output. Even more output. +.TP 0 +The following flags control the major behavior of the task, i.e. the type +of output to present. +.TP 8 +.B \-c, --count +Print a count of matching records. For each of the search terms, a simple +count of matching resources will be printed. A breakdown by service type +will be printed if the verbose flag is enabled. +.TP 8 +.B \-e, --exact +Match exactly the search term (resolve mode only). The \fIterm\fP in this +case will normally be an IVO identifier, this flag can be used to match the +identifier exactly rather than as a potential substring. This option will +return an empty string if no exact match is found. +.TP 8 +.B \-l, --list +List the full resource record for each matching resource. For each matching +resource, all (well, most) of the information available about a resource +will be printed to the screen. Additional information may be available from +the Registry web interface. +.TP 8 +.B \-m, --meta +List the metadata for the data services associated with the resource. For +each resource found, the table metadata (i.e. the column UCD values) +associated with the resource will be printed. Currently only those DAL +services supported by VOClient may be queried. +.TP 8 +.B \-r, --resolve +\fIResolve\fP the search term to a specified resource. In \fIresolve mode\fP +the search terms are assumed to be either the resource \fIShortName\fP or +\fIIdentifier\fP and the match will be done using only these two fields in +the Registry resource record. The default output is simply the +\fIServiceURL\fP for all matching records (i.e. resources where the search +string is part of the \fIShortName\fP or \fIIdentifier\fP fields) unless +the \fI-f\fP flag is given to select other fields. +.TP 0 +Shorthand Convenience Options: +.TP 8 +.B \-I, --id +Print only the \fIIdentifier\fP field for the resolved resource. +.TP 8 +.B \-L, --long +Suppress the linebreaks imposed for output fields that would wrap around the +normal 80-character output and allow long lines. This allows tasks to parse +the output more predictably. +.TP 8 +.B \-R, --Resolve +Print the \fIShortName\fP, \fIServiceType\fP and \fIIdentifier\fP fields for +the resolved resource. +.TP 8 +.B \-S, --SName +Print only the \fIShortName\fP field for the resolved resource. +.TP 8 +.B \-T, --Title +Print only the \fITitle\fP for the resolved resources. +.TP 0 +Constraint Options: +.PP +The list of allowed constraint strings is generally specified in the +\fIResource Metadata for the Virtual Observatory\fP document available on +the IVOA document repository. These flags provide a convenient method to +limit a result list to resources that explicitly specify a value for the +given constraint. +.TP 8 +.B \-b, --bandpass <bpass> +Constrain the search to the specified bandpass string. +The text argument following the -f flag +will be matched against the \fISpectralCoverage\fP field of the resource +record. Registry resources allow a list of values, however only a single +argument may be used to constrain the search. Permitted values include: +"Radio", "Millimeter", "Infrared" (IR), "Optical", "Ultraviolet" (UV), +"X-Ray" (XRay), and "Gamma-Ray" (GR). The match is case insensitive, values +shown in parentheses may be given and will be substituted automatically. +.TP 8 +.B \-C, --clevel <content> +Constrain the search to the specified ContentLevel string. The Registry +may contain data for a variety of intended audiences; Most often this +constraint will be used to limit the results to 'Research' grade data. +.TP 8 +.B \-d, --dal +Constrain the search to only standard DAL services. A general keyword search will +normally return all resources, including those referring to custom services or +non data-access entries. Use of the \fI-d\fP flag will restrict results to only +those resource records describing a standard VO data-access service. +.TP 8 +.B \-g, --group +Group the search terms to form a single query. +.TP 8 +.B \-s, --subject <subject> +Constrain the search to the specified Subject string. Note that multi-word +subjects (e.g. "cool stars") must either be quoted or have the space escaped +for the subject to be queried correctly. A substring, case-insensitive search +of the Subject field is performed. +.TP 8 +.B \-t, --type <type> +Constrain the search to the specified ResourceType string. The Registry +records may contain any user-specified string, however unless you know +specifically how a specific resource is defined, this constraint should +use the values 'catalog' (for Cone services), 'image' (for SIAP +services), 'spectra' (for SSAP services), 'table' (for Vizier tables), +or a literal string which appears in the +resource record. Additional aliases will be added as new +data services are supported. +.TP 8 +.B \-N, --new <time> +Constrain the search to those resources that have been newly created during +the specified <time>. By default, <time> is an integer value assumed to be +a number of days, the last character may contain one of the qualifying +characters to change the time period: 'h' for hours, 'd' for days, +'w' for weeks, and 'm' for months. For example, the <time> string "6m" +refers to the last siz months. If no search term is given, all results +for that period will be returned, otherwise only those results that match +both the search terms and the time constraint will be listed. +.TP 8 +.B \-U, --updated <time> +Constrain the search to those resource records that have been updated during +the specified time period. +.TP 0 +Output Control Options: +.TP 8 +.B \-a, --all +Output all matching records (default). When used with the constraint flags +above, this flag will allow those constraint strings to be matched as a +substring, e.g. using "-t siap" will exactly match resources with type +'siap', but using "-a -t siap" will also match 'siap/cutout' services. +.TP 8 +.B \-f, --fields <fields> +Output the specified fields from the resource record (used in Resolve Mode +only). The list of available fields is given below, an 'INDEF' string is +printed for invalid field names or when no information is available. +.TP 8 +.B \-O, --or +Logically OR the search terms. By default, all terms will be used when +matching resource records. +.TP 8 +.B \-n, --index <index> +Output only the results for the matchng \fIindex\fP. Results are 1-indexed, +i.e. the first result is index 1 (one). +.TP 8 +.B \-o, --output <oname> +Save the results in VOTable format to the file name \fIoname\fP. The +verbose level of the query is increased when using this option. +.TP 8 +.B \-B, --samp +Broadcast the results as a SAMP message using a \fItable.load.votable\fP +message type. +.TP 8 +.B \-V, --votable +Write results in VOTable format. +.TP 8 +.B \-X, --xml +Write results in VOTable format. + + +.SH DESCRIPTION +The \fIvoregistry\fP task provides a command-line interface to the \fINVO +Registry\fP at STScI/JHU. The task also provides a basic search capability +for the Registry, as well as a "Resolve Mode" that can be used to lookup +resource records given some familiar name (e.g. 'USNO-B1'). Constraint +parameters allow the search to be restricted to resources declaring a +specific type (the \fI-t\fP flag), spectral coverage (the \fI-b\fP flag), or +content level (the \fI-C\fP flag). +.PP +Search terms may be provided on the +command-line, in a filename specified on the commandline, or read from the +standard input (e.g. redirected from a file or other command). Advanced +users can submit a quoted ADQL string to access specific fields of a resource +record. This is similar to using the "Advanced Search" capability on the +NVO Registry web page. ADQL strings are required to be in double quotes +when given on the command line, the quotes are needed when query strings +come from a file. Standard SQL operators apply for comparison and boolean +operations, the 'like' operator is used to match strings (which must be in +single quotes), one or more '%' metacharacters may be used in the string +to indicate a wildcard match. +.PP +In the default search mode, keywords given on the command line will all be +used to match resource records. The \fI-o\fR flag may be used to logically +OR the keyword terms, e.g. to allow a search of 'galaxy' or 'galaxies'. The +minimal output provides the resource title, type, subject and the 'ShortName' +that can be used in the resolve mode or be passed to other tasks such as +vodata(1). Additional output can be had with the \fI-v\fR or \fI-vv\fP +verbose flags. A simple count of the resources will be printed if the +\fI-c\fP flag is set (e.g. the command "voregistry -oc chandra spitzer" +will print a count of how many records match each term rather than display +them directly, without the -o flag a count of resources mentioning both +keywords will be printed). +.PP +The "Resolve mode" is activated by the \fI-r\fR flag; In this mode the +keywords will only be matched against the Registry \fIShortName\fP and +\fIIdentifier\fR fields. The default output is simply the \fIServiceURL\fR, +adding the verbose flags will instead print the ShortName, ResourceType and +Title (with "-v") or Description (with "-vv"). The user can select specific +fields to be printed using the \fI-f\fP flag followed by a comma-delimited +list of fields. The allowed fields are shown with the \fI-h\fP help flag. +.PP +The \fI-list\fP flag implies Resolve Mode and will cause all fields of the +matching resource to be printed. Unless the \fI-a\fP flag is set, the +search term will be matched exactly, otherwise it will be considered to be +a substring of the ShortName or Identifier fields. For example, searching +with the term '2mass' will list only 2MASS image service, but using the +\fI-a\fP flag will list all services where '2mass' appears in the ShortName. +.PP +The \fI-meta\fP flag likewise assumes the command line arg is a resource +ShortName to be resolved and will query the DAL service associated with it +using a \fIFORMAT=METADATA\fP query. The default position will be (0.0,0.0) +with a search size of 0.1 degrees, the response will be a list of the column +UCDs returned by the query (note that adding \fI-v\fP flags will likewise +increase the VERBOSE of the query and may return additional columns). + +.SH RETURN STATUS +The task will exit with a status of 0 if at least one search term could +be successfully resolved, otherwise the status will be 1. + +.SH VOCLIENT DAEMON PROCESSING +All VO-CLI tasks are built upon the VOClient interface an rely on a +separate \fIvoclientd\fP process to provide the VO functionality. The +voclientd task is distributed as part of VO-CLI and will be started +automatically by each task if it is not already running. If problems +are encountered, you may want to manually start the voclientd in a separate +window before running the task so you can monitor the output for error +messages. + +.SH RESOURCE CACHING +Registry resolution is a common activity of VO-CLI tasks and so results +will be cached in the $HOME/.voclient/cache/regResolver directory based +on the search term, service type and bandpass parameters. Defining the +\fIVOC_NO_CACHE\fP environment variable will cause the task to ignore the +cache. + + +.SH EXAMPLES + +.TP 4 +1) +Get a count of all the SIAP services available in the Registry, then +list more information about each one: +.nf + + % voregistry --count -t image + 142 + % voregistry -rv -t image + +.fi +.TP 4 +2) +Find all catalog (i.e. Cone) services using the search words 'radio' +and 'galaxies': +.nf + + % voregistry -t catalog radio galaxies + +.fi +.TP 4 +3) +Print the full resource record of the GSC2.2 catalog at STScI: +.nf + + % voregistry --list GSC2.2 + +.fi +.TP 4 +4) +Find all services with radio data of Abell clusters. Then print the +full description of the first record associated with one of the matching +Vizier tables: +.nf + + % voregistry -b radio abell + % voregistry -rvv -n 1 J/A+A/446/97/tab + +.fi +.TP 4 +5) +Find all image services that have WFPC data: +.nf + + % voregistry -v -t image wfpc + +.fi +.TP 4 +6) +Print a breakdown of VO services having Keck data: +.nf + + % voregistry -cv keck + keck 122 (Cat: 2 Tab: 117 SNode: 1 Other: 2) + +.fi +.TP 4 +7) +Print a count of services having all of Chandra, HST and Spitzer data, +then break it down by each mission: +.nf + + % voregistry -c chandra hst spitzer + chandra hst spitzer 3 + % voregistry -co chandra hst spitzer + chandra 323 + hst 443 + spitzer 31 + +.fi +.TP 4 +8) +Print the column metadata returned by the GSC2.2 service: +.nf + + % voregistry --meta gsc2.2 + +.fi +.TP 4 +9) +Use the ADQL query format to find services in which HST was the used, +and not simply a match of 'HST' in the resource record: +.nf + + % voregistry "Facility like 'HST'" + +.fi +Note that use assumed knowledge of the Registry being queried, specifically +that there exists a 'Facility' field with this information and that the +syntax of the query requires the string to be in quotes. + +.TP 4 +10) Use the ADQL query format to find services in which 'Keck' appears in +the Title of the resource: +.nf + + % voregistry "Title like '%Keck%'" + + or + + % cat query.txt + Title like '%Keck%' + % cat query.txt | voregistry + +.fi +Note that here we use the '%' operator around the string so that we perform +a substring match on the entire title. As before, the ADQL string itself +must be enclosed in double quotes. + +.TP 4 +11) Find all resources that are newly registered in the last 3 months, then +find only those resources dealing with "cool stars", and finally just print +a count of resources updated in the last year: +.nf + + % voregistry --new 3m + % voregistry --new 3m cool stars + % voregistry --updated 12m --count + +.fi + +.SH BUGS +Some services don't repond properly to the metadata query and will print +a "no attributes found" message. +.SH Revision History +June 2007 - This task is new. +.SH Author +Michael Fitzpatrick (fitz@noao.edu), July 2007 +.SH "SEE ALSO" +voclient(1), voclientd(1), vosesame(1), vodata(1) diff --git a/vendor/voclient/doc/voregistry.pdf b/vendor/voclient/doc/voregistry.pdf Binary files differnew file mode 100644 index 00000000..4f5a302d --- /dev/null +++ b/vendor/voclient/doc/voregistry.pdf diff --git a/vendor/voclient/doc/vosamp.html b/vendor/voclient/doc/vosamp.html new file mode 100644 index 00000000..f68f4b27 --- /dev/null +++ b/vendor/voclient/doc/vosamp.html @@ -0,0 +1,405 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOSAMP</TITLE> +</HEAD><BODY> +<H1>VOSAMP</H1> +Section: User Commands (1)<BR>Updated: Feb 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +vosamp - command-line SAMP utility task +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>vosamp</B> [-t to] [-p pattern] [-f file] <cmd> [args ...] +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>vosamp</I> application accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<P> +<DT><B>-i, --interact</B> + +<DD> +Interactive mode. If enabled, a command prompt will be printed allowing +users to enter commands interactively until an <EOF> is encountered. +<DT><B>-m, --many</B> + +<DD> +Handle multiple messages when in listening mode. If not enabled, +<I>vosamp</I> can be called to wait for a specific message and will exit when +it is received, otherwise the task will continue to run and process +multiple messages. +<DT><B>-s </B><I>SENDER</I>, --sender <I>SENDER</I> + +<DD> +Handle only messages from <I>sender</I>. +<DT><B>-q, --quiet</B> + +<DD> +Suppress all output. +<P> +<DT><B>-t </B><I>TO</I>, --to <I>TO</I> + +<DD> +Send to specified app (or all apps if not given). The <I>TO</I> argument +may be given as either an application public ID or the application name. +<DT><B>-p </B><I>PATTERN</I>, --pattern <I>PATTERN</I> + +<DD> +Messaging pattern to use when sending messages. The default mode +is 'async' to send messages asychrnously, other allowed values are 'sync' +for syncronous messages and 'notify' to broadcast without expecting a +response. +<DT><B>-f </B><I>FILE</I>, --file <I>FILE</I> + +<DD> +Send all commands in the <I>FILE</I> argument. This mode allows the task to +take command input from a text file to process multiple commands with a +single invocation. +<DT><B>-n, --nokeepalive</B> + +<DD> +Disable <I>keep_alive</I> feature of the task. If the <I>-n</I> flag is used, +a separate connection to the SAMP Hub will be made for each command processed. +<P> +<DT><B>-P </B><I>IP</I>, --proxy <I>IP</I> + +<DD> +Use specfied IP as the proxy connection. See the discussion below about the +<I>keep_alive</I> feature for details on how to use this flag. +<DT><B>-T </B><I>N</I>, --timeout <I>N</I> + +<DD> +Keepalive timeout in seconds. If no new command is received after <I>N</I> +seconds the application will disconnect from the Hub automatically. +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>vosamp</I> task may be used to send and receive SAMP (Simple +Application Messaging Protocol) messages from the command-line or within a +script. It provides a user-friendly command interface that hides the details +of the message construction and delivery for common tasks. By default, +a message will be broadcast to all other SAMP-enabled applications, the +<I>-t</I> (or <I>--to</I>) flag can be used to name a specific receipient by +either the public ID or the application name, the <I>-p</I> flag will accept +a 'sync' or 'notify' argument to change the default message pattern of +asynchronous delivery. +<P> + +In order to minimize the overhead of connecting with the Hub on each command, +<I>vosamp</I> will spawn a proxy process that remains connected to the Hub and +will process subsequent commands transparently. This proxy process will +timeout after some period of inactivity and may be accessed from remote +machines (see below for more information). +<P> +<P> +<A NAME="lbAF"> </A> +<H2>COMMAND SUMMARY</H2> + +<P> + +The <I>vosamp</I> task accepts the following commands, specified either on +the command-line argument list or in interactive mode: +<P> + +<B>snoop<TT> </TT><TT> </TT><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +Print all received messages.<BR> +<P> + +<B>send <mtype> [<args>...]<TT> </TT><TT> </TT><TT> </TT></B> + + +Generalized message send. The <mtype> parameter can be either one of <BR> +the well-known SAMP mtypes or an ad hoc mtype that can be expected to be +recognized by other apps. The <I><args></I> parameter refers +to any of the arguments necessary for the specifed mtype. The <I><args></I> +may be specified as a sequence of values and will be delivered using +parameter names of the form "argN", to send named parameters the argument +must be specified as "<name>:<value>". +<P> + +<B>status<TT> </TT><TT> </TT><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +Print Hub availability.<BR> +<P> + +<B>list<TT> </TT><TT> </TT><TT> </TT><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +List all registered clients.<BR> +<P> + +<B>access <appName><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +Print <appName> availability. The <I>appName</I> may be specified as either<BR> +the public ID or application name. +<P> + +<B>handle <mtype><TT> </TT><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +Wait for <mtype> message to be received. This command will subscribe the task<BR> +to the specified <mtype> and when it is received will print the contents of +the message to the stdout stream. If the <I>--verbose</I> flag is used the +first value printed will be the sender-id, otherwise the first value will be +the <mtype> followed by the message parameters in the form "<name>=<value>". +Using the <I>--quiet</I> argument will suppress output and simply cause the +task to exit. Use of this command implicitly sets the <I>--nokeepalive</I> +flag. +<P> + +<B>load <url><TT> </TT><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +Load the image or table given by <I><url></I>. The type of file and the<BR> +appropriate SAMP <I>mtype</I> are determined automatically. +<P> + +<B>loadImage <url><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +Load the named image. The <I>image.load.fits</I> mtype will be used for <BR> +the message. +<P> + +<B>loadVOTable <url><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +Load the named VOTable. The <I>table.load.votable</I> mtype will be used for <BR> +the message. +<P> + +<B>loadFITS <url><TT> </TT><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +Load the named FITS bintable. The <I>table.load.fits</I> mtype will be used <BR> +for the message. +<P> + +<B>loadSpec <url><TT> </TT><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +Load the named spectrum. The <I>spectrum.load.ssa-generic</I> mtype will be<BR> +used for the message. +<P> + +In the above commands, the <I><url></I> may be an explicit URI containing +an 'http' or 'file' prefix, if a filename or directory path is specified +the URL will be constructed internally when sending the message. +<P> + +<B>pointAt <ra> <dec><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +Point at given coords. The <ra> and <dec> parameters are assumed to be ICRS<BR> +coordinates in decimal degrees, the <I>coord.pointAt.sky</I> mtype is used. +<P> + +<B>showRow [<url>] [<id>] <row><TT> </TT><TT> </TT></B> + + +Highlight specified <row> (zero-indexed). The table may be specified using<BR> +either a <url> or a table <id> if one was specified at the time the table +was loaded, the <I>table.highlight.row</I> mtype is used. +<P> + +<B>selectRows [<url>] [<id>] <rows><TT> </TT></B> + + +Select specified rows. (zero-indexed) The table may be specified using<BR> +either a <url> or a table <id> if one was specified at the time the table +was loaded, the <I>table.select.rowList</I> mtype is used. The <rows> +argument is specified as a comma-delimited list of row numbers or ranges, +where <I>ranges</I> are hyphen-delimited strings (e.g. "1,3,5-9,11-15"). +<P> + +<B>bibcode <bibcode><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +Load the specified bibcode. The <I>bibcode.load</I> mtype is used.<BR> +<P> +<P> + +<B>exec <cmd><TT> </TT><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +Execute a client command. The <cmd> string is sent to the client unchanged,<BR> +it is up to the client to interpret the command properly. +The <I>client.cmd.exec</I> mtype is used. +<P> + +<B>setenv <name> <value><TT> </TT><TT> </TT><TT> </TT></B> + + +Set an environment value. The <I>client.env.set</I> mtype is used.<BR> +<P> + +<B>getenv <name><TT> </TT><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +Get an environment value. The value of the requested variable is printed.<BR> +The <I>client.env.get</I> mtype is used. +<P> + +<B>setparam <name> <value><TT> </TT><TT> </TT><TT> </TT></B> + + +Set a parameter value. The <I>client.param.set</I> mtype is used.<BR> +<P> + +<B>getparam <name><TT> </TT><TT> </TT><TT> </TT><TT> </TT></B> + + +Get a parameter value. The value of the requested variable is printed.<BR> +The <I>client.param.get</I> mtype is used. +<P> +<P> +<A NAME="lbAG"> </A> +<H2>KEEP-ALIVE CONNECTIONS</H2> + +<P> + +In the standard SAMP interaction, and application is required to first +register with the <I>Hub</I> before sending or receiving messages. This +registration can add significant overhead to an application that may only +send a single message, significantly slowing it's use within a scripting +environment. Unless the <I>-n</I> (or <I>--nokeepalive</I>) flag is set, +the first time VOSAMP is started it will execute the specified command +and then fork a child process that stays connected to the Hub. Subsequent +VOSAMP calls will simply forward the command to this child proxy process, +thereby avoiding a new Hub registration. +<P> + +The proxy process by default will listen on inet port 3999 (as of this writing +there is no option to change it) for new commands, however there is no +restriction that the only application that can connect to it must be running +on the same host. The <I>-P</I> (or <I>--proxy</I>) flag can be used to +specify an alternate proxy to be used; the argument is of the form + +<I>node</I> [ ':' <I>port</I> ] +<P> + +where <I>node</I> can be a simple host name, a fully-qualified domain name or +and IP address, and <I>port</I> number number is optional. The proxy will +run for up to an hour if no new commands are received before disconnecting +from the Hub, this timeout value may be changed by using the <I>-T</I> flag +to specify the timeout in seconds. +<P> +<A NAME="lbAH"> </A> +<H2>RETURN STATUS</H2> + +On exit the <B>vosamp</B> task will return a zero indicating success, or a +one indicating an error. +<P> +<A NAME="lbAI"> </A> +<H2>EXAMPLES</H2> + +<DL COMPACT> +<DT>1) Load a VOTable to Topcat:<DD> +<P> +<PRE> + % vosamp load /path/example.xml + % vosamp load <A HREF="http://foo.edu/example.xml">http://foo.edu/example.xml</A> + % vosamp load <A HREF="http://foo.edu/query?RA=0.0">http://foo.edu/query?RA=0.0</A>&DEC=0.0&SR=0.1 +</PRE> + +<DT>2) Send a command string to IRAF:<DD> +<P> +<PRE> + % vosamp -t iraf exec "display dev$pix 1" +</PRE> + +<DT>3) List all clients in a SAMP desktop session:<DD> +<P> +<PRE> + % vosamp list +</PRE> + +<DT>4) Check whether a Hub is available from a script:<DD> +<P> +<PRE> + set isHub = `vosamp access Hub` + if ($isHub == "no") then + echo "No Hub available, quitting ....." + exit $status + endif +</PRE> + +<P> +<P> +<P> +</DL> +<A NAME="lbAJ"> </A> +<H2>BUGS</H2> + +No known bugs with this release. +<A NAME="lbAK"> </A> +<H2>KNOWN SHORTCOMINGS</H2> + +No known bugs with this release. + +- The 'handle' command should allow a command to be executed with message argument substitution. + +- A flag is needed to change the child proxy port being used +<P> +<A NAME="lbAL"> </A> +<H2>Revision History</H2> + +Feb 2013 - First public release +<A NAME="lbAM"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), Feb 2013 +<A NAME="lbAN"> </A> +<H2>SEE ALSO</H2> + +<P> +<P> + +The description of commonly used SAMP mtypes is gen at +<P> + +<A HREF="http://wiki.ivoa.net/twiki/bin/view/IVOA/SampMTypes">http://wiki.ivoa.net/twiki/bin/view/IVOA/SampMTypes</A> +<P> +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">COMMAND SUMMARY</A><DD> +<DT><A HREF="#lbAG">KEEP-ALIVE CONNECTIONS</A><DD> +<DT><A HREF="#lbAH">RETURN STATUS</A><DD> +<DT><A HREF="#lbAI">EXAMPLES</A><DD> +<DT><A HREF="#lbAJ">BUGS</A><DD> +<DT><A HREF="#lbAK">KNOWN SHORTCOMINGS</A><DD> +<DT><A HREF="#lbAL">Revision History</A><DD> +<DT><A HREF="#lbAM">Author</A><DD> +<DT><A HREF="#lbAN">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 06:21:57 GMT, April 26, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/vosamp.man b/vendor/voclient/doc/vosamp.man new file mode 100644 index 00000000..7c70a6d2 --- /dev/null +++ b/vendor/voclient/doc/vosamp.man @@ -0,0 +1,306 @@ +.\" @(#)vosamp.1 1.0 Feb-2013 MJF +.TH VOSAMP 1 "Feb 2013" "VOClient Package" +.SH NAME +vosamp \- command-line SAMP utility task + +.SH SYNOPSIS +\fBvosamp\fP [-t to] [-p pattern] [-f file] <cmd> [args ...] + +.SH OPTIONS +The \fIvosamp\fP application accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.TP 6 +.B -i, --interact +Interactive mode. If enabled, a command prompt will be printed allowing +users to enter commands interactively until an <EOF> is encountered. +.TP 6 +.B -m, --many +Handle multiple messages when in listening mode. If not enabled, +\fIvosamp\fP can be called to wait for a specific message and will exit when +it is received, otherwise the task will continue to run and process +multiple messages. +.TP 6 +.B -s \fISENDER\fP, --sender \fISENDER\fP +Handle only messages from \fIsender\fP. +.TP 6 +.B -q, --quiet +Suppress all output. + +.TP 6 +.B -t \fITO\fP, --to \fITO\fP +Send to specified app (or all apps if not given). The \fITO\fP argument +may be given as either an application public ID or the application name. +.TP 6 +.B -p \fIPATTERN\fP, --pattern \fIPATTERN\fP +Messaging pattern to use when sending messages. The default mode +is 'async' to send messages asychrnously, other allowed values are 'sync' +for syncronous messages and 'notify' to broadcast without expecting a +response. +.TP 6 +.B -f \fIFILE\fP, --file \fIFILE\fP +Send all commands in the \fIFILE\fP argument. This mode allows the task to +take command input from a text file to process multiple commands with a +single invocation. +.TP 6 +.B -n, --nokeepalive +Disable \fIkeep_alive\fP feature of the task. If the \fI-n\fP flag is used, +a separate connection to the SAMP Hub will be made for each command processed. + +.TP 6 +.B -P \fIIP\fP, --proxy \fIIP\fP +Use specfied IP as the proxy connection. See the discussion below about the +\fIkeep_alive\fP feature for details on how to use this flag. +.TP 6 +.B -T \fIN\fP, --timeout \fIN\fP +Keepalive timeout in seconds. If no new command is received after \fIN\fP +seconds the application will disconnect from the Hub automatically. + +.SH DESCRIPTION +The \fIvosamp\fP task may be used to send and receive SAMP (Simple +Application Messaging Protocol) messages from the command-line or within a +script. It provides a user-friendly command interface that hides the details +of the message construction and delivery for common tasks. By default, +a message will be broadcast to all other SAMP-enabled applications, the +\fI-t\fP (or \fI--to\fP) flag can be used to name a specific receipient by +either the public ID or the application name, the \fI-p\fP flag will accept +a 'sync' or 'notify' argument to change the default message pattern of +asynchronous delivery. +.PP +In order to minimize the overhead of connecting with the Hub on each command, +\fIvosamp\fP will spawn a proxy process that remains connected to the Hub and +will process subsequent commands transparently. This proxy process will +timeout after some period of inactivity and may be accessed from remote +machines (see below for more information). + + +.SH COMMAND SUMMARY +.PP +The \fIvosamp\fP task accepts the following commands, specified either on +the command-line argument list or in interactive mode: + +.in 10 +.B snoop +.in 16 +Print all received messages. + +.in 10 +.B send <mtype> [<args>...] +.in 16 +Generalized message send. The <mtype> parameter can be either one of +the well-known SAMP mtypes or an ad hoc mtype that can be expected to be +recognized by other apps. The \fI<args>\fP parameter refers +to any of the arguments necessary for the specifed mtype. The \fI<args>\fP +may be specified as a sequence of values and will be delivered using +parameter names of the form "argN", to send named parameters the argument +must be specified as "<name>:<value>". + +.in 10 +.B status +.in 16 +Print Hub availability. + +.in 10 +.B list +.in 16 +List all registered clients. + +.in 10 +.B access <appName> +.in 16 +Print <appName> availability. The \fIappName\fP may be specified as either +the public ID or application name. + +.in 10 +.B handle <mtype> +.in 16 +Wait for <mtype> message to be received. This command will subscribe the task +to the specified <mtype> and when it is received will print the contents of +the message to the stdout stream. If the \fI--verbose\fP flag is used the +first value printed will be the sender-id, otherwise the first value will be +the <mtype> followed by the message parameters in the form "<name>=<value>". +Using the \fI--quiet\fP argument will suppress output and simply cause the +task to exit. Use of this command implicitly sets the \fI--nokeepalive\fP +flag. + +.in 10 +.B load <url> +.in 16 +Load the image or table given by \fI<url>\fP. The type of file and the +appropriate SAMP \fImtype\fP are determined automatically. + +.in 10 +.B loadImage <url> +.in 16 +Load the named image. The \fIimage.load.fits\fP mtype will be used for +the message. + +.in 10 +.B loadVOTable <url> +.in 16 +Load the named VOTable. The \fItable.load.votable\fP mtype will be used for +the message. + +.in 10 +.B loadFITS <url> +.in 16 +Load the named FITS bintable. The \fItable.load.fits\fP mtype will be used +for the message. + +.in 10 +.B loadSpec <url> +.in 16 +Load the named spectrum. The \fIspectrum.load.ssa-generic\fP mtype will be +used for the message. + +.in 10 +In the above commands, the \fI<url>\fP may be an explicit URI containing +an 'http' or 'file' prefix, if a filename or directory path is specified +the URL will be constructed internally when sending the message. + +.in 10 +.B pointAt <ra> <dec> +.in 16 +Point at given coords. The <ra> and <dec> parameters are assumed to be ICRS +coordinates in decimal degrees, the \fIcoord.pointAt.sky\fP mtype is used. + +.in 10 +.B showRow [<url>] [<id>] <row> +.in 16 +Highlight specified <row> (zero-indexed). The table may be specified using +either a <url> or a table <id> if one was specified at the time the table +was loaded, the \fItable.highlight.row\fP mtype is used. + +.in 10 +.B selectRows [<url>] [<id>] <rows> +.in 16 +Select specified rows. (zero-indexed) The table may be specified using +either a <url> or a table <id> if one was specified at the time the table +was loaded, the \fItable.select.rowList\fP mtype is used. The <rows> +argument is specified as a comma-delimited list of row numbers or ranges, +where \fIranges\fP are hyphen-delimited strings (e.g. "1,3,5-9,11-15"). + +.in 10 +.B bibcode <bibcode> +.in 16 +Load the specified bibcode. The \fIbibcode.load\fP mtype is used. + + +.in 10 +.B exec <cmd> +.in 16 +Execute a client command. The <cmd> string is sent to the client unchanged, +it is up to the client to interpret the command properly. +The \fIclient.cmd.exec\fP mtype is used. + +.in 10 +.B setenv <name> <value> +.in 16 +Set an environment value. The \fIclient.env.set\fP mtype is used. + +.in 10 +.B getenv <name> +.in 16 +Get an environment value. The value of the requested variable is printed. +The \fIclient.env.get\fP mtype is used. + +.in 10 +.B setparam <name> <value> +.in 16 +Set a parameter value. The \fIclient.param.set\fP mtype is used. + +.in 10 +.B getparam <name> +.in 16 +Get a parameter value. The value of the requested variable is printed. +The \fIclient.param.get\fP mtype is used. + + +.SH KEEP-ALIVE CONNECTIONS +.PP +In the standard SAMP interaction, and application is required to first +register with the \fIHub\fP before sending or receiving messages. This +registration can add significant overhead to an application that may only +send a single message, significantly slowing it's use within a scripting +environment. Unless the \fI-n\fP (or \fI--nokeepalive\fP) flag is set, +the first time VOSAMP is started it will execute the specified command +and then fork a child process that stays connected to the Hub. Subsequent +VOSAMP calls will simply forward the command to this child proxy process, +thereby avoiding a new Hub registration. +.PP +The proxy process by default will listen on inet port 3999 (as of this writing +there is no option to change it) for new commands, however there is no +restriction that the only application that can connect to it must be running +on the same host. The \fI-P\fP (or \fI--proxy\fP) flag can be used to +specify an alternate proxy to be used; the argument is of the form +.in 15 +\fInode\fP [ ':' \fIport\fP ] +.PP +where \fInode\fP can be a simple host name, a fully-qualified domain name or +and IP address, and \fIport\fP number number is optional. The proxy will +run for up to an hour if no new commands are received before disconnecting +from the Hub, this timeout value may be changed by using the \fI-T\fP flag +to specify the timeout in seconds. + +.SH RETURN STATUS +On exit the \fBvosamp\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Load a VOTable to Topcat: + +.nf + % vosamp load /path/example.xml + % vosamp load http://foo.edu/example.xml + % vosamp load http://foo.edu/query?RA=0.0&DEC=0.0&SR=0.1 +.fi +.TP 4 +2) Send a command string to IRAF: + +.nf + % vosamp -t iraf exec "display dev$pix 1" +.fi +.TP 4 +3) List all clients in a SAMP desktop session: + +.nf + % vosamp list +.fi +.TP 4 +4) Check whether a Hub is available from a script: + +.nf + set isHub = `vosamp access Hub` + if ($isHub == "no") then + echo "No Hub available, quitting ....." + exit $status + endif +.fi + + + +.SH BUGS +No known bugs with this release. +.SH KNOWN SHORTCOMINGS +No known bugs with this release. +.in 4 +- The 'handle' command should allow a command to be executed with message argument substitution. +.in 4 +- A flag is needed to change the child proxy port being used + +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" + +.PP +The description of commonly used SAMP mtypes is gen at + +.in 9 +http://wiki.ivoa.net/twiki/bin/view/IVOA/SampMTypes + diff --git a/vendor/voclient/doc/vosamp.pdf b/vendor/voclient/doc/vosamp.pdf Binary files differnew file mode 100644 index 00000000..1553333a --- /dev/null +++ b/vendor/voclient/doc/vosamp.pdf diff --git a/vendor/voclient/doc/vosamp_session.man b/vendor/voclient/doc/vosamp_session.man new file mode 100644 index 00000000..7f7e328e --- /dev/null +++ b/vendor/voclient/doc/vosamp_session.man @@ -0,0 +1,342 @@ +.\" @(#)vosamp.1 1.0 Feb-2013 MJF +.TH VOSAMP 1 "Feb 2013" "VOClient Package" +.SH NAME +vosamp \- command-line SAMP utility task + +.SH SYNOPSIS +\fBvosamp\fP [-t to] [-p pattern] [-f file] <cmd> [args ...] + +.SH OPTIONS +The \fIvosamp\fP application accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.TP 6 +.B -i, --interact +Interactive mode. If enabled, a command prompt will be printed allowing +users to enter commands interactively until an <EOF> is encountered. +.TP 6 +.B -m, --many +Handle multiple messages when in listening mode. If not enabled, +\fIvosamp\fP can be called to wait for a specific message and will exit when +it is received, otherwise the task will continue to run and process +multiple messages. +.TP 6 +.B -s \fISENDER\fP, --sender \fISENDER\fP +Handle only messages from \fIsender\fP. +.TP 6 +.B -q, --quiet +Suppress all output. + +.TP 6 +.B -t \fITO\fP, --to \fITO\fP +Send to specified app (or all apps if not given). The \fITO\fP argument +may be given as either an application public ID or the application name. +.TP 6 +.B -p \fIPATTERN\fP, --pattern \fIPATTERN\fP +Messaging pattern to use when sending messages. The default mode +is 'async' to send messages asychrnously, other allowed values are 'sync' +for syncronous messages and 'notify' to broadcast without expecting a +response. +.TP 6 +.B -f \fIFILE\fP, --file \fIFILE\fP +Send all commands in the \fIFILE\fP argument. This mode allows the task to +take command input from a text file to process multiple commands with a +single invocation. +.TP 6 +.B -n, --nokeepalive +Disable \fIkeep_alive\fP feature of the task. If the \fI-n\fP flag is used, +a separate connection to the SAMP Hub will be made for each command processed. + +.TP 6 +.B -P \fIIP\fP, --proxy \fIIP\fP +Use specfied IP as the proxy connection. See the discussion below about the +\fIkeep_alive\fP feature for details on how to use this flag. +.TP 6 +.B -T \fIN\fP, --timeout \fIN\fP +Keepalive timeout in seconds. If no new command is received after \fIN\fP +seconds the application will disconnect from the Hub automatically. +.TP 6 +.B -S \fINAME\fP, --session \fINAME\fP +Name of the SAMP session. See below for a description of sessions. + +.SH DESCRIPTION +The \fIvosamp\fP task may be used to send and receive SAMP (Simple +Application Messaging Protocol) messages from the command-line or within a +script. It provides a user-friendly command interface that hides the details +of the message construction and delivery for common tasks. By default, +a message will be broadcast to all other SAMP-enabled applications, the +\fI-t\fP (or \fI--to\fP) flag can be used to name a specific receipient by +either the public ID or the application name, the \fI-p\fP flag will accept +a 'sync' or 'notify' argument to change the default message pattern of +asynchronous delivery. +.PP +In order to minimize the overhead of connecting with the Hub on each command, +\fIvosamp\fP will spawn a proxy process that remains connected to the Hub and +will process subsequent commands transparently. This proxy process will +timeout after some period of inactivity and may be accessed from remote +machines (see below for more information). + + +.SH COMMAND SUMMARY +.PP +The \fIvosamp\fP task accepts the following commands, specified either on +the command-line argument list or in interactive mode: + +.in 10 +.B snoop +.in 16 +Print all received messages. + +.in 10 +.B send <mtype> [<args>...] +.in 16 +Generalized message send. The <mtype> parameter can be either one of +the well-known SAMP mtypes or an ad hoc mtype that can be expected to be +recognized by other apps in the session. The \fI<args>\fP parameter refers +to any of the arguments necessary for the specifed mtype. The \fI<args>\fP +may be specified as a sequence of values and will be delivered using +parameter names of the form "argN", to send named parameters the argument +must be specified as "<name>:<value>". + +.in 10 +.B status +.in 16 +Print Hub availability. + +.in 10 +.B list +.in 16 +List all registered clients. + +.in 10 +.B access <appName> +.in 16 +Print <appName> availability. The \fIappName\fP may be specified as either +the public ID or application name. + +.in 10 +.B handle <mtype> +.in 16 +Wait for <mtype> message to be received. This command will subscribe the task +to the specified <mtype> and when it is received will print the contents of +the message to the stdout stream. If the \fI--verbose\fP flag is used the +first value printed will be the sender-id, otherwise the first value will be +the <mtype> followed by the message parameters in the form "<name>=<value>". +Using the \fI--quiet\fP argument will suppress output and simply cause the +task to exit. Use of this command implicitly sets the \fI--nokeepalive\fP +flag. + +.in 10 +.B load <url> +.in 16 +Load the image or table given by \fI<url>\fP. The type of file and the +appropriate SAMP \fImtype\fP are determined automatically. + +.in 10 +.B loadImage <url> +.in 16 +Load the named image. The \fIimage.load.fits\fP mtype will be used for +the message. + +.in 10 +.B loadVOTable <url> +.in 16 +Load the named VOTable. The \fItable.load.votable\fP mtype will be used for +the message. + +.in 10 +.B loadFITS <url> +.in 16 +Load the named FITS bintable. The \fItable.load.fits\fP mtype will be used +for the message. + +.in 10 +.B loadSpec <url> +.in 16 +Load the named spectrum. The \fIspectrum.load.ssa-generic\fP mtype will be +used for the message. + +.in 10 +In the above commands, the \fI<url>\fP may be an explicit URI containing +an 'http' or 'file' prefix, if a filename or directory path is specified +the URL will be constructed internally when sending the message. + +.in 10 +.B pointAt <ra> <dec> +.in 16 +Point at given coords. The <ra> and <dec> parameters are assumed to be ICRS +coordinates in decimal degrees, the \fIcoord.pointAt.sky\fP mtype is used. + +.in 10 +.B showRow [<url>] [<id>] <row> +.in 16 +Highlight specified <row> (zero-indexed). The table may be specified using +either a <url> or a table <id> if one was specified at the time the table +was loaded, the \fItable.highlight.row\fP mtype is used. + +.in 10 +.B selectRows [<url>] [<id>] <rows> +.in 16 +Select specified rows. (zero-indexed) The table may be specified using +either a <url> or a table <id> if one was specified at the time the table +was loaded, the \fItable.select.rowList\fP mtype is used. The <rows> +argument is specified as a comma-delimited list of row numbers or ranges, +where \fIranges\fP are hyphen-delimited strings (e.g. "1,3,5-9,11-15"). + +.in 10 +.B bibcode <bibcode> +.in 16 +Load the specified bibcode. The \fIbibcode.load\fP mtype is used. + + +.in 10 +.B exec <cmd> +.in 16 +Execute a client command. The <cmd> string is sent to the client unchanged, +it is up to the client to interpret the command properly. +The \fIclient.cmd.exec\fP mtype is used. + +.in 10 +.B setenv <name> <value> +.in 16 +Set an environment value. The \fIclient.env.set\fP mtype is used. + +.in 10 +.B getenv <name> +.in 16 +Get an environment value. The value of the requested variable is printed. +The \fIclient.env.get\fP mtype is used. + +.in 10 +.B setparam <name> <value> +.in 16 +Set a parameter value. The \fIclient.param.set\fP mtype is used. + +.in 10 +.B getparam <name> +.in 16 +Get a parameter value. The value of the requested variable is printed. +The \fIclient.param.get\fP mtype is used. + + +.in 10 +.B session list +.in 16 +List nodes in current session. + +.in 10 +.B session leave|exit|logout +.in 16 +Leave the current session. + +.in 10 +.B session <name> +.in 16 +Join the named session. + + +.SH KEEP-ALIVE CONNECTIONS AND SESSIONS +.PP +In the standard SAMP interaction, and application is required to first +register with the \fIHub\fP before sending or receiving messages. This +registration can add significant overhead to an application that may only +send a single message, significantly slowing it's use within a scripting +environment. Unless the \fI-n\fP (or \fI--nokeepalive\fP) flag is set, +the first time VOSAMP is started it will execute the specified command +and then fork a child process that stays connected to the Hub. Subsequent +VOSAMP calls will simply forward the command to this child proxy process, +thereby avoiding a new Hub registration. +.PP +The proxy process by default will listen on inet port 3999 (as of this writing +there is no option to change it) for new commands, however there is no +restriction that the only application that can connect to it must be running +on the same host. The \fI-P\fP (or \fI--proxy\fP) flag can be used to +specify an alternate proxy to be used; the argument is of the form +.in 15 +\fInode\fP [ ':' \fIport\fP ] +.PP +where \fInode\fP can be a simple host name, a fully-qualified domain name or +and IP address, and \fIport\fP number number is optional. The proxy will +run for up to an hour if no new commands are received before disconnecting +from the Hub, this timeout value may be changed by using the \fI-T\fP flag +to specify the timeout in seconds. + +.PP +SAMP \fISessions\fP are an experimental concept in which \fIvosamp\fP +tasks on separate machines register independently with their local Hub, +but also register with the \fIvosession\fP task running elsewhere. Commands +which are sent to the local child proxy are also forwarded to the +\fIvosession\fP instance and then on to other vosamp clients registered in +the same session. The \fIsession\fP commands allow a vosamp client to +register with a new session, list the other machines involved in the session +and later leave the sessions. Commands which require a URL will upload +local data to the \fIvosession\fP manager and rewrite the URL appropiately +so it may be served to the other vosamp clients. Since SAMP is designed +only for local desktop messaging, this approach provides a means to share +messages and data between desktops (e.g. when working collaboratively with +colleagues). See the \fIvosession\fP man page or contact the author for +further information on using this feature. + + +.SH RETURN STATUS +On exit the \fBvosamp\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Load a VOTable to Topcat: + +.nf + % vosamp load /path/example.xml + % vosamp load http://foo.edu/example.xml + % vosamp load http://foo.edu/query?RA=0.0&DEC=0.0&SR=0.1 +.fi +.TP 4 +2) Send a command string to IRAF: + +.nf + % vosamp -t iraf exec "display dev$pix 1" +.fi +.TP 4 +3) List all clients in a SAMP session: + +.nf + % vosamp list +.fi +.TP 4 +4) Check whether a Hub is available from a script: + +.nf + set isHub = `vosamp access Hub` + if ($isHub == "no") then + echo "No Hub available, quitting ....." + exit $status + endif +.fi + + + +.SH BUGS +No known bugs with this release. +.SH KNOWN SHORTCOMINGS +No known bugs with this release. +.in 4 +- The 'handle' command should allow a command to be executed with message argument substitution. +.in 4 +- A flag is needed to change the child proxy port being used + +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +vosession +.PP +The description of commonly used SAMP mtypes is gen at + +.in 9 +http://wiki.ivoa.net/twiki/bin/view/IVOA/SampMTypes + diff --git a/vendor/voclient/doc/vosesame.html b/vendor/voclient/doc/vosesame.html new file mode 100644 index 00000000..7104e743 --- /dev/null +++ b/vendor/voclient/doc/vosesame.html @@ -0,0 +1,320 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOSESAME</TITLE> +</HEAD><BODY> +<H1>VOSESAME</H1> +Section: User Commands (1)<BR>Updated: July 2007<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +vosesame - call the Sesame name resolver service +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>vosesame</B> [-<I>adefhinstACHT</I>] [<I>file</I> | <I>target</I> ] [ ... ] +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>vosesame</I> task accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<DT><B>-q, --quiet</B> + +<DD> +Quiet mode (suppress warning output). +<DT><B>-v, --verbose</B> + +<DD> +Verbose output. Normally used to print warnings when an object could not be +resolved. +<DT>The following flags may be combined as a single option to indicate the<DD> +desired output fields. The order of the flags implies the order of the +output values, e.g. "-dnt" prints the decimal position, name and type in +that order. +<DT><B>-a, --all</B> + +<DD> +Output all available information about the object. +<DT><B>-d, --decimal</B> + +<DD> +Output the position as J2000 decimal degrees. This is the default output if +no format flags are specified. +<DT><B>-e, --errors</B> + +<DD> +Output the estimated position errors. +<DT><B>-n, --name</B> + +<DD> +Output the object name. +<DT><B>-t, --type</B> + +<DD> +Output the object type. +<DT><B>-s, --sex</B> + +<DD> +Output the position as sexagesimal RA and Dec. +<P> +<DT>Control Flags:<DD> +<DT><B>-f, --force</B> + +<DD> +Force the object(s) to be resolved even if it is cached. This option will +cause the task to call the Sesame service rather than output a previously +cached value, however the result will still be cached unless the VOC_NO_CACHE +environment variable is defined. +<DT><B>-o <name> or --output=<name></B> + +<DD> +Specify the output file. The default is to write the results to the +standard output. +<DT><B>-p <ra,dec> or --pos=<ra,dec></B> + +<DD> +Specify a comma-delimited input position. This option can be used to +convert input sexagesimal or floating-point values using the formatting +options. +<P> +<DT>Formatting Flags:<DD> +<DT><B>-A, --ascii</B> + +<DD> +Print the results as a whitespace delimited ascii table. +<DT><B>-C, --csv</B> + +<DD> +Print the results as a comma-separated-value (CSV) table. +<DT><B>-F, --format</B> + +<DD> +Format ASCII results using fixed-width columns. +<DT><B>-H, --header</B> + +<DD> +Print a table header. The table header will be a single line beginning with +a '#' character to indicate a comment, and followed by the name of each +column in the specified format. +<DT><B>-I, --init_cache</B> + +<DD> +Initialize the resolver cache directory. +<DT><B>-T, --tsv</B> + +<DD> +Print the results as a tab-separated-value (TSV) table. +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>vosesame</I> task provides a command-line interface to the +<I>Sesame</I> name +resolver service at CDS that convert a familiar object name to the J2000 +coordinates required by VO services. Additional information +such such as the object type is also available. The <I>Sesame</I> service +queries NED, Simbad and Vizier databases for this information. If no +flags are provided, the default output is simply the RA and Dec of the +object in decimal degrees (this is what most VO services expect), however +command-line flags provide a method to specify the desired output and +the order in which they are printed. +<P> + +Object names may be specified on the commandline individually (multiple +arguments are allowed), as the name of a file containing a list of +objects to be resolved, or both. If no object or file names are given on +the command line the task will read from the standard input, allowing the +task to be used as a command filter or interactively from the keyboard. +Files containing object names are assumed +to list the name of one object-per-line where whitespace in the object name +is allowed on the line (e.g. "M 51"). From the command line, most shell +interpreters will require that the whitespace be escaped (e.g. "M 51") +so it is interpreted properly. A warning will be printed if an object name +cannot be resolved and the <I>-v</I> verbose flag is set, otherwise no +output will be printed for the failed request. +<P> + +The <I>OPTIONS</I> section describes the formatting options available. +For each of these options, the order in which it appears controls the order of +where it appears in the output string for the object. Output format +flags control how the values are printed. Supported formats include +comma-separated-values (CSV, the <I>-C</I> flag), tab-separated-values (TSV, +the <I>-T</I> flag), whitespace-delimited values (the <I>-A</I> default), +and may include an optional head (the <I>-H</I>) flag) that precedes the +output with a line of text listing the output colums where the first +character of the header is a '#' to indicate a comment. +<P> +<A NAME="lbAF"> </A> +<H2>VOCLIENT DAEMON PROCESSING</H2> + +All VO-CLI tasks are built upon the VOClient interface an rely on a +separate <I>voclientd</I> process to provide the VO functionality. The +voclientd task is distributed as part of VO-CLI and will be started +automatically by each task if it is not already running. If problems +are encountered, you may want to manually start the voclientd in a separate +window before running the task so you can monitor the output for error +messages. +<P> +<A NAME="lbAG"> </A> +<H2>OBJECT CACHING</H2> + +The <B>Sesame</B> service at CDS is normally fairly reliable, however there +are times when it is either unavailable, or simply returns a null result +without indicating an error. Additionally, the access time is on the +order of ~1 sec/object and so resolving many objects creates an overhead +for applications using this service. +<P> + +The <B>vosesame</B> task's only function is to resolve objects, however it +still uses the object caching capability in the VOClient interface. Once +an object is resolved, it will automatically be cached unless the +<B>VOC_NO_CACHE</B> environment variable is defined. The <I>-f</I> +command-line option can be used to override any existing cached values and +force the Sesame service to be invoked. The object cache may be initialized +completely by deleting the $HOME/.voclient/cache/sesame directory. +<P> +<A NAME="lbAH"> </A> +<H2>RETURN STATUS</H2> + +If all objects were successfully resolved the task will exit with a +status code of 0. If one or more of the objects failed to be resolved for +any reason, the exit status will be the number of unresolved objects. +<P> +<P> +<A NAME="lbAI"> </A> +<H2>EXAMPLES</H2> + +<P> +<DL COMPACT> +<DT>1)<DD> +Print the coordinates of NGC4456, first in decimal degrees and +then as sexagesimal values: +<P> +<PRE> + % vosesame ngc4456 + 186.960000 -30.120000 + % vosesame -s ngc4456 + 12:27.8 -30:07 +</PRE> + +<P> +<DT>2)<DD> +Print the sexagesimal coordinates of multiple objects, include the type: +<P> +<PRE> + % vosesame -st m31 m51 m99 + 00:42:44.31 +41:16:09.4 LINER + 13:29:52.36 +47:11:40.8 Seyfert_2 + 12:18:49.51 +14:25:00.4 HII_G +</PRE> + +<P> +<DT>3)<DD> +Print the decimal coordinates of those same objects listed in +the file 'myobjs.txt', output as CSV, include a header, and print +the id, coords, and type: +<P> +<PRE> + % vosesame -CHndt myobjs.txt + #Name,DRA,DDEC,Type, + m31,10.684625,41.269278,LINER + m51,202.468208,47.194667,Seyfert_2 + m99,184.706333,14.416778,HII_G + : : : : +</PRE> + +<P> +<DT>4)<DD> +Extract the object names from column 17-25 of a file and pipe the +list to vosesame to create a new table of id, ra and dec: +<P> +<PRE> + % cut -c17-25 data.txt | vosesame -ns + m51 13:29:52.36 +47:11:40.8 + m23 17:57:00.00 -18:58:59.9 + m67 08:51:17.99 +11:48:00.0 + : : : +</PRE> + +<P> +<DT>5)<DD> +Interactively resolve coordinates by enterying object names on the +standard input: +<PRE> + + % vosesame -a + m98 + m98 12:13:48.37 +14:53:57.9 183.45154 14.89944 10.0 10.0 LINER + [EOF] + +</PRE> + +Type the EOF character (typically Ctrl-D or Ctrl-Z) to quit. +<P> +<P> +<DT>6)<DD> +Print the sexagesimal and decimal values for multiple user coords: +<PRE> + + % vosesame -sd -p 12:30:0.0,-45:00:0.0 -p 187.5,2.05 + 12:30:00.0 -45:00:00.0 12.500000 -45.000000 + 12:30:00.0 02:03:00.0 187.500000 2.050000 + +</PRE> + +<P> +<P> +</DL> +<A NAME="lbAJ"> </A> +<H2>BUGS</H2> + +The Sesame service can sometimes respond without resolving the object. In +this case all values are returned as zero or a null string. <I>Vosesame</I> +will sense this as a non-response and not print a result. If the +<I>verbose</I> flag is set a warning message will be printed. +<A NAME="lbAK"> </A> +<H2>Revision History</H2> + +June 2007 - This task is new. +<A NAME="lbAL"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), July 2007 +<A NAME="lbAM"> </A> +<H2>SEE ALSO</H2> + +voclient, voclientd, voregistry, vodata +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">VOCLIENT DAEMON PROCESSING</A><DD> +<DT><A HREF="#lbAG">OBJECT CACHING</A><DD> +<DT><A HREF="#lbAH">RETURN STATUS</A><DD> +<DT><A HREF="#lbAI">EXAMPLES</A><DD> +<DT><A HREF="#lbAJ">BUGS</A><DD> +<DT><A HREF="#lbAK">Revision History</A><DD> +<DT><A HREF="#lbAL">Author</A><DD> +<DT><A HREF="#lbAM">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 19:30:04 GMT, April 15, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/vosesame.man b/vendor/voclient/doc/vosesame.man new file mode 100644 index 00000000..e7237252 --- /dev/null +++ b/vendor/voclient/doc/vosesame.man @@ -0,0 +1,243 @@ +.\" @(#)vosesame.1 1.0 June-07 MJF +.TH VOSESAME 1 "July 2007" "VOClient Project" +.SH NAME +vosesame \- call the Sesame name resolver service + +.SH SYNOPSIS +\fBvosesame\fP [\-\fIadefhinstACHT\fP] [\fIfile\fP | \fItarget\fP ] [ ... ] + +.SH OPTIONS +The \fIvosesame\fP task accepts the following options: +.TP 8 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. +.TP 8 +.B \-q, --quiet +Quiet mode (suppress warning output). +.TP 8 +.B \-v, --verbose +Verbose output. Normally used to print warnings when an object could not be +resolved. +.TP 0 +The following flags may be combined as a single option to indicate the +desired output fields. The order of the flags implies the order of the +output values, e.g. "-dnt" prints the decimal position, name and type in +that order. +.TP 8 +.B \-a, --all +Output all available information about the object. +.TP 8 +.B \-d, --decimal +Output the position as J2000 decimal degrees. This is the default output if +no format flags are specified. +.TP 8 +.B \-e, --errors +Output the estimated position errors. +.TP 8 +.B \-n, --name +Output the object name. +.TP 8 +.B \-t, --type +Output the object type. +.TP 8 +.B \-s, --sex +Output the position as sexagesimal RA and Dec. + +.TP 0 +Control Flags: +.TP 8 +.B \-f, --force +Force the object(s) to be resolved even if it is cached. This option will +cause the task to call the Sesame service rather than output a previously +cached value, however the result will still be cached unless the VOC_NO_CACHE +environment variable is defined. +.TP 8 +.B \-o <name> or --output=<name> +Specify the output file. The default is to write the results to the +standard output. +.TP 8 +.B \-p <ra,dec> or --pos=<ra,dec> +Specify a comma-delimited input position. This option can be used to +convert input sexagesimal or floating-point values using the formatting +options. + +.TP 0 +Formatting Flags: +.TP 8 +.B \-A, --ascii +Print the results as a whitespace delimited ascii table. +.TP 8 +.B \-C, --csv +Print the results as a comma-separated-value (CSV) table. +.TP 8 +.B \-F, --format +Format ASCII results using fixed-width columns. +.TP 8 +.B \-H, --header +Print a table header. The table header will be a single line beginning with +a '#' character to indicate a comment, and followed by the name of each +column in the specified format. +.TP 8 +.B \-I, --init_cache +Initialize the resolver cache directory. +.TP 8 +.B \-T, --tsv +Print the results as a tab-separated-value (TSV) table. + +.SH DESCRIPTION +The \fIvosesame\fP task provides a command-line interface to the +\fISesame\fP name +resolver service at CDS that convert a familiar object name to the J2000 +coordinates required by VO services. Additional information +such such as the object type is also available. The \fISesame\fP service +queries NED, Simbad and Vizier databases for this information. If no +flags are provided, the default output is simply the RA and Dec of the +object in decimal degrees (this is what most VO services expect), however +command-line flags provide a method to specify the desired output and +the order in which they are printed. +.PP +Object names may be specified on the commandline individually (multiple +arguments are allowed), as the name of a file containing a list of +objects to be resolved, or both. If no object or file names are given on +the command line the task will read from the standard input, allowing the +task to be used as a command filter or interactively from the keyboard. +Files containing object names are assumed +to list the name of one object-per-line where whitespace in the object name +is allowed on the line (e.g. "M 51"). From the command line, most shell +interpreters will require that the whitespace be escaped (e.g. "M\ 51") +so it is interpreted properly. A warning will be printed if an object name +cannot be resolved and the \fI-v\fP verbose flag is set, otherwise no +output will be printed for the failed request. +.PP +The \fIOPTIONS\fP section describes the formatting options available. +For each of these options, the order in which it appears controls the order of +where it appears in the output string for the object. Output format +flags control how the values are printed. Supported formats include +comma-separated-values (CSV, the \fI-C\fP flag), tab-separated-values (TSV, +the \fI-T\fP flag), whitespace-delimited values (the \fI-A\fP default), +and may include an optional head (the \fI-H\fP) flag) that precedes the +output with a line of text listing the output colums where the first +character of the header is a '#' to indicate a comment. + +.SH VOCLIENT DAEMON PROCESSING +All VO-CLI tasks are built upon the VOClient interface an rely on a +separate \fIvoclientd\fP process to provide the VO functionality. The +voclientd task is distributed as part of VO-CLI and will be started +automatically by each task if it is not already running. If problems +are encountered, you may want to manually start the voclientd in a separate +window before running the task so you can monitor the output for error +messages. + +.SH OBJECT CACHING +The \fBSesame\fP service at CDS is normally fairly reliable, however there +are times when it is either unavailable, or simply returns a null result +without indicating an error. Additionally, the access time is on the +order of ~1 sec/object and so resolving many objects creates an overhead +for applications using this service. +.PP +The \fBvosesame\fP task's only function is to resolve objects, however it +still uses the object caching capability in the VOClient interface. Once +an object is resolved, it will automatically be cached unless the +\fBVOC_NO_CACHE\fP environment variable is defined. The \fI-f\fP +command-line option can be used to override any existing cached values and +force the Sesame service to be invoked. The object cache may be initialized +completely by deleting the $HOME/.voclient/cache/sesame directory. + +.SH RETURN STATUS +If all objects were successfully resolved the task will exit with a +status code of 0. If one or more of the objects failed to be resolved for +any reason, the exit status will be the number of unresolved objects. + + +.SH EXAMPLES + +.TP 4 +1) +Print the coordinates of NGC4456, first in decimal degrees and +then as sexagesimal values: + +.nf + % vosesame ngc4456 + 186.960000 -30.120000 + % vosesame -s ngc4456 + 12:27.8 -30:07 +.fi + +.TP 4 +2) +Print the sexagesimal coordinates of multiple objects, include the type: + +.nf + % vosesame -st m31 m51 m99 + 00:42:44.31 +41:16:09.4 LINER + 13:29:52.36 +47:11:40.8 Seyfert_2 + 12:18:49.51 +14:25:00.4 HII_G +.fi + +.TP 4 +3) +Print the decimal coordinates of those same objects listed in +the file 'myobjs.txt', output as CSV, include a header, and print +the id, coords, and type: + +.nf + % vosesame -CHndt myobjs.txt + #Name,DRA,DDEC,Type, + m31,10.684625,41.269278,LINER + m51,202.468208,47.194667,Seyfert_2 + m99,184.706333,14.416778,HII_G + : : : : +.fi + +.TP 4 +4) +Extract the object names from column 17-25 of a file and pipe the +list to vosesame to create a new table of id, ra and dec: + +.nf + % cut -c17-25 data.txt | vosesame -ns + m51 13:29:52.36 +47:11:40.8 + m23 17:57:00.00 -18:58:59.9 + m67 08:51:17.99 +11:48:00.0 + : : : +.fi + +.TP 4 +5) +Interactively resolve coordinates by enterying object names on the +standard input: +.nf + + % vosesame -a + m98 + m98 12:13:48.37 +14:53:57.9 183.45154 14.89944 10.0 10.0 LINER + [EOF] + +.fi +Type the EOF character (typically Ctrl-D or Ctrl-Z) to quit. + + +.TP 4 +6) +Print the sexagesimal and decimal values for multiple user coords: +.nf + + % vosesame -sd -p 12:30:0.0,-45:00:0.0 -p 187.5,2.05 + 12:30:00.0 -45:00:00.0 12.500000 -45.000000 + 12:30:00.0 02:03:00.0 187.500000 2.050000 + +.fi + + +.SH BUGS +The Sesame service can sometimes respond without resolving the object. In +this case all values are returned as zero or a null string. \fIVosesame\fP +will sense this as a non-response and not print a result. If the +\fIverbose\fP flag is set a warning message will be printed. +.SH Revision History +June 2007 - This task is new. +.SH Author +Michael Fitzpatrick (fitz@noao.edu), July 2007 +.SH "SEE ALSO" +voclient, voclientd, voregistry, vodata diff --git a/vendor/voclient/doc/vosesame.pdf b/vendor/voclient/doc/vosesame.pdf Binary files differnew file mode 100644 index 00000000..3649acf7 --- /dev/null +++ b/vendor/voclient/doc/vosesame.pdf diff --git a/vendor/voclient/doc/vospectra.html b/vendor/voclient/doc/vospectra.html new file mode 100644 index 00000000..6cf2ad2e --- /dev/null +++ b/vendor/voclient/doc/vospectra.html @@ -0,0 +1,102 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOSPECTRA</TITLE> +</HEAD><BODY> +<H1>VOSPECTRA</H1> +Section: User Commands (1)<BR>Updated: Feb 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +vospectra - Query VO spectral services for data +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>vospectra</B> [<opts>] <service> [ <object> | <ra> <dec> ] [ <size> ] +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>vospectra</I> application accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<P> +<DT><B>All VODATA task options</B> + +<DD> +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>vospectra</I> task is a convenience application built on top of the +<I>vodata</I> application, logically it will only query for spectral data +and will set the appropriate flags when calling <I>vodata</I>. +<P> + +For a complete list of options and a description of the task behavior, see +the <I>VODATA</I> man page. +<P> +<A NAME="lbAF"> </A> +<H2>RETURN STATUS</H2> + +On exit the <B>vospectra</B> task will return a zero indicating success, or a +one indicating an error. +<P> +<A NAME="lbAG"> </A> +<H2>EXAMPLES</H2> + +<DL COMPACT> +<DT>1) Query all services for spectra data of 3c273:<DD> +<P> +<PRE> + % vospectra any 3c273 +</PRE> + +<P> +</DL> +<A NAME="lbAH"> </A> +<H2>BUGS</H2> + +No known bugs with this release. +<A NAME="lbAI"> </A> +<H2>Revision History</H2> + +Feb 2013 - First public release +<A NAME="lbAJ"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), Feb 2013 +<A NAME="lbAK"> </A> +<H2>SEE ALSO</H2> + +vodata, vocatalog, voimage +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">RETURN STATUS</A><DD> +<DT><A HREF="#lbAG">EXAMPLES</A><DD> +<DT><A HREF="#lbAH">BUGS</A><DD> +<DT><A HREF="#lbAI">Revision History</A><DD> +<DT><A HREF="#lbAJ">Author</A><DD> +<DT><A HREF="#lbAK">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 05:13:26 GMT, April 14, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/vospectra.man b/vendor/voclient/doc/vospectra.man new file mode 100644 index 00000000..6151ca75 --- /dev/null +++ b/vendor/voclient/doc/vospectra.man @@ -0,0 +1,46 @@ +.\" @(#)vospectra.1 1.0 Feb-2013 MJF +.TH VOSPECTRA 1 "Feb 2013" "VOClient Package" +.SH NAME +vospectra \- Query VO spectral services for data + +.SH SYNOPSIS +\fBvospectra\fP [<opts>] <service> [ <object> | <ra> <dec> ] [ <size> ] + +.SH OPTIONS +The \fIvospectra\fP application accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.TP 6 +.B All VODATA task options + +.SH DESCRIPTION +The \fIvospectra\fP task is a convenience application built on top of the +\fIvodata\fP application, logically it will only query for spectral data +and will set the appropriate flags when calling \fIvodata\fP. +.PP +For a complete list of options and a description of the task behavior, see +the \fIVODATA\fP man page. + +.SH RETURN STATUS +On exit the \fBvospectra\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Query all services for spectra data of 3c273: + +.nf + % vospectra any 3c273 +.fi + +.SH BUGS +No known bugs with this release. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +vodata, vocatalog, voimage diff --git a/vendor/voclient/doc/vospectra.pdf b/vendor/voclient/doc/vospectra.pdf Binary files differnew file mode 100644 index 00000000..baf32d4d --- /dev/null +++ b/vendor/voclient/doc/vospectra.pdf diff --git a/vendor/voclient/doc/votcnv.html b/vendor/voclient/doc/votcnv.html new file mode 100644 index 00000000..00e858d2 --- /dev/null +++ b/vendor/voclient/doc/votcnv.html @@ -0,0 +1,185 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOTCNV</TITLE> +</HEAD><BODY> +<H1>VOTCNV</H1> +Section: User Commands (1)<BR>Updated: Feb 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +votcnv - Convert from VOTable to another format +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>votcnv</B> [<I>-opts</I>] votable.xml +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>votcnv</I> task accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<DT><B>-f </B><I>FMT</I>, --fmt <I>FMT</I> + +<DD> +Convert the VOTable to the format specified by <I>FMT</I>. Allowed +formats are described below. +<DT><B>-i </B><I>NUM</I>, --indent <I>NUM</I> + +<DD> +Indent each level of XML output by <I>NUM</I> spaces. +<DT><B>-n, --noheader</B> + +<DD> +Suppress writing any header information. This flag only applies to formats +other than FITS and VOTable. +<DT><B>-o </B><I>NAME</I>, --output <I>NAME</I> + +<DD> +Write the result to the file <I>NAME</I>. +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>votcnv</I> task is used to convert a VOTable XML document to a +different format, or to rewrite a VOTable using (or removing) indention. +Creating a new VOTable document will fix any compliance issues since the +task will loosly read a VOTable on input but will always write an XML +file that complies with the VOTable specification. +<P> +The <I>-f</I> (or <I>--fmt</I>) flag is used to specify the new format using +one of the names listed below. +<P> + +<I>vot<TT> </TT><TT> </TT></I> + +A new VOTable<BR> + +<I>asv<TT> </TT><TT> </TT></I> + +ASCII-separated (i.e. whitespace) values.<BR> + +<I>bsv<TT> </TT><TT> </TT></I> + +Bar-separated values.<BR> + +<I>csv<TT> </TT><TT> </TT></I> + +Comma-separated values<BR> + +<I>tsv<TT> </TT><TT> </TT></I> + +Tab-separated values<BR> + +<I>html<TT> </TT><TT> </TT></I> + +Standalone HTML document (entire table)<BR> + +<I>shtml<TT> </TT></I> + +Single HTML table<BR> + +<I>fits<TT> </TT><TT> </TT></I> + +FITS bintable<BR> + +<I>ascii<TT> </TT></I> + +ASV alias<BR> + +<I>xml<TT> </TT><TT> </TT></I> + +VOTable alias<BR> + +<I>raw<TT> </TT><TT> </TT></I> + +VOTable alias<BR> +<P> + +For formats such as CSV that normally +include column headers, the <I>-n</I> (or <I>--noheader</I>) flag may be used +to suppress this header. The FITS file produced will be an MEF containing +a bintable extension for each VOTable "<TABLE>" element. Column types and +names in this case come from the VOTable "<FIELD>" attributes. +<P> +If no input file is specified the VOTable will be read from the stdin, +results will be written to stdout unless the <I>-o</I> (or <I>--output</I>) +names an output file. The task will only process a single VOTable and may +not be used to convert multiple files in a single call. +<P> +<A NAME="lbAF"> </A> +<H2>RETURN STATUS</H2> + +On exit the <B>votcnv</B> task will return a zero indicating success, or a +one indicating an error. +<P> +<A NAME="lbAG"> </A> +<H2>EXAMPLES</H2> + +<DL COMPACT> +<DT>1) Convert a VOTable to a CSV file:<DD> +<P> +<PRE> + % votcnv --fmt=csv test.xml +</PRE> + +<DT>2) Rewrite a VOTable with readable indention:<DD> +<P> +<PRE> + % votcnv -f vot -i 2 test.xml +</PRE> + +<DT>3) Remove indention from a VOTable:<DD> +<P> +<PRE> + % votcnv -f vot -i 0 test.xml +</PRE> + +</DL> +<A NAME="lbAH"> </A> +<H2>BUGS</H2> + +No known bugs with this release. +<A NAME="lbAI"> </A> +<H2>Revision History</H2> + +Feb 2013 - First public release +<A NAME="lbAJ"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), Feb 2013 +<A NAME="lbAK"> </A> +<H2>SEE ALSO</H2> + +votget, votinfo, votpos, votsort, votstat +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">RETURN STATUS</A><DD> +<DT><A HREF="#lbAG">EXAMPLES</A><DD> +<DT><A HREF="#lbAH">BUGS</A><DD> +<DT><A HREF="#lbAI">Revision History</A><DD> +<DT><A HREF="#lbAJ">Author</A><DD> +<DT><A HREF="#lbAK">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 05:13:26 GMT, April 14, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/votcnv.man b/vendor/voclient/doc/votcnv.man new file mode 100644 index 00000000..1a17fbee --- /dev/null +++ b/vendor/voclient/doc/votcnv.man @@ -0,0 +1,116 @@ +.\" @(#)votcnv.1 1.0 Feb-2013 MJF +.TH VOTCNV 1 "Feb 2013" "VOClient Package" +.SH NAME +votcnv \- Convert from VOTable to another format + +.SH SYNOPSIS +\fBvotcnv\fP [\fI-opts\fP] votable.xml + +.SH OPTIONS +The \fIvotcnv\fP task accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. +.TP 6 +.B \-f \fIFMT\fP, --fmt \fIFMT\fP +Convert the VOTable to the format specified by \fIFMT\fP. Allowed +formats are described below. +.TP 6 +.B \-i \fINUM\fP, --indent \fINUM\fP +Indent each level of XML output by \fINUM\fP spaces. +.TP 6 +.B \-n, --noheader +Suppress writing any header information. This flag only applies to formats +other than FITS and VOTable. +.TP 6 +.B \-o \fINAME\fP, --output \fINAME\fP +Write the result to the file \fINAME\fP. + +.SH DESCRIPTION +The \fIvotcnv\fP task is used to convert a VOTable XML document to a +different format, or to rewrite a VOTable using (or removing) indention. +Creating a new VOTable document will fix any compliance issues since the +task will loosly read a VOTable on input but will always write an XML +file that complies with the VOTable specification. + +The \fI\-f\fP (or \fI\--fmt\fP) flag is used to specify the new format using +one of the names listed below. + +.in 15 +.I vot +A new VOTable +.in 15 +.I asv +ASCII-separated (i.e. whitespace) values. +.in 15 +.I bsv +Bar-separated values. +.in 15 +.I csv +Comma-separated values +.in 15 +.I tsv +Tab-separated values +.in 15 +.I html +Standalone HTML document (entire table) +.in 15 +.I shtml +Single HTML table +.in 15 +.I fits +FITS bintable +.in 15 +.I ascii +ASV alias +.in 15 +.I xml +VOTable alias +.in 15 +.I raw +VOTable alias + +.in 7 +For formats such as CSV that normally +include column headers, the \fI\-n\fP (or \fI\--noheader\fP) flag may be used +to suppress this header. The FITS file produced will be an MEF containing +a bintable extension for each VOTable "<TABLE>" element. Column types and +names in this case come from the VOTable "<FIELD>" attributes. + +If no input file is specified the VOTable will be read from the stdin, +results will be written to stdout unless the \fI\-o\fP (or \fI\--output\fP) +names an output file. The task will only process a single VOTable and may +not be used to convert multiple files in a single call. + +.SH RETURN STATUS +On exit the \fBvotcnv\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Convert a VOTable to a CSV file: + +.nf + % votcnv --fmt=csv test.xml +.fi +.TP 4 +2) Rewrite a VOTable with readable indention: + +.nf + % votcnv -f vot -i 2 test.xml +.fi +.TP 4 +3) Remove indention from a VOTable: + +.nf + % votcnv -f vot -i 0 test.xml +.fi +.SH BUGS +No known bugs with this release. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +votget, votinfo, votpos, votsort, votstat diff --git a/vendor/voclient/doc/votcnv.pdf b/vendor/voclient/doc/votcnv.pdf Binary files differnew file mode 100644 index 00000000..e46d2cc4 --- /dev/null +++ b/vendor/voclient/doc/votcnv.pdf diff --git a/vendor/voclient/doc/votget.html b/vendor/voclient/doc/votget.html new file mode 100644 index 00000000..c19b09ed --- /dev/null +++ b/vendor/voclient/doc/votget.html @@ -0,0 +1,244 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOTGET</TITLE> +</HEAD><BODY> +<H1>VOTGET</H1> +Section: User Commands (1)<BR>Updated: Feb 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +votget - Download URLs or access references in a VOTable +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>votget</B> [<I><opts></I>] [ <votable.xml> | <listfile> ] +<BR> + +<B>votget</B> [<I><opts></I>] --samp # to listen for SAMP messages +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>votget</I> task accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<P> +<DT><B>-b </B><I>BASE</I>,--base <I>BASE</I> + +<DD> +Base output filename. The <I>BASE</I> name will be appended with a running +(leading zero, 4-digit) number for each downloaded file. +<DT><B>-e [</B><I>EXTN</I>],--extn [<I>EXTN</I>] + +<DD> +Extension to add to each filename. If no <I>EXTN</I> is provided, a guess +of the file type will be made an an appropriate extension chosen +automatically. +<DT><B>-f,--fmt </B><I>FILE_TYPE</I> + +<DD> +Download only file of the specified <I>TYPE</I>. The <I>TYPE</I> value is +used in a substring match of the image format column value. The format +column uses a well-known UCD or may be specified using the <I>-u</I> or +<I>-F</I> flags. +<DT><B>-s,--sum </B> + +<DD> +Use the 32-bit file checksum numbers when appending to the <I>BASE</I> +filename. By default, a sequential file number is used. +<DT><B>-t,--tmp </B> + +<DD> +Input file is temporary, delete it when done. +<DT><B>-u </B><I>UCD</I>,--ucd <I>UCD</I> + +<DD> +Use ucd to identify access reference column. The VOTable <I><FIELD></I> +containing the <I>ucd=UCD</I> attribute will identify the access reference +column used when matching the <I>TYPE</I> value. +<P> +<DT><B>-o </B><I>NAME</I>,--output <I>NAME</I> + +<DD> +Output filename (single download only). This option may be used to specify +the name of the downloaded file in cases where only a single file is +requested. +<DT><B>-v,--verbose </B> + +<DD> +Verbose output. +<DT><B>-x,--extract </B> + +<DD> +Extract access references only. Files are not downloaded, the access +reference URLs are written to the output file or stderr stream if no +<I>-o</I> output file is given. +<P> +<DT><B>-A </B><I>COLUMN</I>,--acref <I>COLNUM</I> + +<DD> +Column number (0-indexed) for access reference column. +<DT><B>-B,--bkg</B> + +<DD> +Background the download, i.e. run in a forked child process. +<DT><B>-C,--cache</B> + +<DD> +Cache the downloaded file +<DT><B>-D </B><I>DIR</I>,--download <I>dir</I> + +<DD> +Specify download directory, i.e. download files to the <I>DIR</I> directory +and not the current working directory. +<DT><B>-F,--fmtcol <colnum</B> + +<DD> +Column number (0-indexed) for image format column. This column value will be +used to match the <I>TYPE</I> value given to the <I>-f</I> option. +<DT><B>-N </B><I>NUM</I>,--num <I>NUM</I> + +<DD> +Number of simultaneous downloads to process. In cases where multiple files +are requested, the task will create <I>NUM</I> separate threads to multiplex +the downloads for greater efficiency. +<DT><B>-S,--samp</B> + +<DD> +Start as SAMP listener. If enabled, the task will simply listen for +SAMP messages containing a 'table.load.votable' message type and will +process the requested file automatically. This allows the task to act as a +download client for other applications. +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>votget</I> task can be used to download remote files to the local +machine. If given a filename argument on the command-line, the file may be +either a plain-text file containing a list of URLs (one per line), or a +VOTable (e.g. such as one returned from an SIA or SSA service) containing +<I>'acess references'</I> to data. If no filename is given on the +command-line and the <I>-S</I> flag is used, the task will start as a listener +for SAMP messages containing a 'table.load.votable' request and will process +those VOTable files as they arrive. +<P> + +When processing VOTables, the <I>-A</I> and <I>-F</I> flags can be used to +specify the access reference and image format columns as 0-indexed column +numbers, or the <I>-u</I> and <I>-f</I> options can be used to specify the +access reference UCD and format string respectively. By default, all access +references will be downloaded, if a format parameter is used then only images +of that type will be downloaded. If the <I>-x</I> option is enabled, the +access references will be extracted from the VOTable and the URL written to +the output rather than downloading the referenced file. +<P> + +If the <I>-b</I> option is set the argument should be a base name for the +downloaded files. This name will be appended with a sequential 4-digit +number to make the filenames unique, unless the <I>-s</I> option is set to +indicate the 32-bit file checksum should be used instead. An optional +filename extension (e.g. "fits") can be added to these names by specifying +the <I>-e</I> option to given the extension string. If none of these options +are given, a best-guess of the filename will be made based on the URL. +<P> + +<I>VOGET</I> will attempt to download multiple files simultaneously, the +number of download threads may be set using the <I>-N</I> option. By setting +the <I>-B</I> option, downloads will proceed in a background child process +allowing control to be returned to the calling shell quickly. +<P> +If no input file is specified the VOTable will be read from the stdin, +results will be written to stdout unless the <I>-o</I> (or <I>--output</I>) +names an output file. The task will only process a single VOTable and may +not be used to convert multiple files in a single call. +<P> +<A NAME="lbAF"> </A> +<H2>RETURN STATUS</H2> + +<I>votget</I> will return a zero for a successful exit, one otherwise. +<P> +<A NAME="lbAG"> </A> +<H2>EXAMPLES</H2> + +<DL COMPACT> +<DT>1) <DD> +Download all files in the VOTable 'results.xml', 3 files at a time: +<P> +<PRE> + % votget -N 3 results.xml +</PRE> + +<DT>2) <DD> +Start as a SAMP listener waiting for VOTable events to be broadcast, saved +files will begin with the string 'foo' and contain a 'fits' filename extension: +<P> +<PRE> + % votget -b foo -e fits -S +</PRE> + +<P> +To exit the task, hit the <CR>. +<DT>3) <DD> +Download all the urls in the file 'urls.txt': +<P> +<PRE> + % votget -b foo urls.txt +</PRE> + +<DT>4) <DD> +Extract all the access references in a VOTable: +<P> +<PRE> + % votget -x results.xml +</PRE> + +<P> +<P> +</DL> +<A NAME="lbAH"> </A> +<H2>BUGS</H2> + +No known bugs with this release. +<A NAME="lbAI"> </A> +<H2>Revision History</H2> + +Feb 2013 - First public release +<A NAME="lbAJ"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), Feb 2013 +<A NAME="lbAK"> </A> +<H2>SEE ALSO</H2> + +votcnv, votinfo, votpos, votsort, votstat +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">RETURN STATUS</A><DD> +<DT><A HREF="#lbAG">EXAMPLES</A><DD> +<DT><A HREF="#lbAH">BUGS</A><DD> +<DT><A HREF="#lbAI">Revision History</A><DD> +<DT><A HREF="#lbAJ">Author</A><DD> +<DT><A HREF="#lbAK">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 05:13:26 GMT, April 14, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/votget.man b/vendor/voclient/doc/votget.man new file mode 100644 index 00000000..000c5e9e --- /dev/null +++ b/vendor/voclient/doc/votget.man @@ -0,0 +1,170 @@ +.\" @(#)votget.1 1.0 Feb-2013 MJF +.TH VOTGET 1 "Feb 2013" "VOClient Package" +.SH NAME +votget \- Download URLs or access references in a VOTable + +.SH SYNOPSIS +\fBvotget\fP [\fI<opts>\fP] [ <votable.xml> | <listfile> ] +.br +\fBvotget\fP [\fI<opts>\fP] \--samp # to listen for SAMP messages + +.SH OPTIONS +The \fIvotget\fP task accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.TP 6 +.B -b \fIBASE\fP,--base \fIBASE\fP +Base output filename. The \fIBASE\fP name will be appended with a running +(leading zero, 4-digit) number for each downloaded file. +.TP 6 +.B -e [\fIEXTN\fP],--extn [\fIEXTN\fP] +Extension to add to each filename. If no \fIEXTN\fP is provided, a guess +of the file type will be made an an appropriate extension chosen +automatically. +.TP 6 +.B -f,--fmt \fIFILE_TYPE\fP +Download only file of the specified \fITYPE\fP. The \fITYPE\fP value is +used in a substring match of the image format column value. The format +column uses a well-known UCD or may be specified using the \fI-u\fP or +\fI-F\fP flags. +.TP 6 +.B -s,--sum +Use the 32-bit file checksum numbers when appending to the \fIBASE\fP +filename. By default, a sequential file number is used. +.TP 6 +.B -t,--tmp +Input file is temporary, delete it when done. +.TP 6 +.B -u \fIUCD\fP,--ucd \fIUCD\fP +Use ucd to identify access reference column. The VOTable \fI<FIELD>\fP +containing the \fIucd=UCD\fP attribute will identify the access reference +column used when matching the \fITYPE\fR value. + +.TP 6 +.B -o \fINAME\fP,--output \fINAME\fP +Output filename (single download only). This option may be used to specify +the name of the downloaded file in cases where only a single file is +requested. +.TP 6 +.B -v,--verbose +Verbose output. +.TP 6 +.B -x,--extract +Extract access references only. Files are not downloaded, the access +reference URLs are written to the output file or stderr stream if no +\fI-o\fP output file is given. + +.TP 6 +.B -A \fICOLUMN\fP,--acref \fICOLNUM\fP +Column number (0-indexed) for access reference column. +.TP 6 +.B -B,--bkg +Background the download, i.e. run in a forked child process. +.TP 6 +.B -C,--cache +Cache the downloaded file +.TP 6 +.B -D \fIDIR\fP,--download \fIdir\fP +Specify download directory, i.e. download files to the \fIDIR\fP directory +and not the current working directory. +.TP 6 +.B -F,--fmtcol <colnum\fP +Column number (0-indexed) for image format column. This column value will be +used to match the \fITYPE\fP value given to the \fI-f\fP option. +.TP 6 +.B -N \fINUM\fP,--num \fINUM\fP +Number of simultaneous downloads to process. In cases where multiple files +are requested, the task will create \fINUM\fP separate threads to multiplex +the downloads for greater efficiency. +.TP 6 +.B -S,--samp +Start as SAMP listener. If enabled, the task will simply listen for +SAMP messages containing a 'table.load.votable' message type and will +process the requested file automatically. This allows the task to act as a +download client for other applications. + +.SH DESCRIPTION +The \fIvotget\fP task can be used to download remote files to the local +machine. If given a filename argument on the command-line, the file may be +either a plain-text file containing a list of URLs (one per line), or a +VOTable (e.g. such as one returned from an SIA or SSA service) containing +\fI'acess references'\fP to data. If no filename is given on the +command-line and the \fI-S\fP flag is used, the task will start as a listener +for SAMP messages containing a 'table.load.votable' request and will process +those VOTable files as they arrive. +.PP +When processing VOTables, the \fI-A\fP and \fI-F\fP flags can be used to +specify the access reference and image format columns as 0-indexed column +numbers, or the \fI-u\fP and \fI-f\fP options can be used to specify the +access reference UCD and format string respectively. By default, all access +references will be downloaded, if a format parameter is used then only images +of that type will be downloaded. If the \fI-x\fP option is enabled, the +access references will be extracted from the VOTable and the URL written to +the output rather than downloading the referenced file. +.PP +If the \fI-b\fP option is set the argument should be a base name for the +downloaded files. This name will be appended with a sequential 4-digit +number to make the filenames unique, unless the \fI-s\fP option is set to +indicate the 32-bit file checksum should be used instead. An optional +filename extension (e.g. "fits") can be added to these names by specifying +the \fI-e\fP option to given the extension string. If none of these options +are given, a best-guess of the filename will be made based on the URL. +.PP +\fIVOGET\fP will attempt to download multiple files simultaneously, the +number of download threads may be set using the \fI-N\fP option. By setting +the \fI-B\fP option, downloads will proceed in a background child process +allowing control to be returned to the calling shell quickly. + +If no input file is specified the VOTable will be read from the stdin, +results will be written to stdout unless the \fI\-o\fP (or \fI\--output\fP) +names an output file. The task will only process a single VOTable and may +not be used to convert multiple files in a single call. + +.SH RETURN STATUS +\fIvotget\fP will return a zero for a successful exit, one otherwise. + +.SH EXAMPLES +.TP 4 +1) +Download all files in the VOTable 'results.xml', 3 files at a time: + +.nf + % votget -N 3 results.xml +.fi +.TP 4 +2) +Start as a SAMP listener waiting for VOTable events to be broadcast, saved +files will begin with the string 'foo' and contain a 'fits' filename extension: + +.nf + % votget -b foo -e fits -S +.fi + +To exit the task, hit the <CR>. +.TP 4 +3) +Download all the urls in the file 'urls.txt': + +.nf + % votget -b foo urls.txt +.fi +.TP 4 +4) +Extract all the access references in a VOTable: + +.nf + % votget -x results.xml +.fi + + +.SH BUGS +No known bugs with this release. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +votcnv, votinfo, votpos, votsort, votstat diff --git a/vendor/voclient/doc/votget.pdf b/vendor/voclient/doc/votget.pdf Binary files differnew file mode 100644 index 00000000..aa01c130 --- /dev/null +++ b/vendor/voclient/doc/votget.pdf diff --git a/vendor/voclient/doc/votinfo.html b/vendor/voclient/doc/votinfo.html new file mode 100644 index 00000000..3566c0d1 --- /dev/null +++ b/vendor/voclient/doc/votinfo.html @@ -0,0 +1,188 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOTINFO</TITLE> +</HEAD><BODY> +<H1>VOTINFO</H1> +Section: User Commands (1)<BR>Updated: Feb 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +votinfo - Get information about a VOTable +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>votinfo</B> [<opts>] votable.xml +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>votinfo</I> task accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<P> +<DT><B>-b,--brief</B> + +<DD> +Print only brief output about the table. +<DT><B>-d,--description</B> + +<DD> +Print the toplevel <DESCRIPTION> element of the VOTable. +<DT><B>-i,--info</B> + +<DD> +Print all <INFO> elements in the VOTable. Parameters are printed as +<I>name=value</I> pairs,, if there is no output it is +implied there are no <INFO> elements in the document. +<DT><B>-n </B><I>WHAT</I>,--numberOf <I>WHAT</I> + +<DD> +Get number of elements specified by <I>WHAT</I>. The <I>WHAT</I> must be a +valid VOTable element name. +<DT><B>-p,--param</B> + +<DD> +Print all <PARAM> elements in the VOTable. Parameters are printed as +<I>name=value</I> pairs, if there is no output it is implied there are no +<PARAM> elements in the document. +<DT><B>-q,--query_status</B> + +<DD> +Get the 'QUERY_STATUS' <INFO> value, a value of zero is returned of the +value is OK, or one if it is an ERROR. +<DT><B>-s,--size</B> + +<DD> +Print the table size as <nrows> and <ncols> values. In a multi-RESOURCE +VOTable only results for the first table are returned. +<DT><B>-v,--verbose</B> + +<DD> +Print verbose otuput. +<DT><B>-w,--warn</B> + +<DD> +Print VOTable parser warning messages. +<P> +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>votinfo</I> task is used to either print a summary of a VOTable's +structure, or to get specific attributes of a VOTable (e.g. the size of +a table, number of parameters, etc). The <I>-n WHAT</I> flag is used to query +for the number of <I>WHAT</I> elements in the document, allow values of WHAT +include: +<P> + +<I>param<TT> </TT></I> + +number of <PARAM> elements<BR> + +<I>info<TT> </TT><TT> </TT></I> + +number of <INFO> elements<BR> + +<I>rows<TT> </TT><TT> </TT></I> + +number of table rows<BR> + +<I>cols<TT> </TT><TT> </TT></I> + +number of table cols<BR> + +<I>resources<TT> </TT></I> + +number of <RESOURCE> elements<BR> +<P> +<P> + +The VOTable <PARAM> elements may be printed using the <I>-p</I> flag, +similarly <INFO> elements can be printed using <I>-i</I>. +<P> +If no input file is specified the VOTable will be read from the stdin, +results will be written to stdout unless the <I>-o</I> (or <I>--output</I>) +names an output file. The task will only process a single VOTable and may +not be used to convert multiple files in a single call. +<P> +<A NAME="lbAF"> </A> +<H2>RETURN STATUS</H2> + +On exit the <B>votinfo</B> task will return a zero indicating success, or a +one indicating an error. +<P> +<A NAME="lbAG"> </A> +<H2>EXAMPLES</H2> + +<DL COMPACT> +<DT>1) Print verbose summary information about a VOTable<DD> +<P> +<PRE> + % votinfo -v test.xml +</PRE> + +<DT>2) Print the <PARAM> elements in a table, then get a count<DD> +<P> +<PRE> + % votinfo -p test.xml + % votinfo --numberOf=param test.xml +</PRE> + +<DT>3) Determine whether a VOTable contains a successful result<DD> +<P> +<PRE> + % votinfo -q test.xml +</PRE> + +<P> +A zero indicates 'OK', a one is an 'ERR', and -1 means that an <INFO> with a 'QUERY_STATUS' was not found +<P> +</DL> +<A NAME="lbAH"> </A> +<H2>BUGS</H2> + +The task doesn't always work intuitively with multi-resource VOTables. +<A NAME="lbAI"> </A> +<H2>Revision History</H2> + +Feb 2013 - First public release +<A NAME="lbAJ"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), Feb 2013 +<A NAME="lbAK"> </A> +<H2>SEE ALSO</H2> + +votget, votget, votpos, votsort, votstat +<P> +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">RETURN STATUS</A><DD> +<DT><A HREF="#lbAG">EXAMPLES</A><DD> +<DT><A HREF="#lbAH">BUGS</A><DD> +<DT><A HREF="#lbAI">Revision History</A><DD> +<DT><A HREF="#lbAJ">Author</A><DD> +<DT><A HREF="#lbAK">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 05:13:26 GMT, April 14, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/votinfo.man b/vendor/voclient/doc/votinfo.man new file mode 100644 index 00000000..43d672b3 --- /dev/null +++ b/vendor/voclient/doc/votinfo.man @@ -0,0 +1,119 @@ +.\" @(#)votinfo.1 1.0 Feb-2013 MJF +.TH VOTINFO 1 "Feb 2013" "VOClient Package" +.SH NAME +votinfo \- Get information about a VOTable + +.SH SYNOPSIS +\fBvotinfo\fP [<opts>] votable.xml + +.SH OPTIONS +The \fIvotinfo\fP task accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.TP 6 +.B \-b,--brief +Print only brief output about the table. +.TP 6 +.B \-d,--description +Print the toplevel <DESCRIPTION> element of the VOTable. +.TP 6 +.B \-i,--info +Print all <INFO> elements in the VOTable. Parameters are printed as +\fIname=value\fP pairs,, if there is no output it is +implied there are no <INFO> elements in the document. +.TP 6 +.B \-n \fIWHAT\fP,--numberOf \fIWHAT\fP +Get number of elements specified by \fIWHAT\fP. The \fIWHAT\fP must be a +valid VOTable element name. +.TP 6 +.B \-p,--param +Print all <PARAM> elements in the VOTable. Parameters are printed as +\fIname=value\fP pairs, if there is no output it is implied there are no +<PARAM> elements in the document. +.TP 6 +.B \-q,--query_status +Get the 'QUERY_STATUS' <INFO> value, a value of zero is returned of the +value is OK, or one if it is an ERROR. +.TP 6 +.B \-s,--size +Print the table size as <nrows> and <ncols> values. In a multi-RESOURCE +VOTable only results for the first table are returned. +.TP 6 +.B \-v,--verbose +Print verbose otuput. +.TP 6 +.B \-w,--warn +Print VOTable parser warning messages. + + +.SH DESCRIPTION +The \fIvotinfo\fP task is used to either print a summary of a VOTable's +structure, or to get specific attributes of a VOTable (e.g. the size of +a table, number of parameters, etc). The \fI-n WHAT\fP flag is used to query +for the number of \fIWHAT\fP elements in the document, allow values of WHAT +include: + +.in 15 +.I param +number of <PARAM> elements +.in 15 +.I info +number of <INFO> elements +.in 15 +.I rows +number of table rows +.in 15 +.I cols +number of table cols +.in 15 +.I resources +number of <RESOURCE> elements + +.PP +The VOTable <PARAM> elements may be printed using the \fI-p\fP flag, +similarly <INFO> elements can be printed using \fI-i\fP. + +If no input file is specified the VOTable will be read from the stdin, +results will be written to stdout unless the \fI\-o\fP (or \fI\--output\fP) +names an output file. The task will only process a single VOTable and may +not be used to convert multiple files in a single call. + +.SH RETURN STATUS +On exit the \fBvotinfo\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Print verbose summary information about a VOTable + +.nf + % votinfo -v test.xml +.fi +.TP 4 +2) Print the <PARAM> elements in a table, then get a count + +.nf + % votinfo -p test.xml + % votinfo --numberOf=param test.xml +.fi +.TP 4 +3) Determine whether a VOTable contains a successful result + +.nf + % votinfo -q test.xml +.fi + +A zero indicates 'OK', a one is an 'ERR', and -1 means that an <INFO> with a 'QUERY_STATUS' was not found + +.SH BUGS +The task doesn't always work intuitively with multi-resource VOTables. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +votget, votget, votpos, votsort, votstat + diff --git a/vendor/voclient/doc/votinfo.pdf b/vendor/voclient/doc/votinfo.pdf Binary files differnew file mode 100644 index 00000000..dcf7c6e3 --- /dev/null +++ b/vendor/voclient/doc/votinfo.pdf diff --git a/vendor/voclient/doc/votopic.html b/vendor/voclient/doc/votopic.html new file mode 100644 index 00000000..38d7b59c --- /dev/null +++ b/vendor/voclient/doc/votopic.html @@ -0,0 +1,126 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOTOPIC</TITLE> +</HEAD><BODY> +<H1>VOTOPIC</H1> +Section: User Commands (1)<BR>Updated: Feb 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +votopic - Query for data from resources specified by topic keyword +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>votopic</B> [<opts>] <topic> { <object> | <ra> <dec> } [ <size> ] +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>votopic</I> application accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<P> +<DT><B>All VODATA task options</B> + +<DD> +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>votopic</I> task is a convenience application built on top of the +<I>vodata</I> and <I>voregistry</I> applications. Its main purpose is to +allow a query for data using logical concepts (e.g. "galaxies", "observation +logs") rather than a specific list of resources. This should limit the +number of resources that need to be queried when querying all data services +and return more relevant results. This is done by using the <I><topic></I> +argument as a keyword search value for the Registry, the resulting resource +list +is then used as input for the VODATA task to query only those resources +returned by the Registry query at the position listed by the <I><object>fP +or <ra> <dec></I> position. As an example, the topic 'AGN' may be used +to query only those resources that claim to have something to do with AGN +as opposed to the many hundreds or thousands more that may not contain data +for that field at all but would be queried anyway using the more generalized +approach of <I>VODATA</I>. +<P> + +The actual effectiveness or suitability of this approach will depend greatly +on the keywords (i.e. <I>topic</I>) chosen and the aims of a specific query. +<P> + +For a complete list of options and a description of the task behavior, see +the <I>VODATA</I> and <I>VOREGISTRY</I> man page. +<P> +<A NAME="lbAF"> </A> +<H2>RETURN STATUS</H2> + +On exit the <B>votopic</B> task will return a zero indicating success, or a +one indicating an error. +<P> +<A NAME="lbAG"> </A> +<H2>EXAMPLES</H2> + +<DL COMPACT> +<DT>1) Query for catalog data of A2712 from Resources related to gravitational lensing:<DD> +<P> +<PRE> + % votopic -t catalog lens A2712 +</PRE> + +<DT>This query is against only 142 services (data found for 128), a similar query against ALL catalog services would require more than 8000 services to be queried. This is equivalent to the commands<DD> +<P> +<PRE> + % voregistry -t catalog -d -o lens.xml lens + % vodata lens.xml A2712 +</PRE> + +<DT>Here the 'lens.xml' output file contains the resources to be queried, the '-d' flag says to return only DAL services, the '-t' flag resticts by service type. In the call to VODATA, the 'lens.xml' file defines the 142 resources to be queried, the contraint to service type and DAL-only was done in the registry query that produced the file.<DD> +<P> +</DL> +<A NAME="lbAH"> </A> +<H2>BUGS</H2> + +No known bugs with this release. +<A NAME="lbAI"> </A> +<H2>Revision History</H2> + +Feb 2013 - First public release +<A NAME="lbAJ"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), Feb 2013 +<A NAME="lbAK"> </A> +<H2>SEE ALSO</H2> + +vodata, vocatalog, voimage, vospectra, voregistry +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">RETURN STATUS</A><DD> +<DT><A HREF="#lbAG">EXAMPLES</A><DD> +<DT><A HREF="#lbAH">BUGS</A><DD> +<DT><A HREF="#lbAI">Revision History</A><DD> +<DT><A HREF="#lbAJ">Author</A><DD> +<DT><A HREF="#lbAK">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 05:13:27 GMT, April 14, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/votopic.man b/vendor/voclient/doc/votopic.man new file mode 100644 index 00000000..1fbdd1ae --- /dev/null +++ b/vendor/voclient/doc/votopic.man @@ -0,0 +1,70 @@ +.\" @(#)votopic.1 1.0 Feb-2013 MJF +.TH VOTOPIC 1 "Feb 2013" "VOClient Package" +.SH NAME +votopic \- Query for data from resources specified by topic keyword + +.SH SYNOPSIS +\fBvotopic\fP [<opts>] <topic> { <object> | <ra> <dec> } [ <size> ] + +.SH OPTIONS +The \fIvotopic\fP application accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.TP 6 +.B All VODATA task options + +.SH DESCRIPTION +The \fIvotopic\fP task is a convenience application built on top of the +\fIvodata\fP and \fIvoregistry\fP applications. Its main purpose is to +allow a query for data using logical concepts (e.g. "galaxies", "observation +logs") rather than a specific list of resources. This should limit the +number of resources that need to be queried when querying all data services +and return more relevant results. This is done by using the \fI<topic>\fP +argument as a keyword search value for the Registry, the resulting resource +list +is then used as input for the VODATA task to query only those resources +returned by the Registry query at the position listed by the \fI<object>fP +or \fI<ra> <dec>\fP position. As an example, the topic 'AGN' may be used +to query only those resources that claim to have something to do with AGN +as opposed to the many hundreds or thousands more that may not contain data +for that field at all but would be queried anyway using the more generalized +approach of \fIVODATA\fP. +.PP +The actual effectiveness or suitability of this approach will depend greatly +on the keywords (i.e. \fItopic\fP) chosen and the aims of a specific query. +.PP +For a complete list of options and a description of the task behavior, see +the \fIVODATA\fP and \fIVOREGISTRY\fP man page. + +.SH RETURN STATUS +On exit the \fBvotopic\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Query for catalog data of A2712 from Resources related to gravitational lensing: + +.nf + % votopic -t catalog lens A2712 +.fi +.TP 4 +This query is against only 142 services (data found for 128), a similar query against ALL catalog services would require more than 8000 services to be queried. This is equivalent to the commands + +.nf + % voregistry -t catalog -d -o lens.xml lens + % vodata lens.xml A2712 +.fi +.TP 4 +Here the 'lens.xml' output file contains the resources to be queried, the '-d' flag says to return only DAL services, the '-t' flag resticts by service type. In the call to VODATA, the 'lens.xml' file defines the 142 resources to be queried, the contraint to service type and DAL-only was done in the registry query that produced the file. + +.SH BUGS +No known bugs with this release. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +vodata, vocatalog, voimage, vospectra, voregistry diff --git a/vendor/voclient/doc/votopic.pdf b/vendor/voclient/doc/votopic.pdf Binary files differnew file mode 100644 index 00000000..a1c60740 --- /dev/null +++ b/vendor/voclient/doc/votopic.pdf diff --git a/vendor/voclient/doc/votpos.html b/vendor/voclient/doc/votpos.html new file mode 100644 index 00000000..c8623034 --- /dev/null +++ b/vendor/voclient/doc/votpos.html @@ -0,0 +1,122 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOTPOS</TITLE> +</HEAD><BODY> +<H1>VOTPOS</H1> +Section: User Commands (1)<BR>Updated: Feb 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +votpos - Extract the main positional columns from a VOTable +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>votpos</B> [<I>-opts</I>] votable.xml +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>votpos</I> task accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<P> +<B>-n, --number</B> + +Print the row number before the position. +<DT><B>-o </B><I>NAME</I>, --output <I>NAME</I> + +<DD> +Write the result to the file <I>NAME</I>. +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>votpos</I> task is used to extract the positional information from a +VOTable. The columns identified by the UCD <I>POS_EQ_RA_MAIN</I> and +<I>POS_EQ_DEC_MAIN</I> (or UCD+ values <I>pos.eq.ra;meta.main</I> and +<I>pos.eq.dec;meta.main</I>) are located automatically and will be written +as a two-column ascii table to the stdout, or to the file named by +the <I>-o</I> flag. An error will be printed if no columns with these +specific UCDs are found. +<P> +If no input file is specified the VOTable will be read from the stdin, +results will be written to stdout unless the <I>-o</I> (or <I>--output</I>) +names an output file. The task will only process a single VOTable and may +not be used to convert multiple files in a single call. In a multi-resource +VOTABLE only the first <RESOURCE> table will be processed. +<P> +<A NAME="lbAF"> </A> +<H2>RETURN STATUS</H2> + +On exit the <B>votpos</B> task will return a zero indicating success, or a +one indicating an error. +<P> +<A NAME="lbAG"> </A> +<H2>EXAMPLES</H2> + +<DL COMPACT> +<DT>1) Print the primary (RA,Dec) columns from a table:<DD> +<P> +<PRE> + % votpos test.xml # un-numbered + % votpos -n test.xml # numbered + % cat test.xml | votpos # un-numbered +</PRE> + +<DT>2) Print the primary (RA,Dec) columns to a file:<DD> +<P> +<PRE> + % votpos -o pos.txt test.xml +</PRE> + +</DL> +<A NAME="lbAH"> </A> +<H2>BUGS</H2> + +- No known bugs with this release. +<P> +- The task should have options to specify columns to extract when no UCDs are +available. +<A NAME="lbAI"> </A> +<H2>Revision History</H2> + +Feb 2013 - First public release +<A NAME="lbAJ"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), Feb 2013 +<A NAME="lbAK"> </A> +<H2>SEE ALSO</H2> + +votget, votinfo, votcnv, votsort, votstat +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">RETURN STATUS</A><DD> +<DT><A HREF="#lbAG">EXAMPLES</A><DD> +<DT><A HREF="#lbAH">BUGS</A><DD> +<DT><A HREF="#lbAI">Revision History</A><DD> +<DT><A HREF="#lbAJ">Author</A><DD> +<DT><A HREF="#lbAK">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 05:13:27 GMT, April 14, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/votpos.man b/vendor/voclient/doc/votpos.man new file mode 100644 index 00000000..36b57b49 --- /dev/null +++ b/vendor/voclient/doc/votpos.man @@ -0,0 +1,66 @@ +.\" @(#)votpos.1 1.0 Feb-2013 MJF +.TH VOTPOS 1 "Feb 2013" "VOClient Package" +.SH NAME +votpos \- Extract the main positional columns from a VOTable + +.SH SYNOPSIS +\fBvotpos\fP [\fI-opts\fP] votable.xml + +.SH OPTIONS +The \fIvotpos\fP task accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.B \-n, --number +Print the row number before the position. +.TP 6 +.B \-o \fINAME\fP, --output \fINAME\fP +Write the result to the file \fINAME\fP. + +.SH DESCRIPTION +The \fIvotpos\fP task is used to extract the positional information from a +VOTable. The columns identified by the UCD \fIPOS_EQ_RA_MAIN\fP and +\fIPOS_EQ_DEC_MAIN\fP (or UCD+ values \fIpos.eq.ra;meta.main\fP and +\fIpos.eq.dec;meta.main\fP) are located automatically and will be written +as a two-column ascii table to the stdout, or to the file named by +the \fI-o\fP flag. An error will be printed if no columns with these +specific UCDs are found. + +If no input file is specified the VOTable will be read from the stdin, +results will be written to stdout unless the \fI\-o\fP (or \fI\--output\fP) +names an output file. The task will only process a single VOTable and may +not be used to convert multiple files in a single call. In a multi-resource +VOTABLE only the first <RESOURCE> table will be processed. + +.SH RETURN STATUS +On exit the \fBvotpos\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Print the primary (RA,Dec) columns from a table: + +.nf + % votpos test.xml # un-numbered + % votpos -n test.xml # numbered + % cat test.xml | votpos # un-numbered +.fi +.TP 4 +2) Print the primary (RA,Dec) columns to a file: + +.nf + % votpos -o pos.txt test.xml +.fi +.SH BUGS +- No known bugs with this release. + +- The task should have options to specify columns to extract when no UCDs are +available. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +votget, votinfo, votcnv, votsort, votstat diff --git a/vendor/voclient/doc/votpos.pdf b/vendor/voclient/doc/votpos.pdf Binary files differnew file mode 100644 index 00000000..d41658e7 --- /dev/null +++ b/vendor/voclient/doc/votpos.pdf diff --git a/vendor/voclient/doc/votsort.html b/vendor/voclient/doc/votsort.html new file mode 100644 index 00000000..c8fd11bb --- /dev/null +++ b/vendor/voclient/doc/votsort.html @@ -0,0 +1,230 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOTSORT</TITLE> +</HEAD><BODY> +<H1>VOTSORT</H1> +Section: User Commands (1)<BR>Updated: Feb 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +votsort - Extract the main positional columns from a VOTable +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>votsort</B> [<I>-opts</I>] votable.xml +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>votsort</I> task accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<P> +<DT><B>-c </B><I>N</I>,--col <I>N</I> + +<DD> +Sort by column number <I>N</I> (0-indexed). +<DT><B>-d,--desc</B> + +<DD> +Sort in descending order. +<DT><B>-f </B><I>FORMAT</I>,--fmt <I>FORMAT</I> + +<DD> +Output format of sorted table. See description below for list of formats. +<DT><B>-o </B><I>NAME</I>,--output <I>NAME</I> + +<DD> +Output name of sorted file, if not specified results are written to stdout. +<DT><B>-s,--string</B> + +<DD> +Perform a string sort of the columns. +<DT><B>-t </B><I>N</I>,--top <I>N</I> + +<DD> +Print the top <I>N</I> rows of the sorted table. +<DT><B>-i </B><I>N</I>,--indent <I>N</I> + +<DD> +XML indention level when writing a new XML document. +<DT><B>-n,--noheader</B> + +<DD> +Suppress header information for formats other than XML and FITS. +<DT><B>-N </B><I>NAME</I>,--name <I>NAME</I> + +<DD> +Sort by column with the name=<I>NAME</I> attribute. +<DT><B>-I </B><I>ID</I>,--id <I>ID</I> + +<DD> +Sort by column with the id=<I>ID</I> attribute. +<DT><B>-U </B><I>UCD</I>,--ucd <I>ucd</I> + +<DD> +Sort by column with the ucd=<I>UCD</I> attribute. +<P> +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>votsort</I> task is used to sort the rows of a VOTable either by +explicit column number (i.e. the <I>-c</I> flag), as a simple string sort +(i.e. the <I>-s</I> flag), or by an explicit 'name', 'id' or 'ucd' attribute +of the <FIELD> elements (the <I>-N</I>, <I>-I</I> and <I>-U</I> flags +respectively). If no column is specified explicitly by number or attribute, +then the first column will be used for sorting. By default, columns are +sorted in ascending order, the +<I>-d</I> flag can be used to force a descending sort of the column. +<P> + +Output is written to the stdout unless the <I>-o</I> flag is used to +name a specific output file. By default, a new VOTable will be written, +the <I>-f</I> flag can be used to specify a new format. Allowed formats +include: +<P> + +<I>vot</I> + +A new VOTable + +<I>asv</I> + +ASCII-separated (i.e. whitespace) values. + +<I>bsv</I> + +Bar-separated values. + +<I>csv</I> + +Comma-separated values + +<I>tsv</I> + +Tab-separated values + +<I>html</I> + +Standalone HTML document (entire table) + +<I>shtml</I> + +Single HTML table + +<I>fits</I> + +FITS bintable + +<I>ascii</I> + +ASV alias + +<I>xml</I> + +VOTable alias + +<I>raw</I> + +VOTable alias +<P> + +For formats such as CSV that normally +include column headers, the <I>-n</I> (or <I>--noheader</I>) flag may be used +to suppress this header. The FITS file produced will be an MEF containing +a bintable extension for each VOTable "<TABLE>" element. Column types and +names in this case come from the VOTable "<FIELD>" attributes. +<P> +If no input file is specified the VOTable will be read from the stdin, +results will be written to stdout unless the <I>-o</I> (or <I>--output</I>) +names an output file. The task will only process a single VOTable and may +not be used to convert multiple files in a single call. +<P> +<A NAME="lbAF"> </A> +<H2>RETURN STATUS</H2> + +On exit the <B>votsort</B> task will return a zero indicating success, or a +one indicating an error. +<P> +<A NAME="lbAG"> </A> +<H2>EXAMPLES</H2> + +<DL COMPACT> +<DT>1) Sort a VOTable based on first column<DD> +<P> +<PRE> + % votsort test.xml + % votsort <A HREF="http://generic.edu/test.xml">http://generic.edu/test.xml</A> + % cat test.xml | votsort -o sort_test.xml +</PRE> + +<P> +A string sort will be done automatically if this is a string-valued column, otherwise a numeric sort is done. +<DT>2) Sort a VOTable based on the magnitude column<DD> +<P> +<PRE> + % votsort --name=V test.xml +</PRE> + +<DT>3) Same as above, select 10 faintest stars<DD> +<P> +<PRE> + % votsort --name=V --desc --top=10 test.xml +</PRE> + +<DT>4) String sort based on object name, output as CSV<DD> +<P> +<PRE> + % votsort -s -f csv test.xml + % votsort --string --fmt=csv test.xml +</PRE> + +</DL> +<A NAME="lbAH"> </A> +<H2>BUGS</H2> + +No known bugs with this release. +<A NAME="lbAI"> </A> +<H2>Revision History</H2> + +Feb 2013 - First public release +<A NAME="lbAJ"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), Feb 2013 +<A NAME="lbAK"> </A> +<H2>SEE ALSO</H2> + +votget, votinfo, votcnv, votpos, votstat +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">RETURN STATUS</A><DD> +<DT><A HREF="#lbAG">EXAMPLES</A><DD> +<DT><A HREF="#lbAH">BUGS</A><DD> +<DT><A HREF="#lbAI">Revision History</A><DD> +<DT><A HREF="#lbAJ">Author</A><DD> +<DT><A HREF="#lbAK">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 05:13:27 GMT, April 14, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/votsort.man b/vendor/voclient/doc/votsort.man new file mode 100644 index 00000000..a3705822 --- /dev/null +++ b/vendor/voclient/doc/votsort.man @@ -0,0 +1,153 @@ +.\" @(#)votsort.1 1.0 Feb-2013 MJF +.TH VOTSORT 1 "Feb 2013" "VOClient Package" +.SH NAME +votsort \- Extract the main positional columns from a VOTable + +.SH SYNOPSIS +\fBvotsort\fP [\fI-opts\fP] votable.xml + +.SH OPTIONS +The \fIvotsort\fP task accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.TP 6 +.B \-c \fIN\fP,--col \fIN\fP +Sort by column number \fIN\fP (0-indexed). +.TP 6 +.B \-d,--desc +Sort in descending order. +.TP 6 +.B \-f \fIFORMAT\fP,--fmt \fIFORMAT\fP +Output format of sorted table. See description below for list of formats. +.TP 6 +.B \-o \fINAME\fP,--output \fINAME\fP +Output name of sorted file, if not specified results are written to stdout. +.TP 6 +.B \-s,--string +Perform a string sort of the columns. +.TP 6 +.B \-t \fIN\fP,--top \fIN\fP +Print the top \fIN\fP rows of the sorted table. +.TP 6 +.B \-i \fIN\fP,--indent \fIN\fP +XML indention level when writing a new XML document. +.TP 6 +.B \-n,--noheader +Suppress header information for formats other than XML and FITS. +.TP 6 +.B \-N \fINAME\fP,--name \fINAME\fP +Sort by column with the name=\fINAME\fP attribute. +.TP 6 +.B \-I \fIID\fP,--id \fIID\fP +Sort by column with the id=\fIID\fP attribute. +.TP 6 +.B \-U \fIUCD\fP,--ucd \fIucd\fP +Sort by column with the ucd=\fIUCD\fP attribute. + + +.SH DESCRIPTION +The \fIvotsort\fP task is used to sort the rows of a VOTable either by +explicit column number (i.e. the \fI-c\fP flag), as a simple string sort +(i.e. the \fI-s\fP flag), or by an explicit 'name', 'id' or 'ucd' attribute +of the <FIELD> elements (the \fI-N\fP, \fI-I\fP and \fI-U\fP flags +respectively). If no column is specified explicitly by number or attribute, +then the first column will be used for sorting. By default, columns are +sorted in ascending order, the +\fI-d\fP flag can be used to force a descending sort of the column. +.PP +Output is written to the stdout unless the \fI-o\fP flag is used to +name a specific output file. By default, a new VOTable will be written, +the \fI-f\fP flag can be used to specify a new format. Allowed formats +include: + +.in 15 +.I vot +A new VOTable +.in 15 +.I asv +ASCII-separated (i.e. whitespace) values. +.in 15 +.I bsv +Bar-separated values. +.in 15 +.I csv +Comma-separated values +.in 15 +.I tsv +Tab-separated values +.in 15 +.I html +Standalone HTML document (entire table) +.in 15 +.I shtml +Single HTML table +.in 15 +.I fits +FITS bintable +.in 15 +.I ascii +ASV alias +.in 15 +.I xml +VOTable alias +.in 15 +.I raw +VOTable alias + +.in 7 +For formats such as CSV that normally +include column headers, the \fI\-n\fP (or \fI\--noheader\fP) flag may be used +to suppress this header. The FITS file produced will be an MEF containing +a bintable extension for each VOTable "<TABLE>" element. Column types and +names in this case come from the VOTable "<FIELD>" attributes. + +If no input file is specified the VOTable will be read from the stdin, +results will be written to stdout unless the \fI\-o\fP (or \fI\--output\fP) +names an output file. The task will only process a single VOTable and may +not be used to convert multiple files in a single call. + +.SH RETURN STATUS +On exit the \fBvotsort\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Sort a VOTable based on first column + +.nf + % votsort test.xml + % votsort http://generic.edu/test.xml + % cat test.xml | votsort -o sort_test.xml +.fi + +A string sort will be done automatically if this is a string-valued column, otherwise a numeric sort is done. +.TP 4 +2) Sort a VOTable based on the magnitude column + +.nf + % votsort --name=V test.xml +.fi +.TP 4 +3) Same as above, select 10 faintest stars + +.nf + % votsort --name=V --desc --top=10 test.xml +.fi +.TP 4 +4) String sort based on object name, output as CSV + +.nf + % votsort -s -f csv test.xml + % votsort --string --fmt=csv test.xml +.fi +.SH BUGS +No known bugs with this release. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +votget, votinfo, votcnv, votpos, votstat diff --git a/vendor/voclient/doc/votsort.pdf b/vendor/voclient/doc/votsort.pdf Binary files differnew file mode 100644 index 00000000..d9cf5f86 --- /dev/null +++ b/vendor/voclient/doc/votsort.pdf diff --git a/vendor/voclient/doc/votstat.html b/vendor/voclient/doc/votstat.html new file mode 100644 index 00000000..5e09cae3 --- /dev/null +++ b/vendor/voclient/doc/votstat.html @@ -0,0 +1,122 @@ +Content-type: text/html + +<HTML><HEAD><TITLE>Manpage of VOTSTAT</TITLE> +</HEAD><BODY> +<H1>VOTSTAT</H1> +Section: User Commands (1)<BR>Updated: Feb 2013<BR><A HREF="#index">Index</A> +<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR> + +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +votstat - Compute statistics for numeric columns of a VOTable. +<P> +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +<B>votstat</B> [<I>-opts</I>] votable.xml +<P> +<A NAME="lbAD"> </A> +<H2>OPTIONS</H2> + +The <I>votstat</I> task accepts the following options: +<DL COMPACT> +<DT><B>-h, --help</B> + +<DD> +Print a help summary to the terminal and exit. No processing is done +following this flag. +<P> +<DT><B>-a,--all</B> + +<DD> +Print all columns, but only compute statistics for the numeric columns. +<DT><B>-o </B><I>NAME</I>,--output <I>NAME</I> + +<DD> +Output name of sorted file, if not specified results are written to stdout. +<DT><B>-n,--noheader</B> + +<DD> +Suppress header information for formats other than XML and FITS. +<P> +<P> +</DL> +<A NAME="lbAE"> </A> +<H2>DESCRIPTION</H2> + +The <I>votstat</I> task is used to compute statistics for columns of a table. +Output is written to the stdout unless the <I>-o</I> flag is used to +name a specific output file. If the <I>-a</I> flag is used, all columns +are printed but only the statistics of numeric columns is computed. +<P> +If no input file is specified the VOTable will be read from the stdin, +results will be written to stdout unless the <I>-o</I> (or <I>--output</I>) +names an output file. The task will only process a single VOTable and may +not be used to convert multiple files in a single call. +<P> +<A NAME="lbAF"> </A> +<H2>RETURN STATUS</H2> + +On exit the <B>votstat</B> task will return a zero indicating success, or a +one indicating an error. +<P> +<A NAME="lbAG"> </A> +<H2>EXAMPLES</H2> + +<DL COMPACT> +<DT>1) Print statistics for a VOTable<DD> +<P> +<PRE> + % votstat test.xml +</PRE> + +<P> +<DT>2) Print statistics for all column in a VOTable and save results to a file.<DD> +<P> +<PRE> + % votsort -a -o stats test.xml +</PRE> + +<P> +</DL> +<A NAME="lbAH"> </A> +<H2>BUGS</H2> + +The task should have a way to select specific columns or request specific +values. +<A NAME="lbAI"> </A> +<H2>Revision History</H2> + +Feb 2013 - First public release +<A NAME="lbAJ"> </A> +<H2>Author</H2> + +Michael Fitzpatrick (<A HREF="mailto:fitz@noao.edu">fitz@noao.edu</A>), Feb 2013 +<A NAME="lbAK"> </A> +<H2>SEE ALSO</H2> + +votget, votinfo, votcnv, votpos, votstat +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">OPTIONS</A><DD> +<DT><A HREF="#lbAE">DESCRIPTION</A><DD> +<DT><A HREF="#lbAF">RETURN STATUS</A><DD> +<DT><A HREF="#lbAG">EXAMPLES</A><DD> +<DT><A HREF="#lbAH">BUGS</A><DD> +<DT><A HREF="#lbAI">Revision History</A><DD> +<DT><A HREF="#lbAJ">Author</A><DD> +<DT><A HREF="#lbAK">SEE ALSO</A><DD> +</DL> +<HR> +This document was created by +<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>, +using the manual pages.<BR> +Time: 05:13:28 GMT, April 14, 2013 +</BODY> +</HTML> diff --git a/vendor/voclient/doc/votstat.man b/vendor/voclient/doc/votstat.man new file mode 100644 index 00000000..ab9532c8 --- /dev/null +++ b/vendor/voclient/doc/votstat.man @@ -0,0 +1,65 @@ +.\" @(#)votstat.1 1.0 Feb-2013 MJF +.TH VOTSTAT 1 "Feb 2013" "VOClient Package" +.SH NAME +votstat \- Compute statistics for numeric columns of a VOTable. + +.SH SYNOPSIS +\fBvotstat\fP [\fI-opts\fP] votable.xml + +.SH OPTIONS +The \fIvotstat\fP task accepts the following options: +.TP 6 +.B \-h, --help +Print a help summary to the terminal and exit. No processing is done +following this flag. + +.TP 6 +.B \-a,--all +Print all columns, but only compute statistics for the numeric columns. +.TP 6 +.B \-o \fINAME\fP,--output \fINAME\fP +Output name of sorted file, if not specified results are written to stdout. +.TP 6 +.B \-n,--noheader +Suppress header information for formats other than XML and FITS. + + +.SH DESCRIPTION +The \fIvotstat\fP task is used to compute statistics for columns of a table. +Output is written to the stdout unless the \fI-o\fP flag is used to +name a specific output file. If the \fI-a\fP flag is used, all columns +are printed but only the statistics of numeric columns is computed. + +If no input file is specified the VOTable will be read from the stdin, +results will be written to stdout unless the \fI\-o\fP (or \fI\--output\fP) +names an output file. The task will only process a single VOTable and may +not be used to convert multiple files in a single call. + +.SH RETURN STATUS +On exit the \fBvotstat\fP task will return a zero indicating success, or a +one indicating an error. + +.SH EXAMPLES +.TP 4 +1) Print statistics for a VOTable + +.nf + % votstat test.xml +.fi + +.TP 4 +2) Print statistics for all column in a VOTable and save results to a file. + +.nf + % votsort -a -o stats test.xml +.fi + +.SH BUGS +The task should have a way to select specific columns or request specific +values. +.SH Revision History +Feb 2013 - First public release +.SH Author +Michael Fitzpatrick (fitz@noao.edu), Feb 2013 +.SH "SEE ALSO" +votget, votinfo, votcnv, votpos, votstat diff --git a/vendor/voclient/doc/votstat.pdf b/vendor/voclient/doc/votstat.pdf Binary files differnew file mode 100644 index 00000000..ef2864bf --- /dev/null +++ b/vendor/voclient/doc/votstat.pdf |