1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
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>
|
