Persist zoom factor = 1 cells in MongoDB and support VSI messages

.gitattributes

@@ -0,0 +1 @@
+mvnw.cmd eol=crlf

.gitignore

@@ -5,4 +5,6 @@ target
 .project
 log
 .DS_Store
-coverage-test.xml
+coverage-test.xml
+.idea/
+ais-coverage.iml

.mvn/wrapper/maven-wrapper.properties

@@ -0,0 +1 @@
+distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.3.9/apache-maven-3.3.9-bin.zip

.travis.yml

@@ -0,0 +1,3 @@
+language: java
+jdk:
+  - oraclejdk8

README.md

@@ -13,19 +13,49 @@ AisCoverage is a tool for calculating how well AIS receivers (sources) cover a g
 
 ## Building ##
 
-    mvn clean install 
+    ./mvnw clean install 
 
 ## Developing in Eclipse ##
 
 M2 Eclipse plugin or 
 
-    mvn eclipse:eclipse
+    ./mvnw eclipse:eclipse
+
+## Running
+
+    target/ais-coverage-[version]-dist/ais-coverage-[version]/coverage.sh
 
-### Rest API ###
+## Rest API ##
 
     /coverage/rest/*
+
+## Storing Coverage Data ##
+Only MongoDB is supported at the moment. Mongo v3.4.2 or above needs to be installed and authentication is not yet supported.
+
+Data (at the highest detailed level) is persisted by a background thread at regular (configurable) intervals. The default is 60 minutes.
+
+## Handling incoming AIS packets
+
+To avoid saturating the system with incoming packets, an overflow mechanism is implemented both at the `AisBus` and `CoverageHandler`
+levels. The `AisBus` drops packets if lower layers of the application cannot handle more incoming packets. The `CoverageHandler` consumes the
+packets provided by the bus through its consumers, but since it requires time to process every single packet, another buffer level is introduced
+to let the bus provide as much packets as possible and give handling threads a chance to process messages with dropping as few as possible.
+
+The size of the `AisBus` can be configured with the `<busQueueSize>` configuration element, while the `CoverageHandler` can be configured with the `<receivedPacketsBufferSize>` element:
+
+```xml
+<aisCoverageConfiguration>
+    <aisbus>
+        <busQueueSize>10000</busQueueSize>
+    </aisbus>
+
+    <receivedPacketsBufferSize>10000</receivedPacketsBufferSize>
+</aisCoverageConfiguration>
+```
+
+Past these limits, the system will start overflowing and dropping packets.
 
-### Distribution ###
+## Distribution ##
 
 A distributable zip file is found [here](http://fuka.dk/snapshots/AisCoverage-0.2.zip). <br>
 Be aware: As it contains executable files, your browser may post a warning when you download the file. <br><br>
@@ -42,7 +72,7 @@ When running tests over longer periods using mongodb you might experience some i
 The current release makes it possible to see the coverage within a limited timespan, down to a single hour, and with 1 hour intervals. <br>
 The data is currently only persisted in memory, so might make an out of memory error, if run over longer amounts of time. <br>
 
-A sample of how satalite data coverage will be handled is possible, by pressing ctrl, and dragging the mouse over the area of interest.
+A sample of how satellite data coverage will be handled is possible, by pressing ctrl, and dragging the mouse over the area of interest.
 <br>
 
 Examples of configuration files can be found here:<br>