4.0

.github/workflows/ci.yml

@@ -79,9 +79,6 @@ jobs:
       - name: Install Dependencies
         run: composer install
 
-      - name: Static Analysis
-        run: composer analyze
-
       - name: Unit Tests
         run: composer test
 

AGENTS.md

@@ -17,8 +17,8 @@ Guidance for AI coding agents contributing to **Tensor** — a scientific-comput
 
 ## Environment
 
-- PHP **8.1+** (CI matrix is 8.1 → 8.5). `composer.json` declares `>=1.0`.
-- Dev tooling is installed as Composer dev dependencies (PHPStan, php-cs-fixer, phpunit, phpbench, Zephir).
+- PHP **8.1+** (CI matrix is 8.1 → 8.5). `composer.json` declares `>=8.1`.
+- Dev tooling is installed as Composer dev dependencies (php-cs-fixer, phpunit, phpbench, Zephir).
 - Compiling the extension additionally needs a C compiler, GFortran, `phpize`, OpenBLAS dev headers, LAPACKE, and re2c (see README for per-OS install commands).
 
 ## Commands
@@ -29,20 +29,18 @@ All are Composer scripts (see `composer.json`):
 | --- | --- |
 | Install deps | `composer install` |
 | Validate manifest | `composer validate` |
-| Static analysis | `composer analyze` (PHPStan level 8 over `tests`, `benchmarks`) |
 | Run tests | `composer test` (PHPUnit, test suite `Base`; requires the extension to be loaded) |
 | Check style | `composer check` (php-cs-fixer, dry-run; sets `PHP_CS_FIXER_IGNORE_ENV=1`) |
 | Fix style | `composer fix` |
 | Full build | `composer build` = validate → install → analyze → test → check |
 | Benchmarks | `composer benchmark` (requires the extension to be loaded) |
-| Compile extension | `composer compile` = zephir generate → `php build-ext` → zephir compile |
+| Compile extension | `composer compile` = zephir generate → zephir compile |
 | Clean generated extension | `composer clean` (zephir fullclean) |
 
 **Recommended loop before submitting a change:**
 
 ```sh
 composer install
-composer analyze
 composer test
 composer fix
 ```
@@ -52,12 +50,11 @@ composer fix
 ## Conventions to follow
 
 - **Coding style** is governed by `.php-cs-fixer.dist.php` (extends `@PSR2`). Highlights: single quotes, short array syntax, compact nullable type hints, pre-increment, ordered class elements, trimmed/multi-line phpdoc, `echo` over `print`. Rather than memorize the rule set, run `composer fix`.
-- **Static analysis is required.** New code must pass PHPStan level 8 (`composer analyze`). Keep types accurate; the codebase uses docblock generics like `list<float>` and `int<0,max>`.
 - **Testing guidance** (from `CONTRIBUTING.md`):
   - New functionality ships with a matching unit test in `tests/`.
   - Bug fixes ship with a passing test that would have reproduced the bug beforehand.
   - Tests target public methods and cover edge cases / invalid input.
-- **Documentation & changelog:** update docs if behavior changes, and add a `CHANGELOG.md` entry for user-facing changes.
+- **Documentation:** update docs if behavior changes.
 - **PHPDoc:** classes use `@category` / `@package` / `@author` blocks; methods carry param and return annotations. Use `@var list<float>` for element arrays.
 - **Exceptions** are typed under `Tensor\Exceptions` (e.g. `InvalidArgumentException`, `DimensionalityMismatch`, `RuntimeException`). Use the existing ones rather than `Exception`.
 - **Math is float-only.** Values stored/computed as `float`; don't introduce integer-only branches. When adding a new operation, mirror it across the `Tensor` sub-interfaces (`Arithmetic`, `Comparable`, `Algebraic`, `Trigonometric`, `Statistical`, `Special`).
@@ -70,16 +67,16 @@ Every public method a new `tensor/` class adds typically routes into the C backi
 1. Update the Zephir class in `tensor/`.
 2. Add/adjust the matching `optimizers/Tensor<Op>Optimizer.php` if it is a callable that the extension should route into C.
 3. Ensure the underlying C implementation exists under `ext/include/*.c` and is linked (already wired in `config.json` `extra-sources`).
-4. Bump the version in both `config.json` and `package.xml` if this is a released change, and record it in `CHANGELOG.md`.
+4. Bump the version in both `config.json` if this is a released change, and record it in `CHANGELOG.md`.
 
 Do **not** hand-edit the generated C in `ext/` (files like `*.dep`, `*.lo`, `*.o`, `Makefile*`, `config.h`). They are produced by `composer compile`. Hand-written logic belongs in `ext/include/*.c`.
 
 ## Working verification paths
 
-To run the tests against the locally compiled extension, load the built shared object. For example:
+An installed TEnsor extension will override any new changes. To run the tests against the locally compiled extension, load the built shared object. For example:
 
 ```sh
-php -n -d extension=$PWD/ext/modules/tensor.so vendor/bin/phpunit ...
+php -n -d extension=$PWD/ext/modules/tensor_ext.so extension=iconv -d extension=mbstring -d extension=tokenizer -d extension=dom -d extension=xml -d extension=ctype -d extension=xmlwriter vendor/bin/phpunit ...
 ```
 
 If a system-installed `tensor` extension is already enabled, you can rely on it instead of building locally.

CHANGELOG.md

@@ -1,7 +1,7 @@
 # Change Log
 
-- 3.1.1
-    - Just triggering the first Packagist release
+- 4.0.0
+    - Speed up `Vector::fromArray()` and `Matrix::fromArray()` by eliminating intermediate array copies
 
 - 3.1.0
     - Implemented the singular value decomposition (SVD) in the extension

benchmarks/Arithmetic/ColumnVectorMatrixDivideBench.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Tensor\Benchmarks\Arithmetic;
+
+use Tensor\Matrix;
+use Tensor\ColumnVector;
+
+/**
+ * @Groups({"Arithmetic"})
+ * @BeforeMethods({"setUp"})
+ */
+class ColumnVectorMatrixDivideBench
+{
+    /**
+     * @var \Tensor\Vector
+     */
+    protected $a;
+
+    /**
+     * @var Matrix
+     */
+    protected $b;
+
+    public function setUp() : void
+    {
+        $this->a = ColumnVector::uniform(1000);
+
+        $this->b = Matrix::uniform(1000, 1000);
+    }
+
+    /**
+     * @Subject
+     * @Iterations(5)
+     * @OutputTimeUnit("seconds", precision=3)
+     */
+    public function divide() : void
+    {
+        $this->a->divide($this->b);
+    }
+}

benchmarks/Arithmetic/MatrixColumnVectorDivideBench.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Tensor\Benchmarks\Arithmetic;
+
+use Tensor\Matrix;
+use Tensor\ColumnVector;
+
+/**
+ * @Groups({"Arithmetic"})
+ * @BeforeMethods({"setUp"})
+ */
+class MatrixColumnVectorDivideBench
+{
+    /**
+     * @var Matrix
+     */
+    protected $a;
+
+    /**
+     * @var ColumnVector
+     */
+    protected $b;
+
+    public function setUp() : void
+    {
+        $this->a = Matrix::uniform(1000, 1000);
+
+        $this->b = ColumnVector::uniform(1000);
+    }
+
+    /**
+     * @Subject
+     * @Iterations(5)
+     * @OutputTimeUnit("seconds", precision=3)
+     */
+    public function divide() : void
+    {
+        $this->a->divide($this->b);
+    }
+}

benchmarks/Arithmetic/MatrixColumnVectorSubtractBench.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Tensor\Benchmarks\Arithmetic;
+
+use Tensor\Matrix;
+use Tensor\ColumnVector;
+
+/**
+ * @Groups({"Arithmetic"})
+ * @BeforeMethods({"setUp"})
+ */
+class MatrixColumnVectorSubtractBench
+{
+    /**
+     * @var Matrix
+     */
+    protected $a;
+
+    /**
+     * @var ColumnVector
+     */
+    protected $b;
+
+    public function setUp() : void
+    {
+        $this->a = Matrix::uniform(1000, 1000);
+
+        $this->b = ColumnVector::uniform(1000);
+    }
+
+    /**
+     * @Subject
+     * @Iterations(5)
+     * @OutputTimeUnit("seconds", precision=3)
+     */
+    public function subtract() : void
+    {
+        $this->a->subtract($this->b);
+    }
+}

benchmarks/Arithmetic/MatrixVectorAddBench.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Tensor\Benchmarks\Arithmetic;
+
+use Tensor\Matrix;
+use Tensor\Vector;
+
+/**
+ * @Groups({"Arithmetic"})
+ * @BeforeMethods({"setUp"})
+ */
+class MatrixVectorAddBench
+{
+    /**
+     * @var Matrix
+     */
+    protected $a;
+
+    /**
+     * @var Vector
+     */
+    protected $b;
+
+    public function setUp() : void
+    {
+        $this->a = Matrix::uniform(1000, 1000);
+
+        $this->b = Vector::uniform(1000);
+    }
+
+    /**
+     * @Subject
+     * @Iterations(5)
+     * @OutputTimeUnit("seconds", precision=3)
+     */
+    public function add() : void
+    {
+        $this->a->add($this->b);
+    }
+}

benchmarks/Arithmetic/MatrixVectorDivideBench.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Tensor\Benchmarks\Arithmetic;
+
+use Tensor\Matrix;
+use Tensor\Vector;
+
+/**
+ * @Groups({"Arithmetic"})
+ * @BeforeMethods({"setUp"})
+ */
+class MatrixVectorDivideBench
+{
+    /**
+     * @var Matrix
+     */
+    protected $a;
+
+    /**
+     * @var Vector
+     */
+    protected $b;
+
+    public function setUp() : void
+    {
+        $this->a = Matrix::uniform(1000, 1000);
+
+        $this->b = Vector::uniform(1000);
+    }
+
+    /**
+     * @Subject
+     * @Iterations(5)
+     * @OutputTimeUnit("seconds", precision=3)
+     */
+    public function divide() : void
+    {
+        $this->a->divide($this->b);
+    }
+}

benchmarks/Arithmetic/VectorMatrixMultiplyBench.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Tensor\Benchmarks\Arithmetic;
+
+use Tensor\Matrix;
+use Tensor\Vector;
+
+/**
+ * @Groups({"Arithmetic"})
+ * @BeforeMethods({"setUp"})
+ */
+class VectorMatrixMultiplyBench
+{
+    /**
+     * @var Vector
+     */
+    protected $a;
+
+    /**
+     * @var Matrix
+     */
+    protected $b;
+
+    public function setUp() : void
+    {
+        $this->a = Vector::uniform(1000);
+
+        $this->b = Matrix::uniform(1000, 1000);
+    }
+
+    /**
+     * @Subject
+     * @Iterations(5)
+     * @OutputTimeUnit("seconds", precision=3)
+     */
+    public function multiply() : void
+    {
+        $this->a->multiplyMatrix($this->b);
+    }
+}