bevo_iaq

BEVO Beacon with more robust air quality monitoring

https://github.com/intelligent-environments-lab/bevo_iaq

Science Score: 62.0%

This score indicates how likely this project is to be science-related based on various indicators:

✓
CITATION.cff file
Found CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
○
DOI references
○
Academic publication links
✓
Committers with academic emails
2 of 6 committers (33.3%) from academic institutions
✓
Institutional organization owner
Organization intelligent-environments-lab has institutional domain (nagy.caee.utexas.edu)
○
JOSS paper metadata
○
Scientific vocabulary similarity
Low similarity (10.9%) to scientific vocabulary

Keywords

co co2 iaq ieq no2 particles sensor tvoc

Last synced: 6 months ago · JSON representation ·

Repository

BEVO Beacon with more robust air quality monitoring

Basic Info

Host: GitHub
Owner: intelligent-environments-lab
Language: Python
Default Branch: master
Homepage:
Size: 103 MB

Statistics

Stars: 5
Watchers: 1
Forks: 1
Open Issues: 45
Releases: 2

Topics

co co2 iaq ieq no2 particles sensor tvoc

Created over 6 years ago · Last pushed over 3 years ago

Metadata Files

Readme Code of conduct Citation

README.md

GitHub top language

Bevo Beacon IAQ

This document details the basics of the Building EnVironment and Occupancy (BEVO) Beacon with enhanced Indoor Air Quality (IAQ) monitoring.

Installation

1. Install GIT and Clone Repository

Make sure your RPi is connected to WiFi. Then install git with

bash sudo apt install git

Clone this repository and cd into the newly created bevo bevo_iaq directory. Edit the rpi_install.sh file to include the correct GitHub credentials and set your timezone.

2. Install Libraries to RPi

Run

bash sh rpi_install.sh

which will install updates, upgrade, install Python3, initialize the Tailscale VPN, and create a virtual environment.

3. Install Libraries to Virtual Environment

Create a virtual environment with

bash source .venv/bin/activate

and then install the packages to operate the beacon's monitoring capabilities

bash pip install -r requirements.txt

4. Enable Service Files on Boot

Finally, enable the service files by

bash deactivate

bash sh service_install.sh

5. Specify Device Number (Optional)

By default, the device number is 00. You can specify the number by running the fix_number shell script:

bash sh fix_number.sh <label>

where <label> is any identifier you would like whether it be numeric, alphabetical, or a combination.

6. Finalize and Check

Simply restart with $ sudo reboot for a clean start to the device.

You can check if the device is working properly by examining the data in the DATA directory or on the individual services with:

bash sudo journalctl -u <service_name>.service

Owner

Name: Intelligent Environments Laboratory
Login: intelligent-environments-lab
Kind: organization
Location: Austin, TX

Website: http://nagy.caee.utexas.edu
Repositories: 14
Profile: https://github.com/intelligent-environments-lab

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: BEVO Beacon IAQ
message: If you use this software, please cite it using these meta data."
type: software
authors:
  - given-names: Hagen
    family-names: Fritz
    email: hagenfritz@utexas.edu
    affiliation: The University of Texas at Austin
    orcid: 'https://orcid.org/0000-0002-5708-7683'
  - given-names: Calvin
    family-names: Lin
    affiliation: The University of Texas at Austin
  - given-names: Dung
    family-names: Le
    affiliation: The University of Texas at Austin
  - given-names: Tejal
    family-names: Kulkarni
    affiliation: The University of Texas at Austin
  - given-names: Sepehr
    family-names: Bastami
    affiliation: The University of Texas at Austin
  - given-names: Zoltan
    family-names: Nagy
    affiliation: The University of Texas at Austin
    orcid: 'https://orcid.org/0000-0002-6014-3228'
repository-code: "https://github.com/intelligent-environments-lab/bevo_iaq"

GitHub Events

Total

Last Year

Committers

Last synced: about 2 years ago

All Time

Total Commits: 674
Total Committers: 6
Avg Commits per committer: 112.333
Development Distribution Score (DDS): 0.316

Past Year

Commits: 0
Committers: 0
Avg Commits per committer: 0.0
Development Distribution Score (DDS): 0.0

Top Committers

Name	Email	Commits
Hagen E. Fritz	h**z@g**m	461
Hagen_Fritz	3****z	108
Calvin J Lin	5****n	64
hagenfritz	h**z@u**u	32
Dung Le	h**e@u**u	5
Tejal Kulkarni	4****l	4

Committer Domains (Top 20 + Academic)

utexas.edu: 2

Issues and Pull Requests

Last synced: about 2 years ago

All Time

Total issues: 80
Total pull requests: 9
Average time to close issues: 4 months
Average time to close pull requests: less than a minute
Total issue authors: 2
Total pull request authors: 1
Average comments per issue: 0.9
Average comments per pull request: 0.0
Merged pull requests: 9
Bot issues: 0
Bot pull requests: 0

Past Year

Issues: 0
Pull requests: 0
Average time to close issues: N/A
Average time to close pull requests: N/A
Issue authors: 0
Pull request authors: 0
Average comments per issue: 0
Average comments per pull request: 0
Merged pull requests: 0
Bot issues: 0
Bot pull requests: 0

View more stats

Top Authors

Issue Authors

HagenFritz (75)
calvinjlin (5)
heidnerd (1)

Pull Request Authors

HagenFritz (9)

Top Labels

Issue Labels

documentation (54) software (16) hardware (9) enhancement (6) bug (3) design (3) manufacturing (2) wontfix (2)

Pull Request Labels

bug (1) enhancement (1) software (1)

Dependencies

requirements.txt pypi

adafruit-circuitpython-sgp30 *
adafruit-circuitpython-tsl2591 *
boto3 *
numpy *
oled_text *
pandas *
pillow *
pyserial *
scd30-i2c *
smbus2 ==0.3.0
sps30 *