bonn-activity-maps · porcupineyhairs · Aug 10, 2020 · Aug 10, 2020 · Aug 12, 2020 · Aug 12, 2020
diff --git a/.gitignore b/.gitignore
@@ -8,4 +8,5 @@ venv
 docker-compose.yml
 initialize.js
 src/static/node_modules/
-
+src/python/config.py
+notes.txtk
diff --git a/README.md b/README.md
@@ -0,0 +1,86 @@
+# Annotation Tool
+
+This tool was created to interact (visualize, create, modify, remove) with **Bonn Activity Maps**[[1]](https://github.com/bonn-activity-maps/aikapi) datasets. Additionally, the tool supports interactions with **Posetrack**[[2]](https://posetrack.net/) datasets. The following sections contain the explanations of the main functionalities of the tool.
+
+## Screenshots
+### User 
+The tool has a user management system and is therefore protected by a login. This system allows two different types of user:
+  - **Annotators**: have access to the datasets that have been assigned to them. They can create, modify and delete annotations.
+  - **Superusers**: have access to all the management functionalities of the tool. They can create/modify/delete users, upload/remove datasets, modify the datasets assigned to each user and create real-time notifications for all the users using the tool.
+
+![Login image](https://github.com/Belberus/ThanosDidNothingWrong/blob/develop/images/screenshot2.png)
+
+---
+
+### Multiple views of the scene at the same time
+The tool allows to have up to 4 camera views simultaneously to interact with. This views can be switched at all times with the ones stored in the views storage panel situated on the right of the tool. 
+The storage panel hides when not being used.
+
+Since all the views are synchronized, moving through the timeline will update all the views to match the actual frame.
+
+![Mutiple views image](https://github.com/Belberus/ThanosDidNothingWrong/blob/develop/images/screenshot1.jpg)
+
+---
+
+### Annotations
+The tool allows different types of objects; "Persons", "Poses" and "Boxes". Each object has an individual and unique UID for fast identification. Multiple objects can be visualized at the same time.
+(TODO: maybe show the process focusing in a single person and show all assigned object types and actions to that UID)
+
+![Poses image](https://github.com/Belberus/ThanosDidNothingWrong/blob/develop/images/screenshot3.jpg)
+
+##### Visualization
+In the Keypoint editor you can visualize which frames (top row) have annotations for each object (first column). There are also special operations that can be perfomed at an object level and for a range of frames(red buttons):
+  1. Batch delete annotations.
+  2. Swap the UIDs of two objects.
+  3. For Poses, enforce all limbs' length.
+
+![KeypointEditor image](https://github.com/Belberus/ThanosDidNothingWrong/blob/develop/images/screenshot4.png)
+
+##### Modification
+Each object can be individually edited for each individual frame: 
+  1. Each position of the keypoints can be modified by clicking or dragging.
+  2. The length of the limbs can be changed and enforced, so that the involved keypoints always respect that length constraints.
+  3. It is possible to delete the whole annotation or each individual keypoint.
+
+In order to speed up the annotation process several operations can be performed:
+  1. **Interpolate**: searches the previous closest annotated frame for that object and interpolates all the frames in between.
+  2. **Autocomplete**:  searches the previous closest annotated frame and copies its content to all the frames in between. This operation can be performed at an object or tag level.
+
+Saving the annotation interpolates automatically (this option can be disabled in the Options Panel that will be shown later).
+
+![KeypointEditor Editor image](https://github.com/Belberus/ThanosDidNothingWrong/blob/develop/images/screenshot5.jpg)
+
+##### Boxes
+The objects of type "Box" are considered static and their behaviour is different. They represent entities whose position and orientation barely change during the whole recording, for example, chairs, tables, fridges, etc.
+
+Each "Box" object has a *label* field to mark them as specific real-world objects (chair, table, fridge, etc.). When creating/editing a static object, changes will be replicated forward in the timeline, so all following frames will be also updated.
+
+![Boxes image](https://github.com/Belberus/ThanosDidNothingWrong/blob/develop/images/screenshot8.jpg)
+
+##### 3D process
+Since the datasets expect the annotations to be in 3D, the tool provides some aid to ease the process. When a keypoint is placed in one of the views, *epipolar* lines will appear on the other views. This lines can be used as a reference of where should the keypoint lie in that view. Once a point is placed in at least 2 different views, we can save it. The tool will then triangulate those points and generate the final 3D point.
+
+![Epipolar image](https://github.com/Belberus/ThanosDidNothingWrong/blob/develop/images/screenshot7.jpg)
+
+##### Actions 
+Users can also annotate the actions being performed by each "Person". This actions can be visualized directly on the views.
+
+![Actions 1 image](https://github.com/Belberus/ThanosDidNothingWrong/blob/develop/images/screenshot13.jpg)
+
+In the Actions Editor Panel, new actions can be created, specifying *action type*, *start frame* and *end frame*, and deleted.
+
+![Actions 2 image](https://github.com/Belberus/ThanosDidNothingWrong/blob/develop/images/screenshot12.jpg)
+
+
+---
+
+### Options and shortcuts
+The tool lets the user change some options so that everything fits his/her specific preferences.
+
+![Options image](https://github.com/Belberus/ThanosDidNothingWrong/blob/develop/images/screenshot11.png)
+
+Almost every action that the user can perform has a keyboard shortcut to speed up the annotation process. This shortcuts are available for different keyboard layouts to fit everyone.
+
+![Shortcuts 1 image](https://github.com/Belberus/ThanosDidNothingWrong/blob/develop/images/screenshot9.png)
+![Shortcuts 2 image](https://github.com/Belberus/ThanosDidNothingWrong/blob/develop/images/screenshot10.png)
+
diff --git a/docs/export_data.md b/docs/export_data.md
@@ -0,0 +1,48 @@
+# Create backup and import data into a local database
+
+## 1. Create a backup and download it from the server
+
+- Create a new backup from bam_annotation_tool/src/db (This may take a few minutes):
+```
+./databaseBackup.sh
+```
+or 
+- Download the last backup
+
+
+All the backups are located in `.../database_backups`
+
+The name of the backup folder is the date in format:  `yyyy-mm-dd_hh:mm:ss`
+
+## 2. Import into local database
+
+- Launch in local the database and annotation tool with docker:
+```
+./launch.sh -ldb
+./launch.sh -aweb
+```
+
+- If you have previous data in the database, you can remove it:
+```
+mongo 172.18.0.2:27017/cvg path_to_bam_tool/src/db/reset.js
+```
+
+- Import the backup (this may take 5-10 min):
+```
+mongorestore --host "172.18.0.2:27017" --db cvg path_to_backup/'yyyy-mm-dd_hh:mm:ss'/cvg
+```
+
+## 3. Export from the local annotation tool
+
+- Log in in the tool as root
+- Go to dataset tab
+- Export the datasets. The exported json files will be located in:  `/usr/share/cvg/datasets`
+
+
+
+
+
+
+
+
+
diff --git a/images/CVG_BBDD.png b/images/CVG_BBDD.png
diff --git a/images/screenshot1.jpg b/images/screenshot1.jpg
diff --git a/images/screenshot10.png b/images/screenshot10.png
diff --git a/images/screenshot11.png b/images/screenshot11.png
diff --git a/images/screenshot12.jpg b/images/screenshot12.jpg
diff --git a/images/screenshot13.jpg b/images/screenshot13.jpg
diff --git a/images/screenshot2.png b/images/screenshot2.png
diff --git a/images/screenshot3.jpg b/images/screenshot3.jpg
diff --git a/images/screenshot4.png b/images/screenshot4.png
diff --git a/images/screenshot5.jpg b/images/screenshot5.jpg
diff --git a/images/screenshot6.png b/images/screenshot6.png
diff --git a/images/screenshot7.jpg b/images/screenshot7.jpg
diff --git a/images/screenshot8.jpg b/images/screenshot8.jpg
diff --git a/images/screenshot9.png b/images/screenshot9.png
diff --git a/src/Dockerfile b/src/Dockerfile
@@ -4,7 +4,7 @@ FROM nvidia/cuda:9.0-base
 # install python3.6, pip and other libraries
 RUN apt-get update
 RUN apt-get install -y software-properties-common
-RUN add-apt-repository ppa:jonathonf/python-3.6
+RUN add-apt-repository ppa:deadsnakes/ppa
 RUN apt-get update
 RUN apt-get install -y \
         curl \