Skip to content

Repository files navigation

ENTS-Backend

Build Test codecov

Environmental Networked Sensing (ENTS) backend is part of the ENTS hardware and software ecosystem for outdoor sensor networks. It's an open source data ingestion and visualization service that parses data from the hardware nodes and presents it in an easy-to-use web interface. Users can dynamically generate interactive plots, live monitor their sensors, or download data for offline processing. Our live version, DirtViz, is available at https://dirtviz.jlab.ucsc.edu/.

Dependencies

Dependency
Python
Node
Docker

Example screenshot of ENTS backend

Getting Started

cp .env.example .env
docker compose up --build -d

For developers see docs/development.md for how to get started and CONTRIBUTING.md for PR requirements.

Support

For bugs refer to bug_template.md. For other issues, create an new issue in this repository.

For documentation on the backend, refer to backend readme

Contributing

To start contributing to the ENTS backend, please read CONTRIBUTING.md

Here's a list of good first issues to get yourself familiar with the ENTS backend. Comment in the issue to pick it up, and feel free to ask any questions!

To keep in communication, we use Zulip! Feel free to join and ask questions.

FAQ

How do I import my own TEROS and Rocketlogger data previously collected?

There exists csv importers that can be used to populate the database. Python utilities currently exist to import RocketLogger and TEROS data. These are available as modules under the backend folder. More information on used can be found by running the modules with the --help flag.

python -m backend.api.database.utils.import_cell_data

Maintainers

Contributors

About

ENTS backend is a project to visualize data collected from a network of environmental sensors.

Resources

Code of conduct

Contributing

Stars

15 stars

Watchers

2 watching

Forks

Releases

Packages

Used by

Contributors

Languages