README.md 3.33 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 29
* PosgreSQL
* Postgis
* Python3
* Pip
* Virtualenv

Thomas Frion's avatar
Thomas Frion committed
30
### Front-end
31 32 33 34 35 36

* NodeJs
* Angular/Cli

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

Thomas Frion's avatar
Thomas Frion committed
37

Thomas Frion's avatar
Thomas Frion committed
38
## Installation
Thomas Frion's avatar
Thomas Frion committed
39

Thomas Frion's avatar
Thomas Frion committed
40
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
41

Thomas Frion's avatar
Thomas Frion committed
42 43 44 45
## 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
46
## Troubleshooting
Thomas Frion's avatar
Thomas Frion committed
47

Thomas Frion's avatar
Thomas Frion committed
48
### Version issue of libgeos
Thomas Frion's avatar
Thomas Frion committed
49

Thomas Frion's avatar
Thomas Frion committed
50
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
51

Thomas Frion's avatar
Thomas Frion committed
52
### pg_config is missing
Thomas Frion's avatar
Thomas Frion committed
53

Thomas Frion's avatar
Thomas Frion committed
54 55 56 57 58 59 60 61 62 63
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 

It's done. Now `npm start` should work.