#region License Information
/* HeuristicLab
* Copyright (C) 2002-2013 Heuristic and Evolutionary Algorithms Laboratory (HEAL)
*
* This file is part of HeuristicLab.
*
* HeuristicLab is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* HeuristicLab is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with HeuristicLab. If not, see .
*/
#endregion
using System;
using System.Collections.Generic;
using System.Linq;
using HeuristicLab.Clients.Hive.Jobs;
using HeuristicLab.Collections;
using HeuristicLab.Common;
using HeuristicLab.Optimization;
using HeuristicLab.PluginInfrastructure;
namespace HeuristicLab.Clients.Hive {
public class OptimizerHiveTask : HiveTask {
#region Constructors and Cloning
public OptimizerHiveTask() { }
public OptimizerHiveTask(IOptimizer optimizer)
: this() {
this.ItemTask = new OptimizerTask(optimizer);
}
public OptimizerHiveTask(OptimizerTask optimizerJob)
: this() {
this.ItemTask = optimizerJob;
}
protected OptimizerHiveTask(OptimizerHiveTask original, Cloner cloner)
: base(original, cloner) {
}
public override IDeepCloneable Clone(Cloner cloner) {
return new OptimizerHiveTask(this, cloner);
}
#endregion
///
/// if this.Optimizer is an experiment
/// Uses the child-optimizers of this.HiveTask and creates HiveTask-childs
/// if this.Optimizer is a batchrun
/// Creates a number of child-jobs according to repetitions
///
protected override void UpdateChildHiveTasks() {
base.UpdateChildHiveTasks();
childHiveTasksLock.EnterWriteLock();
try {
if (Task != null && syncTasksWithOptimizers) {
if (!ItemTask.ComputeInParallel) {
this.childHiveTasks.Clear();
} else {
if (ItemTask.Item is Optimization.Experiment) {
Optimization.Experiment experiment = (Optimization.Experiment)ItemTask.Item;
foreach (IOptimizer childOpt in experiment.Optimizers) {
var optimizerHiveTask = new OptimizerHiveTask(childOpt);
optimizerHiveTask.Task.Priority = Task.Priority; //inherit priority from parent
this.childHiveTasks.Add(optimizerHiveTask);
}
} else if (ItemTask.Item is Optimization.BatchRun) {
Optimization.BatchRun batchRun = ItemTask.OptimizerAsBatchRun;
if (batchRun.Optimizer != null) {
while (this.childHiveTasks.Count < batchRun.Repetitions) {
var optimizerHiveTask = new OptimizerHiveTask(batchRun.Optimizer);
optimizerHiveTask.Task.Priority = Task.Priority;
this.childHiveTasks.Add(optimizerHiveTask);
}
while (this.childHiveTasks.Count > batchRun.Repetitions) {
this.childHiveTasks.Remove(this.childHiveTasks.Last());
}
}
}
}
}
}
finally {
childHiveTasksLock.ExitWriteLock();
}
}
protected override void RegisterItemTaskEvents() {
base.RegisterItemTaskEvents();
if (ItemTask != null) {
if (ItemTask.Item is Optimization.Experiment) {
Optimization.Experiment experiment = ItemTask.OptimizerAsExperiment;
experiment.Optimizers.ItemsAdded += new CollectionItemsChangedEventHandler>(Optimizers_ItemsAdded);
experiment.Optimizers.ItemsReplaced += new CollectionItemsChangedEventHandler>(Optimizers_ItemsReplaced);
experiment.Optimizers.ItemsRemoved += new CollectionItemsChangedEventHandler>(Optimizers_ItemsRemoved);
experiment.Optimizers.CollectionReset += new CollectionItemsChangedEventHandler>(Optimizers_CollectionReset);
} else if (ItemTask.Item is Optimization.BatchRun) {
Optimization.BatchRun batchRun = ItemTask.OptimizerAsBatchRun;
batchRun.RepetitionsChanged += new EventHandler(batchRun_RepetitionsChanged);
batchRun.OptimizerChanged += new EventHandler(batchRun_OptimizerChanged);
}
}
}
protected override void DeregisterItemTaskEvents() {
base.DeregisterItemTaskEvents();
if (ItemTask != null) {
if (ItemTask.Item is Optimization.Experiment) {
Optimization.Experiment experiment = ItemTask.OptimizerAsExperiment;
experiment.Optimizers.ItemsAdded -= new CollectionItemsChangedEventHandler>(Optimizers_ItemsAdded);
experiment.Optimizers.ItemsReplaced -= new CollectionItemsChangedEventHandler>(Optimizers_ItemsReplaced);
experiment.Optimizers.ItemsRemoved -= new CollectionItemsChangedEventHandler>(Optimizers_ItemsRemoved);
experiment.Optimizers.CollectionReset -= new CollectionItemsChangedEventHandler>(Optimizers_CollectionReset);
} else if (ItemTask.Item is Optimization.BatchRun) {
Optimization.BatchRun batchRun = ItemTask.OptimizerAsBatchRun;
batchRun.RepetitionsChanged -= new EventHandler(batchRun_RepetitionsChanged);
batchRun.OptimizerChanged -= new EventHandler(batchRun_OptimizerChanged);
}
}
}
private void batchRun_OptimizerChanged(object sender, EventArgs e) {
if (syncTasksWithOptimizers) {
UpdateChildHiveTasks();
}
}
private void batchRun_RepetitionsChanged(object sender, EventArgs e) {
if (syncTasksWithOptimizers) {
UpdateChildHiveTasks();
}
}
private void Optimizers_ItemsAdded(object sender, CollectionItemsChangedEventArgs> e) {
if (syncTasksWithOptimizers && this.ItemTask.ComputeInParallel) {
childHiveTasksLock.EnterWriteLock();
try {
foreach (var item in e.Items) {
if (GetChildByOptimizer(item.Value) == null && item.Value.Name != "Placeholder") {
this.childHiveTasks.Add(new OptimizerHiveTask(item.Value));
}
}
}
finally { childHiveTasksLock.ExitWriteLock(); }
}
}
private void Optimizers_ItemsReplaced(object sender, CollectionItemsChangedEventArgs> e) {
if (syncTasksWithOptimizers && this.ItemTask.ComputeInParallel) {
childHiveTasksLock.EnterWriteLock();
try {
foreach (var item in e.OldItems) {
this.childHiveTasks.Remove(this.GetChildByOptimizer(item.Value));
}
foreach (var item in e.Items) {
if (GetChildByOptimizer(item.Value) == null && item.Value.Name != "Placeholder") {
this.childHiveTasks.Add(new OptimizerHiveTask(item.Value));
}
}
}
finally { childHiveTasksLock.ExitWriteLock(); }
}
}
private void Optimizers_ItemsRemoved(object sender, CollectionItemsChangedEventArgs> e) {
if (syncTasksWithOptimizers && this.ItemTask.ComputeInParallel) {
childHiveTasksLock.EnterWriteLock();
try {
foreach (var item in e.Items) {
this.childHiveTasks.Remove(this.GetChildByOptimizer(item.Value));
}
}
finally { childHiveTasksLock.ExitWriteLock(); }
}
}
private void Optimizers_CollectionReset(object sender, CollectionItemsChangedEventArgs> e) {
if (syncTasksWithOptimizers && this.ItemTask.ComputeInParallel) {
childHiveTasksLock.EnterWriteLock();
try {
foreach (var item in e.Items) {
this.childHiveTasks.Remove(this.GetChildByOptimizer(item.Value));
}
}
finally { childHiveTasksLock.ExitWriteLock(); }
}
}
///
/// if this.Optimizer is Experiment
/// replace the child-optimizer in the experiment
/// if this.Optimizer is BatchRun
/// add the runs from the optimizerTask to the batchrun and replace the Optimizer
///
public override void IntegrateChild(ItemTask task, Guid childTaskId) {
var optimizerTask = (OptimizerTask)task;
syncTasksWithOptimizers = false; // don't sync with optimizers during this method
if (this.ItemTask != null && this.ItemTask.Item != null) {
if (this.ItemTask.Item is Optimization.Experiment) {
UpdateOptimizerInExperiment(this.ItemTask.OptimizerAsExperiment, optimizerTask);
} else if (this.ItemTask.Item is Optimization.BatchRun) {
UpdateOptimizerInBatchRun(this.ItemTask.OptimizerAsBatchRun, optimizerTask);
}
}
IEnumerable childs = this.ChildHiveTasks.Where(j => j.Task.Id == childTaskId);
//TODO: in very rare cases childs is empty. This shouldn't be the case and should be further investigated.
if (childs.Count() > 0) {
OptimizerHiveTask child = childs.First() as OptimizerHiveTask;
if (child != null && !optimizerTask.ComputeInParallel) {
child.syncTasksWithOptimizers = false;
child.ItemTask = optimizerTask;
child.syncTasksWithOptimizers = true;
}
}
syncTasksWithOptimizers = true;
}
///
/// Adds the runs from the optimizerTask to the batchrun and replaces the Optimizer
/// Sideeffect: the optimizerTask.Optimizer will be prepared (scopes are deleted and executionstate will be reset)
///
private void UpdateOptimizerInBatchRun(BatchRun batchRun, OptimizerTask optimizerTask) {
itemTaskLock.EnterWriteLock();
try {
if (batchRun.Optimizer == null) {
batchRun.Optimizer = (IOptimizer)optimizerTask.Item; // only set the first optimizer as Optimizer. if every time the Optimizer would be set, the runs would be cleared each time
}
foreach (IRun run in optimizerTask.Item.Runs) {
if (!batchRun.Runs.Contains(run)) {
run.Name = GetNewRunName(run, batchRun.Runs);
batchRun.Runs.Add(run);
}
}
}
finally {
itemTaskLock.ExitWriteLock();
}
}
///
/// replace the child-optimizer in the experiment
/// Sideeffect: the optimizerTask.Optimizer will be prepared (scopes are deleted and executionstate will be reset)
///
private void UpdateOptimizerInExperiment(Optimization.Experiment experiment, OptimizerTask optimizerTask) {
itemTaskLock.EnterWriteLock();
try {
if (optimizerTask.IndexInParentOptimizerList < 0)
throw new IndexOutOfRangeException("IndexInParentOptimizerList must be equal or greater than zero! The Task is invalid and the optimizer-tree cannot be reassembled.");
while (experiment.Optimizers.Count < optimizerTask.IndexInParentOptimizerList) {
experiment.Optimizers.Add(new UserDefinedAlgorithm("Placeholder")); // add dummy-entries to Optimizers so that its possible to insert the optimizerTask at the correct position
}
if (experiment.Optimizers.Count < optimizerTask.IndexInParentOptimizerList + 1) {
experiment.Optimizers.Add(optimizerTask.Item);
} else {
// if ComputeInParallel==true, don't replace the optimizer (except it is still a Placeholder)
// this is because Jobs with ComputeInParallel get submitted to hive with their child-optimizers deleted
if (!optimizerTask.ComputeInParallel || experiment.Optimizers[optimizerTask.IndexInParentOptimizerList].Name == "Placeholder") {
experiment.Optimizers[optimizerTask.IndexInParentOptimizerList] = optimizerTask.Item;
}
}
}
finally {
itemTaskLock.ExitWriteLock();
}
}
///
/// Sets the IndexInParentOptimizerList property of the OptimizerJob
/// according to the position in the OptimizerList of the parentHiveTask.Task
/// Recursively updates all the child-jobs as well
///
internal void SetIndexInParentOptimizerList(OptimizerHiveTask parentHiveTask) {
if (parentHiveTask != null) {
if (parentHiveTask.ItemTask.Item is Optimization.Experiment) {
this.ItemTask.IndexInParentOptimizerList = parentHiveTask.ItemTask.OptimizerAsExperiment.Optimizers.IndexOf(this.ItemTask.Item);
} else if (parentHiveTask.ItemTask.Item is Optimization.BatchRun) {
this.ItemTask.IndexInParentOptimizerList = 0;
} else {
throw new NotSupportedException("Only Experiment and BatchRuns are supported");
}
}
childHiveTasksLock.EnterReadLock();
try {
foreach (OptimizerHiveTask child in childHiveTasks) {
child.SetIndexInParentOptimizerList(this);
}
}
finally { childHiveTasksLock.ExitReadLock(); }
}
public override void AddChildHiveTask(HiveTask hiveTask) {
base.AddChildHiveTask(hiveTask);
var optimizerHiveJob = (OptimizerHiveTask)hiveTask;
syncTasksWithOptimizers = false;
if (this.ItemTask != null && optimizerHiveJob.ItemTask != null) {
// if task is in state Paused, it has to preserve its ResultCollection, which is cleared when a optimizer is added to an experiment
OptimizerTask optimizerJobClone = null;
if (optimizerHiveJob.Task.State == TaskState.Paused) {
optimizerJobClone = (OptimizerTask)optimizerHiveJob.ItemTask.Clone();
}
if (this.ItemTask.Item is Optimization.Experiment) {
if (!this.ItemTask.OptimizerAsExperiment.Optimizers.Contains(optimizerHiveJob.ItemTask.Item)) {
UpdateOptimizerInExperiment(this.ItemTask.OptimizerAsExperiment, optimizerHiveJob.ItemTask);
}
} else if (this.ItemTask.Item is Optimization.BatchRun) {
UpdateOptimizerInBatchRun(this.ItemTask.OptimizerAsBatchRun, optimizerHiveJob.ItemTask);
}
if (optimizerHiveJob.Task.State == TaskState.Paused) {
optimizerHiveJob.ItemTask = optimizerJobClone;
}
}
syncTasksWithOptimizers = true;
}
///
/// Creates a TaskData object containing the Task and the IJob-Object as byte[]
///
///
/// if true the Child-Optimizers will not be serialized (if the task contains an Experiment)
///
public override TaskData GetAsTaskData(bool withoutChildOptimizers, out List plugins) {
plugins = new List();
if (this.itemTask == null) // || this.jobItem.Optimizer == null
return null;
IEnumerable usedTypes;
byte[] jobByteArray;
if (withoutChildOptimizers && this.ItemTask.Item is Optimization.Experiment) {
OptimizerTask clonedJob = (OptimizerTask)this.ItemTask.Clone(); // use a cloned task, so that the childHiveJob don't get confused
clonedJob.OptimizerAsExperiment.Optimizers.Clear();
jobByteArray = PersistenceUtil.Serialize(clonedJob, out usedTypes);
} else if (withoutChildOptimizers && this.ItemTask.Item is Optimization.BatchRun) {
OptimizerTask clonedJob = (OptimizerTask)this.ItemTask.Clone();
clonedJob.OptimizerAsBatchRun.Optimizer = null;
jobByteArray = PersistenceUtil.Serialize(clonedJob, out usedTypes);
} else if (this.ItemTask.Item is IAlgorithm) {
((IAlgorithm)this.ItemTask.Item).StoreAlgorithmInEachRun = false; // avoid storing the algorithm in runs to reduce size
jobByteArray = PersistenceUtil.Serialize(this.ItemTask, out usedTypes);
} else {
jobByteArray = PersistenceUtil.Serialize(this.ItemTask, out usedTypes);
}
TaskData jobData = new TaskData() { TaskId = task.Id, Data = jobByteArray };
PluginUtil.CollectDeclaringPlugins(plugins, usedTypes);
return jobData;
}
public OptimizerHiveTask GetChildByOptimizerTask(OptimizerTask optimizerTask) {
childHiveTasksLock.EnterReadLock();
try {
foreach (OptimizerHiveTask child in childHiveTasks) {
if (child.ItemTask == optimizerTask)
return child;
}
return null;
}
finally { childHiveTasksLock.ExitReadLock(); }
}
public HiveTask GetChildByOptimizer(IOptimizer optimizer) {
childHiveTasksLock.EnterReadLock();
try {
foreach (OptimizerHiveTask child in childHiveTasks) {
if (child.ItemTask.Item == optimizer)
return child;
}
return null;
}
finally { childHiveTasksLock.ExitReadLock(); }
}
public void ExecuteReadActionOnItemTask(Action action) {
itemTaskLock.EnterReadLock();
try {
action();
}
finally {
itemTaskLock.ExitReadLock();
}
}
#region Helpers
///
/// Parses the run numbers out of runs and renames the run to the next number
///
private static string GetNewRunName(IRun run, RunCollection runs) {
int idx = run.Name.IndexOf("Run ") + 4;
if (idx == 3 || runs.Count == 0)
return run.Name;
int maxRunNumber = int.MinValue;
foreach (IRun r in runs) {
int number = GetRunNumber(r.Name);
maxRunNumber = Math.Max(maxRunNumber, number);
}
return run.Name.Substring(0, idx) + (maxRunNumber + 1).ToString();
}
///
/// Parses the number of a Run out of its name. Example "Genetic Algorithm Run 3" -> 3
///
private static int GetRunNumber(string runName) {
int idx = runName.IndexOf("Run ") + 4;
if (idx == 3) {
return 0;
} else {
return int.Parse(runName.Substring(idx, runName.Length - idx));
}
}
#endregion
}
}