@sc-voice/tools v3.33.0

@sc-voice/tools

Javascript libary for SC-Voice applications

• Math
• Text
• Graph

Math.Fraction

let f = new Fraction(9, 240, 'segments');
console.log(f.value); // 0.375
console.log(f.numerator, f.denominator); // 9 240
console.log(f.n, f.d); // 9 240
console.log(f.toString()); // 1/2 segments
console.log(Fraction.gcd(9, 240)); // 3
console.log(f.difference); // -150
console.log(f.remainder); // 9
console.log(f.percent); // '4%'
console.log(f.add(new Fraction(1,80)); // new Fraction(4,80)

Text.WordSpace

Used for text similarity comparison, WordSpace creates and compares Vectors of words weighted by normalized frequency of occurrence. Weights and scores are normalized to the interval 0..1. (NOTE: Odd how bag-of-words works better here than fastText?)

Text.MerkleJson

Computing the hash of JSON objects can be tricky because JSON.stringify() does not have a guaranteed string representation of a Javascript object. Specifically, the following are equivalent and valid outputs of JSON.stringify():

var json = "{size:{w:100,h:200}}";
var json = "{size:{h:100,w:200}}"; ```

MerkleJson guarantees a unique hash code for any Javascript object.
In addition, MerkleJson is efficient in that it only recalculates 
object hashes if the object has no Merkle hash tag. If a Merkle hash
tag is present, its value is returned as the hash value of that object.

### Serialize JSON object
Unlike JSON, MerkleJson serializes objects canonically.

```js
var obj = {
    d:4,
    b:2,
    a:1,
    c:3,
};
console.log(JSON.stringify(obj)); // {"d":4,"b":2,"a":1,"c":3}
var mj = new MerkleJson();
console.log(mj.stringify(obj)); // {"a":1,"b":2,"c":3,"d":4}

Compute hash of JSON object

var mj = new MerkleJson();
var hash = mj.hash({
    size:{
        w:100,
        h:200
    }
}); // e77b735125fec27a61c6f54b17fb6221

var hash = mj.hash({
    size:{ // hash is independent of property order
        h:200
        w:100,
    }
}); // e77b735125fec27a61c6f54b17fb6221

Do not calculate hash if merkleHash is present

var mj = new MerkleJson();
var useMerkleHash = true;
var hash = mj.hash({
    any1: thing1, 
    any2: thing2, 
    any3: thing3, 
}, useMerkleHash); // 441e4f8dabdc6cb17dc9500cee73155b

var hash = mj.hash({
    ... // anything
    merkleHash: e77b735125fec27a61c6f54b17fb6221, 
}, useMerkleHash); // e77b735125fec27a61c6f54b17fb6221

var useMerkleHash = false; // force hash calculation
var hash = mj.hash({
    any1: thing1, 
    any2: thing2, 
    any3: thing3, 
    merkleHash: e77b735125fec27a61c6f54b17fb6221, // ignored
}, useMerkleHash); // 441e4f8dabdc6cb17dc9500cee73155b