## Minimum requirements ##

Oracle VirtualBox 5.2: https://www.virtualbox.org/wiki/Downloads
- 64bit Host OS (Windows >= 7 64bit, macOS >= 10.6, Linux 64bit)
- Intel Core i3+ or a recent AMD processor
- VT-d or AMD-V vrtualization support
- At lest 4GB of RAM

## Release ##

stable/lubuntu1604/3.1.0-1

## User ##

openquake

## Password ##

openquake

## Documentation ##

Index: https://github.com/gem/oq-engine/tree/engine-3.1#openquake-engine
CLI: https://github.com/gem/oq-engine/blob/engine-3.1/doc/running/unix.md
WebUI: https://github.com/gem/oq-engine/blob/engine-3.1/doc/running/server.md
QGIS: http://docs.openquake.org/oq-irmt-qgis/v3.1.1/
Programming API: http://docs.openquake.org/oq-engine/stable/

## Usage info ##

WebUI: http://localhost:8800/engine
CLI: oq engine

The OpenQuake manual and books are located in:
    /home/openquake/GEM/documentation

To manage the OpenQuake engine WebUI use:
    systemctl --user <start|stop|restart> openquake-webui

To RESET the DB to its initial status use:
    oq reset

To update the OpenQuake tools (and optionally the Engine):
    /home/openquake/GEM/updateme.sh

The oq-demos are located in:
    /home/openquake/GEM/demos

## IPT, Taxtweb and Taxonomy ##

IPT: http://localhost:8800/ipt
Taxtweb: http://localhost:8800/taxtweb
Taxonomy: http://localhost:8800/taxtweb

## RMTK ##

RMTK is located in:
    /home/openquake/GEM/rmtk
    
The RMTK Jupyter notebook can be launched with the alias:
    jpn

## HMTK ##

HMTK is located in:
    /home/openquake/GEM/oq-engine/openquake/hmtk

## GMPE_SMTK ##

GMPE-SMTK is located in:
    /home/openquake/GEM/gmpe-smtk

## catalogue_toolkit ##

catalogue_toolkit is located in:
    /home/openquake/GEM/catalogue_toolkit

The Jupyter notebook can be launched with the alias:
    jpn

## Hazard Jupyter notebooks ##

The GEM Jupyter notebooks are located in:
    /home/openquake/GEM/hazard-notebooks

The Jupyter notebook can be launched with the alias:
    jpn

## Python ##

The main Python enviroment in based on Python 3.5
To switch to python 2.7 type: gempy27
To switch back to python 3.5 type: gempy35

## GEM Software installed ##

python-oq-engine         3.1.0
python-oq-libs           1.6.0
oq-platform-ipt          git#engine-3.1
oq-platform-taxtweb      git#engine-3.1
oq-platform-taxonomy     git#engine-3.1
gmpe-smtk                git#engine-3.1
catalogue_toolkit        git#5025c51
CatalogueTool-Lite       git#b331728
rmtk                     git#caf2dc3

### GIS ###

qgis                    2.18.18
qgis-gem-svir             3.1.1
saga                      2.3.1
gmt                       5.2.1

### Python libs ###

See https://github.com/gem/oq-libs/blob/v2.0.0/doc/wheels.md

### Extra Python libs and tools ###

GDAL                      2.2.4
cartopy                  0.16.0
ipython                   6.4.0
jupyter                   1.0.0
notebook                  5.0.0
runipy                    0.1.5
prettytable               0.7.2
tables                    3.4.2
pandas                   0.19.2
geopandas                 0.3.0
obspy                     1.1.0
hdfview	                    2.9