README.md 3.14 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
18
19
20
21
# 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.

## Installation

### Requirements

22
23
#### Back-end

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

30
31
32
33
34
35
36
#### Front-end

* NodeJs
* Angular/Cli

> To install Angular Cli, type this command `npm install -g @angular/cli`

Thomas Frion's avatar
Thomas Frion committed
37
### Installation (Back-end)
Thomas Frion's avatar
Thomas Frion committed
38
39
40

#### 1. Project init
```bash
Thomas Frion's avatar
Thomas Frion committed
41
42
$ git clone git@gricad-gitlab.univ-grenoble-alpes.fr:Projets-INFO4/19-20/8/app-pghm.git
$ cd app-pghm/choucas
Thomas Frion's avatar
Thomas Frion committed
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
$ source bin/activate
$ cd choucas
$ pip install -r requirements.txt
```

If is necessay, edit the setting file (`choucas/settings.py`) for database connection.

#### 2. Database creation

```bash
$ python manage.py makemigrations
$ python manage.py migrate
```

#### 3. Load data

Thomas Frion's avatar
Thomas Frion committed
59
60
This part allows you to load test data or data to initialize the database.

Thomas Frion's avatar
Thomas Frion committed
61
```bash
Thomas Frion's avatar
Thomas Frion committed
62
$ python manage.py loaddata pghm/fixtures/xxxx.json
Thomas Frion's avatar
Thomas Frion committed
63
64
65
66
67
68
69
```

#### 4. Run server

```bash
$ python manage.py runserver
```
Thomas Frion's avatar
Thomas Frion committed
70

Thomas Frion's avatar
Thomas Frion committed
71
72
73
74
75
### Installation (Front-end)

#### 1. Setup

```bash
Thomas Frion's avatar
Thomas Frion committed
76
$ git clone git@gricad-gitlab.univ-grenoble-alpes.fr:Projets-INFO4/19-20/8/app-pghm.git
Thomas Frion's avatar
Thomas Frion committed
77
78
$ cd app-pghm/GendLoc
$ npm install
Alexandra Chaton's avatar
Alexandra Chaton committed
79
$ npm install -g @angular/cli
Thomas Frion's avatar
Thomas Frion committed
80
81
82
83
84
85
86
87
88
89
90
91
92
93
```

#### 2. Run 

```bash
$ npm start
```

Or

```bash
$ ng serve
```

Thomas Frion's avatar
Thomas Frion committed
94
95
### Troubleshooting

Thomas Frion's avatar
Thomas Frion committed
96
97
#### Version issue of libgeos

Thomas Frion's avatar
Thomas Frion committed
98
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
99
100
101
102

#### pg_config is missing

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)