Skip to content

Commit

Permalink
🚢 EscherConverter 1.0 release.
Browse files Browse the repository at this point in the history
  • Loading branch information
devkhan committed Aug 21, 2016
1 parent f3cbb13 commit ee80fce
Show file tree
Hide file tree
Showing 3 changed files with 30 additions and 51 deletions.
68 changes: 24 additions & 44 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,58 +1,38 @@
# EscherConverter
# EscherConverter<sup>1.0</sup> [![Build Status](https://travis-ci.org/SBRG/EscherConverter.svg?branch=master)](https://travis-ci.org/SBRG/EscherConverter)

EscherConverter is a standalone program that reads files created with the graphical network editor [Escher](http://escher.github.io) and converts them to files in community standard formats.

## Using EscherConverter
## Quick-start

Escher uses a JSON file format to represent its networks. This format has been developed because of its very small file size and its compatibility to online programs that are written in JavaScript. In particular, JSON is a JavaScript Object Notation, or in other words, a JSON file directly represents components of JavaScript programs. This makes parsing very simple and allows direct use of those files in web-based programs.
**Try out the live web version [here](http://139.59.18.143/).**

However, in systems biology, specific file formats have been developed with the aim to be easily exchangeable between software implemented in diverse programming languages.
#### OR

To this end, these formats support semantically clear annotations and are maintained by a large community of scientists. EscherConverter supports export to two particularly important XML-based community file formats SBML with layout extension and SBGN-ML.
Get a local copy of EscherConverter from [here](https://github.com/SBRG/EscherConverter/releases/latest). As a Java™ application, the only thing needed is a valid Java(JRE) 8+ installation present. After that you can either open the JAr by double-clicking it or use it from the command line as below.

While SBML has been mainly developed for dynamic simulation of biological networks, it is nowadays also usable for diverse other purposes. Its layout extension facilitates the encoding the display of biological networks.

SBGN-ML has been directly developed as a language for the display of biological pathway maps of diverse kinds. It stores the position and connection of entities, similar to what is shown in Escher networks.

EscherConverter takes Escher’s JSON files as input and generates equivalent SBML Level 3 Version 1 files with layout extension or SBGN-ML files.

In order to ensure that the conversion is correct, EscherConverter provides its own display that gives users a preview of how the export data format will be rendered by other tools. In this preview display, you can zoom in and out, move arcs and node positions. However, it is important to know that none of the changes made in this preview are stored in the export file.

## Download and Installation

You can obtain local copy of EscherConverter by clicking [here](https://github.com/SBRG/EscherConverter/releases/latest/).

As a Java™ application, no specific installation is required for EscherConverter.

However, make sure you have a recent Java™ Runtime Environment (JRE) installed on your computer (at least JRE 8). You can obtain Java™ from the Oracle website. There you can also find installation instructions for your respective operating system.
On Unix-like system (Ubuntu, Fedora, macOS, etc.):
```
bash$ java -jar -Xms8G -Xmx8G -Duser.language=en ./EscherConverter.jar --help
```
On Windows:
```
C:\> javaw -jar -Xms8G -Xmx8G -Duser.language=en EscherConverter-0.5 --help
```

Once Java™ has been installed, you can simply place the EscherConverter JAR file somewhere on your local computer, for instance in the folder
* `/Applications/` if you are working under Mac OS
* `/opt/` for Linux computers
* `C:\Program Files\` if you are using Windows

## Launching the program
### Need to know more?

You can launch EscherConverter simply by double-clicking on the application JAR file. This will open a following graphical user interface.
Head over to the wiki.

## Included third-party software

EscherConverter includes several third-party libraries, which we here list and acknowledge:
* ArgParser
* JSBML
* libSBGN
* Pixel-Mixer icons
* yFiles (only in the first version)

## Command-line interface API

You can launch EscherConverter from the command-line. On a Unix system (such as Linux, MacOS, or Solaris, etc.), use a command like:
```
bash$ java -jar -Xms8G -Xmx8G -Duser.language=en ./EscherConverter-0.5.jar [options]
```
Under Window, use a command like:
```
C:\> javaw -jar -Xms8G -Xmx8G -Duser.language=en EscherConverter-0.5.jar [options]
```

Escher has a large collection of command-line options, which can be useful if you want to launch the program with specific settings or if multiple files are to be converted in a batch mode. It is even possible to completely disable the graphical user interface. When launching EscherConverter with the option `--help` or `-?` you will receive more information about possible options. In the graphical user interface, you can find the full list of command-line options in the online Help menu.
* ArgParser
* JSBML
* libSBGN
* Pixel-Mixer icons
* yFiles (only in the first version)
* Jackson

##### Author: Andreas Dräger (@draeger)
##### Maintainer: Devesh Khandelwal (@devkhan)
11 changes: 5 additions & 6 deletions frontend/package.json
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
{
"name": "EscherConverter",
"version": "0.0.1",
"description": "Mr. Plumpy Senior",
"main": "EscherConverter/app.coffee",
"version": "1.0.0",
"description": "EscherConverter is a standalone program that reads files created with the graphical network editor Escher and converts them to files in community standard formats.",
"main": "EscherConverter/app.js",
"scripts": {
"start": "brunch w -s",
"build": "brunch b -p",
"deploy": "sh deploy.sh"
},
"author": "Devesh Khandelwal <[email protected]>",
"license": "MIT",
"repository": "devkhan/EscherConverter",
"repository": "SBRG/EscherConverter",
"dependencies": {
"auto-reload-brunch": "^2.2.0",
"autoprefixer": "^6.3.6",
Expand All @@ -26,8 +26,7 @@
"picnic": "^6.1.2",
"postcss-brunch": "^0.5.0",
"stylus-brunch": "^2.6.0",
"uglify-js-brunch": "^2.0.1",
"zepto": "^1.2.0"
"uglify-js-brunch": "^2.0.1"
},
"devDependencies": {
"babel-brunch": "^6.0.5",
Expand Down
2 changes: 1 addition & 1 deletion pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
<!-- =================================================================== -->

<name>${project.artifactId}</name>
<version>0.6</version>
<version>1.0.0</version>
<url>https://github.com/SBRG/EscherConverter</url>
<inceptionYear>2015</inceptionYear>
<description>EscherConverter is a stand-alone program that reads files created with the graphical network editor Escher and converts them to files in community standard formats.</description>
Expand Down

0 comments on commit ee80fce

Please sign in to comment.