luma.gl: A JavaScript WebGL2 Framework for Data Visualization
\n\n## Overview\n\nluma.gl's provides efficient and easy-to-use WebGL2-based building blocks enabling high-performance GPU-based data visualizations and computations on your browser.\n\nSee\n[**Examples**](http://uber.github.io/luma.gl/) and\n[**Documentation**](http://uber.github.io/luma.gl/docs/).\n[**Change Log**](https://github.com/uber/luma.gl/blob/master/CHANGELOG.md).\n\n\n## luma.gl Design Goals\n\nHigh Level Design Goals\n- **Focus on data visualization** - While generic, luma.gl prioritizes features that enable efficient rendering of large data sets or that support improved visualization techniques. In practice this means that luma.gl is an early adopter of techniques like instanced rendering, WebGL2 and GPGPU techniques.\n- **Celebrate WebGL** Simplify the use of WebGL but do not hide it from the programmer. Learn luma.gl and you learn WebGL.\n- **Simplification, not abstraction** Provide an API that simplifies WebGL usage without hiding WebGL from the programmer. Abstractions are good but they should be built on top of luma.gl.\n\nSecondary Design Goals:\n- Focus on Shader Programming - Let's efficiently create, organize and debug shader code.\n- **Interoperability** - No \"magic\" global state that gets in the way of interoperability. All components work with a standard `WebGLRenderingContext` and can used together with components from other frameworks (e.g. stackgl).\n- **Debugging** Built in support for debugging and profiling WebGL and GLSL haders.\n\n\n## Usage\n\n* [deck.gl](https://github.com/uber/deck.gl) builds 3D map visualization overlays on luma.gl.\n\n\n## History\n\nluma.gl started out as a fork of\n[PhiloGL](https://github.com/philogb/philogl) however no effort has been\nmade to maintain compatibility with PhiloGL-based applications.\n\n\n# Installation\n\n```sh\nnpm install luma.gl --save\n```\n\n# Documentation, Lessons and Examples\n\nLuma.gl comes with 16 lessons, a number of examples, and a full set of\nreference documenation.\n\nTo run examples:\n```sh\ngit clone git@github.com:uber/luma.gl.git\ncd luma.gl\nnpm install\nnpm start\n```\nThis builds the luma.gl bundle, starts a small local server, and opens a browser window on a welcome page, allowing you to run to all lessons and examples.\n\n\n# Developing\n\nUse `npm start` to run the test server, it will open a web page from which\nyou can access the examples and lessons, and automatically update when you\nsave modified source files.\n\n\n## Testing\n\nTesting is performed on Travis CI and using a precommit hook. Local testing is\nsupported on three environments\n* `npm test` - runs `npm run test-headless`\n* `npm run test-browser` - Tests in your browser, may be helpful\n to quickly debug test case failures since it autoreloads on changes and\n gives you full access to your browser's debugger.\n\nWhen adding new features, or modifying existing ones, carefully consider if\nunit testing can be provided.\n","_shasum":"f26fb068ed6b661b0edb7790b340a0ed307e9cb9","gitHead":"bb811402f8a27eb1a837a5c95d41b198debf7e73","license":"MIT","scripts":{"docs":"npm run docs-build && open ./_docs/docs/index.html","lint":"eslint src test && npm run lint-yarn","test":"npm run lint && npm run build && npm run test-node","bench":"node test/bench/node.js","build":"npm run build-clean && npm run build-es6 && npm run build-es5","cover":"NODE_ENV=test nyc --reporter html --reporter cobertura --reporter=lcov npm run test-cover","start":"cat < docs/get-started/examples.md","build-es5":"babel src --out-dir dist --plugins=transform-es2015-modules-commonjs --source-maps && babel packages --out-dir dist/packages --plugins=transform-es2015-modules-commonjs --source-maps","build-es6":"babel src --out-dir dist-es6 --source-maps && babel packages --out-dir dist-es6/packages --source-maps","lint-yarn":"!(grep -q unpm.u yarn.lock) || (echo 'Please rebuild yarn.lock file using public npmrc' && false)","test-fast":"node test/node.js","test-fp64":"(cd src/shadertools/test && webpack-dev-server --progress --hot --open)","test-node":"node test/node.js | faucet","docs-build":"rm -fr _docs/* && jekyll build --config=docs/_config.yml --layouts docs/_layouts","test-cover":"NODE_ENV=test tape -r babel-register test/node.js && nyc report","build-clean":"rm -fr dist dist-es6 && mkdir -p dist/packages dist-es6/packages ","test-shader":"npm run build-dist && budo src/test/fp64-shader.spec.js:build/test-bundle.js --dir test --live --open --watch-glob '**/*.{html,css,scss,js,glsl}' -- -t babelify -t brfs-babel","docs-publish":"npm run docs-build && git add _docs -f && git commit -m 'UPDATE DOCS' --no-verify && npm run docs-gh-pages","publish-beta":"npm run build && npm run test-fast && npm publish --tag beta","publish-prod":"npm run build && npm run test-fast && npm publish","test-browser":"webpack-dev-server --env.test --progress --hot --open","bench-browser":"webpack-dev-server --env.bench --progress --hot --open","docs-gh-pages":"git subtree push --prefix _docs origin gh-pages","lint-examples":"eslint examples","test-fp64-old":"(cd src/shadertools/modules/fp64/test-deprecated && webpack-dev-server --progress --hot --open)","build-es6-packages":"","docs-gh-pages-force":"git push origin `git subtree split --prefix _docs dev`:gh-pages --force"},"_npmUser":{"name":"1chandu","email":"chandu@uber.com"},"homepage":"https://github.com/uber/luma.gl#readme","keywords":["webgl","visualization","animation","3d"],"repository":{"url":"git+https://github.com/uber/luma.gl.git","type":"git"},"_npmVersion":"4.2.0","description":"A WebGL JavaScript visualization library.","directories":{},"maintainers":[{"name":"1chandu","email":"chandu@uber.com"},{"name":"apercu","email":"bgronon@gmail.com"},{"name":"gnavvy","email":"gnavvy@gmail.com"},{"name":"heshan0131","email":"heshan0131@gmail.com"},{"name":"ibgreen","email":"ib.green.home@gmail.com"},{"name":"jianh","email":"jianh@uber.com"},{"name":"pessimistress","email":"cxiaoji@gmail.com"},{"name":"shaojingli","email":"lishaojing@gmail.com"}],"_nodeVersion":"7.10.0","contributors":[{"name":"Ib Green","email":"ib@uber.com"},{"name":"Nicolas Belmonte","email":"nico@uber.com"},{"name":"Rye Terrell"},{"name":"Shan He","email":"shan@uber.com"},{"name":"Mikola Lysenko"},{"name":"Wesam Manassra","email":"manassra@uber.com"},{"name":"Shaojing Li","email":"shaojing@uber.com"},{"name":"Ravi Akenapalli","email":"chandu@uber.com"}],"dependencies":{"seer":"^0.2.4","math.gl":"^1.0.0","webgl-debug":"^2.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"gl":"^4.0.2","nyc":"^10.2.0","disc":"^1.3.2","tape":"^4.6.3","buble":"^0.15.1","reify":"^0.4.4","sinon":"^4.1.3","eslint":"^3.0","faucet":"0.0.1","mkdirp":"^0.5.1","babelify":"^7.2.0","probe.gl":"0.0.2","babel-cli":"^6.18","coveralls":"^2.13.0","babel-core":"^6.18","brfs-babel":"^1.0.0","browserify":"^13.0.0","pre-commit":"^1.2.2","raw-loader":"^0.5.1","tape-catch":"^1.0.4","babel-eslint":"^6.0.0","buble-loader":"^0.4.0","module-alias":"^2.0.0","tape-promise":"^1.1.0","source-map-loader":"^0.2.1","tap-browser-color":"^0.1.2","source-map-support":"^0.4.2","webpack-dev-server":"^2.4.4","babel-preset-es2015":"^6.18","eslint-plugin-babel":"^4.0.0","eslint-plugin-react":"~6.7.0","babel-plugin-istanbul":"^4.1.1","eslint-config-uber-jsx":"^3.0.0","eslint-config-uber-es2015":"^3.0.0","babel-plugin-version-inline":"^1.0.0","babel-plugin-transform-builtin-extend":"^1.1.0"},"_npmOperationalInternal":{"tmp":"tmp/luma.gl_5.2.0-alpha.2_1519778522374_0.5142763865222795","host":"s3://npm-registry-packages"},"_id":"luma.gl@5.2.0-alpha.2","version":"5.2.0-alpha.2"}
![\"version\"](\"https://img.shields.io/npm/v/luma.gl.svg?style=flat-square\")
\n \n \n ![\"build\"](\"https://img.shields.io/travis/uber/luma.gl/master.svg?style=flat-square\")
\n \n \n ![\"downloads\"](\"https://img.shields.io/npm/dm/luma.gl.svg?style=flat-square\")
\n \n \n