pyIncore viz

pyIncore viz#

Visualization package associated with pyIncore is called pyIncore-viz. It contains advanced Python packages and methods required for visualizing and disseminating the IN-CORE results, mainly via Jupyter Notebooks. A library called Matplotlib for creating static visualizations in Python is already part of pyIncore (as a dependency). We decided however to keep more interactive visualization in a separate package. An example would be for example geo-referenced mapping with ipyleaflet.

Features#

Geospatial visualization such as tornado path or earthquake raster data, vector data (shapefile) and network data.
Data visualization, graphs of data such as statistical curves including pre-processing.
Creates map window from inventory of multiple csv files stored in a folder (in progress).

Prerequisites#

pyIncore: A user must have pyIncore package installed. See pyIncore section for details.
Virtual environment: We recommend that users work with virtual environment managers called Anaconda or Miniconda.
Mac OS specific notes: There is a Mac specific matplotlib installation issue addressed at StackOverflow link 1 and link 2. In a nutshell, insert line:
```
    backend : Agg
```
into ~/.matplotlib/matplotlibrc file. You must create the file (matplotlibrc) if it does not exist.

Installation#

To install pyIncore-viz, navigate to the directory you want to use for running Jupyter Notebooks and run the following command:
```
conda install -c in-core pyincore-viz
```
If you have trouble installing pyincore-viz or it is taking a long time to resolve the dependencies, try using the libmamba solver by running the following command:
```
conda install -c in-core pyincore-viz --solver=libmamba
```
If the installed pyincore-viz version is not the latest or lower than the desired one, specify the version number in installation command.
```
conda install -c in-core pyincore-viz=1.5.0 (or your version of choice)
```
Version information for pyincore-viz can be found in
- https://anaconda.org/IN-CORE/pyincore-viz
For update replace install with update.
To check that the package is installed run
```
conda list
```
It will again list all packages currently installed. You can check if pyincore and pyincore-viz exist in the list.

Examples#

Jupyter notebook showing a visualization of shape files and other geographic information. Web Map Service (WMS) layer generated by Geoserver is also used for mapping an infrastructure. The shapefile format is a geospatial vector data format for geographic information system (GIS) software developed by Esri for interoperability among GIS software products. WMS is protocol for geo-referenced images developed by the OG Consortium.

Examples:
pyincore-viz-example.ipynb
pyincore-viz-analysis-example.ipynb