Project

General

Profile

Wiki » History » Version 36

Philippe May, 12/01/2019 13:14

1 3 Philippe May
h1. Software
2 1 Philippe May
3 15 Philippe May
Gisaf (for, eg, GIS Auroville Front-end) is a web application that is under development.
4 1 Philippe May
5 27 Philippe May
[[User manual]]
6 2 Philippe May
[[Server]]
7 2 Philippe May
[[Client]]
8 1 Philippe May
[[Stack]]
9 15 Philippe May
[[Mapbox]]
10 3 Philippe May
11 7 Philippe May
h2. Database
12 7 Philippe May
13 7 Philippe May
Gisaf uses a Postgis database.
14 1 Philippe May
15 9 Philippe May
h3. Creation
16 9 Philippe May
17 9 Philippe May
To create an appropriate database, run these commands:
18 9 Philippe May
<pre>
19 9 Philippe May
createuser avgis -P
20 9 Philippe May
createdb avgis -O avgis
21 9 Philippe May
psql avgis -c "CREATE EXTENSION postgis;"
22 9 Philippe May
</pre>
23 9 Philippe May
24 9 Philippe May
h3. Notes
25 9 Philippe May
26 7 Philippe May
The geometry features' metadata MUST be set with the proper SRID, which can be tricky. See below.
27 7 Philippe May
28 3 Philippe May
h3. Import files
29 5 Philippe May
30 16 Philippe May
31 8 Philippe May
h2. Development
32 8 Philippe May
33 8 Philippe May
See the README file
34 22 Philippe May
35 35 Philippe May
h2. Build frontend (Angular)
36 35 Philippe May
37 36 Philippe May
Until a bug in (Angular build or plotly) is fixed (https://github.com/plotly/angular-plotly.js/issues/15), build the web application (browser side) with:
38 35 Philippe May
39 35 Philippe May
<pre>
40 35 Philippe May
cd gisaf-app
41 1 Philippe May
ng build --prod --build-optimizer=false --vendor-chunk
42 36 Philippe May
</pre>
43 36 Philippe May
44 36 Philippe May
Otherwise, this is the standard command for generating the build:
45 36 Philippe May
46 36 Philippe May
<pre>
47 36 Philippe May
cd gisaf-app
48 36 Philippe May
ng build --prod
49 35 Philippe May
</pre>
50 35 Philippe May
51 34 Philippe May
h2. Plugins
52 34 Philippe May
53 34 Philippe May
Gisaf can load models in external plugins. See [[plugins]].
54 34 Philippe May
55 22 Philippe May
h2. Configuration
56 22 Philippe May
57 22 Philippe May
TODO: more about parameters of the conf file
58 22 Philippe May
59 22 Philippe May
h3. Map
60 22 Philippe May
61 22 Philippe May
The default view of the map can be configured in the gisaf yaml config, eg:
62 22 Philippe May
63 22 Philippe May
<pre>
64 22 Philippe May
map:
65 22 Philippe May
  openMapTilesKey: cS3lrAfYXoM4MDooT6aS
66 22 Philippe May
  zoom: 14
67 22 Philippe May
  pitch: 45
68 22 Philippe May
  lat: 12.0000
69 22 Philippe May
  lng: 79.8106
70 22 Philippe May
  bearing: 0
71 22 Philippe May
  style: OSM (vector)
72 22 Philippe May
  opacity: 0.3
73 22 Philippe May
  tilesUrl: /tiles/data/india-vector.json
74 22 Philippe May
</pre>
75 22 Philippe May
76 22 Philippe May
h3. Production
77 22 Philippe May
78 22 Philippe May
Gisaf reads the file @/etc/gisaf/prod.yml@ at boot.
79 22 Philippe May
80 22 Philippe May
81 22 Philippe May
h3. Development
82 22 Philippe May
83 22 Philippe May
Gisaf reads the @~/.gisaf/prod.yml@ file at boot.
84 22 Philippe May
85 22 Philippe May
86 22 Philippe May
h2. Third party
87 22 Philippe May
88 22 Philippe May
h3. TileServer
89 22 Philippe May
90 32 Philippe May
Serve the vector tiles for mapbox-gl locally: [[ TileServer ]]
91 33 Philippe May
92 33 Philippe May
Alternative: see #6907