aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--.github/architecture.pngbin0 -> 132739 bytes
-rw-r--r--.github/preview.gifbin0 -> 230836 bytes
-rw-r--r--README.md41
3 files changed, 41 insertions, 0 deletions
diff --git a/.github/architecture.png b/.github/architecture.png
new file mode 100644
index 0000000..142f05b
--- /dev/null
+++ b/.github/architecture.png
Binary files differ
diff --git a/.github/preview.gif b/.github/preview.gif
new file mode 100644
index 0000000..129a587
--- /dev/null
+++ b/.github/preview.gif
Binary files differ
diff --git a/README.md b/README.md
index e1eea6d..0fd76f6 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,42 @@
# Pollutometer
+
+A system for monitoring air pollution at Roskilde train station. Mandatory
+school project on 3rd semester of Computer Science course at Erhvervsakademi
+Sjælland.
+
+## Preview
+
+![Preview](/.github/preview.gif)
+
+## Features
+
+- current air pollution display, i.e. concentration of SO2, NO2 and CO
+- calculation of current [air quality index]
+(https://en.wikipedia.org/wiki/Air_quality_index)
+- tables showing all gathered data and data from last week
+- graphs visualizing the changes in gas concentration
+- train schedule for Roskilde St. with AQI measurement corresponding to train
+departure
+- warning e-mails, sent when air pollution could be harmful
+
+## Architecture
+
+![Architecture](/.github/architecture.png)
+
+The system's architecture is built according to the project requirements and
+consists of several components:
+- Website built with PHP, Symphony and Chart.js, serving as a front-end for the
+users and allowing them to see the gathered data
+- Microsoft SQL server database holding all the readings
+- RESTful Web API created with ASP.NET which acts as a bridge between the
+website and the database by serving the data in JSON format
+- Raspberry Pi, used for gathering the data and posting it to the Web API
+- OpenAQ API, source of pollution readings (replacement for RPi sensor)
+- Rejseplanen API, to get train departures at Roskilde St.
+
+
+## Authors
+- [Jeppe Holm](https://github.com/Shadify)
+- [Adnan Ünal](https://github.com/marwolaethblack)
+- [Jiří Vrbas](https://linkedin.com/in/jiří-vrbas-a2286514a)
+- [Marcin Zelent](https://github.com/marcinzelent)