igdb/README.org

65 lines
1.1 KiB
Org Mode
Raw Normal View History

2019-11-17 17:10:59 +01:00
* IGDB: Internation Glacier Database
2020-01-10 11:59:54 +01:00
The IGDB is a database, that uses data from the [[https://dx.doi.org/10.5904/wgms-fog-2019-12][WGMS]] to illustrate the consequences of climate change.
Our system allows you to visualize data with tables and plots, via our intuitive
Web UI.
** Technologies used
- Flask
- SQLAlchemy
- Pandas
** Requirements
- Python3
- Pip
- Pipenv
- MySQL/MariaDB
** Installation
1. Clone the repository:
#+BEGIN_SRC shell
git clone https://coolneng.duckdns.org/gitea/coolneng/igdb
#+END_SRC
2. Change the working directory to the project:
#+BEGIN_SRC shell
cd igdb
#+END_SRC
3. Install the dependencies:
#+BEGIN_SRC shell
pipenv install
#+END_SRC
All the dependencies will be installed inside a virtualenv.
** Usage
1. Start a shell inside the virtualenv:
#+BEGIN_SRC shell
pipenv shell
#+END_SRC
2. Start the Flask server:
#+BEGIN_SRC shell
flask run
#+END_SRC
3. When prompted for a password, insert your MySQL/MariaDB root password
The database will be created and populated automatically, if needed, each time the server is executed
3. The website can be accessed via the URL:
localhost:5000