Data model used by the bluesky ecosystem
Project description
Event Model
This repository contains documents that specify the schema for an event-based data model used at NSLS-II. Other projects in the organization use this model; it is their common way of organizing event-based data.
See this page of the NSLS-II documentation for an illustrated overview of the model.
The documents are specified using jsonschema. See this excellent tutorial for more on jsonschema.
Conda Recipes
Install the most recent tagged build: conda install event-model -c lightsource2-tag
Install the most recent tagged build: conda install event-model -c lightsource2-dev
Find the tagged recipe here and the dev recipe here
Usage
The schemas are packaged with a Python API. (In the future, they will probably be packaged for other languages. Get in touch if you are interested in this.) Because of its use of the new Enum type, this package requires Python 3.4+.
There are two variables in the public API, an Enum called DocumentNames and
a dictionary called schemas that is keyed on the values of
DocumentNames.
In [1]: import event_model
In [2]: event_model.schemas[event_model.DocumentNames.event]
Out[2]:
{'additionalProperties': False,
'description': 'Document to record a quanta of collected data',
'properties': {'data': {'description': 'The actual measument data',
'type': 'object'},
'descriptor': {'description': 'UID to point back to Descriptor for this event stream',
'type': 'string'},
'seq_num': {'description': 'Sequence number to identify the location of this Event in the Event stream',
'type': 'integer'},
'time': {'description': 'The event time. This maybe different than the timestamps on each of the data entries',
'type': 'number'},
'timestamps': {'description': 'The timestamps of the individual measument data',
'type': 'object'},
'uid': {'description': 'Globally unique identifier for this Event',
'type': 'string'}},
'required': ['uid', 'data', 'timestamps', 'time', 'descriptor', 'seq_num'],
'title': 'event',
'type': 'object'}
Use it in conjunction with the jsonschema package to validate documents in Python.
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
Built Distribution
Hashes for event_model-1.13.0b1-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 8501c649c459c810d055056c0972655b6c1ce3164a429354a4fdbe4dfc1a8ae9 |
|
| MD5 | 27474d0c0bc979daca301455dd06388d |
|
| BLAKE2b-256 | 78d2a3878d48a481b0ef905c8913be13bbaed7ac081a0af17b0786b3f36df887 |
