annotate OPPL/README @ 15:622cde484f4c draft

Add new tool to perform OPPL queries

INSTALLATION
============

1.- Stop Galaxy.

2.- Copy the following files and dirs to
/galaxy-dist/tool-data/shared/jars/:

oppl_galaxy_tool.jar
inference.jar
query.jar
oppl_query.jar
oppl_galaxy_lib/
inference_lib/
query_lib/
oppl_query_lib/
FaCT++-linux-v1.5.2/ 
FaCT++-OSX-v1.5.2/
 
3.- Create directory /galaxy-dist/tools/OPPL/

4.- Copy oppl.xml, inference.xml and query.xml to
/galaxy-dist/tools/OPPL/

5.- Add the following lines to /galaxy-dist/tool_conf.xml:

  <section name="Ontology Pre Processor Language" id="oppl">
    <tool file="OPPL/oppl.xml"/>
    <tool file="OPPL/inference.xml"/>
    <tool file="OPPL/query.xml"/>
    <tool file="OPPL/oppl_query.xml"/>   
  </section>

6.- Start Galaxy.



FORESEEN FEATURES
=================

General (OPPL, Inference, Query, OPPL query):

- Support for processing ontologies that import other ontologies loaded
in galaxy.

- Entities rendering definition (URI fragment, rdfs:label, QName, etc).

- OWLLink and Racer support.


OPPL:

- Standalone OPPL assertions parsing (e.g. ADD phagocyte subClassOf
cell).

- Other output formats apart from RDF/XML.


Inference:

- Support for DataPropertyAssertion, DataPropertyHierarchy,
DifferentIndividuals, ...

OPPL query:



KNOWN BUGS AND ISSUES
=====================

Currently Galaxy interprets any information thrown to stderr as a tool
error, which is bad since OPPL (And many other tools) throw info to 
sdterr even if working properly. In OPPL Galaxy, stderr is redirected
to /dev/null to avoid the problem, but that means that OPPL Galaxy does
not fail gracefully (It simply stops). A wrapper will be implemented.

http://wiki.g2.bx.psu.edu/Future/Job%20Failure%20When%20stderr



CONTACT
=======

Please send any request or comment to [e-mail].



ACKNOWLEDGEMENTS
================

This work is funded by the Marie Curie Cofund program of the EU, FP7.



COPYRIGHT AND LICENSE
=====================

Copyright (c) 2011 Mikel Egaña Aranguren. 

(OPPL|Inference|Query)-Galaxy 
is free software: you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free
Software Foundation, either version 3 of the License, or (at your
option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

OPPL API, OWL API, Pellet, HermiT, and FaCT++ have their own licenses.