ISAcreator is the ISAtools Java-based desktop editor for producing ISA-Tab files.
For programmatic management of ISA metadata for experimental descriptions (ISA-Tab and ISA-json representations), please check the ISA-API, which is a Python-based API to parse, create, convert ISA metadata among other functionality.
To run ISAcreator locally:
./compile.sh
). This script runs the maven command (mvn assembly:assembly -Dmaven.test.skip=true -Pbuild
) after downloading the required configuration (without which the tests will fail) and example ISAtab files. The build profile automatically sets some system variables, such as version, from information held within the pom.java -cp target/ISAcreator-<version number>.jar org.isatools.isacreator.launch.ISAcreatorApplication
)You should read this article about Github Flow: http://scottchacon.com/2011/08/31/github-flow.html. Although we don't strictly use Github flow, it's a really useful tutorial on how to use Git for collaborative development.
Ensure you have maven 2.2.1 installed and enabled as well as git. If you have trouble with dependencies, and you are running behind a proxy, please ensure you set the proxy in both MAVEN_OPTS and settings.xml. See here for more information.
git checkout -b myisacreator
)mvn clean test
)git commit -am "Added something useful"
)git push origin myisacreator
)A simple git pull git@github.com:ISA-tools/ISAcreator.git
Instead of using your native OS environment, we have provided a Vagrant configuration in which you can build ISAcreator inside an Ubuntu VM. For instructions on installing and using Vagrant, see https://www.vagrantup.com/docs/installation/
Once you have Vagrant installed, just open a terminal window to the root of the ISAcreator project, and type vagrant up
. After a log of log messages, eventually it should finish with a success message.
Then do vagrant ssh
to log into the Ubuntu VM. From here do cd /vagrant/
which maps to your project root.
Then run ./Vagrant-bootstrap.sh
to install Java and Maven build tools. If all went well, your build environment should be ready to use ./compile.sh
and ./package.sh
.
Note: this builds using OpenJDK Java 1.7 and Maven 3.
Before we can accept any contributions to ISAcreator, you need to sign a CLA:
Please email us at isatools@googlegroups.com to receive the CLA. Then you should sign this and send it back asap so we can add you to our development pool.
The purpose of this agreement is to clearly define the terms under which intellectual property has been contributed to ISAcreator and thereby allow us to defend the project should there be a legal dispute regarding the software at some future time.
For a list of contributors, please see http://github.com/ISA-tools/ISAcreator/contributors
CPAL License, available at https://raw.githubusercontent.com/ISA-tools/ISAcreator/master/LICENSE.txt