rizalmf / deductive-formula
Evaluate given math expressions
0.0.1-alpha
2021-04-04 13:28 UTC
Requires
- php: >=7.0
- ext-mbstring: *
Requires (Dev)
This package is auto-updated.
Last update: 2024-04-06 09:10:09 UTC
README
DeductiveFormula is library evaluate expression of variables from given string
Install via "composer require"
composer require rizalmf/deductive-formula
Usage:
use rizalmf\formula\DeductiveFormula; use rizalmf\formula\exception\FormulaException; require_once __DIR__ . '/vendor/autoload.php'; // example path $formula = new DeductiveFormula();
Example 1: (Define Expressions & Set Formula)
try { $expression = '{foo}^({bar}/2+(2+3^(1/2)))'; $requestedVariables = $formula->setFormula($expression); var_dump($formula->getFormula()); var_dump($requestedVariables); } catch (FormulaException $e) { // handle Exceptions } // output : // {foo}^({bar}/2+(2+3^(1/2))) // array ([0] => "foo", [1] => "bar")
Example 2: (Set Variables)
// ... // 1. define value per variable $formula->setVariable("foo", 4); $formula->setVariable("bar", 1); // 2. use array $formula->setVariables([ "foo" => 4, "bar" => 1 ]);
Example 3: (Get Variables)
// ... // 1. get value from specific variable var_dump($formula->getVariable("foo")); // output : 4 // 2. get values all variables var_dump($formula->getVariables()); // output : array ([foo] => 4, [bar] => 1) // 1. get possible variables from Formula var_dump($formula->getRequestedVariables()); // output : array ([0] => "foo", [1] => "bar")
Example 4: (Evaluate)
$result = $formula->execute(); var_dump($result); // output : 353.141268350837
Example 5: (Set Limit Iteration & Debug)
// (optional) set limit iteration calculating machine. default 200 $formula->setLimit(50); // show prepared formula var_dump($formula->getFormulaExposed()); // output : 4^(1/2+(2+3^(1/2))) // debug $result = $formula->execute(true); var_dump($result); // output : // iteration-1 => 4^(1/2+(2+3^(1/2))) // iteration-2 => 4^(1/2+(2+3^0.50)) // iteration-3 => 4^(1/2+(2+1.73205080756888)) // iteration-4 => 4^(1/2+3.73205080756888) // iteration-5 => 4^(0.50+3.73205080756888) // iteration-6 => 4^4.23205080756888 // 353.141268350837
Exception Tree
FormulaException |- BadFormulaException
Unit Test:
- Composer is a prerequisite for running the tests.
composer install
- The tests can be executed by running this command from the root directory:
./vendor/bin/phpunit test
LICENSE
The MIT License (MIT) Copyright (c) 2021 Rizal Maulana Fahmi