leap-motion

Latest stable version:

http://models-resources.concord.org/leap-motion/index.html

Latest development version:

http://models-resources.concord.org/leap-motion/branch/master/index.html

Old versions can be accesed via /version/<tag> path, e.g.:

http://models-resources.concord.org/leap-motion/version/0.6.0/index.html

Development

This project is using webpack to build the final JS file in /dist folder.

First, you need to make sure that webpack is installed and all the NPM packages required by this project are available:

npm install -g webpack
npm install

Then you can build JavaScript files using:

webpack

or:

webpack --watch

Deployment

This project is automatically deployed to S3 bucket by Travis-CI.

• production branch is deployed to top-level directory (http://models-resources.concord.org/leap-motion/index.html).
• other branches are deployed to /branch/ subdirectories (e.g. http://models-resources.concord.org/leap-motion/branch/master/index.html)
• tags are deployed to /version/ subdirectories (e.g. http://models-resources.concord.org/leap-motion/version/0.6.0/index.html)

URL Parameters

Many of the simulations can be customized using URL parameters as follows:

Translations (all simulations)

GRASP Leap Interactives are available in two languages - English and Spanish. The Spanish version can be selected from the main menu page by clicking on the flag in the top-right to choose the language. Alternatively, all simulations can be launched with one of the following parameters:

lang=en_us
lang=es_es

English is the default language. Spanish translation is a work-in-progress. All language translation strings can be found in apps/common/js/lang.

Seasons

For the Seasons simulation URL parameters can be specified to preset which panels to display. Panels are specified with the parameters:

viewMain
viewTop
viewBottom

Contents can be one of the following:

orbit
earth
raysGround
raysSpace

If orbit view controls are required, they can be enabled with the orbitControl=true parameter

The active (controlled by Leap device) view can be specified with the activeView parameter, and selecting the contents. Example URLs include:

https://models-resources.concord.org/leap-motion/branch/master/index.html?simulation=seasons&viewMain=orbit&viewTop=earth&viewBottom=raysGround&activeView=raysGround

https://models-resources.concord.org/leap-motion/branch/master/index.html?simulation=seasons&viewMain=raysGround&viewTop=orbit&activeView=raysGround&orbitControl=true

https://models-resources.concord.org/leap-motion/branch/master/index.html?simulation=seasons&viewMain=earth&viewTop=raysGround

Heat Transfer Simulations

For the main Heat Transfer and Heat Transfer Transparent demos, the following URL parameters can be applied:

bar (thick/thin/vacuum/none)
spoon (true/false)
markOne

Adding a bar will connect the two groups of molecules immediately when the simulation is loaded. The spoon, previously enabled in the Options menu, can be pre-set to appear whenever a bar is present.

The vacuum parameter for the bar will leave a vacuum between the two groups of molecules, but if the spoon is selected it will appear.

The markOne parameter will highlight an atom on the right for the student to watch as the simulation heats up.

Example URL: https://models-resources.concord.org/leap-motion/branch/master/index.html?simulation=labheattransfertransparent&bar=thick&spoon=false&markOne

For the Heat Transfer Long simulation, the only parameter that can be specified is the markOne parameter, and this will highlight the top right particle. Omitting the parameter leaves all particles unmarked. https://models-resources.concord.org/leap-motion/branch/master/index.html?simulation=labheattransferlong&markOne

Running project locally

Prerequisites

1. Open Terminal app
2. Make sure that node and npm tools are installed and up to date. Type: node --version and npm --version
3. If they are not installed or outdated (node version is older than 5.x), download node installer from this page. npm will be automatically installed together with node.
4. [Windows only] If npm install fails, you might need to run terminal as Administrator and type: npm install --global --production windows-build-tools

Running local server (production code)

1. Download and unzip the source code: https://github.com/concord-consortium/leap-motion/archive/production.zip
2. Open Terminal app
3. Go to the directory with downloaded code, type cd ~/Downloads/leap-motion-production
4. Type: npm install (it might take a while)
5. Type: npm run server
6. Open: http://localhost:8080/index.html

Running local server (latest development or topic branch code)

Follow previous instructions, but replace production.zip segment in the URL with master.zip for the latest development version or with name of the branch that you're interested in. For example:

• https://github.com/concord-consortium/leap-motion/archive/master.zip
• https://github.com/concord-consortium/leap-motion/archive/two-hands-angle.zip

Releases

• 0.7.0 (Apr 4, 2018)
• 0.6.0 (Jun 13, 2017)
• 0.5.0 (Mar 20, 2017)
• 0.4.0 (Jun 9, 2016)
• 0.3.0 (Feb 18, 2016)
• 0.2.2 (Feb 17, 2016)
• 0.2.0 (Feb 13, 2016)
• 0.1.0 (Feb 2, 2016)

License

MIT