nelson-numerical-software/nelson

The Nelson Programming Language

Nelson is an array programming language providing a powerful open computing environment for engineering and scientific applications using modern C/C++ libraries (Boost, Eigen, …) and others state of art numerical libraries.

It has sophisticated data structures (including cell, struct, dictionary, linear systems, …), an interpreter and a high level programming language.

Nelson has been developed to be an open/modular system where an user can define these own data types and operations on these data types by using overload.

Website dedicated to users

For more information go to https://nelson-lang.github.io/nelson-website/.

Starring the repository

If you found this project useful, please consider starring it on GitHub !!! This allows me to see how many people are using my code, and motivates me to keep working to improve it.

Download

Latest Windows Installer

Get it from the Windows Package Manager

Get it from the Chocolatey Package Manager

Features

• Types managed by Nelson:

  • double and double complex: scalar, vector, matrix 2D, N dimensions array, sparse matrix.
  • single and single complex: scalar, vector, matrix 2D, N dimensions array, sparse matrix.
  • logical: scalar, vector, matrix 2D, N dimensions array, sparse matrix.
  • character array (UNICODE supported).
  • string array (UNICODE supported).
  • integers 8, 16, 32, 64 signed and unsigned: scalar, vector, matrix 2D, N dimensions array.
  • handle objects.
  • anonymous functions,
  • all types can be overloaded.

• OpenMP and SIMD extensions used.

• 2D and 3D plotting with high-level plot commands.

• Desktop environment with history, file and workspace browser.

• Parallel Computing Module.

• Fast Fourrier Transformation functions based on FFTW and MKL wrapper.

• SLICOT (Subroutine Library in Systems and Control Theory) interfaces (optional).

• Control System module.

• Message Passing Interface (MPI): functions for parallel computing.

• JSON decode/encode data support.

• HDF5 high-level functions I/O,

• HDF5 used as default data file format (.nh5) load/save workspace,

• MAT-file compatible load/save workspace,

• Foreign Function Interface C/Fortran.

• Interfacing C/C++ or Fortran with Nelson (build and load external code on the fly).

• MEX C API compatibility.

• Nelson Engine API for C (compatible with MEX Engine). Call Nelson from your C code as engine.

• Call Python from Nelson.

• RESTful API web service.

• Inter-process communication between Nelson's process.

• The QML engine enables nelson programs to display and manipulate graphical content using Qt's QML framework.

• Component Object Model (COM) client interface: binary-interface standard for software components on Windows.

• Write/Read xlsx files on Windows using COM.

• Embedded Nelson code editor.

• Help engine:

  Generate help files using Nelson dedicated functions. View your generated help files as html, markdown, pdf, gitbook or directly in Nelson help viewer.

• Tests engine:

  Validate your algorithm using Nelson dedicated functions. Export the test results under the xUnit reports format.

• Profiling and Code coverage tools for Nelson's language:

  Nelson has a built-in profiler that is very useful to profile your code and find out what script or function is taking the most time.

• Nelson cloud: Instant access to Nelson anywhere from an web browser.

• Module skeleton to extend Nelson available here:

  • template macros and builtin,
  • basic template macros only.

• Nelson Modules Manager (nmm) : package manager for Nelson

Licenses

Nelson is delivered under dual-license:

• 

  or

• 

Resources

• Homepage: https://nelson-lang.github.io/nelson-website/
• Source code: https://github.com/nelson-lang/nelson
• Binaries: https://github.com/nelson-lang/nelson/releases
• Docker: https://hub.docker.com/r/nelsonsoftware/nelson/
• Documentation: https://nelson-lang.github.io/nelson-website/help/en_US/
• GitBook: https://nelson-9.gitbook.io/nelson/
• Gitter: https://gitter.im/nelson-lang/Lobby
• YouTube: https://www.youtube.com/channel/UCdZMnH0HC9XflNGAFFiRX9g
• Twitter: https://twitter.com/Nelson_software

Tested and supported platforms

Systems with ✓ downloads are available on downloads page.

Systems with ✓ for CI are tested with continuous integration for every commit.

The systems listed here without CI or binaries are known to build and operate, but the continued support of these platforms is user-dependent.

Operating System	Architecture	CI	Binaries
Windows 7 to 11	x86-64 (64-bit)	✓	✓
	i686 (32-bit)	✓	✓
macOS Sonoma	arm64 (M1)	✓
macOS Ventura	x86-64 (64-bit)	✓
macOS Monterey	x86-64 (64-bit)	✓
Ubuntu 24.04	x86-64 (64-bit)		✓ (snap)
Ubuntu 22.04	x86-64 (64-bit)	✓	✓ (snap)
Ubuntu 20.04	x86-64 (64-bit)	✓	✓ (snap)
Ubuntu 18.04	x86-64 (64-bit)		✓ (snap)
ArchLinux	x86-64 (64-bit)	✓	✓ (snap)
Fedora 36	x86-64 (64-bit)	✓	✓ (snap)
Raspbian	ARM v8 (64-bit)

Allan CORNET ([email protected])

nelson's Issues

Some qml demos crashs on Windows 32 bits

ThreeJs demo crashs on Windows 32 bits due to drivers ... :(

add 'lastwarn' builtin

to return last warning message
warning('toto')

previous_warning_message = lastwarn()
lastwarn('toto') set last warning message
lastwarn('') to clear last warning

COM_xlsread does not support path with dot '.'

--> [numeric_data, text_data, raw_data] = COM_xlsread([nelsonroot(), '/modules/com_engine/tests/format_excel97.xls']);
An absolute path expected.
appelée à partir de :
C:/Program Files/Nelson-0.1.7.0 (64 bits)/modules/com_engine/functions/COM_xlsread.nlf
à la ligne: 71 position:1

Add subsref & subsasgn functions

subsref & subsasgn functions required for overloading

Help browser have no icon in Windows binary version

icon is not embedded in binaries @

rename getContentsAsWideString to getContentAsWideString

typo error to fix

test_makeref should start another nelson process

Currently, test_makeref uses current session to create a ref file.
It should be better to start another clean process.

datenum does not support some string format

dv = datevec(datenum('10-Mar-2010 16:48:17'));
REF = [2010 3 10 16 48 17];
assert_isequal(dv, REF);

dv = datevec(datenum('Mar.10,2010'));
REF = [2010 3 10 0 0 0];
assert_isequal(dv, REF);

extend warning behavior

Currently 'warning' manages only a message.
Nelson could be extended with

warning('off') : disable all warnings
warning('on'): enable warning
warning('stop'): warning stop execution
current_warning_state = warning('query')

builder.nls of module_skeleton have again an ref to old function exec

Creating and developing an matrix-based numerical  interpreter

Content is in the title ;)

module_skeleton does not build/load

loadfunction was removed from current Nelson and must be removed.

rename "locales" to "locale" more standard

qml demos does not start on adv-cli mode

Generates Nelson.pot

Current generatepo.nls does not generate also a .pot file

extend fprintf

current fprintf is too simple and do not manage format.

>= operator is not implemented

t1 <= t2 OK(double)
but
t2 >= t1 KO(double)

Create an help file for each public builtin

In 0.1 version, help is very uncomplet for existing builtins.
The next "major" version MUST close this ticket before all others tickets in 2017.

inv([0 0;i() 3]) does not return [Inf, Inf; Inf, Inf] on ARM platform

on ARM: inv([0 0;i() 3]) return [NaN NaN; NaN NaN] --> KO
on others [Inf, Inf; Inf, Inf] --> OK

rcond on ARM returns 1.5 and not 0 as expected

tests are not embedded in linux & macos binaries

Current linux & macos binaries version do not embed tests

With new mac version of icu4c 59.1 nelson build fails

[ 0%] Building CXX object modules/characters_encoding/CMakeFiles/nlsCharacters_encoding.dir/src/cpp/characters_encoding.cpp.o
/Users/travis/build/Nelson-numerical-software/nelson/modules/characters_encoding/src/cpp/characters_encoding.cpp:56:9: error: use of undeclared identifier 'u_strFromUTF8_59'
u_strFromUTF8(&buffer[0], (int32_t)buffer.size(), &len, &str[0], (int32_t)str.size(), &status);
^
/usr/local/Cellar/icu4c/59.1/include/unicode/urename.h:351:23: note: expanded from macro 'u_strFromUTF8'
#define u_strFromUTF8 U_ICU_ENTRY_POINT_RENAME(u_strFromUTF8)
^
/usr/local/Cellar/icu4c/59.1/include/unicode/uvernum.h:113:40: note: expanded from macro 'U_ICU_ENTRY_POINT_RENAME'
#define U_ICU_ENTRY_POINT_RENAME(x) U_DEF2_ICU_ENTRY_POINT_RENAME(x,U_ICU_VERSION_SUFFIX)
^
/usr/local/Cellar/icu4c/59.1/include/unicode/uvernum.h:112:44: note: expanded from macro 'U_DEF2_ICU_ENTRY_POINT_RENAME'
#define U_DEF2_ICU_ENTRY_POINT_RENAME(x,y) U_DEF_ICU_ENTRY_POINT_RENAME(x,y)
^
/usr/local/Cellar/icu4c/59.1/include/unicode/uvernum.h:111:43: note: expanded from macro 'U_DEF_ICU_ENTRY_POINT_RENAME'
#define U_DEF_ICU_ENTRY_POINT_RENAME(x,y) x ## y
^
:125:1: note: expanded from here
u_strFromUTF8_59

==> Downloading https://homebrew.bintray.com/bottles/icu4c-59.1.sierra.bottle.tar.gz
==> Pouring icu4c-59.1.sierra.bottle.tar.gz
==> Caveats
This formula is keg-only, which means it was not symlinked into /usr/local,
because macOS provides libicucore.dylib (but nothing else).
If you need to have this software first in your PATH run:
echo 'export PATH="/usr/local/opt/icu4c/bin:$PATH"' >> ~/.bash_profile
echo 'export PATH="/usr/local/opt/icu4c/sbin:$PATH"' >> ~/.bash_profile
For compilers to find this software you may need to set:
LDFLAGS: -L/usr/local/opt/icu4c/lib
CPPFLAGS: -I/usr/local/opt/icu4c/include
For pkg-config to find this software you may need to set:
PKG_CONFIG_PATH: /usr/local/opt/icu4c/lib/pkgconfig
==> Summary
🍺 /usr/local/Cellar/icu4c/59.1: 246 files, 65.4MB
Linking /usr/local/Cellar/icu4c/59.1... 61 symlinks created
If you need to have this software first in your PATH instead consider running:
echo 'export PATH="/usr/local/opt/icu4c/bin:$PATH"' >> ~/.bash_profile
echo 'export PATH="/usr/local/opt/icu4c/sbin:$PATH"' >> ~/.bash_profile
Error: pkg-config 0.29.1_2 is already installed

doc function is too slow on slow computers

with a netbook, first doc call takes more 1 minute to index help files.
Indexing could be generated only once and regenerated if we add or remove a help

rand & randn do not use Column-major order

rand & randn do not use Column-major order

search path for functions is wrong

Creates a function already existing
example d:\test\doc.nlf

addpath('d:\test')
call doc
doc function of nelson is called and not d:\test\doc.nlf

Sparse type: insertion & extraction

Current sparse insertion and extraction need to be completed.

7.853981633974482790D-01 not correctly parsed

7.853981633974482790D-01 and 7.853981633974482790e-01 must be equivalent.
atof does not support natively 7.853981633974482790D-01 syntax

buildhelp() crashs if rights cannot write

example on windows with a release version installed in program files do
buildhelp()

add isnan & isinf functions

add isnan & isinf functions

error(error_struct) should return an error

a = lasterror();
lasterror('reset')
error(a)

add isfinite

isfinite required for cosd, sind

datenum does not support vectorization

example:
datenum([10000, 200000])

Y = complex(rand(500), rand(500)) crashes Nelson

Y = complex(rand(500), rand(500)); OK
Y = complex(rand(500), rand(500)) // KO

display of complex number crashs with big matrix

test_nargin & test_nargout fails in Windows binary version

Some files are missing

--> test_run('core')
 1/1 - [core] :
 1/4 - [core] test_nargin                                                   Fail
      run('C:/Program Files/Nelson-0.1.1.30 (64 bits)/modules/core/tests/test_nargin.nls')
 
 2/4 - [core] test_nargout                                                  Fail
      run('C:/Program Files/Nelson-0.1.1.30 (64 bits)/modules/core/tests/test_nargout.nls')
 
 3/4 - [core] test_nfilename                                                Pass
 4/4 - [core] bug_namelengthmax                                             Pass
 
  //==========================================================================
  Summary:
  Tests: 4
  Passed: 2
  Failed: 2
  Skipped: 0
  Benchs: 0
  Temps écoulé: 0 ms
  //===========================================================================

ans =

  <logical>  - size: 1x1
 false  

Invalid extraction & insertion on function_handle

Overload need to be completed:

Error expected (OK):
a = str2func('sin')
a(1).b= 1

Error expected (KO):
a = str2func('sin')
a(1).b

or
c = complexObj(3,4);
c(1).r

Currently, we evaluate a(1) only

Assignment expected(KO):
a = str2func('sin')
a.b=3

Currently, Nelson returns an error and not a value.

IJV last output argument returns nnz and not nzmax

input arguments of sparse & output arguments of IJV should be same.

colon constructor fails with some special values

Example:
[0:0.1:0.6]
[0:0.1:0.7]

it is due to a round trouble of generated vector.

check/rework diary with new console output

Due to callback added, diary need to be updated

Create an help file and unitary test for each public builtin

In 0.1 version, help is very uncomplet for existing builtins.
Same thing with unitary tests (currently not committed but existing)

The next "major" version MUST close this ticket before all others tickets in 2017.

Migrates to VS 2017

Appveyor image for VS 2017 is available
Qt 5.7 for VS 2017 (ok)
boost 1.64 (need to build)

Help browser does not work on some windows

doc command have no effect on some windows with binary version.
A new build will be required to fix this problem

some tests of datenum fail on linux & mac but not on windows

some format string are only available on windows.

mldivide is missing

mldivide, ldivide & '.' b '' operators are missing (overload & implementation).

add datestr function

example
datestr(now)
19-Feb-2017 09:52:37

Create an unitary test for each public builtin

In 0.1 version, all tests are not published in source for existing builtins.
The next "major" version MUST close this ticket before all others tickets.

sprintf is not implemented

sprintf('toto')

extends fopen builtin

fopen could manage machine format and encoding

add ndims function

add ndims function

windows installer does not copy module_skeleton help files at the good place

enable multithreading

fft functions are fast using FFTW but currently we could do faster using multithreading availabke in FFTW and others librairies used in Nelson

do a check with PVS studio

see 93d7cc4