@totemorg/man

v2.30.0

Published

25 days ago

matrix manipulator

Downloads

183

0High
0Medium
0Low

MAN

Extends MathJX with various AI/ML methods:

light weight image processing
symbolic algebra
time series analysis ( digital signal processing, spectral, kalman filter, autoregressive moving average )
liner programming ( simplex, blossom, hidden markov methods, optimal global alignment )
matrix decompositions ( eigen spectrums, singular value decomposition )
bayesian belief networks
regression methods ( logistic, support vector, other )
non-linear optimizers ( least cost path, linear programming, gradient descent, newton-raphton )
neural networks ( convolutional, caffe CNN, recurrent, tensor flow language models )
cluster analysis ( K-means, expectation maximization, density based scan, support vector machine, principle component analysis, tsne )
special functions ( gamma, multivariate normal, rieman zeta, crypto ).

See the Program Reference for usage details.

Install

npm install @totemorg/man		# install
npm update

Manage

npm run start 					# Unit test
npm run verminor				# Roll minor version
npm run vermajor				# Roll major version
npm run redoc					# Regen documentation

Usage

Acquire and optionally configure MAN as follows:

import { $ } from "@totemorg/man");

$.config({
	key: value, 						// set key
	"key.key": value, 					// indexed set
	"key.key.": value					// indexed append
});

where configuration keys follow ENUMS deep copy conventions. See the Program Reference for usage examples.

Program Reference

switch TEST case TEST BLOCK : default TEST BLOCK end

try BLOCK catch BLOCK end

for INDEX BLOCK end

while TEST BLOCK end

until TEST BLOCK end

when EVENT BLOCK end

def f=(x,y,...) BLOCK end

MAN

Extend mathjs script with mathjx script and various numerical methods.

This module documented in accordance with jsdoc.

Requires: module:enums, module:mathjx, module:kalman-filter, module:arima, module:crypto, module:mathjs, module:fft-js, module:nodehmm, module:node-svd, module:node-svm, module:mljs, module:jimp, module:jsbayes, module:recurrent-js, module:gamma, module:expectation-maximization, module:multivariate-normal, module:newton-raphson, module:random-seed, module:edmonds-blossom, module:simple-simplex, module:@tensorflow/tfjs, module:sdbscan, module:tsne-js
Author: ACMESDS

| Param | Type | Description | | --- | --- | --- | | pgm | String | MathJx script to process. | | ctx | Object | Context to run script. |

Example ( <caption>Eval a js or mathjs script in a context ctx)


var 
	ctx = $( "script", ctx, ctx => {   // eval with callback
		Trace("updated context", ctx);
	} ),

	ctx = "script".$( ctx ),		// abbreviated

	{ x, y, ... } = "script".$( ctx ) || {};	// with context x,y extractions

Example (Create a matrix)


var 
	A = $( N, (n,A) => A[n] = ... ) ,  // define N-length vector 
	A = $( [M,N], (n,m,A) => A[m][n] = ... ) ;	// define M x N matrrix

Example (Index a matrix)


A.$( (n,A) => A[n] = ... ) 	// index vector with callback
A.$$( (n,m,A) => A[n][m] = ... ) 	// index matrix with callback

Example (Sample a matrix with optional callback cb(val))


var 
	B = A.get( idx , cb),
	B = A.get( "key, ...", cb ),
	B = A.get( [idx, ...] , cb),
	B = A.get( [key, ...] , cb ),
	B = A.get( {rekey: { toKey: "fromKey", ... }, cb ),
	B = A.get( {draw: N}, cb ),
	B = A.get( {start:N, count:N}, cb ),
	B = A.get( {KEY_starts: "with", ...}, cb ),
	B = A.get( {KEY_ends: "with", ...}, cb )

Example (Import functions to $.somefn and to $( "somefn(...)" ))


$( {
	somefn: function (args) { ... },
	:
	:
} );

Example (Use the task sharder)


$( { 
	keys: "i,j,k",  	// array indicies
	i: [0,1,2,3],  		// domain of index i
	j: [4,8],				// domain of index j
	k: [0],					// domain of index k
	qos: 0,				// regulation time in ms if not zero
	local: false, 		// enable to run task local, i.e. w/o workers and nodes
	workers: 4, 		// limit number of workers (aka cores) per node
	nodes: 3 			// limit number of nodes (ala locales) in the cluster
}, 

	// here, a simple task that returns a message 
	$ => "my result is " + (i + j*k) + " from " + $.worker + " on "  + $.node,

	// here, a simple callback that displays the task results
	msg => console.log(msg) 
);

Example (Aggregate and save events ev = {at: "KEY", ...} to ctx.Save_KEY)


[ev, ...].save( ctx, evs => { // unsave events ... } );
"query".save( ctx, evs => { //unsave events ... } );

Example (Indexing methods)


$( "mathjs script", ctx, ctx => { ... } )
$( "mathjs script", ctx )
$( "mathjs script" )
$( [M,N], (m,n,A) => { A[m][n] = ... } )
$( N, (n,A) => { A[n] = ... } )
$({	// import functions
	f: (...) => { ... },
	...
})
$({	// task sharding
		keys: "i,j,...",  	// array indicies
		i: [...],  		// domain of index i
		j: [...],				// domain of index j
		k: [...],					// domain of index k
		qos: N,				// regulation time in ms if not zero
		local: false, 		// enable to run task local, i.e. w/o workers and nodes
		workers: N, 		// limit number of workers (aka cores) per node
		nodes: N 			// limit number of nodes (ala locales) in the cluster
	}, 

	// here, a simple task that returns a message 
	$ => "my result is " + (i + j*k) + " from " + $.worker + " on "  + $.node,

	// here, a simple callback that displays the task results
	msg => console.log(msg) 
);

Example (Eval a mathjs script with optional callback and optional context)


var 
	ctx = $( "mathjs script", ctx, ctx => {   
		x: 1, 
		y: 20, ...
	} );

Example (Eval with extraction of context keys)


const {x, y, ... } = $( "mathjs script", ctx ) || {};

Example (Import functions)

$( {
	somefn: function (args) { ... },
	:
	:
} );

Example (Use the task sharder)

$( { 
		keys: "i,j,k",  	// array indicies
		i: [0,1,2,3],  		// domain of index i
		j: [4,8],				// domain of index j
		k: [0],					// domain of index k
		qos: 0,				// regulation time in ms if not zero
		local: false, 		// enable to run task local, i.e. w/o workers and nodes
		workers: 4, 		// limit number of workers (aka cores) per node
		nodes: 3 			// limit number of nodes (ala locales) in the cluster
	}, 

	// here, a simple task that returns a message 
	$ => "my result is " + (i + j*k) + " from " + $.worker + " on "  + $.node,

	// here, a simple callback that displays the task results
	msg => console.log(msg) 
);

MATHJX

Reduce a mathjx-script to a mathjs-script using the following language model:

if TEST
	BLOCK
elseif TEST
	BLOCK
:
else
	BLOCK
end

switch TEST
	case TEST
		BLOCK
	:
	default TEST
		BLOCK
end

try
	BLOCK
catch
	BLOCK
end

for INDEX
	BLOCK
end

while TEST
	BLOCK
end

until TEST
	BLOCK
end

when EVENT
	BLOCK
end

def f=(x,y,...)
	BLOCK
end

Inline functions are also supported using fat-arrows:

(x,y,...) => {
	BLOCK
}

Requires: module:mathjs, module:enums, module:cp
Author: ACMESDS

| Param | Type | Description | | --- | --- | --- | | pgm | String | Array | Script to reduce and execute. Use an Array to bypass default eol-tokenization. | | blks | Array | Stash fo code blocks; initially []. | | idx | Number | Current line index to start parsing; initially 0. | | lang | Object | Language model; see code herein. |

Example (js-reduction)

\\ program
	def f=(x,y)
		f=x+y;
	end

\\ reduces to
	def($ctx[1]) 

\\ with resulting context
	[ { test: 'f=(x,y)', code: 'f=x+y\n' } ]

Example (js-reduction)

\\ program
	for i
		i1
		i2
		for j
			j1; j2;
			while u\u1\end
		end
	end
\\ reduces to
	for($ctx[3]) 
\\ with resulting context 
	[
		{ test: 'u', code: 'u1\n' },
		{ test: 'j', code: 'j1; j2;\nwhile($ctx[1])' },
		{ test: 'i', code: 'i1\ni2\nfor($ctx[2])' }
	]

Example (js-reduction)

\\ program
	a1="this;is;a;test";
\\ reduces to
	a1=$ctx[1];
\\ with resulting context
		[ 'this;is;a;test' ]

Example (js-reduction)

\\ program
	somefn(1,2, \def f=(x,y)
		print("x=%f and y=%f",x,y);
	end
	)
\\ and program
	somefn(1,2, \(x,y) => {
		print("x=%f and y=%f",x,y);
	})
\\ reduces to
	def($ctx[2]))
\\ with resulting context
	[ 'x=%f and y=%f', { test: 'f=(x,y)', code: 'print($ctx[1],x,y);\n' } ]

Example (js-reduction)

\\ program
	def f=(x,y)
		f=x+y;
	end
	disp(f(1,2));
\\ reduces to
	def($ctx[1]);disp(f(1,2));
\\ with resulting context
		[ { test: 'f=(x,y)', code: 'f=x+y;\n' } ]

Example (js-reduction)

\\ program
	def f=([a,b],{x,y})
		f=x+y+a+b;
	end
	disp(f([4,5],{x:10,y:20}));
\\ reduces to
		def($ctx[1]);disp(f([4,5],{x:10,y:20}));
\\ with resulting context
	[ { test: 'f=([a,b],{x,y})', code: 'f=x+y+a+b;\n' } ]

MATHJX

MATHJX~saveKeys

Kind: inner property of MATHJX

MATHJX~scripts

Kind: inner property of MATHJX

~scripts
- .conf
- .pca
- .roc
- .snr
- .p0
- .pw
- .wk
- .trigger()

scripts.conf

Kind: static property of scripts

scripts.pca

Kind: static property of scripts

scripts.roc

Kind: static property of scripts

scripts.snr

Kind: static property of scripts

scripts.p0

Kind: static property of scripts

scripts.pw

Kind: static property of scripts

scripts.wk

Kind: static property of scripts