[pull] master from markrogoyski:master

.github/workflows/test_develop_and_master.yml

@@ -8,11 +8,11 @@ on:
 
 jobs:
   test-and-static-analysis:
-    name: Test and Static Analysis
+    name: Test and Lint
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        php: ['7.2', '7.3', '7.4', '8.0']
+        php: ['7.2', '7.3', '7.4', '8.0', '8.1', '8.2', '8.3']
 
     steps:
       - name: Set up PHP
@@ -23,12 +23,12 @@ jobs:
           tools: composer:v2
 
       - name: Set up Node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
-          node-version: '14.x'
+          node-version: '20.x'
 
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
@@ -54,7 +54,42 @@ jobs:
           ./vendor/bin/phpunit --configuration tests/phpunit.xml --testsuite=LinearAlgebra
 
       - name: PHP Code Sniffer
-        run: ./vendor/bin/phpcs --ignore=vendor --standard=tests/coding_standard.xml -s .
+        run: |
+          ./vendor/bin/phpcs --version
+          ./vendor/bin/phpcs --ignore=vendor --standard=tests/coding_standard.xml -s .
+
+  static-analysis:
+    name: Static Analysis
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        php: ['7.2']
+
+    steps:
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          coverage: xdebug
+          tools: composer:v2
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Run Composer
+        run: composer install --no-interaction
+
+      - name: Static analysis
+        run: |
+          ./vendor/bin/phpstan --version
+          ./vendor/bin/phpstan analyze -c tests/phpstan.neon
 
   code-coverage:
     name: Code coverage
@@ -72,12 +107,12 @@ jobs:
           tools: composer:v2
 
       - name: Set up Node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
-          node-version: '14.x'
+          node-version: '20.x'
 
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 

.github/workflows/test_other_branches.yml

@@ -7,12 +7,12 @@ on:
       - master
 
 jobs:
-  test-and-static-analysis:
-    name: Test and Static Analysis
+  test-and-lint:
+    name: Test and Lint
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        php: ['7.2', '7.3', '7.4', '8.0']
+        php: ['7.2', '7.3', '7.4', '8.0', '8.1', '8.2', '8.3']
 
     steps:
       - name: Set up PHP
@@ -22,12 +22,12 @@ jobs:
           tools: composer:v2
 
       - name: Set up Node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
-          node-version: '14.x'
+          node-version: '20.x'
 
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
@@ -53,4 +53,39 @@ jobs:
           ./vendor/bin/phpunit --configuration tests/phpunit.xml --testsuite=LinearAlgebra
 
       - name: PHP Code Sniffer
-        run: ./vendor/bin/phpcs --ignore=vendor --standard=tests/coding_standard.xml -s .
+        run: |
+          ./vendor/bin/phpcs --version
+          ./vendor/bin/phpcs --ignore=vendor --standard=tests/coding_standard.xml -s .
+
+  static-analysis:
+    name: Static Analysis
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        php: ['7.2']
+
+    steps:
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          coverage: xdebug
+          tools: composer:v2
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Run Composer
+        run: composer install --no-interaction
+
+      - name: Static analysis
+        run: |
+          ./vendor/bin/phpstan --version
+          ./vendor/bin/phpstan analyze -c tests/phpstan.neon

.github/workflows/test_pull_request.yml

@@ -4,11 +4,11 @@ on: pull_request
 
 jobs:
   test-and-static-analysis:
-    name: Test and Static Analysis
+    name: Test and Lint
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        php: ['7.2', '7.3', '7.4', '8.0']
+        php: ['7.2', '7.3', '7.4', '8.0', '8.1', '8.2', '8.3']
 
     steps:
       - name: Set up PHP
@@ -19,12 +19,12 @@ jobs:
           tools: composer:v2
 
       - name: Set up Node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
-          node-version: '14.x'
+          node-version: '20.x'
 
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
@@ -50,7 +50,42 @@ jobs:
           ./vendor/bin/phpunit --configuration tests/phpunit.xml --testsuite=LinearAlgebra
 
       - name: PHP Code Sniffer
-        run: ./vendor/bin/phpcs --ignore=vendor --standard=tests/coding_standard.xml -s .
+        run: |
+          ./vendor/bin/phpcs --version
+          ./vendor/bin/phpcs --ignore=vendor --standard=tests/coding_standard.xml -s .
+
+  static-analysis:
+    name: Static Analysis
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        php: ['7.2']
+
+    steps:
+      - name: Set up PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          coverage: xdebug
+          tools: composer:v2
+
+      - name: Set up Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Run Composer
+        run: composer install --no-interaction
+
+      - name: Static analysis
+        run: |
+          ./vendor/bin/phpstan --version
+          ./vendor/bin/phpstan analyze -c tests/phpstan.neon
 
   code-coverage:
     name: Code coverage
@@ -68,12 +103,12 @@ jobs:
           tools: composer:v2
 
       - name: Set up Node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
-          node-version: '14.x'
+          node-version: '20.x'
 
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 

CHANGELOG.md

@@ -1,5 +1,54 @@
 # MathPHP Change Log
 
+## v2.10.0 - 2024-04-16
+
+### New Features
+* NumberTheory\Integer `isPrime`
+
+## v2.9.0 - 2024-03-02
+
+### New Features
+* Distance `chebyshev`
+
+### Improvements
+* Internal build CI/CD improvements
+
+## v2.8.1 - 2023-05-18
+
+### Improvements
+* Internal improvements to improve conformance with static analysis tools
+
+## v2.8.0 - 2023-05-07
+
+### New Features
+* Matrix `rowAddVector`
+* Matrix `columnAddVector`
+
+### Improvements
+* Better error handling and exception message in `Sequence\NonIntenger::hyperharmonic`
+* Internal code improvements to conform to static analysis checks
+
+### Backwards Incompatible Changes
+* Helper method names changed (public abstract methods but not part of published interface)
+  * `NumericalDifferentiation::isTargetInPoints` changed to `assertTargetInPoints`
+  * `NumericalDifferentiation::isSpacingConstant` changed to `assertSpacingConstant`
+
+## v2.7.0 - 2022-12-31
+
+### Improvements
+* Improved algorithm for `regularizedIncompleteBeta`: Addresses issue 458
+* Issue 456: Improved PHPDoc blocks: Changed "number" to "int|float"
+* Added PHP 8.2 for CI test target
+
+## v2.6.0 - 2022-04-10
+
+### Improvements
+* `Average::truncatedMean` behavior at 50% trim made consistent
+* PHP 8.1 compatibility improvements
+
+### Backwards Incompatible Changes
+# `Average::truncatedMean` throws exception if trim percent greater than 50% rather than error or unpredictable results.
+
 ## v2.5.0 - 2021-11-21
 
 ### New Features

Makefile

@@ -12,7 +12,7 @@ style :
 	vendor/bin/phpcs --standard=tests/coding_standard.xml --ignore=vendor -s .
 
 phpstan :
-	vendor/bin/phpstan analyze --level max src/
+	vendor/bin/phpstan analyze -c tests/phpstan.neon
 
 phpmd :
 	vendor/bin/phpmd src/ ansi cleancode,codesize,design,unusedcode,naming

README.md

@@ -444,16 +444,22 @@ $Aᵢⱼ = $A[2][2];
 // Row operations
 [$mᵢ, $mⱼ, $k] = [1, 2, 5];
 $R = $A->rowInterchange($mᵢ, $mⱼ);
-$R = $A->rowMultiply($mᵢ, $k);     // Multiply row mᵢ by k
-$R = $A->rowAdd($mᵢ, $mⱼ, $k);     // Add k * row mᵢ to row mⱼ
-$R = $A->rowExclude($mᵢ);          // Exclude row $mᵢ
+$R = $A->rowExclude($mᵢ);             // Exclude row $mᵢ
+$R = $A->rowMultiply($mᵢ, $k);        // Multiply row mᵢ by k
+$R = $A->rowDivide($mᵢ, $k);          // Divide row mᵢ by k
+$R = $A->rowAdd($mᵢ, $mⱼ, $k);        // Add k * row mᵢ to row mⱼ
+$R = $A->rowAddScalar($mᵢ, $k);       // Add k to each item of row mᵢ
+$R = $A->rowAddVector($mᵢ, $V);       // Add Vector V to row mᵢ
+$R = $A->rowSubtract($mᵢ, $mⱼ, $k);   // Subtract k * row mᵢ from row mⱼ
+$R = $A->rowSubtractScalar($mᵢ, $k);  // Subtract k from each item of row mᵢ
 
 // Column operations
 [$nᵢ, $nⱼ, $k] = [1, 2, 5];
 $R = $A->columnInterchange($nᵢ, $nⱼ);
+$R = $A->columnExclude($nᵢ);          // Exclude column $nᵢ
 $R = $A->columnMultiply($nᵢ, $k);     // Multiply column nᵢ by k
 $R = $A->columnAdd($nᵢ, $nⱼ, $k);     // Add k * column nᵢ to column nⱼ
-$R = $A->columnExclude($nᵢ);          // Exclude column $nᵢ
+$R = $A->columnAddVector($nᵢ, $V);    // Add Vector V to column nᵢ
 
 // Matrix augmentations - return a new Matrix
 $⟮A∣B⟯ = $A->augment($B);        // Augment on the right - standard augmentation
@@ -859,7 +865,8 @@ use MathPHP\NumberTheory\Integer;
 
 $n = 225;
 
-// Prime factorization
+// Prime numbers
+$bool    = Integer::isPrime($n);
 $factors = Integer::primeFactorization($n);
 
 // Divisor function
@@ -971,7 +978,7 @@ $f’⟮x⟯ = function ($x) {
 };
 [$start, $end, $n] = [0, 3, 4];
 
-$p = Interpolation\ClampedCubicSpline::interpolate($points);                // input as a set of points
+$p = Interpolation\ClampedCubicSpline::interpolate($points);                       // input as a set of points
 $p = Interpolation\ClampedCubicSpline::interpolate($f⟮x⟯, $f’⟮x⟯, $start, $end, $n); // input as a callback function
 
 $p(0); // 1
@@ -1773,7 +1780,7 @@ $hexagons = Advanced::hexagonalNumber($n);
 // [1, 6, 15, 28, 45, 66] - Indexed from 1
 
 // Heptagonal numbers (figurate number)
-$hexagons = Advanced::heptagonalNumber($n);
+$heptagons = Advanced::heptagonalNumber($n);
 // [1, 4, 7, 13, 18, 27] - Indexed from 1
 
 // Look-and-say sequence (describe the previous term!)
@@ -2022,7 +2029,7 @@ $interquartile_mean  = Average::iqm($numbers);               // same as interqua
 $cubic_mean          = Average::cubicMean($numbers);
 
 // Truncated mean (trimmed mean)
-$trim_percent   = 25;
+$trim_percent   = 25;  // 25 percent of observations trimmed from each end of distribution
 $truncated_mean = Average::truncatedMean($numbers, $trim_percent);
 
 // Generalized mean (power mean)
@@ -2260,6 +2267,7 @@ $d⟮X、Y⟯    = Distance::canberra($X, Y);
 brayCurtis = Distance::brayCurtis($X, $Y);
 $cosine    = Distance::cosine($X, $Y);
 $cos⟮α⟯     = Distance::cosineSimilarity($X, $Y);
+$D⟮X、Y⟯    = Distance::chebyshev($X, $Y);
 
 // Mahalanobis distance
 $x    = new Matrix([[6], [5]]);

composer.json

@@ -15,7 +15,7 @@
       "phpunit/phpunit": "^8.5",
       "php-coveralls/php-coveralls": "^2.0",
       "squizlabs/php_codesniffer": "3.*",
-      "phpstan/phpstan": "*",
+      "phpstan/phpstan": "^1.10",
       "phpmd/phpmd": "^2.6",
       "phploc/phploc": "*",
       "php-parallel-lint/php-parallel-lint": "^1.2"