Interactive Numeric Computing

A workshop on interactive numeric computing in JavaScript.

Getting Started

Prerequisites

Running the workshop requires the following prerequisites:

git: version control
GNU Make: task runner
Node.js: JavaScript runtime (version >=0.10)

Note, in order to run make commands on Windows, you can use MinGW, a minimalist GNU for Windows, by adding the application to the PATH variable.

$ set PATH=C:\MinGW\bin;%PATH%

Another alternative is to use Cygwin, a collection of GNU and open source tools which provide functionality similar to a Linux distribution on Windows.

Download

To get started, acquire the stdlib source code by performing a shallow clone of the stdlib repository

$ git clone --depth 1 https://github.com/stdlib-js/stdlib -b develop

Once cloned, navigate to the cloned repository

$ cd ./path/to/cloned/stdlib-js/stdlib

and checkout the develop branch

$ git checkout develop

Environment Variables

For the purposes of this workshop, from the top-level repository directory, set the NODE_PATH environment variable. On Linux and Mac OS X,

$ export NODE_PATH=/path/to/stdlib-js/stdlib/lib/node_modules

On Windows,

$ set NODE_PATH=C:\\path\to\stdlib-js\stdlib\lib\node_modules

Note that setting an environment variable via export or set only affects the current shell. The environment variable will not be available in other shells. To make the environment variable available to all shells, edit the platform-specific configuration file for configuring user environments; e.g., .bash_profile, .profile, .bashrc, or some other variant. Once set, you may need to reload the configuration file in existing shells. For example, in a bash shell,

$ source ~/.bash_profile

Installation

To install dependencies,

$ make install

Testing

To run the full test suite,

$ make test

To run all examples,

$ make examples

Exercises

To begin the exercises, open the following URL in your browser

https://github.com/stdlib-js/stdlib/blob/develop/workshops/numeric-computing/exercises/plotting