Rakam or (رقم) in Arabic, which means "number". This is a math library. Lots of new, breaking, unprecedented features such as parser, which contains something like math2js. That amazing function which is available right now, we will try our best to make this a full-featured, easy-to-use, good-performance library for all uses.
Here is some ready-to-use features:
let {parser} = require('rakam');
let {math2js} = require('rakam').parser; // math2js(math, options, parserOptions);
math: the math expression must be parsable by @scicave/math-parser library
parserOptions: options for @scicave/math-parser library.
See documentation fot more about math2js
Copyright (C) 2020 sciCave™ [email protected]
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
describtion ...
Rakam is using @scicave/math-parser library to parse ath expression, then handle the AST or say the parser tree, to generate the equivalent js code, after all of these steps, we easily use new Function(...) in vanilla js (the native js).
scope: optional object
sum, in latex: \sum_{n = 1}^{100}n
let {parser} = require('rakam');
let generatedJs = parser.math2js('1+2-sum(n,n,1,100000)');
/// test the evaluation speed of sum expression iterating 100000 time.
console.time('evaluation time'); generatedJs.eval(); console.timeEnd('evaluation time');
// when the code went hot in node engine in my pc.
// evaluation time: 0.103ms
// astonishing result!!! <3 alhamdullah!This happens behind the scene:
// this happens behind the scene:
let func = eval(generatedJs.code);
// or
let func = (scope)=>{
// scope is the passed object to math2js or by default is Math
function __scicave_rakam_egvjeuqa__(){
let _ = 0
for(var n = 1; n <= 100000; n++){
_ += n;
}
return _;
}
return ()=>1 + 2 - __scicave_rakam_egvjeuqa__();
}
generatedJs.eval = func(Math);Object:
Function:
passing scope array: [(Object | Function)*]
let {parser} = require('rakam');
let math = 'y t -sinx +z';
let scope = [
{ t: 1, x: 180, },
{ x: 3, y: 4 },
function getId(id){
let vars = { z: 1, sin(x){ return Math.sin(x*Math.PI/180) } };
return vars[id];
}
];
let generatedJs = parser.math2js(math, { scope });
// testing the result!
console.log(generatedJs.eval());
// y t -sinx +z ///////////
// 4 * 1 - Math.sin(Math.PI) + 1
// === 5 ///////////This happens behind the scene:
// behind the scene
let scope = [
{ t: 1, x: 180, },
{ x: 3, y: 4 },
function getId(id){
let vars = { z: 1, sin(x){ return Math.sin(x*Math.PI/180) } };
return vars[id];
}
];
generatedJs.eval = (function anonymous(scope) {
function __scicave_rakam_getId__(id) {
if (typeof scope[0] === 'object' && scope[0].hasOwnProperty(id)) {
return scope[0][id];
}
else if (typeof scope[0] === 'function' && (a = scope[0](id)) && a !== undefined) {
return a;
}
else if (typeof scope[1] === 'object' && scope[1].hasOwnProperty(id)) {
return scope[1][id];
}
else if (typeof scope[1] === 'function' && (a = scope[1](id)) && a !== undefined) {
return a;
}
else if (typeof scope[2] === 'object' && scope[2].hasOwnProperty(id)) {
return scope[2][id];
}
else if (typeof scope[2] === 'function' && (a = scope[2](id)) && a !== undefined) {
return a;
}
else {
throw new Error('the scope array has no valid scope in it.');
}
}
return ()=>__scicave_rakam_getId__('y') * __scicave_rakam_getId__('t') - __scicave_rakam_getId__('sin')(__scicave_rakam_getId__('x')) + __scicave_rakam_getId__('z');
})(scope);handlers: optional array
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,14 +1,15 @@ | ||
| import geometry from './geometry/index.js' | ||
| import core from './core/index.js'; | ||
| import * as core from './core/index.js'; | ||
| import parser from './parser/index.js'; | ||
| import version from './version.js'; | ||
|
|
||
| export default { | ||
|
|
||
| ...core, /// make sre that any new property won't crash with core properties | ||
| ...core, /// make sure that any new property won't crash with core properties | ||
|
|
||
| parser, | ||
|
|
||
| geometry, | ||
|
|
||
| version | ||
| }; |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,4 +1,4 @@ | ||
|
|
||
| // this file is auto generated | ||
| // the current version is: | ||
| module.exports = "0.0.4"; | ||
| export default "0.0.2"; |