====== DSpace ======

DSpace aims to enable people to find, collect, edit, structure and share any kind of information in a real-time, massive-collaboration, augmented-reality-environment (like wikipedia), based on a very common ground: The map of the area, where people actually are, around their //Geolocation//. 

You can create, alter and select from an infinite amount of thematic //DSpace-Overlay's// on this //basemap//, to create your own personal view of your local and social neighborhood.

The internet has enabled us to share information in ways that were never before available to mankind. On the web, we created websites for specific topics, to have a place where we could share what we know about the world around us. But you need to know where to look for and surf through different sites to get all relevant information.

With the help of 1000s of contributors, we as the people, have managed to have a free data source for map-data (OSM). Combined with free topology-data we now have the capability to create meaningful and accurate //basemaps// of the whole world ourselves, without further dependency on external map-servers and map-data, provided by commercial services.

Instead of putting up competing websites, which each only hold a part of the information other people have collected (users), it seems much more efficient to store and manage information with relevance to locality (and there are many, when you really start to think about it) in a different manner:

[{{:lab:dspace-mockup.jpg?285|Early Mockup }}]
[{{ :lab:screenshot-dspace-develop.jpg?305|Development}}]

~~CL~~

<WRAP round important>
 **Check the development demo (may be unstable or broken):**\\ http://dspace-develop.open-resource.org/
</WRAP>

<WRAP round info>
 **Check out the Introduction Slides:**\\ [[https://apollo.open-resource.org/downloads/dspace-introduction.pdf]]
</WRAP>

In technical terms, DSpace is a toolkit which provides its own free (open-source and free to access) map-tile servers for basemaps, a distributed/federated network to store, organize and access data related to what people are interested in or may find useful to easily mark on a map to remember or share with others. We put a strong focus on decentralization and try to employ concepts as server-less syncing, offline caching, browser local storage (etc) from the beginning.

This data is organized and structured in Overlays, which can be 

  * Just a simple list of Points of Interest (POIs) 
  * A dynamic Overlay with real-time data 

A DSpace-Overlay can also offer additional code/styles to enhance the usability/features of the client:

  * Navigation System
  * Tomorrows ingress successor

It will help to reduce a lot of overhead, useless information redundancy and will make the accessibiliy of information, based on geolocation, much more comprehensible and lightning-fast for everyone who uses it. Most people start out simply wanting to have access to information, but when people receive stuff for free they sooner or later also come to the point when they realize, that they have something to add as well. 

Consumers turn into contributors and with free data, every change in reality has only to be documented by one single person. That change of information is instantly available to everyone else, who also has added the same Overlay (1:N).

Closed-Loop effects should be encouraged, for example, create an OSM-Feedback DSpace-Overlay:

You realize, that something on the basemap isn't reflected by reality, so you open the OSM-Feedback Overlay and the client get's new features, which enable you to add/change or delete elements of the //basemap//.

This change will not occur in real time, because the data is not changed locally but submitted back upstream to the people dedicated to mapping the world: [[http://www.openstreetmap.org/|OpenStreetMap]]. After they alter their data, we receive the changes back downstream, when a new map for the //basemap// is rendered. This way we can change data AND our changes are available to EVERYONE else, who is using OSM data.



===== The big picture =====

A client gets //tiles// from a //tileserver// and one or more //overlays// from one or more //overlay servers//.

//Tiles// are bitmaps of pieces of a map (e.g. pre-rendered OSM, satellite images) served in a geographically structured way.
These //tiles// can be available in different //tilesets//, each with its own use-case specific boundary box, zoomlevel
and carto-style.

//Overlays// contain points that are located on specific geolocations and may have a name and contain additional metadata.
An //overlay// -identified by an url- provides a (possibly push-updated) set of points (k-v pairs with key=geo and v=data), 
optionally based on parameters given by the client. The format of the expected paramaters is given by the //overlay// and 
appropriatly displayed as an input by the client.

==== Examples for overlays ====

  * A (static) list of points of interest, see Use Cases above
  * Such a list, with the option for [some] users to add and modify points
  * The current points of locations of (the mobile devices) of a set of users.
  * A dynamic set of points, depending on (optional) parameters, like the result of a search for a string in some geo-database and information-mapping proxies (twitter hashtags etc.)
  * Interactive Search (e.g. proximity to users position or any other location) or Game-Overlays which introduce features not implemented in the basic system
  * Parcel tracking
  * Navigation (input: start and destination (+ more), output: list of points on (pseudo-)optimal route.)
  * Localisation: Pushes GeoLookup of the local device to the overlay server and the overlay-server pushes the list to all clients (when changes occured).
  * Text/Voice Communication between people (far future)


==== Basic focus on ====

  * Federated  
  * Free
  * Open
  * Lose Bindings
  * Resilience
  * Crypto (postponed to later for now)
===== Use Cases =====

  * ERM => Emergency Response Management via local autonomous WiFi (Freifunk) Nodes
    * First Responder Organization
    * Victim Communication
  * Food Mapping/Sharing => http://mundraub.org , http://foodshare.de
  * Realtime Warnings => Road Speed controls, public transportation ticket controls
  * Urban Management => Where are open living spaces, jobs or food sources
  * Fleet Management
  * Decentralized P2P parcel service
  * Organizing Events => Temporary data (i.e. have public congress/camp layers for visitors to find what they look for / non-public 'angel' layers for orga), - https://gis.ohm2013.org/
  * Open Network Access => Mapping Access Points (http://openwifimap.net by a friend from freifunk berlin) - http://map.pberg.freifunk.net/ + ham-radio repeater information
  * Realtime Semantic Mapping => Heat mapping twitter hashtags (i.e. heatmap #earthquake to find current EQ reports and positions)
  * Public Transportation Info => There are some approaches to get live data :) (Oefie?)
  * POI's for a local group (i.e. MuCCC) => More permanent data
  * Drone Management => Localization and interactive Mission/WayPoint Management (GCS Interfacing)
  * Entertainment => Geocaching, AR-MMORPGs, AR-MMO-Strategy-Games
  * ADS-B Airplane Mapping Overlay (just a few RTL-SDR stations globally) 
  * Hitchhiking => Combo of permanent/temporary data - connecting drivers/hikers in a local area (http://hitchwiki.org)


===== Developer Infos =====

==== Discussion ====

  * irc: #apollo@blafasel / #apollo@freenode
  * mumble: voip.open-resource.org
==== Mailing-List ====

  * dspace-develop@apollo.open-resource.org

Send an email to dspace-develop-subscribe@apollo.open-resource.org to subscribe.
==== Git Repo's ====

We're developing everything in separate feature-branches and then merge
to develop branch in order to keep develop more stable. You can fork the project on github and send us pull-requests, when you have fixed something or made improvements :)

=== DSpace-Client for Developers===

<code>
$ git clone git@github.com:apollo-ng/dspace-client.git
</code>

=== DSpace-Server for Developers ===

<code>
$ git clone git@github.com:apollo-ng/dspace-server.git
</code>

=== Public Cloning ===

<code>
$ git clone git://github.com/apollo-ng/dspace-client.git
</code>

=== Backup ===

For safety and to keep the spirit of //services by ourselves, for ourselves// alive, we also keep a backup repo in sync with github, so each commit to develop or master will be mirrored in Apollo-NG's own repos and also autmatically deployed to the demo sites:

<code>
$ git clone git://apollo.open-resource.org/dspace-client
</code>


==== Issue Tracker ====

Please use the github issue tracker in order to find out what can be improved and also to report any bugs/feature-requests you find or want to see implemented:

https://github.com/apollo-ng/dspace-client

==== External Links ====

https://github.com/apollo-ng/dspace-client/wiki/Links

{{tag>dspace map overlay research software development p2p social collaboration}}

{{keywords>Apollo-NG hackerspace hacker space development makerspace fablab lab community open-resource open resource mobile hackbus dspace map overlay research software development p2p social collaboration}}