README.md 3.41 KB
Newer Older
Thomas Frion's avatar
Thomas Frion committed
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# CHOUCAS Project

Over 15000 mountain rescue request by year are recorded in France. The Pelotons de Gendarmerie de Haute Montagne (PGHM) are the main mountain rescue teams.
In this context, CHOUCAS project aims to provide methods and tools to make and improve geographic data from different sources, and thinking models to help the decision process of locating victims in mountainous environment. The goal is to improve the response alert capability.

Following principles of CHOUCAS project, the application will be rewritten.

The application aims to connect:
* The applicant: person who launch the alert, who could be the victim or a third party.
*  The rescue team

The objective of this relation is to get the victim' localization from a manual research of geographic hints from different data sources as well as on the knowledge of the rescue team. This hint research is part of a process of reasoning, which consists of formulating hypotheses based on the initial information provided by the applicant, refining them gradually through dialogue and data analysis, and then deducing the most probable location of the victim.

The rescue application will therefore also have the task of assisting in locating the victim by providing the tools to manage the data necessary for the rescuers' decision-making: multi-source data (institutional or community data) and multi-format data (maps, topo-guides for hikes in paper format, vector data).

This application, although the initiative of the Grenoble PGHM, should have a national scope so that all PGHMs in France can use it.

Thomas Frion's avatar
Thomas Frion committed
18
19
> In this repo, the master branch contains the **lastest stable** version of the code. The real lastest version of the code (but **not necessarily stable**) is in the dev branch.

Thomas Frion's avatar
Thomas Frion committed
20
## Requirements
Thomas Frion's avatar
Thomas Frion committed
21

Thomas Frion's avatar
Thomas Frion committed
22
### Back-end
23

Thomas Frion's avatar
Thomas Frion committed
24
25
26
27
28
* PosgreSQL
* Postgis
* Python3
* Pip
* Virtualenv
Thomas Frion's avatar
Thomas Frion committed
29
* Redis-server
Thomas Frion's avatar
Thomas Frion committed
30

Thomas Frion's avatar
Thomas Frion committed
31
### Front-end
32
33

* NodeJs
Thomas Frion's avatar
Thomas Frion committed
34

Thomas Frion's avatar
Thomas Frion committed
35
## Installation
Thomas Frion's avatar
Thomas Frion committed
36

Thomas Frion's avatar
Thomas Frion committed
37
For installing the project and starting the API and the application, please go to the [wiki](https://gricad-gitlab.univ-grenoble-alpes.fr/Projets-INFO4/19-20/8/app-pghm/-/wikis/home)
Thomas Frion's avatar
Thomas Frion committed
38

Thomas Frion's avatar
Thomas Frion committed
39
40
41
42
## Load data from CSV file

If you have a big CSV file in which you have the data to import, then you can follow our tutorial in [this snippet](https://gricad-gitlab.univ-grenoble-alpes.fr/Projets-INFO4/19-20/8/app-pghm/snippets/186)

Thomas Frion's avatar
Thomas Frion committed
43
## Troubleshooting
Thomas Frion's avatar
Thomas Frion committed
44

Thomas Frion's avatar
Thomas Frion committed
45
### Version issue of libgeos
Thomas Frion's avatar
Thomas Frion committed
46

Thomas Frion's avatar
Thomas Frion committed
47
If there is an error that is raised due to a version problem we advise you to read this [snippet](https://gricad-gitlab.univ-grenoble-alpes.fr/Projets-INFO4/19-20/8/app-pghm/snippets/167)
Thomas Frion's avatar
Thomas Frion committed
48

Thomas Frion's avatar
Thomas Frion committed
49
### pg_config is missing
Thomas Frion's avatar
Thomas Frion committed
50

Thomas Frion's avatar
Thomas Frion committed
51
52
53
54
55
56
57
58
59
If during installation you get an error saying that pg_config is missing, just install the `postgresql-devel` package. Source [Stackoverflow](https://stackoverflow.com/questions/11618898/pg-config-executable-not-found)

### Angular error - `Module '"leaflet"' has no exported member 'SidebarOptions'`

When you launch the command `npm start` and you have the error `Module '"leaflet"' has no exported member 'SidebarOptions'`, then follow the process below to fix it:
1. Open the file which has the error. (Globally it will be `node_modules/@runette/ngx-leaflet-sidebar/lib/ngx-sidebar-control.component.d.ts`)
2. Add at the top of the file `/// <reference types='leaflet-sidebar-v2' />`
3. Save the file 

Thomas Frion's avatar
Thomas Frion committed
60
61
62
63
64
It's done. Now `npm start` should work.

### Segmentation fault during pip installation

If during pip installation an segfault is raised, the found solution is to remove the directory `~/.local`