Installation of 3D-e-Chem KNIME nodes

Requirements:

KNIME, https://www.knime.org, version 4.3 or higher

Steps to get the 3D-e-Chem nodes inside KNIME:

Goto File > Install KNIME extensions ... menu
Expand the KNIME Community nodes - Cheminformatics folder
Select 3D-e-Chem KNIME nodes
Install software
Restart KNIME

Some nodes need Python packages, those nodes have install instructions in their node description and print a warning when attempting to run them without the required Python package.

Setup

Each KNIME node developed in the 3D-e-Chem project has it own Github repository, Eclipse feature and Eclipse plugin.

The update site https://3d-e-chem.github.io/updates contains the Eclipse features of all the 3D-e-Chem developed nodes. When using this update site in KNIME, it will list all the nodes by their repository.

This update site https://3d-e-chem.github.io/knime-node-collection contains a single Eclipse feature which combines all the 3D-e-Chem developed nodes. When using this update site in KNIME, it will list a single feature for all 3D-e-Chem nodes.

Cons of using this repo:

New nodes need to be tracked in the feature/feature.xml file
Each update of a node requires a new release of this repo aswell
License is for all nodes together instead of separate license for each node
Maintenance overhead of 2 update sites (1. only one 3D-e-Chem nodes feature, 2. set of 3D-e-Chem node features)

Pros of using this repo:

Single checkbox to install all 3D-e-Chem nodes
Integrated into KNIME Community Contributions update site under KNIME Community nodes - Cheminformatics folder. Users do not need to configure an extra update site.

So to have the latest version of each node you should use https://3d-e-chem.github.io/updates, but for stable releases use https://3d-e-chem.github.io/knime-node-collection.

Adding a new KNIME node

To include a KNIME node into the 3D-e-Chem KNIME nodes feature, it's plugin(s) and optional 3D-e-Chem dependencies must be added to the feature/feature.xml file. Followed by making a new release, see below.

Adding a new version of a KNIME node

The updated KNIME node can be included in the 3D-e-Chem nodes feature by making a new release, see below.

Build

mvn verify

An Eclipse update site will be made in p2/target/repository repository. The update site can be used to perform a local installation.

Development

Steps to get development environment setup based on https://github.com/knime/knime-sdk-setup#sdk-setup:

Install Java 8
Install Eclipse for RCP and RAP developers
Configure Java 8 inside Eclipse Window > Preferences > Java > Installed JREs
Import this repo as an Existing Maven project
Add http://update.knime.org/analytics-platform/4.0 and https://3d-e-chem.github.io/updates to list of update sites

During import the Tycho Eclipse providers must be installed.

New release

Make sure the local clone of this repo is up to date using
```
git pull
```
Make sure all included plugins are up to date on https://3d-e-chem.github.io/updates or https://github.com/3D-e-Chem/3D-e-Chem.github.io/tree/master/updates
Learn current version by looking in ./pom.xml file for the <version>x.y.z-SNAPSHOT</version> tag.
Increase version. Increase minor version when KNIME node has been added or removed. Increase patch version when KNIME node has been updated. Use following command to update multiple xml files with the new version.
```
mvn org.eclipse.tycho:tycho-versions-plugin:set-version -DnewVersion=<new version>-SNAPSHOT
```
Commit changes
Update docs/4.3/ directory with new update site using
```
mvn install
```
Stage new files, commit and push changes.
```
git add docs/
git commit -a
git push
```
For major or minor release

add message to https://www.knime.com/forum/3d-e-chem-nodes
create a GitHub release and DOI entry