v0.5.10

Nelson-numerical-software · Nelson-numerical-software · commit 05b6b8a4878d · 2021-10-30T20:19:12.000+02:00
diff --git a/en/README.md b/en/README.md
@@ -1,6 +1,6 @@
 ![banner](banner_homepage.png)
 
-### Nelson 0.5.9.0
+### Nelson 0.5.10.0
 
 This is an pre-release of Nelson.
 
diff --git a/en/SUMMARY.md b/en/SUMMARY.md
@@ -38,6 +38,7 @@
     * [exist](./core/exist.md)
     * [exit](./core/exit.md)
     * [format](./core/format.md)
+    * [inputname](./core/inputname.md)
     * [license](./core/license.md)
     * [maxNumCompThreads](./core/maxNumCompThreads.md)
     * [namelengthmax](./core/namelengthmax.md)
@@ -214,6 +215,7 @@
     * [norm](./elementary_functions/norm.md)
     * [num2bin](./elementary_functions/num2bin.md)
     * [numel](./elementary_functions/numel.md)
+    * [pinv](./elementary_functions/pinv.md)
     * [real](./elementary_functions/real.md)
     * [rem](./elementary_functions/rem.md)
     * [repmat](./elementary_functions/repmat.md)
@@ -900,3 +902,13 @@
     * [mustBeTextScalar](./validators/mustBeTextScalar.md)
     * [mustBeValidVariableName](./validators/mustBeValidVariableName.md)
     * [mustBeVector](./validators/mustBeVector.md)
+
+
+* [polynomial_functions](./polynomial_functions/README.md)
+    * [poly](./polynomial_functions/poly.md)
+    * [polyder](./polynomial_functions/polyder.md)
+    * [polyfit](./polynomial_functions/polyfit.md)
+    * [polyint](./polynomial_functions/polyint.md)
+    * [polyval](./polynomial_functions/polyval.md)
+    * [polyvalm](./polynomial_functions/polyvalm.md)
+    * [roots](./polynomial_functions/roots.md)
diff --git a/en/changelogs/CHANGELOG.md b/en/changelogs/CHANGELOG.md
@@ -1,3 +1,25 @@
+# 0.5.10 (2021-10-30)
+
+- Polynomial functions:
+
+  - `poly`: Polynomial with specified roots or characteristic polynomial.
+  - `roots`: Polynomial roots.
+  - `polyval`: Polynomial evaluation.
+  - `polyvalm`: Matrix polynomial evaluation.
+  - `polyint`: Polynomial integration.
+  - `polyfit`: Polynomial curve fitting.
+  - `polyder`: Polynomial differentiation.
+
+- `pinv`: Moore-Penrose pseudoinverse.
+
+- [#520](http://github.com/Nelson-numerical-software/nelson/issues/520): `inputname` get variable name of function input.
+
+- [#525](http://github.com/Nelson-numerical-software/nelson/issues/525): use [`fast_float`](https://github.com/fastfloat/fast_float) library to parse numbers .
+
+- [#528](http://github.com/Nelson-numerical-software/nelson/issues/528): Assignment in cell did not work in this case `[c{:}] = ind2sub (dv, i)`
+
+- [#534](http://github.com/Nelson-numerical-software/nelson/issues/534): `diag(ones(0, 1), -1)` did not return zero as result.
+
 # 0.5.9 (2021-09-29)
 
 - `leapyear` function: determine leap year.
@@ -28,7 +50,6 @@
 
 - [#503](http://github.com/Nelson-numerical-software/nelson/issues/503): Boost 1.77 support (default on Windows).
 
-
 # 0.5.8 (2021-08-25)
 
 ## Features:
diff --git a/en/core/README.md b/en/core/README.md
@@ -17,6 +17,7 @@ core functions
 * [exist](exist.md) - Check for the existence.
 * [exit](exit.md) - Exit from current Nelson application
 * [format](format.md) - Display format and number printing.
+* [inputname](inputname.md) - Get variable name of function input.
 * [license](license.md) - Get license information for Nelson.
 * [maxNumCompThreads](maxNumCompThreads.md) - Set/Get maximum number of computional threads.
 * [namelengthmax](namelengthmax.md) - Return the maximum variable name length.
diff --git a/en/core/SUMMARY.md b/en/core/SUMMARY.md
@@ -8,6 +8,7 @@
     * [exist](exist.md)
     * [exit](exit.md)
     * [format](format.md)
+    * [inputname](inputname.md)
     * [license](license.md)
     * [maxNumCompThreads](maxNumCompThreads.md)
     * [namelengthmax](namelengthmax.md)
diff --git a/en/core/inputname.md b/en/core/inputname.md
@@ -0,0 +1,52 @@
+
+
+# inputname
+
+Get variable name of function input.
+
+## Syntax
+
+- s = inputname(argNumber)
+
+## Input argument
+
+ - argNumber - a scalar, real, positive integer value: Number of function input argument
+
+## Output argument
+
+ - s - character vector: variable name
+
+## Description
+
+
+  <p><b>inputname</b> get variable name of function input.</p>
+  <p><b>inputname</b> is only useable within a function</p>
+
+
+## Example
+
+```matlab
+function R = getinputname(varargin)
+    R = string([]);
+    for i = 1:nargin
+        R = [R, string(inputname(i))];
+    end
+end
+```
+
+## See also
+
+[nargin](nargin.md).
+## History
+
+|Version|Description|
+|------|------|
+|1.0.0|initial version|
+
+
+## Author
+
+Allan CORNET
+
+
+
diff --git a/en/elementary_functions/README.md b/en/elementary_functions/README.md
@@ -59,6 +59,7 @@ elementary functions
 * [norm](norm.md) - Matrix and vector norms
 * [num2bin](num2bin.md) - Convert number to binary representation.
 * [numel](numel.md) - Number of elements.
+* [pinv](pinv.md) - Moore-Penrose pseudoinverse
 * [real](real.md) - Real part of an complex number.
 * [rem](rem.md) - Remainder after division.
 * [repmat](repmat.md) - Replicate and tile an array.
diff --git a/en/elementary_functions/SUMMARY.md b/en/elementary_functions/SUMMARY.md
@@ -50,6 +50,7 @@
     * [norm](norm.md)
     * [num2bin](num2bin.md)
     * [numel](numel.md)
+    * [pinv](pinv.md)
     * [real](real.md)
     * [rem](rem.md)
     * [repmat](repmat.md)
diff --git a/en/elementary_functions/pinv.md b/en/elementary_functions/pinv.md
@@ -0,0 +1,50 @@
+
+
+# pinv
+
+Moore-Penrose pseudoinverse
+
+## Syntax
+
+- y = pinv(A)
+- y = pinv(A, tol)
+
+## Input argument
+
+ - A - matrix: input matrix
+ - tol - scalar: singular value tolerance
+
+## Output argument
+
+ - y - Moore-Penrose Pseudoinverse of matrix A.
+
+## Description
+
+
+  <p><b>pinv</b> returns Moore-Penrose Pseudoinverse of matrix A.</p>
+
+
+## Example
+
+```matlab
+A = [1, 2, 3; 4, 5, 6];
+R = pinv(A)
+R = pinv(A, 2)
+```
+
+## See also
+
+[inv](../linear_algebra/inv.md), [svd](../linear_algebra/svd.md).
+## History
+
+|Version|Description|
+|------|------|
+|1.0.0|initial version|
+
+
+## Author
+
+Allan CORNET
+
+
+
diff --git a/en/polynomial_functions/README.md b/en/polynomial_functions/README.md
@@ -0,0 +1,20 @@
+
+
+# Polynomials
+
+Polynomials
+
+## Description
+Polynomial functions
+
+
+* [poly](poly.md) - Polynomial with specified roots or characteristic polynomial.
+* [polyder](polyder.md) - Polynomial differentiation.
+* [polyfit](polyfit.md) - Polynomial curve fitting.
+* [polyint](polyint.md) - Polynomial integration.
+* [polyval](polyval.md) - Polynomial evaluation.
+* [polyvalm](polyvalm.md) - Matrix polynomial evaluation.
+* [roots](roots.md) - Find polynomial roots.
+
+
+
diff --git a/en/polynomial_functions/SUMMARY.md b/en/polynomial_functions/SUMMARY.md
@@ -0,0 +1,9 @@
+* [polynomial_functions](README.md)
+    * [poly](poly.md)
+    * [polyder](polyder.md)
+    * [polyfit](polyfit.md)
+    * [polyint](polyint.md)
+    * [polyval](polyval.md)
+    * [polyvalm](polyvalm.md)
+    * [roots](roots.md)
+
diff --git a/en/polynomial_functions/poly.md b/en/polynomial_functions/poly.md
@@ -0,0 +1,52 @@
+
+
+# poly
+
+Polynomial with specified roots or characteristic polynomial.
+
+## Syntax
+
+- p = poly(r)
+- p = poly(A)
+
+## Input argument
+
+ - r - vector: polynomial roots
+ - A - matrix: input matrix
+
+## Output argument
+
+ - p - row vector: polynomial coefficients
+
+## Description
+
+
+  <p>If <b>A</b> is a square matrix, <b>p = poly(A)</b> computes an n+1 element row vector. This result is composed the coefficients of the characteristic polynomial.</p>
+  <p>If <b>r</b> is a vector, <b>p = poly(r)</b> computes a row vector. This result is composed the coefficients of the polynomial roots of which are the elements of <b>r</b>.</p>
+
+
+## Example
+
+```matlab
+A = [1    2    3;
+4    5    6;
+7    8    1];
+p = poly(A)
+```
+
+## See also
+
+[conv](../data_analysis/conv.md), [roots](roots.md).
+## History
+
+|Version|Description|
+|------|------|
+|1.0.0|initial version|
+
+
+## Author
+
+Allan CORNET
+
+
+
diff --git a/en/polynomial_functions/polyder.md b/en/polynomial_functions/polyder.md
@@ -0,0 +1,55 @@
+
+
+# polyder
+
+Polynomial differentiation.
+
+## Syntax
+
+- k = polyder(p)
+- k = polyder(a, b)
+- [q, d] = polyder(a, b)
+
+## Input argument
+
+ - p - vector: polynomial coefficients
+ - a - row vector: polynomial coefficients
+ - b - row vector: polynomial coefficients
+
+## Output argument
+
+ - k - row vector: differentiated polynomial coefficients
+ - q - row vector: numerator polynomial
+ - d - row vector: denominator polynomial
+
+## Description
+
+
+  <p><b>k = polyder(p)</b> return the coefficients of the derivative of the polynomial whose coefficients are given by the vector <b>p</b>.</p>
+  <p><b>k = polyder(a, b) </b>  returns the derivative of the product of the polynomials <b>a</b> and <b>b</b>.</p>
+  <p><b>[q, d] = polyder(a, b)</b> returns the derivative of the quotient of the polynomials <b>a</b> and <b>b</b>.</p>
+
+
+## Example
+
+```matlab
+p = [30 0 -20 0 10 50];
+q = polyder(p)
+```
+
+## See also
+
+[polyval](polyval.md), [poly](poly.md).
+## History
+
+|Version|Description|
+|------|------|
+|1.0.0|initial version|
+
+
+## Author
+
+Allan CORNET
+
+
+
diff --git a/en/polynomial_functions/polyfit.md b/en/polynomial_functions/polyfit.md
@@ -0,0 +1,50 @@
+
+
+# polyfit
+
+Polynomial curve fitting.
+
+## Syntax
+
+- p = polyfit(x, y, n)
+
+## Input argument
+
+ - x - vector: query points
+ - y - vector: fitted values at query points
+ - n - positive scalar: degree of polynomial fit
+
+## Output argument
+
+ - p - vector: Least-squares fit polynomial coefficients
+
+## Description
+
+
+  <p><b>p = polyfit(x, y, n)</b> returns the coefficients for a polynomial <b>p(x)</b> of degree <b>n</b> that is a best fit for the data in <b>y</b>.</p>
+
+
+## Example
+
+```matlab
+x = linspace(0, 8 * pi, 15);
+y = sin(x);
+p = polyfit(x, y, 7)
+```
+
+## See also
+
+[roots](roots.md), [poly](poly.md).
+## History
+
+|Version|Description|
+|------|------|
+|1.0.0|initial version|
+
+
+## Author
+
+Allan CORNET
+
+
+
diff --git a/en/polynomial_functions/polyint.md b/en/polynomial_functions/polyint.md
diff --git a/en/polynomial_functions/polyval.md b/en/polynomial_functions/polyval.md
diff --git a/en/polynomial_functions/polyvalm.md b/en/polynomial_functions/polyvalm.md
diff --git a/en/polynomial_functions/roots.md b/en/polynomial_functions/roots.md
diff --git a/fr/README.md b/fr/README.md
diff --git a/fr/changelogs/CHANGELOG.md b/fr/changelogs/CHANGELOG.md
