{"_id":"fast-mersenne-twister","_rev":"4-2d8bb1391ae7fc24690590db497c1e6f","name":"fast-mersenne-twister","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"fast-mersenne-twister","version":"1.0.0","description":"A fast Mersenne Twister","type":"module","main":"mersenne.js","module":"mersenne.js","scripts":{"pack":"npx @thomasrandolph/icepack","test":"node ./test.js","compare":"node ./compare.js","all-meta":"node ./test-mersenne-twister.js && node ./test.js && node ./compare.js"},"repository":{"type":"git","url":"git+https://gitlab.com/rockerest/fast-mersenne-twister.git"},"keywords":["mersenne","twister","mersenne twister","fast"],"author":{"name":"Thomas Randolph","url":"http://rdl.ph/"},"license":"MIT","bugs":{"url":"https://gitlab.com/rockerest/fast-mersenne-twister/issues"},"homepage":"https://gitlab.com/rockerest/fast-mersenne-twister#readme","devDependencies":{"eslint":"7.5.0","eslint-plugin-do-this":"1.0.0","mersenne-twister":"1.1.0"},"gitHead":"f673694f5da1273f1cebb2b82d171de51e993b7e","_id":"fast-mersenne-twister@1.0.0","_nodeVersion":"14.6.0","_npmVersion":"6.14.6","dist":{"integrity":"sha512-L4igMML4/8yaewDR4Z3epiAiuohuMixHde4cgInJ7jWIdT2g1LRkblxItKVdAQdgUZzzy1S/PSXEnxUXGESv+w==","shasum":"8ffc48483a6f60682eba75a64e98c71d36f998a0","tarball":"https://registry.npmjs.org/fast-mersenne-twister/-/fast-mersenne-twister-1.0.0.tgz","fileCount":4,"unpackedSize":11419,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJfGCgbCRA9TVsSAnZWagAA6mcP/3o8K28boLAXnjAYEPVM\nKzEfjvqjX3dndbKGNG8CQ7a3ciGAll1YqiRoRL/7ttFcQl68H72SB7Df73Sr\n7VEEHfhQGBVfGlOAvia5vN7GRVUaSxrXSeb8id/ugSOXv/3qBu6CxaVEEZTp\nL9wJupLqc3SeVrwNzb2E+ZN86YEafbcqWAVZHD4TVUwNiqVPqrkFInPW3l00\nLrdBB+lOQ5Y+IdqAABzxfZ06RGrJsW5KBwh7KRaatDM7rMaQPA7Pe6gOEfgC\nqS0RjyMKHqXUe2YHhZh0l1tIrnzH7MoOWykITILIDyKR/9UaRn81Ydy5Vv1A\n/F7v2K/n3NLkJXmzCtNsTvlJt+FFRw9InvsYDrzqlD8gxBUE3ovdLkbj76fc\nIH+lyFy8BXatBr4YMiakYRkFWzyeiIKWlGHu+XQ29Md1LDMjAB3TDI6kzScW\nwgBK1lGggf40FNRXoN9HTeKBJIm8RQygp6yTJC/6RsGacXCbkm99/kRKoQC9\nSvKTlMVDWzp5vrWjoGuufup7+XED3KR2sWiVGPIwQ6FDKy3ebkhgV51V8xhl\nW/3TCikqgQ119Lb3GyI0+/SZJGXWZ0F72aQIkLOgutrK5em7HAOt/2T9Y1Nt\nh01zMRpsPDBS9RmPgKieyZByx3AqKLbP/bSDofOgfEy+BwjYNKW7wP/IY0xn\nW++2\r\n=8a3r\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDK+RoFoGtjpw4AX+pZVMG+//8bJZNUr0SGwJqTr8xlBgIhAKavp1UEwol/4xtM0Rj6BCB8Fx/fGstqqEcdS/KBzLXt"}]},"maintainers":[{"name":"rockerest","email":"websites@thomasrandolph.info"}],"_npmUser":{"name":"rockerest","email":"websites@thomasrandolph.info"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/fast-mersenne-twister_1.0.0_1595418650729_0.2532707857698564"},"_hasShrinkwrap":false},"1.0.1":{"name":"fast-mersenne-twister","version":"1.0.1","description":"A fast Mersenne Twister","type":"module","main":"mersenne.js","module":"mersenne.js","scripts":{"pack":"npx @thomasrandolph/icepack","test":"node ./test.js","compare":"node ./compare.js","all-meta":"node ./test-mersenne-twister.js && node ./test.js && node ./compare.js"},"repository":{"type":"git","url":"git+https://gitlab.com/rockerest/fast-mersenne-twister.git"},"keywords":["mersenne","twister","mersenne twister","fast"],"author":{"name":"Thomas Randolph","url":"http://rdl.ph/"},"license":"MIT","bugs":{"url":"https://gitlab.com/rockerest/fast-mersenne-twister/issues"},"homepage":"https://gitlab.com/rockerest/fast-mersenne-twister#readme","devDependencies":{"eslint":"7.5.0","eslint-plugin-do-this":"1.0.0","mersenne-twister":"1.1.0"},"gitHead":"7a77e6aa6fac745c19699da07afd76e7815db778","_id":"fast-mersenne-twister@1.0.1","_nodeVersion":"14.6.0","_npmVersion":"6.14.6","dist":{"integrity":"sha512-5j19QJWk5E+xp77ybxh7xIzcvyL4FhYWZYwu/sLOYqyXeZ3lgcrDRf/KkflqbHlNxJCcgUqPGJv6MMMtLJylwg==","shasum":"cfecfc1003ec91840863d2668f2d7ddf27075abf","tarball":"https://registry.npmjs.org/fast-mersenne-twister/-/fast-mersenne-twister-1.0.1.tgz","fileCount":4,"unpackedSize":11685,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJfGCsSCRA9TVsSAnZWagAAedMP/jQmyaVdrr1Sswvy0Xth\nlG9dTJ7YgrrEC6fx27yy0575fTHLDL0dNwo/CCRlsbRS5BUYzfpCKZvIZ5DR\ncalzADaeRGi/5geV1Hc+55EQro33fCglzLNFWWIOT8aop6RUX6ZlI8JOW/vu\ntfERl1GqAKv95vUN0y1qFWCKMRy3ZGrdCcud/aV2X4lbH+F7LiJZmcz14TRx\nHWTrAbcXn8uObcJnl8eq6pLyccvxUbBCj/mB0E2fNKIpV6d38zNaArYXod9x\n9wTD2RC6/Z3ViS7eyfP7xhw1X7bFRJfZkcH3+qlT2bsv+BySwlX3KW9lVbKo\nXwZZNnmnCdP5Tiu3EFGzmXU2gjmI25V/xlwy4co6ZZkjlPvazWvYm6YzLc81\nAS8WssbZDuAvGETdrQm3W6utUUHH3muLbe2Mv7rL/ekL15uNOrzgTpFhBT8H\nHFgQ0/eWessD1+RE2BrX+zjq7Mxhz+qIIGbub2xLGOIkc0X57RECwV+IbDaW\nMtB4MlEf2oBz5fMS42jOhGSSWrKUV8SLMV/j3eTQRNzSf1xN2wxdC/E/xMec\nondDC1TpaQGhPBcLheEwkd0vQl6zV3oFeE+iRwSGPgaqzVDKL3W4+Ky4Dukn\nYaHfOWg4gn4GUdFe5HdvngZCmaf2+c/kqlVppUsxHdaYQIB/v9d/BxrBJem4\nDlX8\r\n=M+Ab\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIGC7WX+zBAnzfCIMAI+N8ZcM1U8g/4pseRZQot+TSxfZAiAcgIBg804GIZ5og7R20J9yTK490QpJuV/+eug53PXweA=="}]},"maintainers":[{"name":"rockerest","email":"websites@thomasrandolph.info"}],"_npmUser":{"name":"rockerest","email":"websites@thomasrandolph.info"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/fast-mersenne-twister_1.0.1_1595419409605_0.9106855346288951"},"_hasShrinkwrap":false},"1.0.2":{"name":"fast-mersenne-twister","version":"1.0.2","description":"A fast Mersenne Twister","type":"module","main":"mersenne.js","module":"mersenne.js","scripts":{"pack":"npx @thomasrandolph/icepack","test":"node ./test.js","compare":"node ./compare.js","all-meta":"node ./test-mersenne-twister.js && node ./test.js && node ./compare.js"},"repository":{"type":"git","url":"git+https://gitlab.com/rockerest/fast-mersenne-twister.git"},"keywords":["mersenne","twister","mersenne twister","fast"],"author":{"name":"Thomas Randolph","url":"http://rdl.ph/"},"license":"MIT","bugs":{"url":"https://gitlab.com/rockerest/fast-mersenne-twister/issues"},"homepage":"https://gitlab.com/rockerest/fast-mersenne-twister#readme","devDependencies":{"eslint":"7.5.0","eslint-plugin-do-this":"1.0.0","mersenne-twister":"1.1.0"},"gitHead":"81693d4237b30cd800789c141407751a2e185ab8","_id":"fast-mersenne-twister@1.0.2","_nodeVersion":"14.6.0","_npmVersion":"6.14.6","dist":{"integrity":"sha512-IaClPxsoBu3MxGpcURyjV8otT5Bj4ARoK0KBCJGnEVnD1A/qclL5eIeYiUuwG/WWJPxL1jlK61HTm2T6SBmvBQ==","shasum":"5ead7caf3ace592a5789d11767732bd81cbaaa56","tarball":"https://registry.npmjs.org/fast-mersenne-twister/-/fast-mersenne-twister-1.0.2.tgz","fileCount":4,"unpackedSize":11691,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJfGCuJCRA9TVsSAnZWagAALskQAJq/ttEGTsDdd4wS1t2q\n7iU0eD1KpDGn7qSFYYbSzw+fW3iVmzakOegCdMOz0poijkzEdzIhjIarEHOs\ntEwzlCi+F4+iJsKHZMQltRRjSvXIt8mKHCjXRbCrABifUOe4EtKgCp1FKLE6\n7JOyhRxu1rDWJX5LJt9KdsF+Bv4uF9q0DZQboZyIHh1ZUfOTps1NOnIdNJMu\nrTkE5KbSHtB57BjjJohQq/3PxnL64to6alw+QBYijU5AEGOynhCeDfxMZ7gt\nnzA/a/TiVxAhNKJveapdLsRUdH9TZSNfkaAYHl9RBqWgEzqWdtn8Hyc81xF7\n9/eOPw9PLBZtQjzJYLiMiyCpLe4gO59t7oOMW58xwkyOp0Dt/M8za3LoLGpr\nBqxiFwx6DC0sdEkjrPWSkEQNCMai+umvw4t8UZB7PPNkSO0usQ+jC90Sxp2D\n9k/Q3Rz+2+bbaQHH5fcqDh8ZrLVeKzAIZ6NV1Yh1JGVnlK6DvF+N8GsM7Ae2\nwS+5NTq4bkJ2QbVSaU6E/oEepi0oMtdFMU+Ay3XxWiA9ceo1RI7l9qY0O9z3\n6aPpdFXnPkZkfUi0qvqm1UKLml4CopSxOx5oNeYW7MVAyL4NLPCgR8xW2yc1\n+Z5RDzG2+xo811O+t46K77EgXYJlW6EY9zG0qnESEwWhxa7InkbOIidodPhU\nbp4I\r\n=MfxA\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIEOrxFB4Dglfe3lYoNZOpXvRrBNzMXlsFjCzg7XIJPvSAiB2VoZzBGND5OX0Q2V9Jx3uaBNlc1dg0tx4/8N9pN9u/Q=="}]},"maintainers":[{"name":"rockerest","email":"websites@thomasrandolph.info"}],"_npmUser":{"name":"rockerest","email":"websites@thomasrandolph.info"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/fast-mersenne-twister_1.0.2_1595419529234_0.5940423450678867"},"_hasShrinkwrap":false},"1.0.3":{"name":"fast-mersenne-twister","version":"1.0.3","description":"A fast Mersenne Twister","type":"module","main":"mersenne.js","module":"mersenne.js","scripts":{"pack":"npx @thomasrandolph/icepack","test":"node ./test.js","compare":"node ./compare.js","all-meta":"node ./test-mersenne-twister.js && node ./test.js && node ./compare.js"},"repository":{"type":"git","url":"git+https://gitlab.com/rockerest/fast-mersenne-twister.git"},"keywords":["mersenne","twister","mersenne twister","mersennetwister","fast","performance","performant","random","number","generator","seed","seedable","seeded","rng","prng"],"author":{"name":"Thomas Randolph","url":"http://rdl.ph/"},"license":"MIT","bugs":{"url":"https://gitlab.com/rockerest/fast-mersenne-twister/issues"},"homepage":"https://gitlab.com/rockerest/fast-mersenne-twister#readme","devDependencies":{"eslint":"7.5.0","eslint-plugin-do-this":"1.0.0","mersenne-twister":"1.1.0"},"gitHead":"bc11ee4d3f6d550d7548d4842f45b8d66fc8a7f2","_id":"fast-mersenne-twister@1.0.3","_nodeVersion":"15.6.0","_npmVersion":"7.4.2","dist":{"integrity":"sha512-fETiILfuW8QuH+eCpaFUGz8BOMA/+8IesWYoVeltuIzEvmq7qekuw1Kmpf3yjZcYwYZH3dNvYkc81+69/gCGhQ==","shasum":"c2aeb1e7d906d1b5ab27c12b8bdeb4e3bf0d9881","tarball":"https://registry.npmjs.org/fast-mersenne-twister/-/fast-mersenne-twister-1.0.3.tgz","fileCount":4,"unpackedSize":11861,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgBT93CRA9TVsSAnZWagAAeKoP/1uST3Lmut9yDmoVI7mk\nVTC00890PH5trwtIdgAoP15bCqqbnrVSa3Cr9mluxCcDvYUDSaEHkw1Fyafq\nyUPX0CjgMfbh/9oTXErUmwYGjkHTJLcArkIoQj8ffN7NUl2hPsJBiWUJkHLq\nuZSh7xuRqgF/L3gAujuChO3JNZ6UzVnCVJIVW/8C+Uv47Gi8SZg+vnlayw/P\nW7rbTuBfrxO7WhOKR/Y7u2REQTeDRMnp+IW3pw1eyVr3BYRyHBkiAzLKRU5H\nwTJxdPfiXeE/n7k8E9G0iXaYDvnYhUacJ3gB+7cBiQj1JOvXOGhfPPVpryFR\n+0nDHtaVXZfdJyL4G207g3sOcsrA9vNQOB3V0jfuVrn89fD4waEDSifDNYbd\nCTHLh5CM37mKfqM/jrc8D+oJgx71SvJ6eDaZqHRmC8r7PPsFVgezKrnAD8DW\nSTnknVIw+GwHKCs2ZdPSLp4F7nQfiWy5/zNoUC7eh3OWSpS+M8dXzeBxrYFJ\nGkywHPEEgKBOyyTPaG176ZX01Au7dPZ4dDq2x4/gLmAenqLZUsvqxiLO2aDh\nh2Yb+LCaa/DRcSoYmZ0cdNYj9ff6XowKTrOdXRJMt/VDPZjIN5mIqm0i8OFO\nbjvbKDkAqlXQYAt89BOPUllo4+gLjqW7t0mDBUDJsQit/x2vHsspwZckwA6d\nk5pp\r\n=9OOI\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQD22ivI/8n04XdPwzKzZ55V+UsCQrkKGVL0gUGpQTAaRgIgFsN3VelmlNk0v7gfIpjsBCMljzBim85xYhoVXlU0/2M="}]},"_npmUser":{"name":"rockerest","email":"websites@thomasrandolph.info"},"directories":{},"maintainers":[{"name":"rockerest","email":"websites@thomasrandolph.info"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/fast-mersenne-twister_1.0.3_1610956662879_0.3172480866955749"},"_hasShrinkwrap":false}},"time":{"created":"2020-07-22T11:50:50.729Z","1.0.0":"2020-07-22T11:50:50.848Z","modified":"2022-05-02T04:28:41.752Z","1.0.1":"2020-07-22T12:03:29.883Z","1.0.2":"2020-07-22T12:05:29.363Z","1.0.3":"2021-01-18T07:57:42.988Z"},"maintainers":[{"name":"rockerest","email":"websites@thomasrandolph.info"}],"description":"A fast Mersenne Twister","homepage":"https://gitlab.com/rockerest/fast-mersenne-twister#readme","keywords":["mersenne","twister","mersenne twister","mersennetwister","fast","performance","performant","random","number","generator","seed","seedable","seeded","rng","prng"],"repository":{"type":"git","url":"git+https://gitlab.com/rockerest/fast-mersenne-twister.git"},"author":{"name":"Thomas Randolph","url":"http://rdl.ph/"},"bugs":{"url":"https://gitlab.com/rockerest/fast-mersenne-twister/issues"},"license":"MIT","readme":"# fast-mersenne-twister\n\nA fast Mersenne Twister\n\n## Usage\n\n```javascript\nimport { MersenneTwister } from \"fast-mersenne-twister\";\n\nvar myFastTwister = MersenneTwister( 1234567890 );\n\nconsole.log( myFastTwister.random() ); // 0.6187947695143521\n```\n\nYou can also use an array seed:\n\n```javascript\nimport { MersenneTwister } from \"fast-mersenne-twister\";\n\nvar myFastTwister = MersenneTwister( [ 1234, 5678, 9012 ] );\n\nconsole.log( myFastTwister.random() ); // 0.22977210697717965\n```\n\n### Methods\n\nAll of the original methods are available on the MersenneTwister object returned by the exported function.  \n\nThey are also aliased to more readable / convenient names.  \n\n| Convenience | Original | Return |\n| ----------- | -------- | ------ |\n| `randomNumber` | `genrand_int32` | 32 bit integer, [0,0xffffffff] |\n| `random31Bit` | `genrand_int31` | 31 bit integer, [0,0x7fffffff] |\n| `randomInclusive` | `genrand_real1` | float, [0,1] |\n| `random` | `genrand_real2` | float, [0,1) (this is just like what `Math.random()` returns) |\n| `randomExclusive` | `genrand_real3` | float, (0,1) |\n| `random53Bit` | `genrand_res53` | float, [0,1) with 53-bit resolution |\n\n## Testing\n\nYou can recompile the original program:\n\n```console\ng++ mt19927.c -o mt\n```\n\nIf you run it with `./mt` it will output 1000 32bit integers and 1000 numbers [0,1).  \nI've removed the original 5-column output to make formatting `original_data.js` a little easier.\n\n----\n\nYou can test this implementation against the data in `original_data.js` with:\n\n```console\nnode ./test.js\n```\n\nor\n\n```console\nnpm run test\n```\n\n----\n\nI found this faster implementation by Stephan Brumme and updated it because I thought the most widely used implementation - `mersenne-twister` (which is also used internally by libraries like ChanceJS) - wasn't fast enough.\n\nI suspect that implementation has also made its way into a lot of other software just by the fact that it's the thing that comes up when you search for \"JavaScript Mersenne Twister.\"\n\nIf you'd like to see how much faster this implementation is, run:\n\n```console\nnpm install\nnpm run pack\nnpm run compare\n```\n\n(`fast-mersenne-twister` consistently comes in around 2X `mersenne-twister`, usually ~2.2)\n\n----\n\nFor all of the possible output from this library, run:\n\n```console\nnpm install\nnpm run pack\nnpm run all-meta\n```\n\n## Notes\n\n- Extremely true to the [original algorithm by Matsumoto & Nishimura](http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/MT2002/emt19937ar.html)\n- Converted to JavaScript by [Stephan Brumme](https://create.stephan-brumme.com/mersenne-twister/)\n    - This version cannot be initialized with an array\n- Updated\n    - with my code style\n\t- with all of the original random generators\n\t- with the ability to be initialized with an array\n\t- with the correct range (the original only outputs unsigned integers, while Stephan's version outputs signed integers)\n\nThe output of this implementation matches the output of the check-file on the original website linked above.\n\nI took the array-seed function from Sean McCullough's [gist](https://gist.github.com/banksean/300494) (the grand-daddy of all[?] the other JavaScript Mersenne Twisters).  \nI modified it very slightly (removed the UInt cast to be deferred to the Int32 function)\n","readmeFilename":"README.md"}