ConvergenceCheckerAndMultiplexer.java

  1. /*
  2.  * Licensed to the Hipparchus project under one or more
  3.  * contributor license agreements.  See the NOTICE file distributed with
  4.  * this work for additional information regarding copyright ownership.
  5.  * The Hipparchus project licenses this file to You under the Apache License, Version 2.0
  6.  * (the "License"); you may not use this file except in compliance with
  7.  * the License.  You may obtain a copy of the License at
  8.  *
  9.  *      https://www.apache.org/licenses/LICENSE-2.0
  10.  *
  11.  * Unless required by applicable law or agreed to in writing, software
  12.  * distributed under the License is distributed on an "AS IS" BASIS,
  13.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14.  * See the License for the specific language governing permissions and
  15.  * limitations under the License.
  16.  */
  17. package org.hipparchus.optim;

  18. import java.util.List;

  19. /** Multiplexer for {@link ConvergenceChecker}, checking <em>all</em> the checkers converged.
  20.  * <p>
  21.  * The checkers are checked in the order of the initial list and the check loop
  22.  * is interrupted as soon as one checker fails to converge (that is the remaining
  23.  * checkers may <em>not</em> be called in first iterations.
  24.  * </p>
  25.  * @param <P> type of the evaluation
  26.  * @since 2.1
  27.  */
  28. public class ConvergenceCheckerAndMultiplexer<P> implements ConvergenceChecker<P> {

  29.     /** Underlying checkers. */
  30.     private final List<ConvergenceChecker<P>> checkers;

  31.     /** Simple constructor.
  32.      * @param checkers checkers to use, convergence is reached when
  33.      * <em>all</em> checkers have converged
  34.      */
  35.     public ConvergenceCheckerAndMultiplexer(final List<ConvergenceChecker<P>> checkers) {
  36.         this.checkers = checkers;
  37.     }

  38.     /** {@inheritDoc} */
  39.     @Override
  40.     public boolean converged(final int iteration, final P previous, final P current) {
  41.         for (final ConvergenceChecker<P> checker : checkers) {
  42.             if (!checker.converged(iteration, previous, current)) {
  43.                 return false;
  44.             }
  45.         }
  46.         return true;
  47.     }

  48. }