]> source.dussan.org Git - poi.git/commitdiff
add FORECAST and FORECAST.LINEAR functions
authorPJ Fanning <fanningpj@apache.org>
Sun, 5 Jun 2022 21:45:59 +0000 (21:45 +0000)
committerPJ Fanning <fanningpj@apache.org>
Sun, 5 Jun 2022 21:45:59 +0000 (21:45 +0000)
git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@1901689 13f79535-47bb-0310-9956-ffa450edef68

poi/src/main/java/org/apache/poi/ss/formula/atp/AnalysisToolPak.java
poi/src/main/java/org/apache/poi/ss/formula/eval/FunctionEval.java
poi/src/main/java/org/apache/poi/ss/formula/functions/ArrayFunctionUtils.java [new file with mode: 0644]
poi/src/main/java/org/apache/poi/ss/formula/functions/Correl.java
poi/src/main/java/org/apache/poi/ss/formula/functions/Covar.java
poi/src/main/java/org/apache/poi/ss/formula/functions/Forecast.java [new file with mode: 0644]
poi/src/main/java/org/apache/poi/ss/formula/functions/TwoArrayFunction.java [deleted file]
poi/src/test/java/org/apache/poi/ss/formula/functions/TestCorrel.java
poi/src/test/java/org/apache/poi/ss/formula/functions/TestForecast.java [new file with mode: 0644]

index af7c4c0aa1e4b5cb9f0211b16098a79e9b949b71..dd165383ee4962b9fc876db67aac957b399f59fb 100644 (file)
@@ -118,6 +118,7 @@ public final class AnalysisToolPak implements UDFFinder {
         r(m, "FACTDOUBLE", FactDouble.instance);
         r(m, "FLOOR.MATH", FloorMath.instance);
         r(m, "FLOOR.PRECISE", FloorPrecise.instance);
+        r(m, "FORECAST.LINEAR", Forecast.instance);
         r(m, "FVSCHEDULE", null);
         r(m, "GCD", Gcd.instance);
         r(m, "GESTEP", null);
index c544d4680aaa560cfae456654040d5d74cb2fce5..6693cc5459dec1ea0dfc7f6f4529a141b564b4a1 100644 (file)
@@ -289,7 +289,7 @@ public final class FunctionEval {
         // 306: CHITEST
         retval[307] = Correl.instance;
         retval[308] = Covar.instanceP;
-        // 309: FORECAST
+        retval[309] = Forecast.instance;
         // 310: FTEST
         retval[311] = new Intercept();
         retval[312] = Correl.instance;
diff --git a/poi/src/main/java/org/apache/poi/ss/formula/functions/ArrayFunctionUtils.java b/poi/src/main/java/org/apache/poi/ss/formula/functions/ArrayFunctionUtils.java
new file mode 100644 (file)
index 0000000..3dbedd2
--- /dev/null
@@ -0,0 +1,136 @@
+/* ====================================================================
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+==================================================================== */
+package org.apache.poi.ss.formula.functions;
+
+import org.apache.poi.ss.formula.ThreeDEval;
+import org.apache.poi.ss.formula.TwoDEval;
+import org.apache.poi.ss.formula.eval.BlankEval;
+import org.apache.poi.ss.formula.eval.ErrorEval;
+import org.apache.poi.ss.formula.eval.EvaluationException;
+import org.apache.poi.ss.formula.eval.NumericValueEval;
+import org.apache.poi.ss.formula.eval.OperandResolver;
+import org.apache.poi.ss.formula.eval.RefEval;
+import org.apache.poi.ss.formula.eval.StringValueEval;
+import org.apache.poi.ss.formula.eval.ValueEval;
+
+import java.util.Arrays;
+import java.util.List;
+
+final class ArrayFunctionUtils {
+
+    static List<DoubleList> getNumberArrays(ValueEval operand0, ValueEval operand1) throws EvaluationException {
+        double[] retval0 = collectValuesWithBlanks(operand0).toArray();
+        double[] retval1 = collectValuesWithBlanks(operand1).toArray();
+        if (retval0.length != retval1.length) {
+            throw new EvaluationException(ErrorEval.NA);
+        }
+        DoubleList filtered0 = new DoubleList();
+        DoubleList filtered1 = new DoubleList();
+        int len = Math.min(retval0.length, retval1.length);
+        for (int i = 0; i < len; i++) {
+            if (Double.isNaN(retval0[i]) || Double.isNaN(retval1[i])) {
+                //ignore
+            } else {
+                filtered0.add(retval0[i]);
+                filtered1.add(retval1[i]);
+            }
+        }
+        return Arrays.asList(filtered0, filtered1);
+    }
+
+    private static DoubleList collectValuesWithBlanks(ValueEval operand) throws EvaluationException {
+        DoubleList doubleList = new DoubleList();
+        if (operand instanceof ThreeDEval) {
+            ThreeDEval ae = (ThreeDEval) operand;
+            for (int sIx = ae.getFirstSheetIndex(); sIx <= ae.getLastSheetIndex(); sIx++) {
+                int width = ae.getWidth();
+                int height = ae.getHeight();
+                for (int rrIx = 0; rrIx < height; rrIx++) {
+                    for (int rcIx = 0; rcIx < width; rcIx++) {
+                        ValueEval ve = ae.getValue(sIx, rrIx, rcIx);
+                        Double d = collectValue(ve);
+                        if (d == null) {
+                            doubleList.add(Double.NaN);
+                        } else {
+                            doubleList.add(d.doubleValue());
+                        }
+                    }
+                }
+            }
+            return doubleList;
+        }
+        if (operand instanceof TwoDEval) {
+            TwoDEval ae = (TwoDEval) operand;
+            int width = ae.getWidth();
+            int height = ae.getHeight();
+            for (int rrIx = 0; rrIx < height; rrIx++) {
+                for (int rcIx = 0; rcIx < width; rcIx++) {
+                    ValueEval ve = ae.getValue(rrIx, rcIx);
+                    Double d = collectValue(ve);
+                    if (d == null) {
+                        doubleList.add(Double.NaN);
+                    } else {
+                        doubleList.add(d.doubleValue());
+                    }
+                }
+            }
+            return doubleList;
+        }
+        if (operand instanceof RefEval) {
+            RefEval re = (RefEval) operand;
+            for (int sIx = re.getFirstSheetIndex(); sIx <= re.getLastSheetIndex(); sIx++) {
+                Double d = collectValue(re.getInnerValueEval(sIx));
+                if (d == null) {
+                    doubleList.add(Double.NaN);
+                } else {
+                    doubleList.add(d.doubleValue());
+                }
+            }
+            return doubleList;
+        }
+        Double d = collectValue(operand);
+        if (d == null) {
+            doubleList.add(Double.NaN);
+        } else {
+            doubleList.add(d.doubleValue());
+        }
+        return doubleList;
+    }
+
+    private static Double collectValue(ValueEval ve) throws EvaluationException {
+        if (ve == null) {
+            throw new IllegalArgumentException("ve must not be null");
+        }
+        if (ve instanceof NumericValueEval) {
+            NumericValueEval ne = (NumericValueEval) ve;
+            return ne.getNumberValue();
+        }
+        if (ve instanceof StringValueEval) {
+            String s = ((StringValueEval) ve).getStringValue().trim();
+            return OperandResolver.parseDouble(s);
+        }
+        if (ve instanceof ErrorEval) {
+            throw new EvaluationException((ErrorEval) ve);
+        }
+        if (ve == BlankEval.instance) {
+            return null;
+        }
+        throw new RuntimeException("Invalid ValueEval type passed for conversion: ("
+                + ve.getClass() + ")");
+    }
+
+}
index 0228873549243413e47fff38805f4f35c8096fdd..0aef78249a556988d92638088afd08bf63f49e9c 100644 (file)
@@ -24,6 +24,8 @@ import org.apache.poi.ss.formula.eval.ValueEval;
 
 import java.util.List;
 
+import static org.apache.poi.ss.formula.functions.ArrayFunctionUtils.getNumberArrays;
+
 /**
  * Implementation for Excel CORREL() function.
  * <p>
@@ -38,7 +40,7 @@ import java.util.List;
  *   See https://support.microsoft.com/en-us/office/correl-function-995dcef7-0c0a-4bed-a3fb-239d7b68ca92
  * </p>
  */
-public class Correl extends TwoArrayFunction {
+public class Correl extends Fixed2ArgFunction {
 
     public static final Correl instance = new Correl();
 
index ac838837e4189d19b7e71518419b941db7df20f0..249233e2438afdabc5a9b6b6743b5b08ff1ef383 100644 (file)
@@ -26,6 +26,8 @@ import org.apache.poi.ss.formula.eval.ValueEval;
 
 import java.util.List;
 
+import static org.apache.poi.ss.formula.functions.ArrayFunctionUtils.getNumberArrays;
+
 /**
  * Implementation for Excel COVAR() and COVARIANCE.P() functions.
  * <p>
@@ -35,7 +37,7 @@ import java.util.List;
  * @see <a href="https://support.microsoft.com/en-us/office/covariance-p-function-6f0e1e6d-956d-4e4b-9943-cfef0bf9edfc">COVARIANCE.P</a>
  * </p>
  */
-public class Covar extends TwoArrayFunction implements FreeRefFunction {
+public class Covar extends Fixed2ArgFunction implements FreeRefFunction {
 
     public static final Covar instanceP = new Covar(false);
     public static final Covar instanceS = new Covar(true);
diff --git a/poi/src/main/java/org/apache/poi/ss/formula/functions/Forecast.java b/poi/src/main/java/org/apache/poi/ss/formula/functions/Forecast.java
new file mode 100644 (file)
index 0000000..b6b3f1c
--- /dev/null
@@ -0,0 +1,93 @@
+/* ====================================================================
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+==================================================================== */
+package org.apache.poi.ss.formula.functions;
+
+import org.apache.poi.ss.formula.OperationEvaluationContext;
+import org.apache.poi.ss.formula.eval.ErrorEval;
+import org.apache.poi.ss.formula.eval.EvaluationException;
+import org.apache.poi.ss.formula.eval.NumberEval;
+import org.apache.poi.ss.formula.eval.OperandResolver;
+import org.apache.poi.ss.formula.eval.ValueEval;
+
+import java.util.List;
+
+import static org.apache.poi.ss.formula.functions.ArrayFunctionUtils.getNumberArrays;
+
+/**
+ * Implementation for Excel FORECAST() and FORECAST.LINEAR() functions.
+ * <p>
+ *   <b>Syntax</b>:<br> <b>FORECAST </b>(<b>number</b>, <b>array1</b>, <b>array2</b>)<br>
+ * </p>
+ * <p>
+ *   See https://support.microsoft.com/en-us/office/forecast-and-forecast-linear-functions-50ca49c9-7b40-4892-94e4-7ad38bbeda99
+ * </p>
+ */
+public class Forecast extends Fixed3ArgFunction implements FreeRefFunction {
+
+    public static final Forecast instance = new Forecast();
+
+    private Forecast() {}
+
+    @Override
+    public ValueEval evaluate(int srcRowIndex, int srcColumnIndex, ValueEval arg0, ValueEval arg1, ValueEval arg2) {
+        try {
+            final Double x = evaluateValue(arg0, srcRowIndex, srcColumnIndex);
+            if (x == null || x.isNaN() || x.isInfinite()) {
+                return ErrorEval.VALUE_INVALID;
+            }
+            final List<DoubleList> arrays = getNumberArrays(arg1, arg2);
+            final double[] arrY = arrays.get(0).toArray();
+            final double[] arrX = arrays.get(1).toArray();
+            final double averageY = MathX.average(arrY);
+            final double averageX = MathX.average(arrX);
+            double bnum = 0;
+            double bdem = 0;
+            final int len = arrY.length;
+            for (int i = 0; i < len; i++) {
+                double diff0 = arrX[i] - averageX;
+                bnum += diff0 * (arrY[i] - averageY);
+                bdem += Math.pow(diff0, 2);
+            }
+            if (bdem == 0) {
+                return ErrorEval.DIV_ZERO;
+            }
+
+            final double b = bnum / bdem;
+            final double a = averageY - (b * averageX);
+            final double res = a + (b * x);
+            return new NumberEval(res);
+        } catch (EvaluationException e) {
+            return e.getErrorEval();
+        } catch (Exception e) {
+            return ErrorEval.NA;
+        }
+    }
+
+    @Override
+    public ValueEval evaluate(ValueEval[] args, OperationEvaluationContext ec) {
+        if (args.length != 3) {
+            return ErrorEval.VALUE_INVALID;
+        }
+        return evaluate(ec.getRowIndex(), ec.getColumnIndex(), args[0], args[1], args[2]);
+    }
+
+    private static Double evaluateValue(ValueEval arg, int srcRowIndex, int srcColumnIndex) throws EvaluationException {
+        ValueEval veText = OperandResolver.getSingleValue(arg, srcRowIndex, srcColumnIndex);
+        String strText1 = OperandResolver.coerceValueToString(veText);
+        return OperandResolver.parseDouble(strText1);
+    }
+}
diff --git a/poi/src/main/java/org/apache/poi/ss/formula/functions/TwoArrayFunction.java b/poi/src/main/java/org/apache/poi/ss/formula/functions/TwoArrayFunction.java
deleted file mode 100644 (file)
index c4cce84..0000000
+++ /dev/null
@@ -1,136 +0,0 @@
-/* ====================================================================
-   Licensed to the Apache Software Foundation (ASF) under one or more
-   contributor license agreements.  See the NOTICE file distributed with
-   this work for additional information regarding copyright ownership.
-   The ASF licenses this file to You under the Apache License, Version 2.0
-   (the "License"); you may not use this file except in compliance with
-   the License.  You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
-==================================================================== */
-package org.apache.poi.ss.formula.functions;
-
-import org.apache.poi.ss.formula.ThreeDEval;
-import org.apache.poi.ss.formula.TwoDEval;
-import org.apache.poi.ss.formula.eval.BlankEval;
-import org.apache.poi.ss.formula.eval.ErrorEval;
-import org.apache.poi.ss.formula.eval.EvaluationException;
-import org.apache.poi.ss.formula.eval.NumericValueEval;
-import org.apache.poi.ss.formula.eval.OperandResolver;
-import org.apache.poi.ss.formula.eval.RefEval;
-import org.apache.poi.ss.formula.eval.StringValueEval;
-import org.apache.poi.ss.formula.eval.ValueEval;
-
-import java.util.Arrays;
-import java.util.List;
-
-abstract class TwoArrayFunction extends Fixed2ArgFunction {
-
-    protected List<DoubleList> getNumberArrays(ValueEval operand0, ValueEval operand1) throws EvaluationException {
-        double[] retval0 = collectValuesWithBlanks(operand0).toArray();
-        double[] retval1 = collectValuesWithBlanks(operand1).toArray();
-        if (retval0.length != retval1.length) {
-            throw new EvaluationException(ErrorEval.NA);
-        }
-        DoubleList filtered0 = new DoubleList();
-        DoubleList filtered1 = new DoubleList();
-        int len = Math.min(retval0.length, retval1.length);
-        for (int i = 0; i < len; i++) {
-            if (Double.isNaN(retval0[i]) || Double.isNaN(retval1[i])) {
-                //ignore
-            } else {
-                filtered0.add(retval0[i]);
-                filtered1.add(retval1[i]);
-            }
-        }
-        return Arrays.asList(filtered0, filtered1);
-    }
-
-    private DoubleList collectValuesWithBlanks(ValueEval operand) throws EvaluationException {
-        DoubleList doubleList = new DoubleList();
-        if (operand instanceof ThreeDEval) {
-            ThreeDEval ae = (ThreeDEval) operand;
-            for (int sIx = ae.getFirstSheetIndex(); sIx <= ae.getLastSheetIndex(); sIx++) {
-                int width = ae.getWidth();
-                int height = ae.getHeight();
-                for (int rrIx = 0; rrIx < height; rrIx++) {
-                    for (int rcIx = 0; rcIx < width; rcIx++) {
-                        ValueEval ve = ae.getValue(sIx, rrIx, rcIx);
-                        Double d = collectValue(ve);
-                        if (d == null) {
-                            doubleList.add(Double.NaN);
-                        } else {
-                            doubleList.add(d.doubleValue());
-                        }
-                    }
-                }
-            }
-            return doubleList;
-        }
-        if (operand instanceof TwoDEval) {
-            TwoDEval ae = (TwoDEval) operand;
-            int width = ae.getWidth();
-            int height = ae.getHeight();
-            for (int rrIx = 0; rrIx < height; rrIx++) {
-                for (int rcIx = 0; rcIx < width; rcIx++) {
-                    ValueEval ve = ae.getValue(rrIx, rcIx);
-                    Double d = collectValue(ve);
-                    if (d == null) {
-                        doubleList.add(Double.NaN);
-                    } else {
-                        doubleList.add(d.doubleValue());
-                    }
-                }
-            }
-            return doubleList;
-        }
-        if (operand instanceof RefEval) {
-            RefEval re = (RefEval) operand;
-            for (int sIx = re.getFirstSheetIndex(); sIx <= re.getLastSheetIndex(); sIx++) {
-                Double d = collectValue(re.getInnerValueEval(sIx));
-                if (d == null) {
-                    doubleList.add(Double.NaN);
-                } else {
-                    doubleList.add(d.doubleValue());
-                }
-            }
-            return doubleList;
-        }
-        Double d = collectValue(operand);
-        if (d == null) {
-            doubleList.add(Double.NaN);
-        } else {
-            doubleList.add(d.doubleValue());
-        }
-        return doubleList;
-    }
-
-    private Double collectValue(ValueEval ve) throws EvaluationException {
-        if (ve == null) {
-            throw new IllegalArgumentException("ve must not be null");
-        }
-        if (ve instanceof NumericValueEval) {
-            NumericValueEval ne = (NumericValueEval) ve;
-            return ne.getNumberValue();
-        }
-        if (ve instanceof StringValueEval) {
-            String s = ((StringValueEval) ve).getStringValue().trim();
-            return OperandResolver.parseDouble(s);
-        }
-        if (ve instanceof ErrorEval) {
-            throw new EvaluationException((ErrorEval) ve);
-        }
-        if (ve == BlankEval.instance) {
-            return null;
-        }
-        throw new RuntimeException("Invalid ValueEval type passed for conversion: ("
-                + ve.getClass() + ")");
-    }
-
-}
index 3be25d2c23f603b063c664a6248e0756fea939b3..58091ac21c7b2d0d9b4e2a81c244cfd9e9e5405c 100644 (file)
@@ -60,6 +60,7 @@ final class TestCorrel {
             assertDouble(fe, cell, "PEARSON(A2:A6,B2:B6)", 0.699379, 0.0000005);
         }
     }
+
     @Test
     void testBlankValue() throws IOException {
         try (HSSFWorkbook wb = initWorkbook1(null)) {
diff --git a/poi/src/test/java/org/apache/poi/ss/formula/functions/TestForecast.java b/poi/src/test/java/org/apache/poi/ss/formula/functions/TestForecast.java
new file mode 100644 (file)
index 0000000..e2e42e1
--- /dev/null
@@ -0,0 +1,63 @@
+/* ====================================================================
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+==================================================================== */
+
+package org.apache.poi.ss.formula.functions;
+
+import org.apache.poi.hssf.usermodel.HSSFCell;
+import org.apache.poi.hssf.usermodel.HSSFFormulaEvaluator;
+import org.apache.poi.hssf.usermodel.HSSFRow;
+import org.apache.poi.hssf.usermodel.HSSFSheet;
+import org.apache.poi.hssf.usermodel.HSSFWorkbook;
+import org.apache.poi.ss.usermodel.FormulaError;
+import org.junit.jupiter.api.Test;
+
+import java.io.IOException;
+
+import static org.apache.poi.ss.util.Utils.addRow;
+import static org.apache.poi.ss.util.Utils.assertDouble;
+import static org.apache.poi.ss.util.Utils.assertError;
+
+/**
+ * Tests for {@link Forecast}
+ */
+final class TestForecast {
+
+    //https://support.microsoft.com/en-us/office/forecast-and-forecast-linear-functions-50ca49c9-7b40-4892-94e4-7ad38bbeda99
+    @Test
+    void testMicrosoftExample1() throws IOException {
+        try (HSSFWorkbook wb = initWorkbook1()) {
+            HSSFSheet sheet = wb.getSheetAt(0);
+            HSSFRow row = sheet.getRow(0);
+            HSSFCell cell = row.createCell(100);
+            HSSFFormulaEvaluator fe = new HSSFFormulaEvaluator(wb);
+            assertDouble(fe, cell, "FORECAST(30,A2:A6,B2:B6)", 10.607253, 0.0000001);
+            assertDouble(fe, cell, "FORECAST.LINEAR(30,A2:A6,B2:B6)", 10.607253, 0.0000001);
+        }
+    }
+
+    private HSSFWorkbook initWorkbook1() {
+        HSSFWorkbook wb = new HSSFWorkbook();
+        HSSFSheet sheet = wb.createSheet();
+        addRow(sheet, 0, "Known X", "Known Y");
+        addRow(sheet, 1, 6, 20);
+        addRow(sheet, 2, 7, 28);
+        addRow(sheet, 3, 9, 31);
+        addRow(sheet, 4, 15, 38);
+        addRow(sheet, 5, 21, 40);
+        return wb;
+    }
+}