{"id":16874145,"url":"https://github.com/olebole/voclient","last_synced_at":"2025-03-18T22:36:25.508Z","repository":{"id":70870855,"uuid":"170281077","full_name":"olebole/voclient","owner":"olebole","description":"VO Client Libraries and Tasks (C/C++) ","archived":false,"fork":false,"pushed_at":"2019-02-12T08:33:34.000Z","size":32480,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-25T00:13:23.372Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/olebole.png","metadata":{"files":{"readme":"README","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-02-12T08:30:31.000Z","updated_at":"2019-02-12T08:32:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"b27e6535-91a4-45f5-9f94-270f1de354c1","html_url":"https://github.com/olebole/voclient","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olebole%2Fvoclient","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olebole%2Fvoclient/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olebole%2Fvoclient/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olebole%2Fvoclient/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/olebole","download_url":"https://codeload.github.com/olebole/voclient/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244320073,"owners_count":20434088,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-13T15:29:47.041Z","updated_at":"2025-03-18T22:36:25.487Z","avatar_url":"https://github.com/olebole.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\t     VOClient v1.0 -- VO Interfaces and Applications\n\t     -----------------------------------------------\n\n\t\t        Last Revised 12/27/13\n\n\n\n\tThe VOClient package is a collection of programming APIs and\ncommand-line tools that provide a user-ready VO software distribution for\nboth scientists and developers.  The initial release of the package is\nintended primarily to distribute the completed CLI tools, additional tasks\nare planned as new functionality is added to the libraries and as new\nstandards come on-line in the VO.  \n\n\tAlthough the underlying libraries are included in this release \nand are fully functional, they lack the documentation and multi-language\ninterfaces we have planned for the final vision of the package.  We \nexpect a release that better supports developers will be available in\nmid-2013.  Later releases will contain additional interfaces and tasks\nas needed.\n\n\n    README\t\t- This file\n    TODO\t\t- ToDo list\n\n    Makefile\t\t- Top-level makefile\n    configure\t\t- pseudo autonf package configuration script\n    install_env\t\t- package installation environment defs\n\n    bin\t\t\t- application binaries\n    doc\t\t\t- documentation, design notes, etc\n    include\t\t- library include files\n    lib\t\t\t- libraries\n\n    common\t\t- shared dependency library codes\n    libsamp\t\t- SAMP interface\n    libvo\t\t- VOTable parser\n    libvoclient\t\t- Client side service code\n    libvotable\t\t- VOTable parser\n\n    voapps\t\t- CLI application source code\n    voclient\t\t- Java VOClient Daemon source code\n\n    test-data\t\t- sample test data files\n    testscripts\t\t- sample task test scripts\n\n\nNOTE:   The 'test-data' directory may contain some files that are used by\n\tthe task unit tests, but are generally of no interest to most users.\n\tUsers who are developing applications using the various interface\n\tlibraries may find the sample files in this directory useful when\n\ttesting new applications, however these are not meant to be a\n\tcomplete collection of sample data available from the VO.\n   \n\nContents:\n\n    1)  CLI Task Summary\n    2)  Client-Side Libraries\n    3)  Using Pre-Built Binaries\n    4)  Building VOClient from Source\n      4.1)  Specifying the Install Directory\n    5)  Supported Platforms\n      5.1)  Platform Dependencies\n    6)  Revision History\n    7)  Help and Contact Info\n\n\n===============================================================================\n\n\n1)  CLI Task Summary\n--------------------\n\n\tThe VOClient package includes a number of command-line utilities\nbuilt from the underlying interfaces.  These tasks can be scripted from any\nnumber of environments or used in a standalone manner.  \n\nTasks distributed as part of this release include:\n\n  DATA ACCESS UTILITIES\n\n        voatlas - Query the SkyView Image service for an all-sky image\n      vocatalog - Query VO catalog services for data\n         vodata - query and access VO data services\n        voimage - Query VO image services for data\n      votiminfo - Print/Get information about a FITS file's structure\n      vospectra - Query VO spectral services for data\n        votopic - Query for data from resources specified by topic keyword\n\n  DESKTOP MESSAGING UTILITIES\n\n         vosamp - Commandline SAMP utility\n\n  NAME RESOLUTION UTILITIES\n\n       vosesame - call the Sesame name resolver service\n\n  REGISTRY UTILITIES\n\n     voregistry - VO Registry search client\n\n  VOTABLE UTILITIES\n\n         votcnv - Convert from VOTable to another format\n         votget - Download URLs or access references in a VOTable\n        votinfo - Get information about a VOTable\n         votpos - Extract the main positional columns from a VOTable\n        votsort - Extract the main positional columns from a VOTable\n        votstat - Compute statistics for numeric columns of a VOTable.\n\n\n    Additional tasks will be added as interfaces are expanded and new\ncapabilities are added to the system.\n\n\n2)  Client-Side Libraries\n-------------------------\n\n    The VOClient provides a number of APIs to support developers building\nscience applications of their own, or for use in other environments. These\nlibraries are implemented in C and provide additional bindings for a number\nof VO supported languages.  Each interface is fully documented and higher-\nlevel \"User's Guide\" documentation is planned for each interface.\n\n\n  libVOApps         High-level interface to application functionality.\n                    Tasks are built on these routines to provide the\n                    cmdline user interface, but are encapsulated in an\n                    API to provide this functionality to other environ-\n                    ments easily (as opposed to having that functionality\n                    be re-implemented using the low-level interfaces).\n\n  libVOTable        A VOTable parser library.  The interface provides\n                    both read (lax parsing) and write (strict compliance)\n                    capabilities.  Reference is VOTable v1.2.\n\n  libVOClient       A VO Service interface library.  This interface uses\n                    the VOClient Daemon to access a variety of VO web\n                    services (Registry, Sesame, DAL services, etc) which\n                    then communicate to the API to pass information back\n                    to the application.\n\n  libsamp           Client-side SAMP interface library.  This interface\n                    allows an application to send and receive SAMP\n                    messages but does NOT (at this time) provide a local\n                    Hub implementation.  Applications can register their\n                    own functions to be used as callbacks in response to\n                    a message, the API provides only the middle-ware needed\n                    to handle the SAMP protocol.\n\n  libVO       \t    A combined library containing the above interfaces and\n\t\t    their dependent system libraries (e.g. cURL, eXpat, etc).\n\t\t    This is a convenience library to allow simplified linking\n\t\t    of applications and is used primarily in the IRAF/VO\n\t\t    task interface.\n\n\n3)  Using Pre-Built Binaries\n----------------------------\n\n\tPre-built binary distributions are available containg both source\nand binaries for a specific platform.  These distribution names are of the\nform\n\tvoclient-\u003cversion\u003e-bin.\u003carch\u003e.tar.gz\n\nThey may be unpacked with the command\n\n\ttar zxf /\u003cpath\u003e/voclient-\u003cversion\u003e-bin.\u003carch\u003e.tar.gz\n\nThis will produce a 'voclient' subdirectory containing the unpacked\ndistribution.  Within that directory you'll find the following important\ndirectories needed to install the package on the system:\n\n\tbin/\t\tTask binaries\n        doc/            Task man pages, HTML and PDF\n\tlib/\t\tAPI library files\n\tinclude/\tProgram header files\n\nThe contents of these directories should be copied to some system directory\navailable in the normal user paths.  For example, to install in /usr/local\n\n\t% cd /\u003cpath\u003e/voclient\n\t% sudo cp bin/* /usr/local/bin\n\t% sudo cp lib/* /usr/local/lib\n\t% sudo cp include/* /usr/local/include\n\t% sudo cp doc/* /usr/local/man/man1\n\nWhen compiling new applications the appropriate '-I' and '-L' flags will\nneed to be set to find the libraries and include files needed.  The binary\ninstallation directory should be some directory in the normal $PATH\nenvironment setting.\n\n\n4)  Building VOClient from Source\n---------------------------------\n\n    The source distribution of the release is contained in the file\n\n\tvoclient-src.tar.gz\n\nIt may be unpacked with the command\n\n\ttar zxf /\u003cpath\u003e/voclient-src.tar.gz\n\nThis will produce a 'voclient' subdirectory containing the unpacked\ndistribution.  A standard build sequence then consists of the commands:\n\n\t% ./configure\n\t% make \n\t% make install\n\nBy default, this sequence will install the voclient package under\n/usr/local.  That is, \"make install\" will copy files into the following\nsubdirectories of /usr/local:\n\n        bin/            Task binaries\n        lib/            API library files\n        include/        Program header files\n        man/man1/       Task man pages\n\nThus, you need to run at least \"make install\" as root.  If these\ndirectories do not exist, they will be created automatically if you run\n\"configure\" as root as well.\n\n\n4.1)  Specifying the Install Directory\n--------------------------------------\n\nTo specify an alternate install directory, the 'configure' script may be used\nas:\n\t./configure [ \u003copts\u003e=\u003cval\u003e | \u003copt\u003e \u003cval\u003e ]\n \nWhere options include:\n\n\t    -h  -help    --help         print a help summary\n            -p  -prefix  --prefix       set global path prefix\n            -b  -bindir  --bindir       task bin directory\n            -i  -incdir  --incdir       include file directory\n            -l  -libdir  --libdir       library directory\n            -m  -mandir  --mandir       man page directory\n \nFor example, the following commands are all equivalent for setting the global\ninstall path prefix to /opt/local:\n \n        % ./configure --p /opt/local\n        % ./configure -prefix /opt/local\n        % ./configure --prefix /opt/local\n        % ./configure -p=/opt/local\n        % ./configure -prefix=/opt/local\n        % ./configure --prefix=/opt/local\n\nThe individual path options to the configure script may be used to specify \npaths for each component of the install.\n\nNote:  \tThe 'configure' command in this case is not a true autoconf script,\n       \tbut simply a utility to provide a familiar interface.  The script\n\twrites the file \"install_env\" in the voclient source directory to\n\tspecify the paths used in the 'make install' command, it is possible\n\tto edit this file by hand to specify the paths.\n\n\n5)  Supported Platforms\n-----------------------\n\n    This release currently supports the following platforms:\n\n    Mac OSX\t\t32-bit and 64-bit Intel, OSX 10.6 and later\n    Linux 32-bit\t32-bit Linux systems (Fedora, Redhat, Ubuntu, etc)\n    Linux 64-bit\t64-bit Linux systems (Fedora, Redhat, Ubuntu, etc)\n\nAdditional platforms will be added as needed.\n\n    Compilation flags are used to provide compatibility for OSX 10.4 on\n32-bit systems, and OSX 10.5 on 64-bit systems, however these have not been\nverified to work.  Linux support should be reasonably independent of platform\nand has been tested on the most common distributions released within the\nlast few years.\n\n5.1)  Platform Dependencies\n----------------------------\n\n\tThe 'voclientd' process used in the initial release requires that\nJava is available on the machine (Java 1.5 or later).  On recent OSX 10.9\n(Mavericks) systems, and perhaps with some Linux distributions as well, \nJava must be installed separately before the tasks can be used.\n\n\n\n6)  Revision History\n--------------------\n\n12/27/13\t    Initial Release v1.0\n\n\n7)  Help and Contact Info\n-------------------------\n\n    For help, questions or suggestions please feel free to contact \nMike Fitzpatrick (fitz@noao.edu) or the VAO Help Desk at\n\n\thttp://www.usvao.org/contact-connect/\n\nQuestions may also be posted the VAO forums at\n\n\thttp://astrobabel.net\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Folebole%2Fvoclient","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Folebole%2Fvoclient","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Folebole%2Fvoclient/lists"}