Code Monkey home page Code Monkey logo

bonesim's Introduction

/*
 * README
 * 
 * Copyright 2012 Chaitanya Talnikar <[email protected]>
 * 
 */
 
Welcome to the biographer simulator.

The simulator uses a Makefile to manage the project. make by default
executes the directive 'all' which consists of 'lint', 'doc', 'test' and
'pkg'. 
The simulator source code does not consist of any external libraries
by default and they have to be fetched and installed.

Build libs:
1. If you are using Ubuntu, install necessary dependences to test and 
build the software by typing in the terminal:
    make deps
Otherwise please refer below for a list of dependencies:
    #required to build bui
    nodejs
    npm
    node-uglify
    #required to build libSBGN.js
    ant
    git-core(git)
    #required for creating documentation
    jsdoc-toolkit(jsdoc)
    #required for the offline app
    libqtwebkit4
    python-qt4
    #required for lint code check
    jshint
    #required for unit testing
    selenium python api
    chromedriver(selenium webdriver)
    
2. Fetch and build the libs by executing the command:
    make libs
The above commands adds the following libs:
    biographer-ui
    d3.js
    libSBGN.js
    
3. To support SBML files in the simulator the biographer server needs to 
be setup. Please read the README in the server folder. 
    
4. For testing purposes if you are using Chrome you need to download the
Chrome WebDriver available at the following url:
    http://code.google.com/p/chromedriver/downloads/list
Download the linux zip depending on your architechture and install it using 
the commands:
    tar -xvf chromedriver*.zip
    sudo cp chromedriver /usr/bin


Now once you have the necessary libs you are ready to test the simulator or
create a deployable package.

Offline App(browse):
To test the application offline(no SBML support) using the qt webkit engine. Run:
    make browse
    
Testing(test):
To run all the tests for the simulator, run:
    make test
This executes all the tests including the file import/export, SBML server
tests and the Simulate, Analyse and Plot features using the selenium
browser testing framework along with python's unittest.
To run specific tests take a look at the main.py file in the tests directory.
The default browser is Chrome and the default URL is the localhost web2py
server. To change these settings modify the simulator.py file.

Packaging(pkg):
To create a package which can be easily deployed on a server execute:
    make pkg
A zip file simulator.zip will be created in the root directory. 

The following tasks don't really require the libs.
Code checking(lint):
To perform jshint on the js files execute:
    make lint

Documentation(doc):
To generate documentation using jsdoc execute:
    make doc
The docs will reside in the jsdoc directory.

bonesim's People

Contributors

chaitan3 avatar

Stargazers

 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.