Visualize the Freifunk Mesh
Find a file
Nils Schneider 3a413463ec Merge pull request #20 from oakey-dev/master
add statisik about nodes total, online, with geo
2015-06-19 20:28:11 +02:00
doc README: add screenshots 2015-04-01 17:07:50 +02:00
html grunt: record git-revision in index.html 2015-04-19 12:55:14 +02:00
img forcegraph: optimize background image 2015-04-02 02:46:19 +02:00
lib add statistic about geoinformations 2015-06-19 20:24:41 +02:00
scss statistics: show global statistics image (globalGraph) - v2 2015-06-07 18:47:14 +02:00
tasks grunt: record git-revision in index.html 2015-04-19 12:55:14 +02:00
.gitignore move config.js from lib to root 2015-04-21 00:11:21 +02:00
.travis.yml travis: use config.js.example for CI 2015-04-21 00:20:10 +02:00
app.js map: draw only labels present on map using rtrees 2015-04-19 12:22:09 +02:00
bower.json map: draw only labels present on map using rtrees 2015-04-19 12:22:09 +02:00
build.js refactor main, app 2015-03-29 04:35:20 +02:00
CHANGELOG.md forcegraph: backport client circles from ffmap-d3 2015-04-16 20:16:49 +02:00
config.js.example config: introduce maxAge setting 2015-04-26 13:12:11 +02:00
Gruntfile.js grunt: record git-revision in index.html 2015-04-19 12:55:14 +02:00
helper.js helper/has_location: validate coordinates (+-90, +-180) 2015-04-10 14:51:07 +02:00
images map: adding custom layers 2015-04-15 22:25:44 +02:00
index.html sidebar styling 2015-04-04 18:01:57 +02:00
LICENSE change LICENSE to AGPL 3 2015-04-11 13:40:15 +02:00
package.json grunt: record git-revision in index.html 2015-04-19 12:55:14 +02:00
README.md statistics: show global statistics image (globalGraph) - v2 2015-06-07 18:47:14 +02:00
style.css switch to sass 2015-03-31 15:39:41 +02:00

Build Status

Meshviewer

Meshviewer is a frontend for ffmap-backend.

Changelog

Screenshots

Dependencies

  • npm
  • bower
  • grunt-cli
  • Sass (>= 3.2)

Installing dependencies

Install npm and Sass with your package-manager. On Debian-like systems run:

sudo apt-get install npm ruby-sass

Execute these commands on your server as a normal user to prepare the dependencies:

git clone https://github.com/tcatm/meshviewer.git
cd meshviewer
npm install
npm install bower grunt-cli
node_modules/.bin/bower install

Configure

Copy config.js.example to config.js and change it to match your community.

dataPath (string)

dataPath must point to a directory containing nodes.json and graph.json (both are generated by ffmap-backend). Don't forget the trailing slash! Data may be served from a different domain with CORS enabled. Also, GZip will greatly reduce bandwidth consumption.

siteName (string)

Change this to match your communities' name. It will be used in various places.

mapSigmaScale (float)

This affects the initial scale of the map. Greater values will show a larger area. Values like 1.0 and 0.5 might be good choices.

showContact (bool)

Setting this to false will hide contact information for nodes.

maxAge (integer)

Nodes being online for less than maxAge days are considered "new". Likewise, nodes being offline for less than than maxAge days are considered "lost".

nodeInfos (array, optional)

This option allows to show client statistics depending on following case-sensitive parameters:

  • name caption of statistics segment in infobox
  • href absolute or relative URL to statistics image
  • thumbnail absolute or relative URL to thumbnail image, can be the same like href
  • caption is shown, if thumbnail is not present (no thumbnail in infobox)

To insert current node-id in either href, thumbnail or caption you can use the case-sensitive template string {NODE_ID}.

Examples for nodeInfos:

"nodeInfos": [
  { "name": "Clientstatistik",
    "href": "nodes/{NODE_ID}.png",
    "thumbnail": "nodes/{NODE_ID}.png",
    "caption": "Knoten {NODE_ID}"
  },
  { "name": "Uptime",
    "href": "nodes_uptime/{NODE_ID}.png",
    "thumbnail": "nodes_uptime/{NODE_ID}.png",
    "caption": "Knoten {NODE_ID}"
  }
]

In order to have statistics images available, you have to run the backend with parameter --with-rrd or generate them in other ways.

globalInfos (array, optional)

This option allows to show global statistics on statistics page depending on following case-sensitive parameters:

  • name caption of statistics segment in infobox
  • href absolute or relative URL to statistics image
  • thumbnail absolute or relative URL to thumbnail image, can be the same like href
  • caption is shown, if thumbnail is not present (no thumbnail in infobox)

In contrast to nodeInfos there is no template substitution in href, thumbnail or caption.

Examples for globalInfos:

"globalInfos": [
  { "name": "Wochenstatistik",
    "href": "nodes/globalGraph.png",
    "thumbnail": "nodes/globalGraph.png",
    "caption": "Bild mit Wochenstatistik"
  },
  { "name": "Jahresstatistik",
    "href": "nodes/globalGraph52.png",
    "thumbnail": "nodes/globalGraph52.png",
    "caption": "Bild mit Jahresstatistik"
  }
]

In order to have global statistics available, you have to run the backend with parameter --with-rrd (this only creates globalGraph.png) or generate them in other ways.

Building

Just run the following command from the meshviewer directory:

node_modules/.bin/grunt

This will generate build/ containing all required files.