org.apache.sysml.runtime.controlprogram.parfor.Task Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of systemml Show documentation
Show all versions of systemml Show documentation
Declarative Machine Learning
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.sysml.runtime.controlprogram.parfor;
import java.io.Serializable;
import java.util.LinkedList;
import java.util.List;
import java.util.StringTokenizer;
import org.apache.sysml.runtime.instructions.cp.IntObject;
/**
* A task is a logical group of one or multiple iterations (each iteration is assigned to exactly one task).
* There, each single task is executed sequentially. See TaskPartitioner for how tasks are created and
* ParWorker for how those tasks are eventually executed.
*
* NOTE: (Extension possibility: group of statements)
*
*/
public class Task implements Serializable
{
private static final long serialVersionUID = 2815832451487164284L;
public enum TaskType {
RANGE,
SET
}
public static final int MAX_VARNAME_SIZE = 256;
public static final int MAX_TASK_SIZE = Integer.MAX_VALUE-1;
private TaskType _type;
private LinkedList _iterations; //each iteration is specified as an ordered set of index values
public Task() {
//default constructor for serialize
}
public Task( TaskType type )
{
_type = type;
_iterations = new LinkedList();
}
public void addIteration( IntObject indexVal )
{
if( indexVal.getName().length() > MAX_VARNAME_SIZE )
throw new RuntimeException("Cannot add iteration, MAX_VARNAME_SIZE exceeded.");
if( size() >= MAX_TASK_SIZE )
throw new RuntimeException("Cannot add iteration, MAX_TASK_SIZE reached.");
_iterations.addLast( indexVal );
}
public List getIterations()
{
return _iterations;
}
public TaskType getType()
{
return _type;
}
public int size()
{
return _iterations.size();
}
/**
*
* @param task
*/
public void mergeTask( Task task )
{
//check for set iteration type
if( _type==TaskType.RANGE )
throw new RuntimeException("Task Merging not supported for tasks of type ITERATION_RANGE.");
//check for same iteration name
String var1 = _iterations.getFirst().getName();
String var2 = task._iterations.getFirst().getName();
if( !var1.equals(var2) )
throw new RuntimeException("Task Merging not supported for tasks with different variable names");
//merge tasks
for( IntObject o : task._iterations )
_iterations.addLast( o );
}
@Override
public String toString()
{
return toFormatedString();
}
/**
*
* @return
*/
public String toFormatedString()
{
StringBuilder sb = new StringBuilder();
sb.append("task (type=");
sb.append(_type);
sb.append(", iterations={");
int count=0;
for( IntObject dat : _iterations )
{
if( count!=0 )
sb.append(";");
sb.append("[");
sb.append(dat.getName());
sb.append("=");
sb.append(dat.getLongValue());
sb.append("]");
count++;
}
sb.append("})");
return sb.toString();
}
/**
*
* @return
*/
public String toCompactString()
{
StringBuilder sb = new StringBuilder( );
sb.append(_type);
if( size() > 0 )
{
sb.append(".");
IntObject dat0 = _iterations.getFirst();
sb.append(dat0.getName());
sb.append(".{");
int count = 0;
for( IntObject dat : _iterations )
{
if( count!=0 )
sb.append(",");
sb.append(dat.getLongValue());
count++;
}
sb.append("}");
}
return sb.toString();
}
/**
*
* @return
*/
public String toCompactString( int maxDigits )
{
StringBuilder sb = new StringBuilder( );
sb.append(_type);
if( size() > 0 )
{
sb.append(".");
IntObject dat0 = _iterations.getFirst();
sb.append(dat0.getName());
sb.append(".{");
int count = 0;
for( IntObject dat : _iterations )
{
if( count!=0 )
sb.append(",");
String tmp = String.valueOf(dat.getLongValue());
for( int k=tmp.length(); k