v0.7.9

Author: Nelson-numerical-software

en/README.md

@@ -1,6 +1,6 @@
 ![banner](banner_homepage.png)
 
-### Nelson 0.7.5.0
+### Nelson 0.7.9.0
 
 This is an pre-release of Nelson.
 

en/SUMMARY.md

@@ -149,7 +149,7 @@
 
 - [overload](./overload/README.md)
 
-  - [overloadbasictypes](./overload/overloadbasictypes.md)
+  - [overloading](./overload/overloading.md)
 
 - [logical](./logical/README.md)
 
@@ -246,6 +246,7 @@
 
 - [function_handle](./function_handle/README.md)
 
+  - [Anonymous Functions](./function_handle/anonymous_function.md)
   - [func2str](./function_handle/func2str.md)
   - [isfunction_handle](./function_handle/isfunction_handle.md)
   - [str2func](./function_handle/str2func.md)
@@ -967,16 +968,18 @@
   - [whosmat](./matio/whosmat.md)
 
 - [json](./json/README.md)
+
   - [jsondecode](./json/jsondecode.md)
   - [jsonencode](./json/jsonencode.md)
   - [jsonprettyprint](./json/jsonprettyprint.md)
 
-* [file_archiver](./file_archiver/README.md)
+- [file_archiver](./file_archiver/README.md)
 
   - [unzip](./file_archiver/unzip.md)
   - [zip](./file_archiver/zip.md)
 
-* [audio](./audio/README.md)
+- [audio](./audio/README.md)
+
   - [audiodevinfo](./audio/audiodevinfo.md)
   - [audioinfo](./audio/audioinfo.md)
   - [audiometadata](./audio/audiometadata.md)
@@ -1084,11 +1087,12 @@
   - [webwrite](./webtools/webwrite.md)
 
 - [geometry](./geometry/README.md)
+
   - [rotx](./geometry/rotx.md)
   - [roty](./geometry/roty.md)
   - [rotz](./geometry/rotz.md)
 
-* [com_engine](./com_engine/README.md)
+- [com_engine](./com_engine/README.md)
   - [actxcontrollist](./com_engine/actxcontrollist.md)
   - [actxGetRunningSrv](./com_engine/actxGetRunningSrv.md)
   - [actxserver](./com_engine/actxserver.md)

en/changelogs/CHANGELOG.md

@@ -4,6 +4,43 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
+## 0.7.9 (2023-09-18)
+
+### Changed
+
+- [#488](http://github.com/Nelson-numerical-software/nelson/issues/488) overloading functions:
+
+  - all types including basic types can be overloaded.
+  - overload is now fully compatible using '@' syntax and precedence.
+  - all operators were reworked to support compatible overload.
+
+- `.*` operator optimized.
+- `conv2` optimized.
+- Boost 1.82 used on Windows.
+
+- Internals:
+
+  - `class`, `function_handle` types reworked.
+  - types order updated.
+  - rework validator module.
+  - functions finder reworked.
+  - file watcher reworked.
+  - operators reworked.
+  - `repmat`, `ones`, `NaN`, `Inf` reworked.
+
+- `function_handle` display is more compatible.
+
+### Added
+
+- [#491](http://github.com/Nelson-numerical-software/nelson/issues/491) Anonymous functions
+- `--withoutfilewatcher` executable argument. disable file watcher for current session.
+- `<--FILE WATCHER REQUIRED -->` test_run option.
+- [#853](http://github.com/Nelson-numerical-software/nelson/issues/853) MacOs 13 ventura CI
+
+### Fixed
+
+- [#916](http://github.com/Nelson-numerical-software/nelson/issues/916) openblas micromamba on macos required to link libgfortran
+
 ## 0.7.5 (2023-05-27)
 
 ### Changed
@@ -21,7 +58,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 ### Added
 
 - Qt 6.5 support.
-- [802](http://github.com/Nelson-numerical-software/nelson/issues/802): `bitand`, `bitor`, `bitxor` functions.
+- [#802](http://github.com/Nelson-numerical-software/nelson/issues/802): `bitand`, `bitor`, `bitxor` functions.
 - `issorted` Determine if array is sorted.
 - `num2cell` Convert array to cell array with consistently sized cells.
 - `hggroup` Create group object.
@@ -53,7 +90,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 - `weboptions` did not manage HeaderFields as expected.
 - update `cacert.pem`.
-- [895](http://github.com/Nelson-numerical-software/nelson/issues/895): Micromamba linux build fails after packages updates.
+- [#895](http://github.com/Nelson-numerical-software/nelson/issues/895): Micromamba linux build fails after packages updates.
 
 ## 0.7.3 (2023-03-28)
 
@@ -63,7 +100,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - `ancestor` Ancestor of graphics object.
 - hexadecimal color code managed example: '#DDFF00'.
 - `validatecolor` Validate color values.
-- [851](http://github.com/Nelson-numerical-software/nelson/issues/851): Build with micromamba environment (linux and macOS)
+- [#851](http://github.com/Nelson-numerical-software/nelson/issues/851): Build with micromamba environment (linux and macOS)
 
 ### Changed
 
@@ -74,10 +111,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ### Fixed
 
-- [866](http://github.com/Nelson-numerical-software/nelson/issues/866): Close menu on figure can crash on linux.
+- [#866](http://github.com/Nelson-numerical-software/nelson/issues/866): Close menu on figure can crash on linux.
 - graphic hierarchy was not fully destroyed after `close` or `delete`.
 - labels were not displayed correctly when the logarithmic scale was enabled.
-- [869](http://github.com/Nelson-numerical-software/nelson/issues/869): missing help files in linux package.
+- [#869](http://github.com/Nelson-numerical-software/nelson/issues/869): missing help files in linux package.
 
 ## 0.7.2 (2023-02-27)
 
@@ -107,9 +144,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - `drawnow`: Update figures and process callbacks.
 - `DrawLater` property added to `figure` graphics object.
 - `interp1` linear interpolation 1D.
-- [736](http://github.com/Nelson-numerical-software/nelson/issues/736): `bone`, `cool`, `copper`, `hot`, `jet`, `pink`, `turbo`, `viridis`, `white` colormaps.
+- [#736](http://github.com/Nelson-numerical-software/nelson/issues/736): `bone`, `cool`, `copper`, `hot`, `jet`, `pink`, `turbo`, `viridis`, `white` colormaps.
 - `Visible` property to `figure` graphics object.
-- [809](http://github.com/Nelson-numerical-software/nelson/issues/809): `NumberTitle` property to `figure` graphics object.
+- [#809](http://github.com/Nelson-numerical-software/nelson/issues/809): `NumberTitle` property to `figure` graphics object.
 - `AlphaMap` and `Colormap` properties added to `Axes` graphics object.
 - `LineStyleOrder` property of 'axes' used for `plot` and `plot3`.
 - `ColorOrderIndex` and `LineStyleOrderIndex` properties added to `axes` graphics object.
@@ -120,10 +157,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 - `imwrite` Write image to graphics file.
 - `imshow` Display image.
 - `surface` Primitive surface plot.
-- [808](http://github.com/Nelson-numerical-software/nelson/issues/808): `pcolor` Pseudocolor plot.
+- [#808](http://github.com/Nelson-numerical-software/nelson/issues/808): `pcolor` Pseudocolor plot.
 - `mesh` Mesh surface plot.
 - `meshz` Mesh surface plot with curtain.
-- [807](http://github.com/Nelson-numerical-software/nelson/issues/807): `loglog` Log-log scale plot.
+- [#807](http://github.com/Nelson-numerical-software/nelson/issues/807): `loglog` Log-log scale plot.
 - `CHANGELOG` 0.7.x family.
 
 ### Changed

en/engine/executable.md

@@ -26,6 +26,7 @@ Executables to start Nelson software.
 - --nouserstartup - disable the user script file executed at startup after the main startup file.
 - --minimize - minimize main GUI Windows (GUI mode only).
 - --noipc - disable interprocess features (files association, ipc builtin).
+- --withoutfilewatcher - disable file watcher feature for this session.
 - --noaudio - disable audio module.
 - --language lang - If this option is present it fixes the user language. Currently, lang can be: fr_FR en_US.
 - --quiet - If this option is present no banner and version displayed.

en/function_handle/README.md

@@ -6,6 +6,7 @@ Function_handle functions
 
 function_handle functions
 
+- [Anonymous Functions](anonymous_function.md) - Anonymous Functions.
 - [func2str](func2str.md) - Return a function handle constructed from a string.
 - [isfunction_handle](isfunction_handle.md) - Checks if value is a function handle.
 - [str2func](str2func.md) - Returns a function handle from a string.

en/function_handle/SUMMARY.md

@@ -1,4 +1,5 @@
 - [function_handle](README.md)
+  - [Anonymous Functions](anonymous_function.md)
   - [func2str](func2str.md)
   - [isfunction_handle](isfunction_handle.md)
   - [str2func](str2func.md)

en/function_handle/anonymous_function.md

@@ -0,0 +1,102 @@
+# Anonymous Functions
+
+Anonymous Functions.
+
+## Description
+
+  <p>Anonymous functions provide a convenient way to swiftly create straightforward functions without the need to generate separate M-files on every occasion.</p>
+  <p>These anonymous functions can be built either directly at the command line or within any M-file function or script.</p>
+  <p>To create an anonymous function from an expression, use the following syntax:</p>
+  <p>function_handle = @(argument_list) expression</p>
+  <p/>
+  <p>Breaking down this syntax, <b>expression</b> represents the body of the function, which contains the code that performs the primary task of your function.</p>
+  <p>This part consists of a valid expression. Next, there's <b>argument_list</b>, which is a comma-separated list of input arguments to be passed to the function.</p>
+  <p>These components are similar to the body and argument list of any regular function.</p>
+  <p/>
+  <p>At the beginning of this syntax statement, you'll notice the <b>@</b> sign.</p>
+  <p>This <b>@</b> sign is the operator that constructs a function handle.</p>
+  <p>Creating a function handle for an anonymous function allows you to invoke the function and is useful when passing your anonymous function as an argument to another function.</p>
+  <p>The <b>@</b> sign is a necessary part of the anonymous function definition.</p>
+  <p/>
+  <p>It's worth noting that function handles not only apply to anonymous functions but also to any function.</p>
+  <p>The syntax for creating a function handle to a regular function is different and looks like this:</p>
+  <p>function_handle = @function_name</p>
+  <p>For example: <b>f = @cos</b></p>
+  <p>You have the option to store function handles along with their associated values in a MAT-file.</p>
+  <p>Later, in a different session, you can retrieve and utilize them using the save and load functions.</p>
+  <p>for example <b>a = 1;b = 2; f = @(x) a + b + x; save('test.nH5', f);</b></p>
+  <p>Only .nh5 files allows to save and load function_handle type as expected.</p>
+  <p>You can create an anonymous function that takes multiple input arguments, x and y.</p>
+  <p>Assuming that variables A and B are already defined, you can define the function as follows:</p>
+  <p>
+    <b>A = 10; B = 100; r = @(x, y) (A*y + B*x);</b>
+  </p>
+
+## Examples
+
+```matlab
+A = 10;
+f1 = @() sqr(A);
+clear A
+f1
+f1()
+```
+
+```matlab
+f2 = @cos;
+f2
+f2(0.6)
+```
+
+```matlab
+f3 = @(x)cos(x) + 1;
+f2
+f3(0.6)
+```
+
+Multiple input arguments
+
+```matlab
+A = 10;
+B = 100;
+f4 = @(x, y) (A*y + B*x);
+f4
+f4(0.6, 0.2)
+```
+
+Save/Load function handle
+
+```matlab
+a = 1;
+b = 2;
+f5 = @(x) a + b + x;
+save([tempdir(), 'test.nh5'], 'f5');
+clear all
+load([tempdir(), 'test.nh5'])
+f5
+f5(10)
+```
+
+Multiple output arguments
+
+```matlab
+P = pi * 3;
+mymeshgrid = @(X, Y) meshgrid((-X:X/P:X),(-Y:Y/P:Y));
+[x, y] = mymeshgrid(pi, 2 * pi);
+z = cos(x) + sin(y);
+mesh(x, y, z)
+```
+
+## See also
+
+[func2str](func2str.md), [str2func](str2func.md), [isfunction_handle](isfunction_handle.md).
+
+## History
+
+| Version | Description     |
+| ------- | --------------- |
+| 1.0.0   | initial version |
+
+## Author
+
+Allan CORNET

en/operators/eq.md

@@ -20,6 +20,7 @@ equality, == operator.
 
   <p><b>C = eq(A, B)</b> returns a logical array with elements set to logical <b>true</b> where arrays A and B are equals.</p>
   <p/>
+  <p><b>eq</b> compares both real and imaginary parts of numeric arrays.</p>
 
 ## Examples
 

en/operators/ge.md

@@ -20,6 +20,7 @@ greater than or equal, >= operator.
 
   <p><b>C = ge(A, B)</b> returns a logical array with elements set to logical <b>true</b> A is greater than or equal to B.</p>
   <p/>
+  <p><b>ge</b> compares only the real part of numeric arrays.</p>
 
 ## Examples
 

en/operators/gt.md

@@ -20,6 +20,7 @@ greater than, > operator.
 
   <p><b>C = gt(A, B)</b> returns a logical array with elements set to logical <b>true</b> A is greater than B.</p>
   <p/>
+  <p><b>gt</b> compares only the real part of numeric arrays.</p>
 
 ## Examples