An open publishing platform for visualization, social sharing, and analysis of geospatial data.
HTML JavaScript Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
api Implemented way better histogram generation Apr 3, 2016
docs Updated docs and DB connection callbacks Feb 5, 2013
public-build Built for production Aug 18, 2014
public
scripts Decoupled geogoose and made it its own npm package Aug 5, 2014
templates Updated Google maps to non-retired release Apr 2, 2016
test Decoupled mapreduce_abstraction into rejuice and made it its own npm … Aug 11, 2014
ui Various style fixes and cleaned-up stylesheets Sep 21, 2013
.gitignore Added .dropbox Dec 5, 2013
.gitignore_global Tentatively fixed import memory problems May 23, 2012
.gitmodules
LICENSE Create LICENSE Aug 14, 2013
Procfile Renamed server.js to app.js to comply with standard Express Oct 1, 2013
README.md Renamed server.js to app.js to comply with standard Express Oct 1, 2013
app.js
clock.js Updated clock.js log messages Jan 27, 2013
config-custom.js Made native BSON parser configurable Aug 29, 2013
config.js
errors.js Fixed error highlighting Aug 16, 2013
ext-console.js Replaced cloneextend with underscore's clone and extend, and fixed tests Oct 23, 2013
manage.js
models.js Implemented way better histogram generation Apr 3, 2016
package.json Updated some packages to work with latest Node/npm Apr 2, 2016
permissions.js
r.js Adding require.js for optimization Jan 15, 2013
utils.js Removed String prototype modification Aug 16, 2014

README.md

What is GeoSense?

GeoSense is an open publishing platform for visualization, social sharing, and analysis of geospatial data. It aims to simplify the process of turning large data collections into beautiful, interactive online maps.

How to install GeoSense on your development machine

The project is built on top of Node.js and uses MongoDB as database. Please install Node.js (including NPM) and MongoDB on your system first.

There are installers and packages available for many operating systems. For instance, if you are using OS X you might want to look into installing the above requirements with Homebrew, to name just one option. This tutorial is a starting point.

To get the GeoSense code, you can either just download it from GitHub and extract it to a folder on your hard drive, or clone the repository using Git. The latter is recommended so you can easily update to newer versions at a later point). You also may have to install Git on your system first.

To acquire the code with Git, open a Terminal window and type the following command.

git clone git://github.com/Safecast/GeoSense.git

Next, change into the GeoSense folder and install the dependencies using NPM:

cd GeoSense
npm install

You should now be ready to run the GeoSense development server.

Running the development server

Before you run the development server, make sure to start MongoDB, either in its own terminal window:

mongod

or as a background service:

mongod --fork --logpath /var/log/MongoDB.log

You can then run the development server using the following command from the GeoSense folder:

NODE_ENV=development node app.js

You should get a success message such as Web server running at http://0.0.0.0:3000/. You'll now be able to open GeoSense in your web browser by typing http://localhost:3000 in the location field.

Command-line interface

In addition to the Graphical User Interface that is running in your web browser, GeoSense comes with a Command-Line Interface (CLI) that enables you to script certain tasks and perform them without user interaction. CLI actions include data import and aggregation into map grids.

To run the CLI, run the following command from the GeoSense folder:

node manage.js

This will display a list of available CLI actions, such as import. For example, to display a list of all existing point collections in the database, type:

node manage.js list-collections

To receive more information about a specific action, pass help as the first argument, followed by the action name. For instance:

node manage.js help import

The import action

Usage: node manage.js import [import-params]

Imports records from a URL or a file into a new point collection.

For example, to import a new data file from scratch, type:

node ./manage.js import --url https://api.safecast.org/system/measurements.csv --format csv --converter safecast

or

node ./manage.js import --path path/to/file.csv --format csv --converter safecast

Later, after the initial import, you might want to re-fetch the source file and sync your local data:

node ./manage.js sync <collectionId> [options]

This basically runs the import command again, with the same arguments. You can override these by passing options to the command, for instance the following would sync the collection with data from a different URL>:

node ./manage.js sync <collectionId> --url https://api.safecast.org/api/<incremental-dump>

The mapreduce action

TODO: document most important CLI actions.

Building the project for deployment

GeoSense utilizes RequireJS to create an optimized build for faster page load times. To create a build, run the following command from the GeoSense folder:

node r.js -o public/app.build.js

You now have an optimized copy of the public/ folder ready for deployment under public-build.