org.jenetics.engine

Interface EvolutionStream<G extends Gene<?,G>,C extends Comparable<? super C>>

All Superinterfaces:

AutoCloseable, BaseStream<EvolutionResult<G,C>,Stream<EvolutionResult<G,C>>>, Stream<EvolutionResult<G,C>>

public interface EvolutionStream<G extends Gene<?,G>,C extends Comparable<? super C>>
extends Stream<EvolutionResult<G,C>>

The EvolutionStream class extends the Java Stream and adds a method for limiting the evolution by a given predicate.

Since:

3.0

Version:

3.0 — $Date: 2014-12-28 $

Author:

Franz Wilhelmstötter

See Also:

Stream, Engine

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.stream.Stream

Stream.Builder<T>

Method Summary

Modifier and Type	Method and Description
EvolutionStream<G,C>	limit(Predicate<? super EvolutionResult<G,C>> proceed) Returns a stream consisting of the elements of this stream, truncated when the given proceed predicate returns false.

Methods inherited from interface java.util.stream.Stream

allMatch, anyMatch, builder, collect, collect, concat, count, distinct, empty, filter, findAny, findFirst, flatMap, flatMapToDouble, flatMapToInt, flatMapToLong, forEach, forEachOrdered, generate, iterate, limit, map, mapToDouble, mapToInt, mapToLong, max, min, noneMatch, of, of, peek, reduce, reduce, reduce, skip, sorted, sorted, toArray, toArray

Methods inherited from interface java.util.stream.BaseStream

close, isParallel, iterator, onClose, parallel, sequential, spliterator, unordered

Method Detail

limit

EvolutionStream<G,C> limit(Predicate<? super EvolutionResult<G,C>> proceed)

Returns a stream consisting of the elements of this stream, truncated when the given proceed predicate returns false.

General usage example:

final Phenotype<DoubleGene, Double> result = engine.stream() // Truncate the evolution stream after 5 "steady" generations. .limit(bySteadyFitness(5)) // The evolution will stop after maximal 100 generations. .limit(100) .collect(toBestPhenotype());

Parameters:

proceed - the predicate which determines whether the stream is truncated or not. If the predicate returns false, the evolution stream is truncated.

Returns:

the new stream

Throws:

NullPointerException - if the given predicate is null.

See Also:

limit