<commit_before># ENVISIoN: Electronic Structure Visualization Studio

ENVISIoN is an open source tool/toolkit for electron structure visualization. ENVISIoN provides a graphical user interface and a set of Python scripts that allow the user to visualise output data from VASP.

ENVISIoN can be used to visualise the following.
* Electron density
* Electron localisation function
* Partial charge density
* Unitcell
* Bandstructure
* Density of states and partial density of states
* Pair correlation function

ENVISIoN is implemented using (a modified version of) the Inviwo visualization framework, developed at the Scientific Visualization Group at Linköping University (LiU).

## Contents

* [Contributors](#contributors)
* [Installing ENVISIoN from .deb package](#installing-envision-from-.deb-package)
* [Installing ENVISIoN source](#installing-envision-from-source)
  * [Install dependencies](#install-dependencies)
  * [Clone ENVISIoN](#clone-envision)
  * [Build Inviwo](#build-inviwo)
  * [Configure ENVISIoN](#configure-envision)
* [Using ENVISIoN](#using-envision)
  * [Starting ENVISIoN with electron user interface](#starting-envision-with-electron-user-interface)
  * [Using ENVISIoN from Inviwo editor](#using-envision-from-inviwo-editor)
* [Building ENVISIoN as package](#building-envision-as-package)



## Contributors

Summer 2019 development was continued by <NAME>.

Spring term 2019 ENVISIoN was developed by a project group consisting of: <NAME>, <NAME>, <NAME>, <NAME> and <NAME>. Supervisor: <NAME>; Requisitioner and co-supervisor: <NAME>; Visualization expert: <NAME>; and Course examiner: <NAME>.

Subsequent contributions have been made during the spring term of 2018 by <NAME>, <NAME>, <NAME>, and <NAME>, as part of the same course. The title of the final report was: "Design och implementering av system för interaktiv visualisering av elektronstrukturdata". The project was supervised by <NAME> (main supervisor) and <NAME> (client and expert). The course examinator was Per Sandström.

The initial version was developed as part of the course TFYA75: Applied Physics - Bachelor Project, given at Linköping University, Sweden (LiU) spring term 2017. The title of the final report was: "Design och implementing av en interakiv visualisering av elektronstrukturdata". Authors: <NAME>, <NAME>, <NAME>, <NAME>, <NAME>. The project was supervised by <NAME> (main supervisor), <NAME> (expert and client), and <NAME> (expert). The course examinator was Per Sandström.

## Installing ENVISIoN from .deb package
Download the packaged version from the [releases page](https://pages.github.com/).

Install the deb package using your package manager.
You should now be able to start ENVISIoN using `envision` and Inviwo using `inviwo` in your terminal.

## Installing ENVISIoN from source

This guide will step by step show how to build Inviwo and thereafter install ENVISIoN from source using Ubuntu 18.04. Installing and building on other platforms should be simmilar but dependencies and specific commands may vary.

### Install dependencies

Inviwo dependencies via package manager:
```
sudo apt install \ 
  git build-essential gcc \
  python3-dev python3-pip python-wxgtk4.0
  nodejs npm
  libpng-dev libglu1-mesa-dev libxrandr-dev \
  libhdf5-dev libxinerama-dev libxcursor-dev
```

Install cmake, version 14 or later required. As of writing this the version supplied by Ubuntu apt-get is not compatible with Inviwo, install latest version of cmake manually.
Uninstall package managed cmake:
```
sudo apt purge --auto-remove cmake
```

Download and install latest cmake version into /opt/cmake/:<commit_msg>fixed link<commit_after># ENVISIoN: Electronic Structure Visualization Studio

ENVISIoN is an open source tool/toolkit for electron structure visualization. ENVISIoN provides a graphical user interface and a set of Python scripts that allow the user to visualise output data from VASP.

ENVISIoN can be used to visualise the following.
* Electron density
* Electron localisation function
* Partial charge density
* Unitcell
* Bandstructure
* Density of states and partial density of states
* Pair correlation function

ENVISIoN is implemented using (a modified version of) the Inviwo visualization framework, developed at the Scientific Visualization Group at Linköping University (LiU).

## Contents

* [Contributors](#contributors)
* [Installing ENVISIoN from deb package](#installing-envision-from-deb-package)
* [Installing ENVISIoN source](#installing-envision-from-source)
  * [Install dependencies](#install-dependencies)
  * [Clone ENVISIoN](#clone-envision)
  * [Build Inviwo](#build-inviwo)
  * [Configure ENVISIoN](#configure-envision)
* [Using ENVISIoN](#using-envision)
  * [Starting ENVISIoN with electron user interface](#starting-envision-with-electron-user-interface)
  * [Using ENVISIoN from Inviwo editor](#using-envision-from-inviwo-editor)
* [Building ENVISIoN as package](#building-envision-as-package)



## Contributors

Summer 2019 development was continued by <NAME>.

Spring term 2019 ENVISIoN was developed by a project group consisting of: <NAME>, <NAME>, <NAME>, <NAME> and <NAME>. Supervisor: <NAME>; Requisitioner and co-supervisor: <NAME>; Visualization expert: <NAME>; and Course examiner: <NAME>.

Subsequent contributions have been made during the spring term of 2018 by <NAME>, <NAME>, <NAME>, and <NAME>, as part of the same course. The title of the final report was: "Design och implementering av system för interaktiv visualisering av elektronstrukturdata". The project was supervised by <NAME> (main supervisor) and <NAME> (client and expert). The course examinator was <NAME>.

The initial version was developed as part of the course TFYA75: Applied Physics - Bachelor Project, given at Linköping University, Sweden (LiU) spring term 2017. The title of the final report was: "Design och implementing av en interakiv visualisering av elektronstrukturdata". Authors: <NAME>, <NAME>, <NAME>, <NAME>, <NAME>. The project was supervised by <NAME> (main supervisor), <NAME> (expert and client), and <NAME> (expert). The course examinator was Per Sandström.

## Installing ENVISIoN from deb package
Download the packaged version from the [releases page](https://pages.github.com/).

Install the deb package using your package manager.
You should now be able to start ENVISIoN using `envision` and Inviwo using `inviwo` in your terminal.

## Installing ENVISIoN from source

This guide will step by step show how to build Inviwo and thereafter install ENVISIoN from source using Ubuntu 18.04. Installing and building on other platforms should be simmilar but dependencies and specific commands may vary.

### Install dependencies

Inviwo dependencies via package manager:
```
sudo apt install \ 
  git build-essential gcc \
  python3-dev python3-pip python-wxgtk4.0
  nodejs npm
  libpng-dev libglu1-mesa-dev libxrandr-dev \
  libhdf5-dev libxinerama-dev libxcursor-dev
```

Install cmake, version 14 or later required. As of writing this the version supplied by Ubuntu apt-get is not compatible with Inviwo, install latest version of cmake manually.
Uninstall package managed cmake:
```
sudo apt purge --auto-remove cmake
```

Download and install latest cmake version into /opt/cmake/:
{'fraction_non_alphanumeric': 0.08035837353549276, 'fraction_numerical': 0.008270158511371467, 'mean_word_length': 5.159592529711375, 'pattern_counts': {'":': 0, '<': 52, '<?xml version=': 0, '>': 52, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1608888', 'n_tokens_mistral': 2124, 'n_tokens_neox': 1950, 'n_words': 871}