View Javadoc
1   /*
2    * Copyright (C) 2023 Alberto Irurueta Carro (alberto@irurueta.com)
3    *
4    * Licensed under the Apache License, Version 2.0 (the "License");
5    * you may not use this file except in compliance with the License.
6    * You may obtain a copy of the License at
7    *
8    *         http://www.apache.org/licenses/LICENSE-2.0
9    *
10   * Unless required by applicable law or agreed to in writing, software
11   * distributed under the License is distributed on an "AS IS" BASIS,
12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13   * See the License for the specific language governing permissions and
14   * limitations under the License.
15   */
16  package com.irurueta.numerical.integration;
17  
18  import com.irurueta.algebra.WrongSizeException;
19  
20  /**
21   * Computes function integration by using an Upper Square Root mid-point quadrature
22   * when upper integration bound lies at a function singularity.
23   */
24  public class UpperSquareRootMidPointQuadratureMatrixIntegrator
25          extends QuadratureMatrixIntegrator<UpperSquareRootMidPointMatrixQuadrature> {
26  
27      /**
28       * Constructor.
29       *
30       * @param a        Lower limit of integration.
31       * @param b        Upper limit of integration.
32       * @param listener listener to evaluate a single dimension matrix (multivariate) function at
33       *                 required points.
34       * @param eps      required accuracy.
35       * @throws WrongSizeException if size notified by provided listener is invalid.
36       */
37      public UpperSquareRootMidPointQuadratureMatrixIntegrator(
38              final double a, final double b, final MatrixSingleDimensionFunctionEvaluatorListener listener,
39              final double eps) throws WrongSizeException {
40          super(new UpperSquareRootMidPointMatrixQuadrature(a, b, listener), eps);
41      }
42  
43      /**
44       * Constructor.
45       *
46       * @param a        Lower limit of integration.
47       * @param b        Upper limit of integration.
48       * @param listener listener to evaluate a single dimension matrix (multivariate) function at
49       *                 required points.
50       * @throws WrongSizeException if size notified by provided listener is invalid.
51       */
52      public UpperSquareRootMidPointQuadratureMatrixIntegrator(
53              final double a, final double b, final MatrixSingleDimensionFunctionEvaluatorListener listener)
54              throws WrongSizeException {
55          this(a, b, listener, EPS);
56      }
57  
58      /**
59       * Gets type of quadrature.
60       *
61       * @return type of quadrature.
62       */
63      @Override
64      public QuadratureType getQuadratureType() {
65          return QuadratureType.UPPER_SQUARE_ROOT_MID_POINT;
66      }
67  }