Jingga/phpOMS
1
0
Fork 0
mirror of https://github.com/Karaka-Management/phpOMS.git synced 2026-01-10 17:28:40 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
a1b591d141
phpOMS/tests/Business/Finance/FinanceFormulasTest.php
Dennis Eichhorn a1b591d141 fix tests
2024-03-20 03:00:25 +00:00

665 lines
23 KiB
PHP
Executable File
Raw Blame History

<?php
/**
* Jingga
*
* PHP Version 8.1
*
* @package tests
* @copyright Dennis Eichhorn
* @license OMS License 2.0
* @version 1.0.0
* @link https://jingga.app
*/
declare(strict_types=1);
namespace phpOMS\tests\Business\Finance;
use phpOMS\Business\Finance\FinanceFormulas;
/**
* @testdox phpOMS\tests\Business\Finance\FinanceFormulasTest: Finance formulas
*
* @internal
*/
final class FinanceFormulasTest extends \PHPUnit\Framework\TestCase
{
/**
* @testdox The annual percentage yield (APY) and reverse value calculations are correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testAnnualPercentageYield() : void
{
$expected = 0.06168;
$r = 0.06;
$n = 12;
$apy = FinanceFormulas::getAnnualPercentageYield($r, $n);
self::assertEqualsWithDelta(\round($expected, 5), \round($apy, 5), 0.01);
self::assertEqualsWithDelta(\round($r, 2), FinanceFormulas::getStateAnnualInterestRateOfAPY($apy, $n), 0.01);
}
/**
* @testdox The future value of annuity (FVA) and reverse value calculations are correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testFutureValueOfAnnuity() : void
{
$expected = 5204.04;
$P = 1000.00;
$r = 0.02;
$n = 5;
$fva = FinanceFormulas::getFutureValueOfAnnuity($P, $r, $n);
self::assertEqualsWithDelta(\round($expected, 2), \round($fva, 2), 0.01);
self::assertEqualsWithDelta($n, FinanceFormulas::getNumberOfPeriodsOfFVA($fva, $P, $r), 0.01);
self::assertEqualsWithDelta(\round($P, 2), \round(FinanceFormulas::getPeriodicPaymentOfFVA($fva, $r, $n), 2), 0.01);
}
/**
* @testdox The future value of annuity continuous compounding (FVACC) and reverse value calculations are correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testFutureValueOfAnnuityContinuousCompounding() : void
{
$expected = 12336.42;
$cf = 1000.00;
$r = 0.005;
$t = 12;
$fvacc = FinanceFormulas::getFutureValueOfAnnuityConinuousCompounding($cf, $r, $t);
self::assertEqualsWithDelta(\round($expected, 2), \round($fvacc, 2), 0.01);
self::assertEqualsWithDelta(\round($cf, 2), \round(FinanceFormulas::getCashFlowOfFVACC($fvacc, $r, $t), 2), 0.01);
self::assertEqualsWithDelta($t, FinanceFormulas::getTimeOfFVACC($fvacc, $cf, $r), 0.01);
}
/**
* @testdox The annuity payment from the present value (PV) and reverse value calculations are correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testAnnuityPaymentPV() : void
{
$expected = 212.16;
$pv = 1000.00;
$r = 0.02;
$n = 5;
$p = FinanceFormulas::getAnnuityPaymentPV($pv, $r, $n);
self::assertEqualsWithDelta(\round($expected, 2), \round($p, 2), 0.01);
self::assertEqualsWithDelta($n, FinanceFormulas::getNumberOfAPPV($p, $pv, $r), 0.01);
self::assertEqualsWithDelta(\round($pv, 2), \round(FinanceFormulas::getPresentValueOfAPPV($p, $r, $n), 2), 0.01);
}
/**
* @testdox The annuity payment from the future value (FV) and reverse value calculations are correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testAnnuityPaymentFV() : void
{
$expected = 192.16;
$fv = 1000.00;
$r = 0.02;
$n = 5;
$p = FinanceFormulas::getAnnuityPaymentFV($fv, $r, $n);
self::assertEqualsWithDelta(\round($expected, 2), \round($p, 2), 0.01);
self::assertEqualsWithDelta($n, FinanceFormulas::getNumberOfAPFV($p, $fv, $r), 0.01);
self::assertEqualsWithDelta(\round($fv, 2), \round(FinanceFormulas::getFutureValueOfAPFV($p, $r, $n), 2), 0.01);
}
/**
* @testdox The annuity payment from the present value (PV) and reverse value calculations are correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testAnnuityPaymentFactorPV() : void
{
$expected = 0.21216;
$r = 0.02;
$n = 5;
$p = FinanceFormulas::getAnnuityPaymentFactorPV($r, $n);
self::assertEqualsWithDelta(\round($expected, 5), \round($p, 5), 0.01);
self::assertEqualsWithDelta($n, FinanceFormulas::getNumberOfAPFPV($p, $r), 0.01);
}
/**
* @testdox The present value of the annuity is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testPresentValueOfAnnuity() : void
{
$expected = 4713.46;
$P = 1000.00;
$r = 0.02;
$n = 5;
$pva = FinanceFormulas::getPresentValueOfAnnuity($P, $r, $n);
self::assertEqualsWithDelta(\round($expected, 2), \round($pva, 2), 0.01);
self::assertEqualsWithDelta($n, FinanceFormulas::getNumberOfPeriodsOfPVA($pva, $P, $r), 0.01);
self::assertEqualsWithDelta(\round($P, 2), \round(FinanceFormulas::getPeriodicPaymentOfPVA($pva, $r, $n), 2), 0.01);
}
/**
* @testdox The present value annuity factor of the annuity is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testPresentValueAnnuityFactor() : void
{
$expected = 4.7135;
$r = 0.02;
$n = 5;
$p = FinanceFormulas::getPresentValueAnnuityFactor($r, $n);
self::assertEqualsWithDelta(\round($expected, 4), \round($p, 4), 0.01);
self::assertEqualsWithDelta($n, FinanceFormulas::getPeriodsOfPVAF($p, $r), 0.01);
}
/**
* @testdox The due present value the annuity is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testPresentValueOfAnnuityDue() : void
{
$expected = 454.60;
$P = 100.00;
$r = 0.05;
$n = 5;
$PV = FinanceFormulas::getPresentValueOfAnnuityDue($P, $r, $n);
self::assertEqualsWithDelta(\round($expected, 2), \round($PV, 2), 0.01);
self::assertEqualsWithDelta(\round($P, 2), FinanceFormulas::getPeriodicPaymentOfPVAD($PV, $r, $n), 0.01);
self::assertEqualsWithDelta($n, FinanceFormulas::getPeriodsOfPVAD($PV, $P, $r), 0.01);
}
/**
* @testdox The due future value the annuity is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testFutureValueOfAnnuityDue() : void
{
$expected = 580.19;
$P = 100.00;
$r = 0.05;
$n = 5;
$FV = FinanceFormulas::getFutureValueOfAnnuityDue($P, $r, $n);
self::assertEqualsWithDelta(\round($expected, 2), \round($FV, 2), 0.01);
self::assertEqualsWithDelta(\round($P, 2), FinanceFormulas::getPeriodicPaymentOfFVAD($FV, $r, $n), 0.01);
self::assertEqualsWithDelta($n, FinanceFormulas::getPeriodsOfFVAD($FV, $P, $r), 0.01);
}
/**
* @testdox The relative market share calculations by shares and ales are correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testRelativeMarketShare() : void
{
self::assertEqualsWithDelta(300 / 400, FinanceFormulas::getRelativeMarketShareByShare(300, 400), 0.01);
self::assertEqualsWithDelta(300 / 400, FinanceFormulas::getRelativeMarketShareBySales(300, 400), 0.01);
}
/**
* @testdox The asset ratio calculations are correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testAssetRatios() : void
{
self::assertEqualsWithDelta(3 / 2, FinanceFormulas::getAssetToSalesRatio(3, 2), 0.01);
self::assertEqualsWithDelta(2 / 3, FinanceFormulas::getAssetTurnoverRatio(3, 2), 0.01);
}
/**
* @testdox Balance ratio calculations for DII, Receivables/Turnover, and more are correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testBalanceRatios() : void
{
self::assertEqualsWithDelta(365 / 1000, FinanceFormulas::getDaysInInventory(1000), 0.01);
self::assertEqualsWithDelta(365 / 1000, FinanceFormulas::getAverageCollectionPeriod(1000), 0.01);
self::assertEqualsWithDelta(500 / 1000, FinanceFormulas::getReceivablesTurnover(500, 1000), 0.01);
self::assertEqualsWithDelta(500 / 1000, FinanceFormulas::getCurrentRatio(500, 1000), 0.01);
}
/**
* @testdox Dept ratios for dept coverage, dept to equity and dept to income are correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testDeptRatios() : void
{
self::assertEqualsWithDelta(500 / 1000, FinanceFormulas::getDebtCoverageRatio(500, 1000), 0.01);
self::assertEqualsWithDelta(500 / 1000, FinanceFormulas::getDebtRatio(500, 1000), 0.01);
self::assertEqualsWithDelta(500 / 1000, FinanceFormulas::getDebtToEquityRatio(500, 1000), 0.01);
self::assertEqualsWithDelta(500 / 1000, FinanceFormulas::getDebtToIncomeRatio(500, 1000), 0.01);
}
/**
* @testdox Return on balance statement positions are correct (e.g. return on assets, on equity)
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testReturnOnBalancePositions() : void
{
self::assertEqualsWithDelta(500 / 1000, FinanceFormulas::getReturnOnAssets(500, 1000), 0.01);
self::assertEqualsWithDelta(500 / 1000, FinanceFormulas::getReturnOnEquity(500, 1000), 0.01);
self::assertEqualsWithDelta(500 / 1000 - 1, FinanceFormulas::getReturnOnInvestment(500, 1000), 0.01);
}
/**
* @testdox Balance / P&L ratios are correct (e.g. inventory turnover, net profit margin)
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testBalancePLRatios() : void
{
self::assertEqualsWithDelta(500 / 1000, FinanceFormulas::getInventoryTurnoverRatio(500, 1000), 0.01);
self::assertEqualsWithDelta(500 / 1000, FinanceFormulas::getNetProfitMargin(500, 1000), 0.01);
self::assertEqualsWithDelta(500 / 1000, FinanceFormulas::getReceivablesTurnoverRatio(500, 1000), 0.01);
}
/**
* @testdox Various ratios are correct (e.g. interest coverage, quick ratio, rate of inflation)
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testRatios() : void
{
self::assertEqualsWithDelta(500 / 1000, FinanceFormulas::getInterestCoverageRatio(500, 1000), 0.01);
self::assertEqualsWithDelta(500 / 1000, FinanceFormulas::getQuickRatio(500, 1000), 0.01);
self::assertEqualsWithDelta((500 - 300) / 500, FinanceFormulas::getRetentionRatio(500, 300), 0.01);
self::assertEqualsWithDelta(500 / 1000 - 1, FinanceFormulas::getRateOfInflation(500, 1000), 0.01);
self::assertEqualsWithDelta(1000 / 500, FinanceFormulas::getPaybackPeriod(1000, 500), 0.01);
self::assertEqualsWithDelta(100 / 0.15, FinanceFormulas::getPresentValueOfPerpetuity(100, 0.15), 0.01);
}
/**
* @testdox Compound calculations for interest, principal and periods are correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testCompound() : void
{
$expected = 15.76;
$P = 100.00;
$r = 0.05;
$t = 3;
$C = \round(FinanceFormulas::getCompoundInterest($P, $r, $t), 2);
self::assertEqualsWithDelta(\round($expected, 2), $C, 0.01);
self::assertEqualsWithDelta($P, FinanceFormulas::getPrincipalOfCompoundInterest($C, $r, $t), 0.1);
self::assertEqualsWithDelta($t, (int) \round(FinanceFormulas::getPeriodsOfCompoundInterest($P, $C, $r), 0), 0.01);
}
/**
* @testdox Continuous compound calculations for interest, principal and periods are correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testContinuousCompounding() : void
{
$expected = 116.18;
$P = 100.00;
$r = 0.05;
$t = 3;
$C = \round(FinanceFormulas::getContinuousCompounding($P, $r, $t), 2);
self::assertEqualsWithDelta(\round($expected, 2), $C, 0.01);
self::assertEqualsWithDelta(\round($P, 2), \round(FinanceFormulas::getPrincipalOfContinuousCompounding($C, $r, $t), 2), 0.01);
self::assertEqualsWithDelta($t, FinanceFormulas::getPeriodsOfContinuousCompounding($P, $C, $r), 0.01);
self::assertEqualsWithDelta($r, FinanceFormulas::getRateOfContinuousCompounding($P, $C, $t), 0.01);
}
/**
* @testdox Calculations for interest, principal and periods are correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testSimpleInterest() : void
{
$P = 100.00;
$r = 0.05;
$t = 3;
$I = $P * $r * $t;
self::assertEqualsWithDelta($I, FinanceFormulas::getSimpleInterest($P, $r, $t), 0.01);
self::assertEqualsWithDelta($P, FinanceFormulas::getSimpleInterestPrincipal($I, $r, $t), 0.01);
self::assertEqualsWithDelta($r, FinanceFormulas::getSimpleInterestRate($I, $P, $t), 0.01);
self::assertEqualsWithDelta($t, FinanceFormulas::getSimpleInterestTime($I, $P, $r), 0.01);
}
/**
* @testdox The discounted payback period is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testDiscountedPaybackPeriod() : void
{
$O1 = 5000;
$r = 0.05;
$CF = 1000;
self::assertEqualsWithDelta(5.896, FinanceFormulas::getDiscountedPaybackPeriod($CF, $O1, $r), 0.01);
}
/**
* @testdox Test the correct calculation of the growth rate in order to double and vice versa
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testDoublingTime() : void
{
$r = 0.05;
self::assertEqualsWithDelta(14.207, FinanceFormulas::getDoublingTime($r), 0.01);
self::assertEqualsWithDelta($r, FinanceFormulas::getDoublingRate(14.207), 0.01);
}
/**
* @testdox Test the correct calculation of the growth rate in order to double and vice versa with continuous compounding
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testDoublingTimeContinuousCompounding() : void
{
$r = 0.05;
self::assertEqualsWithDelta(13.863, FinanceFormulas::getDoublingTimeContinuousCompounding($r), 0.01);
self::assertEqualsWithDelta($r, FinanceFormulas::getDoublingContinuousCompoundingRate(13.863), 0.01);
}
/**
* @testdox Calculations for equivalent annual annuity are correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testEquivalentAnnualAnnuity() : void
{
$npv = 1000;
$r = 0.15;
$n = 7;
self::assertEqualsWithDelta(240.36, FinanceFormulas::getEquivalentAnnualAnnuity($npv, $r, $n), 0.01);
self::assertEqualsWithDelta($n, FinanceFormulas::getPeriodsOfEAA(240.36, $npv, $r), 0.01);
self::assertEqualsWithDelta($npv, FinanceFormulas::getNetPresentValueOfEAA(240.36, $r, $n), 0.01);
}
/**
* @testdox The free cash flow to equity calculation is correct (how much cash is available after expenses and dept payments)
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testFreeCashFlowToEquity() : void
{
$income = 1000;
$depamo = 300;
$capital = 400;
$wc = 200;
$borrowing = 500;
self::assertEqualsWithDelta(1200, FinanceFormulas::getFreeCashFlowToEquity($income, $depamo, $capital, $wc, $borrowing), 0.01);
}
/**
* @testdox The free cash flow to firm calculation is correct (how much cash is available after expenses)
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testFreeCashFlowToFirm() : void
{
$ebit = 1000;
$depamo = 300;
$t = 0.15;
$capital = 400;
$wc = 200;
self::assertEqualsWithDelta(550, FinanceFormulas::getFreeCashFlowToFirm($ebit, $t, $depamo, $capital, $wc), 0.01);
}
/**
* @testdox The future value calculation is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testFutureValue() : void
{
$c = 1000;
$r = 0.15;
$n = 7;
self::assertEqualsWithDelta(2660.02, FinanceFormulas::getFutureValue($c, $r, $n), 0.01);
}
/**
* @testdox The future value calculation including continuous compounding is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testFutureValueContinuousCompounding() : void
{
$pv = 1000;
$r = 0.15;
$t = 7;
self::assertEqualsWithDelta(2857.65, FinanceFormulas::getFutureValueContinuousCompounding($pv, $r, $t), 0.01);
}
/**
* @testdox The future value factor calculation is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testValueFactor() : void
{
$r = 0.15;
$n = 7;
self::assertEqualsWithDelta(2.66, FinanceFormulas::getFutureValueFactor($r, $n), 0.01);
self::assertEqualsWithDelta(0.37594, FinanceFormulas::getPresentValueFactor($r, $n), 0.01);
}
/**
* @testdox The calculation of the geometric mean of multiple return rates is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testGeometricMeanReturn() : void
{
$r = [0.01, 0.02, 0.03, 0.04, 0.05, 0.06, 0.07];
self::assertEqualsWithDelta(0.04123, FinanceFormulas::getGeometricMeanReturn($r), 0.01);
}
/**
* @testdox The calculation of the future value of the growing annuity is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testGrowingAnnuityFV() : void
{
$p = 1000;
$r = 0.15;
$g = 0.1;
$n = 7;
self::assertEqualsWithDelta(14226.06, FinanceFormulas::getGrowingAnnuityFV($p, $r, $g, $n), 0.01);
}
/**
* @testdox The calculation of the payment based on the present value of the growing annuity is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testGrowingAnnuityPaymentPV() : void
{
$p = 1000;
$r = 0.15;
$g = 0.1;
$n = 7;
self::assertEqualsWithDelta(186.98, FinanceFormulas::getGrowingAnnuityPaymentPV($p, $r, $g, $n), 0.01);
}
/**
* @testdox The calculation of the payment based on the future value of the growing annuity is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testGrowingAnnuityPaymentFV() : void
{
$fv = 1000;
$r = 0.15;
$g = 0.1;
$n = 7;
self::assertEqualsWithDelta(70.29, FinanceFormulas::getGrowingAnnuityPaymentFV($fv, $r, $g, $n), 0.01);
}
/**
* @testdox The calculation of the present value of the growing annuity is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testGrowingAnnuityPV() : void
{
$p = 1000;
$r = 0.15;
$g = 0.1;
$n = 7;
self::assertEqualsWithDelta(5348.1, FinanceFormulas::getGrowingAnnuityPV($p, $r, $g, $n), 0.01);
}
/**
* @testdox The calculation of the present value of the growing perpetuity is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testGrowingPerpetuityPV() : void
{
$d = 1000;
$r = 0.15;
$g = 0.1;
self::assertEqualsWithDelta(20000, FinanceFormulas::getGrowingPerpetuityPV($d, $r, $g), 0.01);
}
/**
* @testdox The calculation of the net present value is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testNetPresentValue() : void
{
$c = [1000, 100, 200, 300, 400, 500, 600];
$r = 0.15;
self::assertEqualsWithDelta(172.13, FinanceFormulas::getNetPresentValue($c, $r), 0.01);
}
/**
* @testdox No cash flows in the net present value calculation result in 0
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testEmptyNetPresentValue() : void
{
self::assertEqualsWithDelta(0.0, FinanceFormulas::getNetPresentValue([], 0.1), 0.01);
}
/**
* @testdox The calculation of the real rate of return is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testRealRateOfReturn() : void
{
$nominal = 0.15;
$inflation = 0.05;
self::assertEqualsWithDelta(0.09524, FinanceFormulas::getRealRateOfReturn($nominal, $inflation), 0.01);
}
/**
* @testdox The calculation of the net working capital is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testNetWorkingCapital() : void
{
self::assertEqualsWithDelta(1000 - 600, FinanceFormulas::getNetWorkingCapital(1000, 600), 0.01);
}
/**
* @testdox The periods to reach a future value based on the present value is calculated correctly
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testNumberOfPeriodsPVFV() : void
{
$fv = 1200;
$pv = 1000;
$r = 0.03;
self::assertEqualsWithDelta(6.1681, FinanceFormulas::getNumberOfPeriodsPVFV($fv, $pv, $r), 0.01);
}
/**
* @testdox The calculation of the present value is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testPresentValue() : void
{
$c = 1000;
$r = 0.15;
$n = 7;
self::assertEqualsWithDelta(375.94, FinanceFormulas::getPresentValue($c, $r, $n), 0.01);
}
/**
* @testdox The calculation of the present value using continuous compounding is correct
* @covers \phpOMS\Business\Finance\FinanceFormulas
* @group framework
*/
public function testPresentValueContinuousCompounding() : void
{
$c = 1000;
$r = 0.15;
$t = 7;
self::assertEqualsWithDelta(349.94, FinanceFormulas::getPresentValueContinuousCompounding($c, $r, $t), 0.01);
}
}
Reference in New Issue View Git Blame Copy Permalink