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 Simpson's rule and mid-point quadrature.
22 * Simpson's method is an optimization of Trapezoidal quadrature integrator.
23 * This type of integrator will in general be more efficient than Trapezoidal quadrature
24 * integrators (i.e., require fewer function evaluations) when the function
25 * to be integrated has a finite fourth derivative (i.e., a continuous third derivative).
26 */
27 public class SimpsonMidPointQuadratureMatrixIntegrator extends SimpsonMatrixIntegrator<MidPointMatrixQuadrature> {
28
29 /**
30 * Constructor.
31 *
32 * @param a Lower limit of integration.
33 * @param b Upper limit of integration.
34 * @param listener listener to evaluate a single dimension matrix (multivariate) function at
35 * required points.
36 * @param eps required accuracy.
37 * @throws WrongSizeException if size notified by provided listener is invalid.
38 */
39 public SimpsonMidPointQuadratureMatrixIntegrator(
40 final double a, final double b, final MatrixSingleDimensionFunctionEvaluatorListener listener,
41 final double eps) throws WrongSizeException {
42 super(new MidPointMatrixQuadrature(a, b, listener), eps);
43 }
44
45 /**
46 * Constructor with default accuracy.
47 *
48 * @param a Lower limit of integration.
49 * @param b Upper limit of integration.
50 * @param listener listener to evaluate a single dimension function at required points.
51 * @throws WrongSizeException if size notified by provided listener is invalid.
52 */
53 public SimpsonMidPointQuadratureMatrixIntegrator(
54 final double a, final double b, final MatrixSingleDimensionFunctionEvaluatorListener listener)
55 throws WrongSizeException {
56 this(a, b, listener, EPS);
57 }
58
59 /**
60 * Gets type of quadrature.
61 *
62 * @return type of quadrature.
63 */
64 @Override
65 public QuadratureType getQuadratureType() {
66 return QuadratureType.MID_POINT;
67 }
68 }