numbl 0.1.1 → 0.1.3

package/README.md

@@ -1,22 +1,16 @@
 # Numbl
 
-Numbl is an open-source numerical computing environment that aims to be compatible with Matlab.
-
-**Early stage project.** Numbl is under active development and new functionality is being added regularly.
-
-[Intro presentation](https://magland.github.io/mip-numbl-presentation)
-
-## Try it in the browser
+A MATLAB-compatible numerical computing environment with 400+ built-in functions. Runs in your browser or on the command line.
 
 [![numbl REPL](docs/repl-preview.svg)](https://numbl.org/embed-repl)
 
-Click the terminal above to launch an interactive REPL — no installation required. All execution happens locally in your browser. The full browser IDE with file management and plotting is available at <https://numbl.org>.
+**[Documentation](https://numbl.org/docs)** | **[Browser IDE](https://numbl.org)** | **[REPL](https://numbl.org/embed-repl)** | **[Plot Gallery](https://numbl.org/gallery)**
 
-Numbl scripts can also be embedded in HTML and Markdown pages (including GitHub Pages). See the [numbl-embed-example](https://magland.github.io/numbl-embed-example/) for usage and a [live demo](https://magland.github.io/numbl-embed-example/example1).
+## Quick Start
 
-## Command-line usage
+Try it in the browser at [numbl.org](https://numbl.org) -- no installation required.
 
-For full performance, use the command-line version. If you have Node.js installed, you can run numbl directly with `npx` (no install needed):
+Or use the CLI:
 
 ```bash
 npx numbl                      # interactive REPL
@@ -24,69 +18,41 @@ npx numbl eval "disp(eye(3))"  # evaluate inline code
 npx numbl run script.m         # run a .m file
 ```
 
-Or install globally for regular use:
+Install globally for regular use:
 
 ```bash
 npm install -g numbl
 ```
 
-To enable fast linear algebra, build the native LAPACK addon:
+## Native Addon
+
+For faster linear algebra, FFT, and C++ operations, build the optional native addon:
 
 ```bash
 # Prerequisites: C++ compiler, libopenblas-dev, libfftw3-dev (or equivalents for your OS)
 numbl build-addon
 ```
 
-## Usage
+Rebuild after upgrading numbl (`npm install -g numbl@latest`).
 
-<!-- BEGIN CLI HELP -->
-```
-Usage: numbl <command> [options]
-
-Commands:
-  run <file.m>       Run a .m file
-  eval "<code>"      Evaluate inline code
-  run-tests [dir]    Run .m test scripts (default: numbl_test_scripts/)
-  build-addon        Build native LAPACK addon
-  info               Print machine-readable info (JSON)
-  list-builtins      List available built-in functions
-  (no command)       Start interactive REPL
-
-Global options:
-  --version, -V      Print version and exit
-  --help, -h         Print this help message
-
-Options (for REPL):
-  --plot             Enable plot server
-  --plot-port <port> Set plot server port (implies --plot)
-
-Options (for run and eval):
-  --dump-js <file>   Write JIT-generated JavaScript to file
-  --dump-ast         Print AST as JSON
-  --verbose          Detailed logging to stderr
-  --stream           NDJSON output mode
-  --path <dir>       Add extra workspace directory
-  --plot             Enable plot server
-  --plot-port <port> Set plot server port (implies --plot)
-  --add-script-path  Add the script's directory to the workspace (run only)
-  --opt <level>      Optimization level (0=none, 1=JIT scalar functions; default: 1)
-
-Environment variables:
-  NUMBL_PATH         Extra workspace directories (separated by :)
-```
-<!-- END CLI HELP -->
+## Documentation
 
-## VS Code extension
+Full documentation is available at **[numbl.org/docs](https://numbl.org/docs)**, covering:
 
-The [Numbl extension for VS Code](https://marketplace.visualstudio.com/items?itemName=jmagland.numbl) lets you run `.m` scripts directly in the editor with inline error diagnostics and a built-in figure viewer.
+- [Getting Started](https://numbl.org/docs/getting-started) -- installation, CLI options, native addon
+- [Language Features](https://numbl.org/docs/language) -- operators, data types, control flow, classes
+- [Built-in Functions](https://numbl.org/docs/builtins) -- 400+ functions by category
+- [Plotting](https://numbl.org/docs/plotting) -- 2-D/3-D plots, examples, CLI plot server
+- [Library Usage](https://numbl.org/docs/library) -- using numbl as an npm package
+- [Differences from MATLAB](https://numbl.org/docs/differences) -- behavioral differences and limitations
 
-## Upgrading
+## VS Code Extension
 
-```bash
-npm install -g numbl@latest
-```
+The [Numbl extension for VS Code](https://marketplace.visualstudio.com/items?itemName=jmagland.numbl) provides inline error diagnostics and a built-in figure viewer.
+
+## Embedding
 
-Note: if you previously built the native addon, you'll need to run `numbl build-addon` again after upgrading.
+Numbl scripts can be embedded in HTML and Markdown pages. See the [numbl-embed-example](https://magland.github.io/numbl-embed-example/) for usage and a [live demo](https://magland.github.io/numbl-embed-example/example1).
 
 ## Authors
 
@@ -94,8 +60,4 @@ Jeremy Magland and Dan Fortunato, Center for Computational Mathematics, Flatiron
 
 ## License
 
-Apache 2.0.
-
-## Acknowledgements
-
-See [acknowledgements.md](docs/acknowledgements.md).
+Apache 2.0

package/binding.gyp

@@ -16,7 +16,9 @@
         "native/lapack_qz.cpp",
         "native/lapack_fft.cpp",
         "native/lapack_fft_batch.cpp",
-        "native/elemwise.cpp"
+        "native/elemwise.cpp",
+        "native/randn.cpp",
+        "native/unary_elemwise.cpp"
       ],
       "include_dirs": [
         "<!@(node -p \"require('node-addon-api').include\")",