Skip to main content

A monitoring solution built on Panel.

Project description

Lumen

Illuminate your data

Build Status Linux/MacOS/Windows Build Status
Coverage codecov
Latest dev release Github tag dev-site
Latest release Github release PyPI version lumen version conda-forge version defaults version
Docs gh-pages site
Support Discourse

Purpose

The Lumen project provides a framework to build data-driven dashboards from a simple yaml specification. It is designed to query data from any source, filter it in various ways and then provide views of that information, which can be anything from a simply indicator to a table or a plot.

Since Lumen is built on Panel it supports a wide range of plotting libraries and other components to explore and visualize data. Thanks to integration with Intake, lightweight package for finding, investigating, loading and disseminating data, Lumen can query data from a wide range of sources including many file formats such as CSV or Parquet but also SQL and many others.

The library is organized into a small number of simply object types including:

  • Source: A Source provides any number of tables along with a JSON schema describing the contents of those tables.
  • Filter: A Filter object is given the schema of a field in one of the tables and generates queries which filter the data supplied by a Source.
  • View: A View can query a table from a Source and generates a viewable representation.
  • Transform: A Transform can apply arbitrary transformation to the tables.

All of these base types can be easily subclassed to provide custom data sources, filters, transforms and views.

Getting started

Lumen works with Python 3 and above on Linux, Windows, or Mac. The recommended way to install Lumen is using the conda command provided by Anaconda or Miniconda:

conda install -c pyviz lumen

or using PyPI:

pip install lumen

Once installed you will be able to start a Lumen server by running:

lumen serve dashboard.yaml --show

This will open a browser serving the application or dashboard declared by your yaml file in a browser window. During development it is very helpful to use the --autoreload flag, which will automatically refresh and update the application in your browser window, whenever you make an edit to the dashboard yaml specification. In this way you can quickly iterate on your dashboard.

Try it out! Click on one of the examples below, copy the yaml specification and launch your first Lumen application.

Examples

London Bike Points
NYC Taxi
Palmer Penguins
Precipitation

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lumen-0.3.1.tar.gz (44.8 kB view details)

Uploaded Source

Built Distribution

lumen-0.3.1-py2.py3-none-any.whl (49.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file lumen-0.3.1.tar.gz.

File metadata

  • Download URL: lumen-0.3.1.tar.gz
  • Upload date:
  • Size: 44.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/52.0.0.post20210125 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.7.10

File hashes

Hashes for lumen-0.3.1.tar.gz
Algorithm Hash digest
SHA256 391c9c26b88b75c290c9ff11252c3f254110e3cc12cb35690b0c5153f5dc309a
MD5 6566e022cbfa6214b7a0abdfa1e7d5d1
BLAKE2b-256 faf3c12b5ac5016f84020dfb2f1d9c04080df77357cb8db3d80631434118456b

See more details on using hashes here.

Provenance

File details

Details for the file lumen-0.3.1-py2.py3-none-any.whl.

File metadata

  • Download URL: lumen-0.3.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 49.8 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/52.0.0.post20210125 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.7.10

File hashes

Hashes for lumen-0.3.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 58536471383c89f5b4bb2e5d79fe8ad1a5982ec2fba7c9e815d8895e69feb50a
MD5 84497669855d2b17ee2a65000d6114a4
BLAKE2b-256 5648c4eced93b225f7d3eb0702dce10fe0d27b013073cdb93b53a894922c91ed

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page