An HTTP client for consuming OpenTox predictive toxicology web services.
Java
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Licenses
ToxOtis-benchmark
ToxOtis-core
ToxOtis-db
ToxOtis-janitor
ToxOtis-persistence
doc
README.textile
build.xml
deploy.sh
maven-build.xml
pom.xml

README.textile

Τοξότης : Core Project

About

Version:
+ 0.8.4 (Available from the NTUA Maven repository).

Authors:
+ Sopasakis Pantelis
+ Charalampos Chomenidis

Description:
+ ToxOtis is the Greek word for Sagittarius, that actually means ‘archer’. ToxOtis is a Java interface to the predictive toxicology services of OpenTox. ToxOtis is being developed to help both those who need a painless way to consume OpenTox services and for ambitious service providers that don’t want to spend half of their time in RDF parsing and creation.
+ You can use ToxOtis to search in databases with chemical compounds, download a compound in any supported MIME type (e.g. SDF, SMILES, MOL etc), find a property for a compound (e.g. its LD50 lethal dose concentration), publish your chemicals in an online database, train QSAR models (regression, classification, clustering etc) and lots of other functionalities. Incorporation of ToxOtis into your services will relieve you from the labour of creating RDF documents.
+ You can find full documentation at the doc directory including lots of examples. For any questions don’t hesitate contact to the authors by sending a message to alphaville or hampos (on github ).

Quality Control:
+ For every piece of code introduced in ToxOtis we write extensive unit tests. Recently (since version 0.8.2) we started using the Cobertura Maven plugin calculate our overall code coverage in ToxOtis-core (which was found to be 41% – fair enough!). You can access the report online here .

Documentation:
You will find numerous examples and hints on our wiki page. Additionally, the source code is accompanied by javadoc that is available on our Nexus repository.

Use ToxOtis

With Maven

Recently ToxOtis migrated to Maven so it becomes really easy for you to use ToxOtis in your Maven projects. ToxOtis, since version 0.5.2 (beta) is deployed on the AMBIT repository as a 3rd-party ‘artifact’. So, if you want to include the “core” module of ToxOtis in your project, simply put the following dependency in the pom file of your project:
<dependencies>
  <!-- ToxOtis Dependency -->
  <dependency>
    <groupId>org.opentox.toxotis</groupId>
    <artifactId>ToxOtis-core</artifactId>
    <version>0.8.4</version>
  </dependency>
  <!-- Other Dependencies you might have... -->
</dependencies>

and add once the following repository:

<repositories>
  <!-- NTUA Repository -->
  <repository>
    <id>ntua-public</id>
    <url>http://opentox.ntua.gr:8081/nexus/content/repositories/public/</url>
    <snapshots>
      <enabled>false</enabled>
    </snapshots>
  </repository>
</repositories>

With Ant

If you prefer the ant-based ToxOtis the build.xml files are also distributed along with the source code. Alternatively run mvn ant:ant and create your own XML files for ant. Alternatively, you can download the latest version from our Nexus repository and add it to your classpath.

Source Code and Javadoc

You can manually download the latest version of the source code of ToxOtis from github either in zip or tar.gz format (click on the “Downloads” button). This is most likely to be a SNAPSHOT version. If you want the source code and/or the javadoc for a particular release version, here is an example source code (just choose the version you prefer):
<!-- Dependency for Javadoc -->
<dependency>
  <groupId>org.opentox.toxotis</groupId>
  <artifactId>ToxOtis-core</artifactId>
  <version>0.8.4</version>
  <classifier>javadoc</classifier>
</dependency>
<!-- Dependency for Sources -->
<dependency>
  <groupId>org.opentox.toxotis</groupId>
  <artifactId>ToxOtis-core</artifactId>
  <version>0.8.4</version>
  <classifier>sources</classifier>
</dependency>

Features

Freely distributed

This project is licensed under the GNU GPL license version 3.0. A copy of this license is found in the ./Licenses folder. Licenses for all dependencies of this project are also included in this directory.

This project is being developed in the Automatic Control Lab of the School of Chemical Engineering, NTUA, Athens, Greece and is part of OpenTox; an EU funded FP7 research project.

Extensible

We work on various extensions for ToxOtis including modules that will facilitate external developers towards builing their own web service applications or applications that need to consume OpenTox web services as client. Modules that provide extra security mechanisms and local account management, Hibernate support for ToxOtis to provide persistence for all core ToxOtis objects (Datasets, Algorithms, Models etc), Triple-storage database support (TDB) and lots of other features are under design and construction. The first release of ToxOtis-Persistence, a persistence module for ToxOtis, provides hibernate support for the core project.

License

This project, as well as all other projects developed by the NTUA developers team under OpeTox, is licensed under the GNU GPL license version 3. There is a considerable debate taking place in the open source community regarding the use of the GPL or LGPL, while a variety of other licenses can be found on the web as well. However it is GNU itself that prompts developers to use GPL (read this article). The license of this project (ToxOtis) is also inherited by its modules (ToxOtis-core, ToxOtis-persistence and ToxOtis-benchmark). Information about the licenses of the project are also provided in its pom.xml file including information about the involved developers and organizations.

Stay Tuned

Follow isToxic on Twitter and stay tuned with the latest updates!