sensebox / opensensemap

Platform for storing and exploring sensor data

This repository contains the code of the openSenseMap frontend running at https://opensensemap.org. To get more information about openSenseMap and senseBox visit the before mentioned links or have a look at this video or read the openSenseMap chapter in our documentation. openSenseMap is part of the senseBox project.

Originally, this frontend has been built as part of the bachelor thesis of @mpfeil at the ifgi (Institute for Geoinformatics, WWU Münster) and is currently maintained by @mpfeil.

The easiest way to get up and running with your own copy is clicking the Deploy to Netlify button below. It will clone the repository into your own account, and deploy the site to Netlify. It is going to ask for Maptiles url and API endpoint. Please use the default values listed under configuration or use your own.

Configuration

You can configure the API endpoint and/or map tiles using the following environmental variables:

ENV	Default value
OPENSENSEMAP_API_URL	https://api.testing.opensensemap.org
OPENSENSEMAP_CMS_URL	<YOUR_DIRECTUS_CMS_URL>
OPENSENSEMAP_STYLE_URL	<YOUR_MAPBOX_STYLE_URL>
OPENSENSEMAP_ACCESS_TOKEN	<YOUR_MAPBOX_ACCESS_TOKEN>

You can set them in your terminal or create a file called .env and set the values.

Development

• Have Node.js v10, grunt and bower installed
• Check out a branch for your feature (git checkout my-aweseome-feature)
• Run npm install and npx bower install
• Run frontend in development mode (npx grunt serve)
• Commit your changes to your branch and push it to your fork
• Create a pull request against the master branch

See also: CONTRIBUTING

Release

To release a new version of the openSenseMap frontend do the following:

• Run npm run release on master branch
• Run git push --follow-tags origin master
• Create new release on Github Release

Related projects

Services

• openSenseMap Backend
• openSenseMap translations

Deployment

• OSeM-compose
• openSenseMap-infrastructure

Technologies

• AngularJS

Organization

Branches

• master (runs on testing server)
  • Is used for production container build tags

Docker

openSenseMap including openSenseMap-API

For installing openSenseMap and openSenseMap-API with Docker check out our oSeM-compose repository.

openSenseMap

To build just openSenseMap you can run: docker build -t osem .

Following build-args are availble:

Build Arg	Default value
OPENSENSEMAP_API_URL	https://api.opensensemap.org
OPENSENSEMAP_CMS_URL	<YOUR_DIRECTUS_CMS_URL>
OPENSENSEMAP_STYLE_URL	<YOUR_MAPBOX_STYLE_URL>
OPENSENSEMAP_ACCESS_TOKE	<YOUR_MAPBOX_ACCESS_TOKEN>

License

MIT - Matthias Pfeil 2015 - now

opensensemap's Issues

Additional option for ino download

If file download was missed or file was not backed up by a user, it should be possible to download the ino-file again by providing the SenseBox ID.

Change calendar language based on setting

The calendar used under "Download" does not change its language when you switch the site language

Enlarge size of the registration-map

Maybe we could enlarge the size of the map when creating a fixed SenseBox. It is quite difficult to navigate on the tiny map at the moment.

Visualization of mobile senseBoxes

If a SenseBox was registered as "mobile" the it should be (visually) separated from the fixed stations. Think about an initial position and an aggregation of the different measuring point, when clicking on it.

Option to put sensebox settings

Some of the values for a SenseBox may change (e.g. position). Add an option to change properties of a SenseBox.

Graph: Change data display

Data is not always continuous but currently shown as such. Remove the lines and colour below data points and just show the points?

Bug: Wrong box selected after filter operation

• Search for a name of a SenseBox
• Select the corresponding box by clicking on the rocket icon
• Select the box by clicking on in
  --> Wrong box is shown in the sidepannel (always 'CALIMERO')

Change and improve registration email

• Email sender has quotation marks ' in the name
• Different email text
• Fix double new lines
• Arduino sketch for manually configured boxes has wrong sensor IDs in it

add heatmap layer

Add description for installation site properties

The measurements taken by a SenseBox directly reffer to the site where it was set up.
A short description should be given by the user where he or she is putting the Box.
Later and in addition, we could categorize this attribute (indoors, outdoors, ...)

Fix editing an existing box

Doesn't work at all right now, includes

• Changing name
• Changing details (which?)
• Changing photo
• Deleting box
• others?
  #32

Response page for Arduino internet test

Small static page with text "Your Sensebox is online" or similar that can be easily retreived and displayed by an Arduino sketch

Function for sharing measurements

Besides the API functions, downloading of measurement data (e.g. as csv) should be offered.

Add registration form to register sensebox and obtain ID

Form should contain:

• first name
• last name
• mail
• bought via exp-tech or not

Download: Prevent empty downloads

Make the date when the last data was submitted the maximum date for downloading

and/or

Check if data is present in the time frame chosen by user

Add filter for group tags

Enable filter for 'Group-Tag' via preselection

Download of .ino file

Currently, the ino file which is created by the server after registration process is complete, is only shown as text in a new tab when clicking the download link.
(Firefox 29.0.1 Ubuntu 12.04 64bit)

Set default value for "Type" when creating new SenseBox Umweltstation.

There is already a default setup for the SenseBox-Umweltstation. "Typ" should be set to "stationär" by default as well.

Download data

Select one or multiple SenseBoxes for data download.

Can`t change or remove a registered node

I can`t remove or change the node "Mainframe" unter the following link [0]

[0] http://www.opensensemap.org/#/explore/54e86f19a807ade00f877342

Find better symbols

We need symbols that are on point of what they do (edit/save sensor config).

Create diagrams for sensor measurements

Display current day by default. Nice feature would be a time slider to change time resolution on x-axis.

Display timestamp with measurements

When selecting a point on the OSM, only measurement values are displayed but not the time they where recorded.

bower install does not inject bootstrap-language

Increase download interval of provided arduino source code

The interval is set to 10 seconds at the moment. It should be increased to 1 or 10 minutes.

Add address search when creating new SenseBox

Users should be able to search for an address when registering a SenseBox.

Text and translations improvements

„Aufstellungsort“ in „Geplanter Aufstellungsort“ ändern
Einheit von „UV-Index“ in µW/cm² ändern

Remove Sensebox ID from registration confirmation text (user gets an email with it)

Improve site performance

Graphs and translations make the site work slow, especially on initial load

apply new webdesign

Can you apply the new senseBox design theme to the menu bar:

• logo top left
• fonts in menu
• website icon

"Find your position" when registering a new SenseBox

Add geolocation search when registering a SenseBox.

Icons for measurements only partly appear

Symbols for temperature, humidity and light values are not loaded in the measurement details. Only noise and pressure symbols appear. (I am running Firefox 29.0.1 on Win7 Prof N x64 SP1)

openstreetmap api visualization

Hello Matthias,

just checked your opensensemap. Great work, congratulations!
What I've seen so far, selecting a sensebox via openstreetmap api automatically leads to a zoomed map window at little scale. What do you think about setting automatic zoom display to street name's scale level and center the map on the selected sensebox?

Cheers,
Jakob

Spelling mistake

When downloading the Sketch by hand (over the api key), the ino-file is called "sensbox.ino" instead of "sensebox.ino"

save own box as cookie

option for adding a photo of SenseBox setup

to see what kind of case the users used and how (high / close to wall / exposed to sun) they have mounted the box.

Change color of buttons.

Change green color to appropriate color fitting to sensebox colors.

Registration needs SenseBox ID validation

To prevent unauthorized access to OSM, ID validation is important!

Leaflet is injected twice

Minified and source version are both included:
https://github.com/sensebox/OpenSenseMap/blob/master/app/index.html#L153

Registration: Improve marking the position on the map

• Allow the user to drag the marker to a position
• Zoom further in by default (Zoom on Germany?)
• Use same Mapquest map tiles as in big map

Download: Remove IDs

Remove database IDs from measurements

https://github.com/sensebox/OpenSenseMap-API/blob/master/app.js#L302

Graphs: Y-axis labelling

Add labelling to Y axis

filter panel

sending the .ino Code via Email

To make it easy to upload the Code again send the code/id via Email. Sometimes it's necessary to upload the code again

Create e2e tests

Navbar is destroyed

After cloning repository and running npm install and bower install navbar is not working anymore

Add filter for SenseBox Photonik

Enable filtering for different SenseBox types (Photonik, Home, ...). Result should be a OSM containing only the requested type of SenseBoxes.

Adding an option to delete/editing Boxes

Adding a password section for each Box to manually edit and delete the Box.

Enlage size of download link

After registration, the download link should be stressed so that it catches the view

Move close button in legend/info window into the box

It's in the top right corner of the window right now, not very obvious to find since it overlays some text (but clicking outside of the box already closes it)

Idea: New Layer of Satellite Images

Additional layers of information such as satellite images (which allow turn on/off) to certain areas of the map that are being monitored could provide more information of complex environmental interactions. Landsat images could be an option.