envirocar / envirocar-www

Website of the enviroCar project

enviroCaR

Import and analysis functions for the R environment for statistical computing and graphics

Installation

Install dependencies

You need the trajectories package, which is available from CRAN; on the R prompt, type

install.packages("trajectories")

or install the development version from github:

library(devtools)
install_gihub("edzer/trajectories")

Install enviroCaR

The enviroCaR package is not on CRAN yet, so please download and install the package manually. For this to work must have both git (http://git-scm.com/downloads) and R (see documentation here for Windows) on your path. Then run the following commands in the command line:

git clone https://github.com/enviroCar/enviroCaR
R CMD INSTALL enviroCaR

Usage

Take a look at the demos to see how to use the package:

library(enviroCaR)
demo(package = "enviroCaR")

Bug reporting

If you find a bug or run into problems, please open a new issue on GitHub: https://github.com/enviroCar/enviroCaR/issues

Before you submit the bug, consider these guidelines.

Development

Contributing

Contributions to this package are always welcome. Take a look at the issues to see what tasks are pending and join the enviroCar mailing list/forum to discuss new ideas.

We follow the fork & pull development modell, so please fork the project and send us your contributions as pull requests.

No work should be done without an issue describing the task.

Documentation

We use roxygen comments in the R files. Take a look at the roxygen2 documentation use it and read these guidelines on documenting functions.

About

See http://envirocar.org to learn more about the project.

License

This R exention package is licensed under GPL version 2 or later.

envirocar-www's Issues

Extend FAQ regarding privacy

Add information to existing privacy FAQ about how passwords are encoded/hashed on the server ("we don't know your password") and how https is used for all communication on the website.

Revise English & German texts

Font Rendering on IE

The current approach of loading our fonts does not work on IE, we should have a look a WOFF files.

There are websites which offer multi-format packs of our font raleway, we should check the licenses again before applying that fix

Account deletion

When using the profile page and trying to delete an account deletion fails.

Username: afdsfdadfsasfdfdas

Alertwindow: "Deletion has failed. Please try again"

Affected Browsers: Chromium, Firefox

I want to change my password

User comparison

User jakob2 is a friend of albert. But obviously not vice versa. I can see Albert's tracks and the track statistics. But I cannot compare my statistics to Albert's. That does not make much sense.
Solution: show either both or nothing... but now it's not consistent.
Cheers!

Revise friendship management

Friends should only be listed after request has been accepted.

[informationproducts.php] fix html errors

Result: 18 Fehler / 2 Warnungen

Info: W3c Online Validation

line 119 column 204 - Fehler: Bad value 100% for attribute width on element img: Expected a digit but saw % instead.
line 119 column 204 - Fehler: An img element must have an alt attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.
line 123 column 200 - Fehler: Bad value 100% for attribute width on element img: Expected a digit but saw % instead.
line 123 column 200 - Fehler: An img element must have an alt attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.
line 146 column 186 - Fehler: Bad value 50% for attribute width on element img: Expected a digit but saw % instead.
line 146 column 186 - Fehler: An img element must have an alt attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.
line 154 column 188 - Fehler: Bad value 50% for attribute width on element img: Expected a digit but saw % instead.
line 154 column 188 - Fehler: An img element must have an alt attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.
line 157 column 10 - Fehler: End tag br.
line 165 column 210 - Fehler: Bad value 50% for attribute width on element img: Expected a digit but saw % instead.
line 165 column 210 - Fehler: An img element must have an alt attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.
line 177 column 200 - Fehler: Bad value 50% for attribute width on element img: Expected a digit but saw % instead.
line 177 column 200 - Fehler: An img element must have an alt attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.
line 179 column 10 - Fehler: End tag br.
line 199 column 184 - Fehler: Bad value 100% for attribute width on element img: Expected a digit but saw % instead.
line 199 column 184 - Fehler: An img element must have an alt attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.
line 203 column 184 - Fehler: Bad value 100% for attribute width on element img: Expected a digit but saw % instead.
line 203 column 184 - Fehler: An img element must have an alt attribute, except under certain conditions. For details, consult guidance on providing text alternatives for images.

Cookies according to laws

Take a look at http://www.civicuk.com/cookie-law/index - might be useful.

Revise Display of Statistics

Display of statistics uses one scale for all parameters

Comparison / Friends / Groups: logical structure needs some further thoughts

The page comparison allows for comparing the user's statistics with those of one of his/her friends. the friend has to be selected from a separate list.

The user has no possibility to compare his/her statistics with those of a group

The pages Friends/Groups already provide information about Friends&Groups, it would be nice to avoid further pages and to enrich the Friends/Groups pages (or even the personal dashboard) with further information (e.g the statistics/compared statistics).

Groups: no information about existing groups available

issues:

• When entering the groups page for the first time, the page is empty
• A blanc input field invites to enter something, a title to indicate the meaning of this field is missing
• When entering a letter a number of group names are displayed, which can be selected; when selecting a group name an error message is displayed: "The requested group couldn't be found."

Dashboard: Graphs

When clicking an activity (... created new route..)and using the button "graphs" the system gets into a"busy" mode without displaying results

[FF / Sleipnir / Chrome ] x Button in forms is not working

When using the recent FF / Sleipnir / Chrome the tiny x Button (top right) is not working on the following sites:

profile.php => edit Profile
groups.php => create Group

Friends: access to friends too difficult

issues

• When entering the friends page, the page is empty
• an input field invites to enter something, no title indicates the meaning
• when typing in a letter a number of names are presented; when selecting a name I get the information, that I dont have access to this citizen's data

Since envirocar will host (at least we hope so) a large number of users, the probabilty of selecting a friend is very poor.

suggestion: rethink the logical structure of the pages; provide at least a minimal set of information about all users (allow users to opt in for more information items to be publicly visible..)

community" data (maps, graphs over all members)

 Comparable points:

1. Geolocation + Timestamp
2. Type of Car
3. Noise
4. CO2 (probably Kg/h -> values between 0 and 100)
5. Gas consumption
6. Engine load (0 - 100%)
7. Speed
8. Engine Speed
   

The main problems are also more technical:
o How are different measurements getting combined?
o How handle a large amount of measurements?

Every user can compare his statistics of CO2, Engine Load, speed, engine speed and Gas. He has to declare a range from date_1 to date_2, or he can show the statistics of his entire log.

If a user wants to compare his statistics with another friend, there are two main problems; different distance and different location (track)!
We can calculate the average for each 1 km, watch the example for more details:

Note: these are random numbers !

User story: I am able to see information about the data accuracy

I am able to see information about the data accuracy

Comparison: Icons aren't pretty

The icons under https://envirocar.org/viewandcompare.php are not very pretty. Can we find more modern ones?

Routes: "Your Statistics" is redundant to "Dashboard/Overview"

The Page "Routes" provides with "Your Statistics" exactly the same statistics as "Overview" in the "Dashboard" page.

The list of routes is to 90% identical with the list of activities in the "dashobard" page.

Suggestion: rethink the logical structure of these pages

Comparison Bug

When I want to compare my data with another person who is NOT my friend yet, the statistics graph changes the name to the name of this person but does not display the values.
Reproduce: log in as jakob2. now look at the comparison with jakob1. then try to compare with albert.

MyRoutes: Shown consumption value seems wrong

The fuel consumption given for a track is 0 l/h when I click on a track description under MyRoutes.
When I go to 'Graphs' it shows very small values for concumption (0,0007 - 0,0028) in the graph.
The track is very short, but still the l/h consumption values should be 'normal' and probably between 5 and 15 l/h.

[profile.php] Change Profile is still not completely Internationalized

There are still some hardcoded leftovers in profile.php:

=> Change Profil...
=> Deutsch / English
=> Close
=> Email:

User Story: I'm able to see, where I contributed with my data to certain information products.

A new way of visualizing this needs to be defined. Idea: highlighting own tracks in an aggregated community map...

API link

Should the link "API" in the top menu maybe better point to http://envirocar.github.io/enviroCar-server/ or directly to http://envirocar.github.io/enviroCar-server/api/ ?

Comparison: Better Icons

avatar

Dashboard: layout doesn't scale

currently three columns are being used for displaying three content items (own activities, statistics, friend activities). It is not possible to add further items without changing the layout.

Suggestion: change the orientation of information items and use the entire page width for these items:

• own activities
• statistics
• friend activities

Now you can add further items (Profile, own groups, other statiscs, etc.) without changing the layout.

I want to delete tracks (and associated data)

needed for:

• privacy
• clean up of 'bad' data

"Unsecure" tiles

as the tiles for the maps are fetched from openstreetmap via http requests, the website displays insecure content in a secure page.

A possible solution would be to cache the tiles on the server and serve them through secure https

implementation, see https://github.com/lodum/Campusplan/blob/master/tiles.php

Dashboard, Overview: provide more useful units of measure

a) Currently the dashboard shows l/s as a uom for consumption: suggestion is to use l/100km
b) CO2 is a small number: suggestion: use e.g. mg/s

in general: think about the usefulness of global means such as "average intake temperature"; what would you expect with increasing number of measurements?

Other statistics are more interesting: sum of km tracklengths, number of tracks. Ranking regarding average fuel consumption/track-lengths etc..

User story: Were did I contribute to information products

I'm able to see, where I contributed with my data to certain information products (e.g. Co2-Emission-Map)

Track Overview: Meaning of the data displayed is not clear; other params are of interest

Please describe the meaning of the parameters and indicate, that your'e presenting mean values in this overview.

Provide other parameters, which are more interesting to the useres than the average calculated MAF. e.g.:
-total fuel consumption of this track (liter)

• total CO2 production (kg)

index.php : Login Form

When inserting a false username/password combination in index.php, the login function evaluates to TRUE when it's called a second time

Dashboard: title doesnt use the common font

suggestion: take the font you're using already for the track titles (just bigger/bold).

Information products: semantics / information missing

Some issues:

• you dont explain, what is being presented on this page. Some trial data analysis? best practices, how to analyze the data ? Is this the current content of the database? As a user I dont know, how to read the content you are presenting here!
• interactive map: how can I see, what my contribution to the data is?
• interactive map - first map with blue tracks: what is displayed here? Meaning of different colors (light blue, dark blue, ..)
• interactive map - speed: please make clear, that you are displaying average speed and how the mean values are being computed.
• interactive map - CO2: use a different classification (only green tracks..)
• speed map: map is not plausible, the differences are too large. Dont display the difference if you dont get the max-speed value from OSM (!)

[communitylines.php] fix html errors

Result: 2 Fehler / 2 Warnungen

Info: W3c Online Validation

line 101 column 90 - Fehler: Element link is missing required attribute property.
line 131 column 23 - Fehler: Element style not allowed as child of element body in this context. (Suppressing further errors from this subtree.)

Comparison list between users is in wrong order

Values should be in the same order on both sides

Dashboard: use meaningful descriptions of activities

currently, uploading a bulk of tracks will result in a list of identical list-elements, which is not helpful.
Furthermore the list of own activities always refers to the user of the system, i.e. his name hould not not be repeated in the list.

suggestion:

• either provide a summary: "[number] new track(s) uploaded" and display the upload time
• or be more specific on the respective track, e.g.: "new track created: 2013-07-03, 8:45", and refer to the time, when the track has been created at drivetime

Dashboard, TrackMap: buttons not available when using the browsers back arrow

Worflow:

• click an activity (.. created a new route..) -> the statisics of the respective track and a map are displayed.
• use the button "thematic maps" an change the parameter to be displayed
• use the browser's back arrow to have a look at the track statistics -> you'll see the statistics, but the map is empty and the buttons vanished

Units Track overview

CO2 and Consumption are always displayed as 0 because you do not show enough decimal digits. Maybe you should introduce other units for displaying, for example CO2 is shown in g/s, maybe you should change it to kg/h or g/h or so...

Dashboard, track, Download: KML, CSV or SHP in addition to JSON

When clicking an activity (.. created a new route..) I have the possibility to download th track as a JSON file. Since JSON requires specialized skills/technologies it would be good to additionally provide easy to use formats such as KML, CSV, SHP

Add new 'Terms of Use' page and link to it in footer

We need to create a new 'Terms of Use' page.
A link to this page shall be part of the footer.

Maps & Statistics provide clear semantics for information products

Design needs to be improved

see also #8

Profile: friends dialog, strange behaviour

When entering the profile dialog I see users in my friends list and my groups.

When clicking on one of the friends the list changes to the list of all users, who are members of the "product owner" group.

Groups: "Create Group" Dialog not intuitive

issues:

• language mix ("create Group", "Anfrage senden")
• two input fields, but what is the meaning?
• what is the meaning of "Anfrage senden" when creating a group?

Add display of static badges

Badges needed to fulfill pledges. Badges for:
'First Supporter'
'First Contributor'
'First Local Stakeholder'
'First Regional Stakeholder'

For example, local stakeholder pledge:
"Would you like to have enviroCar data available in a certain city or county? Do you want to motivate people to collect data in this region? For a period of 12 months, we’ll publish your request on the enviroCar world map and display your name, placemark, logo and link (if you’d like) as a local partner, visible at a scale larger than 1:50.000. A “First Local Stakeholder” badge will be added to your user account on the website."

Fwd to a page doen't work any more

Information Products: SHP download invalid

The download results in a file testdata.shp, which is not a valid shapefile.

Profile changes aren't saved

Profile changes only work if all form-fields are filled.
Instead of not saving, it should give an error message.

Track view shows only essential/meaningful information

Present only information that is interesting for the user. E.g., consumption in l/h should be l/100km.