From a2636f1f5f967e9bef0adfc039d60c15d8608914 Mon Sep 17 00:00:00 2001
From: CismonX <admin@cismon.net>
Date: Sun, 10 Mar 2019 23:23:11 +0800
Subject: [PATCH] update stubs

---
 stubs/impl/CxDCol.php                |   2 +-
 stubs/impl/CxDMat.php                |   2 +-
 stubs/impl/CxDRow.php                |   2 +-
 stubs/impl/CxDSvCol.php              |   8 ++
 stubs/impl/CxDSvRow.php              |   8 ++
 stubs/impl/{DColvec.php => DCol.php} |   2 +-
 stubs/impl/DMat.php                  |   2 +-
 stubs/impl/DRow.php                  |   2 +-
 stubs/impl/DSvCol.php                |   8 ++
 stubs/impl/DSvRow.php                |   8 ++
 stubs/impl/ICol.php                  |   2 +-
 stubs/impl/IMat.php                  |   2 +-
 stubs/impl/IRow.php                  |   2 +-
 stubs/impl/ISvCol.php                |   8 ++
 stubs/impl/ISvRow.php                |   8 ++
 stubs/impl/SpCxDMat.php              |   2 +-
 stubs/impl/SpDMat.php                |   2 +-
 stubs/impl/SpIMat.php                |   2 +-
 stubs/internal/Common.php            |  17 ----
 stubs/internal/Dense.php             |   2 +-
 stubs/internal/Matrix.php            | 132 ++++++++++++++++++---------
 stubs/internal/Resizable.php         |  23 +++++
 stubs/internal/ResizableMatrix.php   |  37 ++++++++
 stubs/internal/ResizableVector.php   |  23 +++++
 stubs/internal/Sparse.php            |  18 +++-
 stubs/internal/Splittable.php        |  83 -----------------
 stubs/internal/Vector.php            |  27 ++++++
 27 files changed, 279 insertions(+), 155 deletions(-)
 create mode 100644 stubs/impl/CxDSvCol.php
 create mode 100644 stubs/impl/CxDSvRow.php
 rename stubs/impl/{DColvec.php => DCol.php} (57%)
 create mode 100644 stubs/impl/DSvCol.php
 create mode 100644 stubs/impl/DSvRow.php
 create mode 100644 stubs/impl/ISvCol.php
 create mode 100644 stubs/impl/ISvRow.php
 create mode 100644 stubs/internal/Resizable.php
 create mode 100644 stubs/internal/ResizableMatrix.php
 create mode 100644 stubs/internal/ResizableVector.php
 delete mode 100644 stubs/internal/Splittable.php

diff --git a/stubs/impl/CxDCol.php b/stubs/impl/CxDCol.php
index dcb3a31..78b9b23 100644
--- a/stubs/impl/CxDCol.php
+++ b/stubs/impl/CxDCol.php
@@ -2,7 +2,7 @@
 
 namespace Arma;
 
-class CxDCol implements Col
+class CxDCol implements Col, Internal\ResizableVector
 {
     /**
      * Construct a complex column vector out of two non-complex column vectors.
diff --git a/stubs/impl/CxDMat.php b/stubs/impl/CxDMat.php
index de4bc7c..0759697 100644
--- a/stubs/impl/CxDMat.php
+++ b/stubs/impl/CxDMat.php
@@ -2,7 +2,7 @@
 
 namespace Arma;
 
-class CxDMat implements Mat
+class CxDMat implements Mat, Internal\ResizableMatrix
 {
     /**
      * Construct a complex matrix out of two non-complex matrices.
diff --git a/stubs/impl/CxDRow.php b/stubs/impl/CxDRow.php
index 58645bc..d295984 100644
--- a/stubs/impl/CxDRow.php
+++ b/stubs/impl/CxDRow.php
@@ -2,7 +2,7 @@
 
 namespace Arma;
 
-class CxDRow implements Row
+class CxDRow implements Row, Internal\ResizableVector
 {
     /**
      * Construct a complex row vector out of two non-complex row vectors.
diff --git a/stubs/impl/CxDSvCol.php b/stubs/impl/CxDSvCol.php
new file mode 100644
index 0000000..ca05941
--- /dev/null
+++ b/stubs/impl/CxDSvCol.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Arma;
+
+class CxDSvCol implements SvCol
+{
+
+}
diff --git a/stubs/impl/CxDSvRow.php b/stubs/impl/CxDSvRow.php
new file mode 100644
index 0000000..3720ba6
--- /dev/null
+++ b/stubs/impl/CxDSvRow.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Arma;
+
+class CxDSvRow implements SvRow
+{
+
+}
diff --git a/stubs/impl/DColvec.php b/stubs/impl/DCol.php
similarity index 57%
rename from stubs/impl/DColvec.php
rename to stubs/impl/DCol.php
index 438d95a..33bcc0d 100644
--- a/stubs/impl/DColvec.php
+++ b/stubs/impl/DCol.php
@@ -2,7 +2,7 @@
 
 namespace Arma;
 
-class DCol implements Col
+class DCol implements Col, Internal\ResizableVector
 {
 
 }
diff --git a/stubs/impl/DMat.php b/stubs/impl/DMat.php
index 9c948c8..6d79b09 100644
--- a/stubs/impl/DMat.php
+++ b/stubs/impl/DMat.php
@@ -2,7 +2,7 @@
 
 namespace Arma;
 
-class DMat implements Mat
+class DMat implements Mat, Internal\ResizableMatrix
 {
 
 }
diff --git a/stubs/impl/DRow.php b/stubs/impl/DRow.php
index 83a092e..3d55eba 100644
--- a/stubs/impl/DRow.php
+++ b/stubs/impl/DRow.php
@@ -2,7 +2,7 @@
 
 namespace Arma;
 
-class DRow implements Row
+class DRow implements Row, Internal\ResizableVector
 {
 
 }
diff --git a/stubs/impl/DSvCol.php b/stubs/impl/DSvCol.php
new file mode 100644
index 0000000..02361d8
--- /dev/null
+++ b/stubs/impl/DSvCol.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Arma;
+
+class DSvCol implements SvCol
+{
+
+}
diff --git a/stubs/impl/DSvRow.php b/stubs/impl/DSvRow.php
new file mode 100644
index 0000000..4ece880
--- /dev/null
+++ b/stubs/impl/DSvRow.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Arma;
+
+class DSvRow implements SvRow
+{
+
+}
diff --git a/stubs/impl/ICol.php b/stubs/impl/ICol.php
index 7f17f42..3cbdb93 100644
--- a/stubs/impl/ICol.php
+++ b/stubs/impl/ICol.php
@@ -2,7 +2,7 @@
 
 namespace Arma;
 
-class ICol implements Col
+class ICol implements Col, Internal\ResizableVector
 {
 
 }
diff --git a/stubs/impl/IMat.php b/stubs/impl/IMat.php
index 2d1ffb2..0df4284 100644
--- a/stubs/impl/IMat.php
+++ b/stubs/impl/IMat.php
@@ -2,7 +2,7 @@
 
 namespace Arma;
 
-class IMat implements Mat
+class IMat implements Mat, Internal\ResizableMatrix
 {
 
 }
diff --git a/stubs/impl/IRow.php b/stubs/impl/IRow.php
index 780893f..8ece1cd 100644
--- a/stubs/impl/IRow.php
+++ b/stubs/impl/IRow.php
@@ -2,7 +2,7 @@
 
 namespace Arma;
 
-class IRow implements Row
+class IRow implements Row, Internal\ResizableVector
 {
 
 }
diff --git a/stubs/impl/ISvCol.php b/stubs/impl/ISvCol.php
new file mode 100644
index 0000000..323ead1
--- /dev/null
+++ b/stubs/impl/ISvCol.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Arma;
+
+class ISvCol implements SvCol
+{
+
+}
diff --git a/stubs/impl/ISvRow.php b/stubs/impl/ISvRow.php
new file mode 100644
index 0000000..6c605b4
--- /dev/null
+++ b/stubs/impl/ISvRow.php
@@ -0,0 +1,8 @@
+<?php
+
+namespace Arma;
+
+class ISvRow implements SvRow
+{
+
+}
diff --git a/stubs/impl/SpCxDMat.php b/stubs/impl/SpCxDMat.php
index 2b4e5ba..3cb89a9 100644
--- a/stubs/impl/SpCxDMat.php
+++ b/stubs/impl/SpCxDMat.php
@@ -2,7 +2,7 @@
 
 namespace Arma;
 
-class SpCxDMat implements SpMat
+class SpCxDMat implements SpMat, Internal\ResizableMatrix
 {
     /**
      * Construct a complex sparse matrix out of two non-complex sparse matrices.
diff --git a/stubs/impl/SpDMat.php b/stubs/impl/SpDMat.php
index c860fa9..ec96894 100644
--- a/stubs/impl/SpDMat.php
+++ b/stubs/impl/SpDMat.php
@@ -2,7 +2,7 @@
 
 namespace Arma;
 
-class SpDMat implements SpMat
+class SpDMat implements SpMat, Internal\ResizableMatrix
 {
 
 }
diff --git a/stubs/impl/SpIMat.php b/stubs/impl/SpIMat.php
index 4602700..5d23074 100644
--- a/stubs/impl/SpIMat.php
+++ b/stubs/impl/SpIMat.php
@@ -2,7 +2,7 @@
 
 namespace Arma;
 
-class SpIMat implements SpMat
+class SpIMat implements SpMat, Internal\ResizableMatrix
 {
 
 }
diff --git a/stubs/internal/Common.php b/stubs/internal/Common.php
index f3056bd..5788156 100644
--- a/stubs/internal/Common.php
+++ b/stubs/internal/Common.php
@@ -99,16 +99,6 @@ interface Common
      */
     function div($other);
 
-    /**
-     * Set the size to be the same as the given object.
-     *
-     * The given object must be of the same root type as the calling object.
-     *
-     * @param static $other
-     * @return void
-     */
-    function copySize($other);
-
     /**
      * For all elements equal to $old_value, set them to $new_value.
      *
@@ -139,11 +129,4 @@ interface Common
      * @return void
      */
     function forEach($callback);
-
-    /**
-     * Reset the size to zero. The object will have no elements.
-     *
-     * @return void
-     */
-    function reset();
 }
diff --git a/stubs/internal/Dense.php b/stubs/internal/Dense.php
index 3784f85..df11509 100644
--- a/stubs/internal/Dense.php
+++ b/stubs/internal/Dense.php
@@ -7,7 +7,7 @@ namespace Arma\Internal;
  *
  * @package Arma\Internal
  */
-interface Dense extends Splittable
+interface Dense extends Common
 {
     /**
      * @inheritdoc
diff --git a/stubs/internal/Matrix.php b/stubs/internal/Matrix.php
index 821772a..e94be3f 100644
--- a/stubs/internal/Matrix.php
+++ b/stubs/internal/Matrix.php
@@ -28,47 +28,7 @@ interface Matrix
      */
     function eye($n_rows, $n_cols);
 
-    /**
-     * Recreate the object according to given size specifications, with the elements taken from the
-     * previous version of the object in a column-wise manner.
-     *
-     * The elements in the generated object are placed column-wise.
-     *
-     * @param $n_rows[optional]
-     * @param $n_cols[optional]
-     * @return void
-     */
-    function reshape($n_rows, $n_cols);
-
-    /**
-     * Recreate the object according to given size specifications, while preserving the elements
-     * as well as the layout of the elements.
-     *
-     * @param $n_rows[optional]
-     * @param $n_cols[optional]
-     * @return void
-     */
-    function resize($n_rows, $n_cols);
-
-    /**
-     * Change the size of an object, without explicitly preserving data and without initialising the elements.
-     *
-     * @param $n_rows[optional]
-     * @param $n_cols[optional]
-     * @return void
-     */
-    function setSize($n_rows, $n_cols);
-
-    /**
-     * Read/write access to a diagonal in a matrix.
-     *
-     * For k=0 the main diagonal is accessed. For k > 0, the k-th super-diagonal is accessed (top-right corner).
-     * For k < 0, the k-th sub-diagonal is accessed (bottom-left corner).
-     *
-     * @param int $k
-     * @return Subview
-     */
-    function diag($k = 0);
+    // Matrix characteristics
 
     /**
      * Check whether the matrix has exactly one column or one row.
@@ -111,4 +71,94 @@ interface Matrix
      * @return bool
      */
     function isHermitian();
+
+    // Matrix subview
+
+    /**
+     * Read/write access to a certain column of the object.
+     *
+     * @param int $col_number
+     * @return Subview
+     */
+    function col($col_number);
+
+    /**
+     * Read/write access to a certain row of the object.
+     *
+     * @param int $row_number
+     * @return Subview
+     */
+    function row($row_number);
+
+    /**
+     * Read/write access to certain columns of the object.
+     *
+     * @param int $first_col
+     * @param int $last_col
+     * @return Subview
+     */
+    function cols($first_col, $last_col);
+
+    /**
+     * Read/write access to certain rows of the object.
+     *
+     * @param int $first_row
+     * @param int $last_row
+     * @return Subview
+     */
+    function rows($first_row, $last_row);
+
+    /**
+     * Read/write access to a matrix subview.
+     *
+     * @param int $first_row
+     * @param int $first_col
+     * @param int $last_row
+     * @param int $last_col
+     * @return Subview
+     */
+    function submat($first_row, $first_col, $last_row, $last_col);
+
+    /**
+     * Read/write access to a matrix subview of first specified columns.
+     *
+     * @param $n_cols
+     * @return Subview
+     */
+    function head_cols($n_cols);
+
+    /**
+     * Read/write access to a matrix subview of first specified rows.
+     *
+     * @param int $n_rows
+     * @return Subview
+     */
+    function head_rows($n_rows);
+
+    /**
+     * Read/write access to a matrix subview of last specified columns.
+     *
+     * @param int $n_cols
+     * @return Subview
+     */
+    function tail_cols($n_cols);
+
+    /**
+     * Read/write access to a matrix subview of last specified rows.
+     *
+     * @param int $n_rows
+     * @return Subview
+     */
+    function tail_rows($n_rows);
+
+    /**
+     * Read/write access to a diagonal in a matrix.
+     *
+     * For k=0 the main diagonal is accessed. For k > 0, the k-th super-diagonal is accessed (top-right corner).
+     * For k < 0, the k-th sub-diagonal is accessed (bottom-left corner).
+     *
+     * @param int $k
+     * @return Subview
+     */
+    function diag($k = 0);
 }
diff --git a/stubs/internal/Resizable.php b/stubs/internal/Resizable.php
new file mode 100644
index 0000000..11d01c0
--- /dev/null
+++ b/stubs/internal/Resizable.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace Arma\Internal;
+
+interface Resizable
+{
+    /**
+     * Set the size to be the same as the given object.
+     *
+     * The given object must be of the same root type as the calling object.
+     *
+     * @param static $other
+     * @return void
+     */
+    function copySize($other);
+
+    /**
+     * Reset the size to zero. The object will have no elements.
+     *
+     * @return void
+     */
+    function reset();
+}
diff --git a/stubs/internal/ResizableMatrix.php b/stubs/internal/ResizableMatrix.php
new file mode 100644
index 0000000..2e6d23f
--- /dev/null
+++ b/stubs/internal/ResizableMatrix.php
@@ -0,0 +1,37 @@
+<?php
+
+namespace Arma\Internal;
+
+interface ResizableMatrix extends Resizable
+{
+    /**
+     * Recreate the object according to given size specifications, with the elements taken from the
+     * previous version of the object in a column-wise manner.
+     *
+     * The elements in the generated object are placed column-wise.
+     *
+     * @param int $n_rows
+     * @param int $n_cols
+     * @return void
+     */
+    function reshape($n_rows, $n_cols);
+
+    /**
+     * Recreate the object according to given size specifications, while preserving the elements
+     * as well as the layout of the elements.
+     *
+     * @param int $n_rows
+     * @param int $n_cols
+     * @return void
+     */
+    function resize($n_rows, $n_cols);
+
+    /**
+     * Change the size of an object, without explicitly preserving data and without initialising the elements.
+     *
+     * @param int $n_rows
+     * @param int $n_cols
+     * @return void
+     */
+    function setSize($n_rows, $n_cols);
+}
diff --git a/stubs/internal/ResizableVector.php b/stubs/internal/ResizableVector.php
new file mode 100644
index 0000000..20478b7
--- /dev/null
+++ b/stubs/internal/ResizableVector.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace Arma\Internal;
+
+interface ResizableVector extends Resizable
+{
+    /**
+     * Recreate the object according to given size specifications, while preserving the elements
+     * as well as the layout of the elements.
+     *
+     * @param int $n_elem
+     * @return void
+     */
+    function resize($n_elem);
+
+    /**
+     * Change the size of an object, without explicitly preserving data and without initialising the elements.
+     *
+     * @param int $n_elem
+     * @return void
+     */
+    function setSize($n_elem);
+}
\ No newline at end of file
diff --git a/stubs/internal/Sparse.php b/stubs/internal/Sparse.php
index a77fe83..f9dc72e 100644
--- a/stubs/internal/Sparse.php
+++ b/stubs/internal/Sparse.php
@@ -2,7 +2,23 @@
 
 namespace Arma\Internal;
 
-interface Sparse extends Splittable
+interface Sparse extends Common
 {
+    /**
+     * @inheritdoc
+     *
+     * @param int $i
+     * @param int $j[optional]
+     * @return \Arma\SpSvVal
+     */
+    function at($i, $j);
 
+    /**
+     * @inheritdoc
+     *
+     * @param int $i
+     * @param int $j[optional]
+     * @return \Arma\SpSvVal
+     */
+    function __invoke($i, $j);
 }
diff --git a/stubs/internal/Splittable.php b/stubs/internal/Splittable.php
deleted file mode 100644
index 55fbfe2..0000000
--- a/stubs/internal/Splittable.php
+++ /dev/null
@@ -1,83 +0,0 @@
-<?php
-
-namespace Arma\Internal;
-
-interface Splittable extends Common
-{
-    /**
-     * Read/write access to a certain column of the object.
-     *
-     * @param int $col_number
-     * @return Subview
-     */
-    function col($col_number);
-
-    /**
-     * Read/write access to a certain row of the object.
-     *
-     * @param int $row_number
-     * @return Subview
-     */
-    function row($row_number);
-
-    /**
-     * Read/write access to certain columns of the object.
-     *
-     * @param int $first_col
-     * @param int $last_col
-     * @return Subview
-     */
-    function cols($first_col, $last_col);
-
-    /**
-     * Read/write access to certain rows of the object.
-     *
-     * @param int $first_row
-     * @param int $last_row
-     * @return Subview
-     */
-    function rows($first_row, $last_row);
-
-    /**
-     * Read/write access to an object subview.
-     *
-     * @param int $first_row
-     * @param int $first_col
-     * @param int $last_row
-     * @param int $last_col
-     * @return Subview
-     */
-    function submat($first_row, $first_col, $last_row, $last_col);
-
-    /**
-     * Read/write access to an object subview of first specified columns.
-     *
-     * @param $n_cols
-     * @return Subview
-     */
-    function head_cols($n_cols);
-
-    /**
-     * Read/write access to an object subview of first specified rows.
-     *
-     * @param int $n_rows
-     * @return Subview
-     */
-    function head_rows($n_rows);
-
-    /**
-     * Read/write access to an object subview of last specified columns.
-     *
-     * @param int $n_cols
-     * @return Subview
-     */
-    function tail_cols($n_cols);
-
-    /**
-     * Read/write access to an object subview of last specified rows.
-     *
-     * @param int $n_rows
-     * @return Subview
-     */
-    function tail_rows($n_rows);
-}
\ No newline at end of file
diff --git a/stubs/internal/Vector.php b/stubs/internal/Vector.php
index 178cf1d..26b81b0 100644
--- a/stubs/internal/Vector.php
+++ b/stubs/internal/Vector.php
@@ -63,4 +63,31 @@ interface Vector
      * @return void
      */
     function randn($n_elem);
+
+    // Vector subview
+
+    /**
+     * Read/write access to a vector subview.
+     *
+     * @param int $first_idx
+     * @param int $last_idx
+     * @return Subview
+     */
+    function subvec($first_idx, $last_idx);
+
+    /**
+     * Read/write access to first specified elements of a vector.
+     *
+     * @param int $n_elem
+     * @return Subview
+     */
+    function head($n_elem);
+
+    /**
+     * Read/write access to last specified elements of a vector.
+     *
+     * @param int $n_elem
+     * @return Subview
+     */
+    function tail($n_elem);
 }