npm.io
1.0.5 • Published 2 months ago

@diamondlightsource/davidia

Licence
MIT
Version
1.0.5
Deps
17
Size
129 kB
Vulns
0
Weekly
0
Stars
5

Davidia

Davidia comprises two parts: a plot server and a set of React components including a connected plot. The plot server has a REST api that allows clients to visualize data in connected plots in React applications.

Demonstrating Davidia

Prepare a clean Python 3.10+ installation (this may be a conda or a virtual environment) then install the Davidia Python package with

pip install "davidia[all]"

To start the demo, run

dvd-demo

This starts the plot server, opens a browser window and runs a demo script that shows different plots. Note there are host and port settings available - read the builtin help with dvd-demo -h

Running Python plot server (with bundled example client)

dvd-server -c

Open localhost:8000 to view it in the browser. Now test plot server with,

python -m davidia.demos

Benchmarking the plot client

Set the environment variable DVD_BENCHMARK as on or add a -b argument:

dvd-server -c -b

Run the script to trigger benchmarks:

dvd-benchmark

See its builtin help using the -h argument.

Storybook

View the Storybook here.

Frontend documentation

View the frontend Typescript documentation here.

REST API documentation

View the REST API documentation here.