From 5105d11bc006cbd76290cde59782b4ef8c57646c Mon Sep 17 00:00:00 2001 From: Nathanael Jourdane Date: Thu, 17 Mar 2016 16:51:26 +0100 Subject: [PATCH] Add readme for VOTable et EpnTapClient --- README.md | 15 +++++++++++++++ src/main/java/eu/omp/irap/vespa/epntapclient/votable/README.md | 34 ++++++++++++++++++++++++++++++++++ 2 files changed, 49 insertions(+), 0 deletions(-) create mode 100644 src/main/java/eu/omp/irap/vespa/epntapclient/votable/README.md diff --git a/README.md b/README.md index e69de29..09483fe 100644 --- a/README.md +++ b/README.md @@ -0,0 +1,15 @@ +# EpnTAPClient + +The goal of this application is to provide get VOTable data from services which support implements epn-core. + +## Dependencies + +You need java 7 to execute EpnTAPClient. + +## GUI usage + +Simply right-click on the jar and select *Open with* -> *Oracle Java 7 RunTime* (for example). + +## CLI usage + +No CLI usage are provided for now but this is planned. \ No newline at end of file diff --git a/src/main/java/eu/omp/irap/vespa/epntapclient/votable/README.md b/src/main/java/eu/omp/irap/vespa/epntapclient/votable/README.md new file mode 100644 index 0000000..653ced2 --- /dev/null +++ b/src/main/java/eu/omp/irap/vespa/epntapclient/votable/README.md @@ -0,0 +1,34 @@ +# VOTable + +## Context + +This library aims to provide a simple way to parse and view VOTables. The goal is to make the code +reusable and as light as possible. + +## Usage in command-line interface + +### 1. Reading a VOTable from an XML file + + VOtableApp pathToVOTable + +- `pathToVOTable`: The path to your VOTable, ie `~/dowloads/my_votable.xml`. + +This will display the VOTable stored in the specified XML file, through a minimalist window. + +### 2. Reading a VOTable from an on-line service + + VOtableApp targetURL type language query + +This will display the VOTable resulting the service or registry request. + +- `targetURL`: The URL of the service or registry to ask, ie `http://cdpp-epntap.cesr.fr`; +- `language`: The language of the query, ie `ADQL`; +- `query`: The query in the specified language in double quotes, ie. `"SELECT * FROM amdadb.epn_core"` + +## Usage from a Java library + +Here is a start: + + VOTableController myVOTableController = new VOTableController(REGISTRY_URL, "ADQL", QUERY); + +See the Javadoc for more informations. \ No newline at end of file -- libgit2 0.21.2