Merge pull request #210 from dmsl/develop

After extensive testing and code improvements on v3.0, Anyplace v3.2 is finally ready for production. There are only minor issues left that will be fixed on the way. Anyplace v3.2 also brings the first version of the Fingerprint Management Studio (FMS) component in Architect.

Fingerprint Management Studio (FMS) is an indoor signal management studio that provides a uniform platform to: (i) manage the collection of location-dependent sensor readings (i.e., fingerprints) in indoor environments; (ii) estimate the localization accuracy based on the collected fingerprints; and (iii) assess Wi-Fi coverage and data rates. FMS comprises of the following components: (i) CSM (Crowd Signal Map), which is a map-based visual management environment to orchestrate the crowdsourcing effort of indoor signals for ethical benefit; (ii) ACCES (Accuracy Estimation), which en- ables the qualitative assessment of localization accuracy before deploying the localization service (i.e., in the laboratory as opposed to the field) using Gaussian Processes Regression and the Cramer-Rao Lower Bound (CRLB); and (iii) WS (Wi-Fi Surveying), which enables the qualitative assessment of Wi-Fi coverage using the signals collected by crowdsourcers.

Author: Anyplace

README.md

@@ -1,4 +1,4 @@
-# AnyPlace v3 
+# AnyPlace v3.2 
 
 [![Join the chat at https://gitter.im/dmsl/anyplace](https://badges.gitter.im/dmsl/anyplace.svg)](https://gitter.im/dmsl/anyplace?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
@@ -53,7 +53,7 @@ DEALINGS IN THE SOFTWARE.
 
 Short description of the contents included in this release.
 
-### A. Server v3.0.4
+### A. Server v3.2
 
 The server entails all components to run the anyplace service on your own server. 
 
@@ -62,27 +62,27 @@ The server entails all components to run the anyplace service on your own server
 - Instructions: https://github.com/dmsl/anyplace/tree/master/server
 - Current Leaders: Kyriakos Georgiou, Constantinos Costa 
 
-#### > Viewer v3.0.4
+#### > Viewer v3.2
 The source code of Anyplace HTML5/CSS3 Viewer Client (IP localization). 
 - Try: https://anyplace.cs.ucy.ac.cy/viewer/
 - Documentation/Source: https://github.com/dmsl/anyplace/tree/master/server/public/anyplace_viewer
 
-#### > API v3.0.4
+#### > API v3.2
 The source code of Anyplace JSON API.  
 - Try: https://anyplace.cs.ucy.ac.cy/developers/
 - Documentation/Source: https://github.com/dmsl/anyplace/tree/master/server/public/anyplace_developers
 
-#### > Architect v3.0.4
+#### > Architect v3.2
 The source code of Anyplace HTML5/CSS3 Architect Tool. 
 - Try: https://anyplace.cs.ucy.ac.cy/architect/
 - Documentation/Source: https://github.com/dmsl/anyplace/tree/master/server/public/anyplace_architect
 
-#### > Data Store v3.0.4
+#### > Data Store v3.2
 To setup Anyplace with Couchbase follow the general server instructions here:
 - Instructions: https://github.com/dmsl/anyplace/tree/master/server
 - Couch Views: https://github.com/dmsl/anyplace/tree/master/server/anyplace_views 
 
-### B. Android v2.3.9 
+### B. Android v2.5 
 The Source code for the Anyplace Android Logger and Navigator (WiFi/IMU/IP Localization). Current Leader: Timotheos Constambeys. 
 - Try: https://play.google.com/store/apps/details?id=com.dmsl.anyplace
 - Documentation/Source: https://github.com/dmsl/anyplace/tree/master/android

server/.gitignore

@@ -15,3 +15,26 @@ dist
 /target/
 /conf/application.conf
 /floor_plans/
+public/anyplace_architect/bower_components/
+public/anyplace_architect/build/
+public/anyplace_viewer/bower_components/
+public/anyplace_viewer/build/
+public/anyplace_viewer_campus/bower_components/
+public/anyplace_viewer_campus/build/
+radiomaps_frozen/
+/conf/ap.application.conf
+conf/ap.application.conf
+conf/public/
+public/anyplace_architect/controllers/AlertController.js
+public/anyplace_architect/images/a.png
+public/anyplace_architect/images/access-point-icon.png
+public/anyplace_architect/images/any-bullseye.png
+public/anyplace_architect/images/bullseye.png
+public/anyplace_architect/images/colorbar-heatmap-menu.png
+public/anyplace_architect/images/colorbar-heatmap.png
+public/anyplace_architect/images/delete-icon.png
+public/anyplace_architect/images/fingerPrint-icon.png
+public/anyplace_architect/images/html5-location-blue.png
+public/anyplace_architect/images/html5-location-grey.png
+public/anyplace_viewer/images/anyplace_logo_text3_1.png
+public/anyplace_viewer/images/anyplace_logo_text_white3_1.png

server/README.md

@@ -1,11 +1,13 @@
-# Anyplace v3
+# Anyplace v3 Installation Notes
 This is a latest version of the Anyplace backend, which has been ported to tha scala language and that also supports all the latest versions of its underlying software layers (i.e., it has been tested with couchbase 4.5 and play framework 2.5).
 
-# Setup/Configuration
+# Anyplace v3 for administrators
 
-  1. **Install & Configure Couchbase** Download the latest Couchbase Server Community Edition from [https://www.couchbase.com/downloads](https://www.couchbase.com/downloads). Anyplace v3 has been tested with Couchbase 4.5, but compatibility with later versions is possible.
+## Setup/Configuration
+
+  1. **Install & Configure Couchbase** Download the latest Couchbase Server Community Edition from [https://www.couchbase.com/downloads](https://www.couchbase.com/downloads). Anyplace v3 has been tested with Couchbase 4.5, but compatibility with later versions is expected.
 
-  2. **Download Anyplace v3.0b:**
+  2. **Download Anyplace v3:**
 
     $ wget https://anyplace.cs.ucy.ac.cy/downloads/anyplace_v3.zip  
     #if you don't have wget, just download the file with a browser)
@@ -19,6 +21,7 @@ This is a latest version of the Anyplace backend, which has been ported to tha s
     + Fill in the paremeters in `conf/application.conf` according to the development or production environment.
         * `application.secret` - This is a Play Framework parameter. You can see its purpose and how to generate one in Play Framework's [documentation](https://www.playframework.com/documentation/2.5.x/ApplicationSecret).
         * `server.address` - The URL the server is running on. (e.g. `http://anyplace.cs.ucy.ac.cy`)
+        * `server.port` - The port the server is running on. (e.g. `80 (htpp), 443 (https) `)     
         * `couchbase.hostname` - The URL where the Couchbase instance is running. (e.g. `http://db.<<domain>>.com`)
         * `couchbase.port` - Couchbase's port. The default is `8091`.
         * `couchbase.bucket` - The name of the Couchbase bucket where the Anyplace documents reside.
@@ -30,7 +33,7 @@ This is a latest version of the Anyplace backend, which has been ported to tha s
         * `PASSWORD=""` - This is the administrator's password for the couchbase instance.
         * `BUCKET=""` - This is the bucket for the couchbase instance.
     + Important: As with all passwords, this should be kept a secret. 
-  
+    + Note: If you are getting Authentication Failure errors, then create a user with the bucket name. This is a new change from Couchbase 5.0 (V5.0 - NEW Role-Based Authentication - Bucket Passwords, etc)(https://forums.couchbase.com/t/v5-0-new-role-based-authentication-bucket-passwords-etc/14637)
 # Running
 
     You can now launch the Anyplace service:
@@ -45,7 +48,7 @@ This is a latest version of the Anyplace backend, which has been ported to tha s
     $ Double click  anyplace_v3.bat
     # To stop press Ctrl-C or kill the respective process through the task manager
 
-# Testing
+## Testing
     Just open a browser and test the following URLs.
 
     $ http://localhost:9000/viewer
@@ -58,9 +61,9 @@ This is a latest version of the Anyplace backend, which has been ported to tha s
 
 ## How to setup Anyplace v3 in you IDE?
 1. You can run the project locally on your personal computer using the [IntelliJ IDEA](https://www.jetbrains.com/idea/download/)
-+ Download the  [IntelliJ IDEA](https://www.jetbrains.com/idea/download/) (The Community Edition is free)
++ Download the  [IntelliJ IDEA](https://www.jetbrains.com/idea/download/) (The Community Edition is free but if you are a student we recommend taking advantage of the Ultimate Edition which is free for 1 year - this has built-in integration for Play Framework debugging)
 + Install the Scala plugin during the installation process
-+ Download the project from [GitHub](https://github.com/dmsl/anyplace/archive/develop.zip)
++ Download the project from [GitHub](https://github.com/dmsl/anyplace/archive/master.zip)
 + Extract the `develop.zip` file
 + Click `Open` under the `File` menu on the IntelliJ IDEA
 + Choose the `anyplace-develop/server` directory of the extracted file (The directory icon should be marked)
@@ -71,6 +74,8 @@ This is a latest version of the Anyplace backend, which has been ported to tha s
     * Click the dropdown menu on the right side of the IDE to `Edit configuration`
     * Add a new configuration click the `+` symbol
     * Choose `SBT Task` and then write "run" in the `tasks` fields
++ (Tentatively) Refresh Viewer Packages: https://github.com/dmsl/anyplace/tree/master/server/public/anyplace_viewer
++ (Tentatively) Refresh Architect Packages:  https://github.com/dmsl/anyplace/tree/master/server/public/anyplace_architect
 + Done!
 
 **Important**: In order to fully support the Play project you need download and install the Ultimate edition.