#region License Information /* HeuristicLab * Copyright (C) 2002-2011 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 . * * The LRU cache is based on an idea by Robert Rossney see * . */ #endregion using System; using System.Collections.Generic; using System.Linq; using HeuristicLab.Common; using HeuristicLab.Common.Resources; using HeuristicLab.Core; using HeuristicLab.Data; using HeuristicLab.Parameters; using HeuristicLab.Persistence.Default.CompositeSerializers.Storable; namespace HeuristicLab.Problems.ExternalEvaluation { [Item("EvaluationCache", "Cache for external evaluation values")] [StorableClass] public class EvaluationCache : ParameterizedNamedItem { #region Types private class CacheEntry { public string Key { get; private set; } public double Value { get; set; } public CacheEntry(string key, double value) { Key = key; Value = value; } public CacheEntry(string key) : this(key, 0) { } public override bool Equals(object obj) { CacheEntry other = obj as CacheEntry; if (other == null) return false; return Key.Equals(other.Key); } public override int GetHashCode() { return Key.GetHashCode(); } public override string ToString() { return string.Format("{{{0} : {1}}}", Key, Value); } } public delegate double Evaluator(SolutionMessage message); #endregion #region Fields private LinkedList list; private Dictionary> index; #endregion #region Properties public override System.Drawing.Image ItemImage { get { return VSImageLibrary.Database; } } public int Size { get { return index.Count; } } [Storable] public int Hits { get; private set; } #endregion #region events public event EventHandler SizeChanged; public event EventHandler HitsChanged; protected virtual void OnSizeChanged() { EventHandler handler = SizeChanged; if (handler != null) handler(this, EventArgs.Empty); } protected virtual void OnHitsChanged() { EventHandler handler = HitsChanged; if (handler != null) handler(this, EventArgs.Empty); } #endregion #region Parameters public FixedValueParameter CapacityParameter { get { return (FixedValueParameter)Parameters["Capacity"]; } } #endregion #region Parameter Values public int Capacity { get { return CapacityParameter.Value.Value; } set { CapacityParameter.Value.Value = value; } } #endregion #region Persistence [Storable(Name="Cache")] private IEnumerable> Cache_Persistence { get { return index.ToDictionary(kvp => kvp.Key.Key, kvp => kvp.Key.Value); } set { list = new LinkedList(); index = new Dictionary>(); foreach (var kvp in value) { var entry = new CacheEntry(kvp.Key); entry.Value = kvp.Value; index[entry] = list.AddLast(entry); } } } [StorableHook(HookType.AfterDeserialization)] private void AfterDeserialization() { RegisterEvents(); } #endregion #region Construction & Cloning [StorableConstructor] protected EvaluationCache(bool deserializing) : base(deserializing) { } protected EvaluationCache(EvaluationCache original, Cloner cloner) : base(original, cloner) { Cache_Persistence = original.Cache_Persistence; RegisterEvents(); } public EvaluationCache() { list = new LinkedList(); index = new Dictionary>(); Parameters.Add(new FixedValueParameter("Capacity", "Maximum number of cache entries.", new IntValue(10000))); RegisterEvents(); } public override IDeepCloneable Clone(Cloner cloner) { return new EvaluationCache(this, cloner); } #endregion #region Event Handling private void RegisterEvents() { CapacityParameter.Value.ValueChanged += new EventHandler(Value_ValueChanged); } void Value_ValueChanged(object sender, EventArgs e) { if (Capacity < 0) throw new ArgumentOutOfRangeException("Cache capacity cannot be less than zero"); Trim(); } #endregion #region Methods public void Reset() { list = new LinkedList(); index = new Dictionary>(); Hits = 0; OnSizeChanged(); OnHitsChanged(); } public double GetValue(SolutionMessage message, Evaluator evaluate) { CacheEntry entry = new CacheEntry(message.ToString()); LinkedListNode node; if (index.TryGetValue(entry, out node)) { list.Remove(node); list.AddLast(node); Hits++; OnHitsChanged(); return node.Value.Value; } else { entry.Value = evaluate(message); index[entry] = list.AddLast(entry); Trim(); return entry.Value; } } private void Trim() { while (list.Count > Capacity) { LinkedListNode item = list.First; list.Remove(item); index.Remove(item.Value); } OnSizeChanged(); } #endregion } }