This is a folder with the supporting scripts written in Python 3, node, bash.


## Dependency installation notes

1. Install GDAL/OGR dependencies, which are required by Fiona python package.
   
   You can install GDAL via Homebrew on macOS: 
   `brew install gdal`
   
   For other platforms, please follow the guide on https://gdal.org/download.html#binaries

2. Run the following command in terminal to install python dependencies:
   `pip3 install -r requirements.txt`

3. Run `npm install -g topojson-server` to install `geo2topo` tool which is
   used by python scripts to convert GeoJSON to TopoJSON

4. Make sure you have gettext utilities installed.
   https://www.gnu.org/software/gettext/


## Geo data installation notes

Go to http://www.naturalearthdata.com/downloads/50m-cultural-vectors/ and
download ZIP files with the following shapes:

- Admin 0 – Countries
- Admin 1 – States, provinces - boundary lines
- Populated Places - simple dataset is enough

or use cURL to download all ZIPs:

```
curl -L -O https://www.naturalearthdata.com/http//www.naturalearthdata.com/download/50m/cultural/ne_50m_admin_0_countries.zip
curl -L -O https://www.naturalearthdata.com/http//www.naturalearthdata.com/download/50m/cultural/ne_50m_admin_1_states_provinces_lines.zip
curl -L -O https://www.naturalearthdata.com/http//www.naturalearthdata.com/download/10m/cultural/ne_10m_populated_places.zip
```

Extract the downloaded ZIP files into `scripts` folder.
Make sure the following folders exist after extraction:

- ne_50m_admin_0_countries
- ne_50m_admin_1_states_provinces_lines
- ne_10m_populated_places

or use the following script:

```
unzip ne_50m_admin_0_countries.zip -d ne_50m_admin_0_countries/
unzip ne_50m_admin_1_states_provinces_lines.zip -d ne_50m_admin_1_states_provinces_lines/
unzip ne_10m_populated_places.zip -d ne_10m_populated_places/
```

## Geo data extraction notes

Run the following script to produce a TopoJSON data used by the app:

```
python3 extract-geo-data.py
```

and finally generate the R-Tree cache:

```
npm exec ts-node prepare-rtree.ts
```

At this point all of the data should be saved in `gui/scripts/out` folder.

## App integration notes

Once you've extracted all the geo data, run the integration script that will
copy all files ignoring intermediate ones into the `gui/assets/geo` folder:

```
python3 integrate-into-app.py
```

## Locking Python dependencies

1. Freeze dependencies:

```
pip3 freeze -r requirements.txt
```

and save the output into `requirements.txt`.


2. Hash them with `hashin` tool:

```
hashin --python 3.7 --verbose --update-all
```