From 64913bada00765f881f1102d4f38bde1dae301e9 Mon Sep 17 00:00:00 2001
From: Joakim <joakiale@stud.ntnu.no>
Date: Sun, 19 May 2024 13:12:25 +0200
Subject: [PATCH] fix readmea

---
 README.md                            | 238 ++++++++++++++++++++++++---
 images/selecting-bbox.png            | Bin 0 -> 31185 bytes
 images/sentinelhub_adding_bboxes.png | Bin 0 -> 2039 bytes
 3 files changed, 218 insertions(+), 20 deletions(-)
 create mode 100644 images/selecting-bbox.png
 create mode 100644 images/sentinelhub_adding_bboxes.png

diff --git a/README.md b/README.md
index 9eda7ed8..799bbd30 100644
--- a/README.md
+++ b/README.md
@@ -1,24 +1,147 @@
-# PROG2900
+# IceMap PROG2900
+This software was developed at NTNU as part of a Bachelor thesis for the municipality of Gjøvik.
 
-## Dependencies
-### Python
-To run the server...
+## Table of contents
+* [IceMap sofwtare license](#icemap-software-license)
+* [Server](#server)
+  * [Endpoints](#endpoints)
+    * [Update map](#update-map)
+    * [Get relation](#get-relation)
+    * [Get lake names](#get-lake-names)
+    * [Update measurements](#update-measurements)
+    * [Add new lake](#add-new-lake)
+    * [Add test data](#add-test-data)
+    * [New lidar data](#new-lidar-data)
+  * [Database](#database)
+  * [Server dependencies](#server-dependencies)
+  * [Known bugs](#known-bugs)
+* [Application](#application)
+  * [Application dependencies](#application-dependencies)
+* [Contributors](#contributors)
+  * [Developers](#developers)
+  * [Third party software](#third-party-software)
 
-### Dart & Flutter
+# IceMap software license
+The IceMap software was produced by Joakim Aleksandersen, 
+Sara Savanovic Djordjevic, and Hoa Ben The Nguyen.
 
+Permission is hereby granted, free of charge, to any person obtaining a 
+copy of this software and associated documentation to view the Software. 
+Any distribution and modification of the Software requires prior written 
+permission from the authors.
 
-### Database
-This project requires SQLite3. Download the precompiled binary for your operating system. 
-Precompiled binaries can be found on https://www.sqlite.org/download.html. Extract the downloaded
-binary in a folder and note its path. Add the path to your system environment variables. Now you can 
-manage the SQLite database.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, 
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+# Server
+The server currently only accepts HTTPS requests, not HTTP.
+It listens on ip address 127.0.0.1 and port 8443. 
+
+URL: ```https://127.0.0.1:8443```
+
+## Endpoints
+This server consists of 7 endpoints. Each endpoint requires the desired lake name
+to be provided as an url parameter. Of the 7 endpoints, the first 5 only accept GET requests, while
+```new_lidar_data``` only accepts POST requests. The first three endpoints expose the processed
+data to the application.
+
+Application endpoints:
+```
+.../update_map?lake=*
+.../get_relation?lake=*
+.../get_lake_names
+
+```
+
+Other endpoints:
+```
+.../update_measurements?lake=*
+.../add_new_lake?lake=*&cell_size=*
+.../add_test_data?lake=*
+.../new_lidar_data?lake=*
+```
+
+Request examples:
+```
+https://127.0.0.1:8443/update_map?lake=Mjøsa
+https://127.0.0.1:8443/get_relation?lake=Mjøsa
+https://127.0.0.1:8443/get_lake_names
+
+https://127.0.0.1:8443/update_measurements?lake=Mjøsa
+https://127.0.0.1:8443/add_new_lake?lake=Skumsjøen&cell_size=0.8
+https://127.0.0.1:8443/add_test_data?lake=Mjøsa
+https://127.0.0.1:8443/new_lidar_data?lake=Mjøsa
+```
+
+### Update map
+```
+Method: GET
+Path: update_map?lake=*
+Paramters: 
+    - lake (required)
+```
+
+Returns the contents of the measurement file for the selected lake. 
+The file which is read is called ```*_measurements.json``` and can be found in 
+```server/map_handler/lake_relations```. This endpoint makes no changes to any files.
+This endpoint exposes data for the application.
+
+### Get relation
+```
+Method: GET
+Path: get_relation?lake=*
+Paramters: 
+    - lake (required)
+```
+
+Returns the contents of the relation file for the selected lake.
+The file which is read is called ```*_div.json``` and can be found in
+```server/map_handler/lake_relations```. This endpoint makes no changes to any files.
+This endpoint exposes data for the application.
+
+### Get lake names
+```
+Method: GET
+Path: get_lake_names
+Paramters: none
+```
+
+```get_lake_names``` returns the contents of the file ```all_lake_names.json```. The file
+contains the names of all the lakes in the system. This list is utilized by the applications search
+functionality. This endpoint makes no changes to any files.
+
+### Update measurements
+```
+Method: GET
+Path: update_measurements?lake=*
+Paramters: 
+    - lake (required)
+```
 
-## Adding new maps
-The current server only contains the data for a single lake, Mjøsa. To add more lakes 
-go to https://overpass-turbo.eu/. Once you have navigated to Overpass API, enter
-the Overpass query below in the left field, but swap 'lakeName' out
-with the name of the lake you want to add. Once the query has been adjusted,
-press the 'Run' button.
+Updates the ```*_measurements.json``` for the selected lake.
+The endpoint will retrieve the latest LiDar data from ```_lidar_data.json```, which
+is also located in ```map_handler/lake_relations/```. The endpoint will also update the
+ice statistics form the NVE model. This endpoint exposes data for the application.
+
+### Add new lake
+```
+Method: GET
+Path: add_new_lake?lake=*&cell_size=*
+Paramters: 
+    - lake (required)
+    - cell_size (optional)
+```
+
+Is used when a new lake is added to the system. This process
+requires manual intervention. To add a new lake to the system, first navigate to 
+https://overpass-turbo.eu/.  Once you have navigated to th OverpassTurbo API, copy the
+query below, and enter it into the white field at the left-hand side at the website
+. Swap 'lakeName' out with the name of the lake you want to add. Once the query has been 
+adjusted, press the 'Run' button.
 
 ```
 [out:json];
@@ -29,14 +152,89 @@ press the 'Run' button.
 (._;>;);
 out body;
 ```
+
+![img.png](images/overpass-query.png)
+![img.png](images/geojson-export.png)
+
 If a text box saying "This query returned quite a lot of data (approx. x MB). Your browser may have a hard time trying to render this. Do you really want to continue?
 " appears, press 'continue anyway'. Double check that you have
 the correct lake, then press 'Export'. In the 'Export' menu, download the shape data as
-GeoJson. Once downloaded, name the file the *lakeName.json, and move the file into
-IceMap/server/lake_relations. Once you have added the file, run map division...
+GeoJson. Once downloaded, name the file the ```*lakeName.json```, and move the file into
+```/server/map_handler/lake_relations```. Once you have added the file, make a get request to the endpoint.
+The endpoint requires that the lake name is provided as a parameter. The ```cell_size``` determines
+the dimensions of the subdivisions in kilometers. This parameter is optional, but if a value is not provided
+in the requests, the default size will be 0.5km.
 
-## Endpoints
+![img.png](images/geojson-file.png)
 
-## Bugs
+The endpoint will create the file ```lakeName_div.json```. The original GeoJSON file from OverpassTurbo
+file should also remain in the system. Do not remove this file. Additionally, the file named ```all_lake_names.json```
+should be updated to contain the newly added lake name.
 
+![img.png](images/resulting-files.png)
+
+
+#### Adding an aree for ice run dates
+When adding a lake, a bounding box should also be added inside the ```/server/Sentinelhub/box.json``` file. To view and add new boxes copy and paste the current boxes into sentinel-hub.com/eo-browser, then mark a new area. Make sure the are covers an sufficient area (at least 1 km^2).
+
+![img.png](images/sentinelhub_adding_bboxes.png)
+![img.png](images/selecting-bbox.png)
+
+When updating the ice run dates, the corresponding files will be automatically created.
+This is necessary to do when creating a new lake, but can also be to add more boxes for large lakes. 
+
+
+### Add test data
+```
+Method: GET
+Path: add_test_data?lake=*
+Paramters: 
+    - lake (required)
+```
+As the name implies, this endpoint adds test data to the desired lake. The endpoint will
+overwrite the file ```*_lidar_data.json``` with measurement objects with random thicknesses. 
+This endpoint is only for production, and is not implemented in the application.
+
+### New lidar data
+```
+Method: POST
+Path: new_lidar_data?lake=*
+Paramters: 
+    - lake (required)
+```
+
+
+## Database
+This project requires SQLite3. Download the precompiled binary for your operating system. 
+Precompiled binaries can be found on https://www.sqlite.org/download.html. Extract the downloaded
+binary in a folder and note its path. Add the path to your system environment variables. Now you can 
+manage the SQLite database.
+
+## Server dependencies
+
+## Known bugs
+```add_new_lake.py``` does all the processing of new lake data. The current implementation of the
+shape file processing fails to include internal coordinates. This results in fully enclosed shapes, such
+as islands, to not be included. Simply including internal coordinates without further accommodations will cause
+the server to throw errors.
+
+# Application
+In order to run the application in an IDE like Android Studio, the port randomization of Dart must
+first be bypassed. To do this, run the adb command ```reverse tcp:8443 tcp:8443 ```. This must be
+repeated every time the IDE in which the application is running is restarted. A simpler alternative
+is to add the command to the run configuration as an external tool. If the port randomization
+is not bypassed, the application will not be able to communicate with the server.
+
+## Application dependencies
+The application depends on multiple external libraries. A list of these can be found in the
+pubspec.yaml file, each with a comment explaining the dependencies usage. 
+To install all the dependencies, simply run ```flutter pub get``` inside the app directory.
+
+
+# Contributors
 ## Developers
+This software was developed by Joakim Aleksandersen, Sara Savanovic Djordjevic, 
+and Hoa Ben The Nguyen.
+
+## Third-Party Software
+ModelFromNVE is a third party software provided by the Norwegian Energy Regulatory Authority.
diff --git a/images/selecting-bbox.png b/images/selecting-bbox.png
new file mode 100644
index 0000000000000000000000000000000000000000..89f172b58e5191df82fd14e2451fa72c4aa56bed
GIT binary patch
literal 31185
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

literal 0
HcmV?d00001

diff --git a/images/sentinelhub_adding_bboxes.png b/images/sentinelhub_adding_bboxes.png
new file mode 100644
index 0000000000000000000000000000000000000000..e9b1d5aa313172791b3f6884d5e30df02e9c8e9a
GIT binary patch
literal 2039
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
V-*Ck{g@XV9002ovPDHLkV1g6HsM`Pl

literal 0
HcmV?d00001

-- 
GitLab