Skip to content

Lightweight-Productive-Reliable parallel task running and results aggregation (MapReduce on multicore)

License

Notifications You must be signed in to change notification settings

leonliu315/LeoTask

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 

Repository files navigation

LeoTask

LeoTask is a parallel task running and results aggregation (MapReduce) framework. It is a free and open-source project designed to facilitate running computational intensive tasks [1]. The framework implements the MapReduce model, allocating tasks to multi-cores of a computer and aggregating results according to a XML based configuration file. The framework includes mechanisms to automatically recover applications from interruptions caused by accidents (e.g. Power Cut). Applications using the framework can continue running after an interruption without losing its calculated results.

Download | Introduction | Applications | Discussion | Wiki

Features:

  • Automatic & parallel parameter space exploration.
  • Flexible & configuration-based result aggregation.
  • Programming model focusing only on the key logic.
  • Reliable & automatic interruption recovery.
  • Ultra lightweight ~ 300KB Jar.

Utilities:

Example Application:

Please refer to the introduction for building an example application using the framework.

Code (RollDice.java):

public class RollDice extends Task {
    public Integer nSide; //Number of dice sides
    public Integer nDice; //Number of dices to roll
    public Integer sum;//Sum of the results of nDice dices
   
    public boolean prepTask() {
        boolean rtn = nSide > 0 && nDice > 0;
        return rtn;
    }
    
    public void beforeRept() {
        super.beforeRept();
        sum = 0;
    }

    public boolean step() {
        boolean rtn = iStep <= nDice;
        if (rtn) {
            sum  = (int) (rand.nextDouble() * nSide   1);
        }
        return rtn;
    }
}

Configuration (rolldice.xml):

<Tasks>
    <name val="task-rolldice"/><usage val="0.9"/><nRepeats val="2000"/><checkInterval val="4"/>
    <variables class="org.leores.task.app.RollDice">    
        <nSide val="2;4;6"/>
        <nDice val="2:1:5"/><!--from 2 to 5 with a step of 1, i.e. 2;3;4;5 -->
    </variables>
    <statistics>
        <members>
            <i><info val="afterRept@"/><valVar val="sum;#$sum$/$nDice$#"/><parVars val="nSide;nDice"/></i>
            <i><info val="afterRept@"/><valVar val="sum"/><parVars val="nSide"/></i>
            <i><info val="afterRept@"/><valVar val="sum"/><parVars val="nDice"/></i> 
        </members>
    </statistics>
</Tasks>

Before running the example application, please install Java and include the the directory of the command java in the system's PATH environment variable. Windows system users can alternatively download and install (install.bat) the all-in-one runtime environment package: LeoTaskRunEnv

Chang the current directory to the "Demo" folder and then execute the following commnad

java -jar leotask.jar -load=rolldice.xml

If you are using a MS windows system, you can also execute "rolldice.bat".

References:

[1] Changwang Zhang, Shi Zhou, Benjamin M. Chain (2015). "LeoTask: a fast, flexible and reliable framework for computational research", arXiv:1501.01678. (PDF)

Bitdeli Badge

About

Lightweight-Productive-Reliable parallel task running and results aggregation (MapReduce on multicore)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 99.8%
  • Other 0.2%