.. _chapter_installation:

************
Installation
************

Download
========
There is no public download link for MORe. If you are interested in a copy, please go to https://www.more-simulations.ch .

Prerequisites
=============
MORe depends on following python packages:
`scipy, numpy, pysparse, traits, traitsui, weakref, mayavi, matplotlib, chaco, enable, os, glob, shutil, subprocess, zipfile, tempfile, base64, json, hdf5storage, uuid, pyface, itertools, sympy, logging, time, gc, pdb, numbers`

Following tools are called through command line and, thus, have to be installed on the system:
`7zip` (Windows only)

MORe uses finite element models from `ANSYS`_ Mechanical. Therefore a working installation of ANSYS Mechanical is required (ANSYS version 16 or later). 
The required license is 

* for mechanical-only use of MORe: *ANSYS Mechanical Pro* and for 
* thermo-mechanical use of MORe: *ANSYS Mechanical Enterprise*.

Restrictions on `ANSYS`_ models:

* shell elements are not supported for thermo-mechanical simulations
* lumped inertia is not supported for thermo-mechanical simulations

For the optional MATLAB toolbox and Simulink library, `MATLAB`_ and `Simulink`_ are required (MATLAB version 2017b or later).


Recommended Installation of Prerequisites on Windows OS
=======================================================

Installation of MORe
--------------------
1.  Install Enthought `EDM`_ for Windows 64 bit for your account (run as user and not as administrator)
2.  If your company uses a proxy server, add the user environment variables HTTP_PROXY and HTTPS_PROXY with the address of the proxy server as value [1]_
3.  Download and unzip MORe
4.  Run the installation script `MORe/src/python/install_more.bat` (run as user and not as administrator)
5.  Copy the startup scripts `MORe.bat` and `spyder_MORe.bat` from `MORe/src/python/startup` to a location of choice (e.g. Desktop)

Installation of the ANSYS MORe Interface
----------------------------------------
1.  Copy the folder `MORe/src/ansys` to a location of choice on your computer
2.  Add the folder `MORe/src/ansys` to the user environment variable `ANSYS_MACROLIB` [1]_

Installation of the MATLAB MORe Toolbox
---------------------------------------
1.  Install the MORe MATLAB toolbox by running `MORe/src/matlab/MORe.mltbx` using MATLAB
2.  Type `open more_library` in MATLAB, wait for the library to be opened and save the library (in order to have the library version congruent with the MATLAB version)
3.  Install `7zip`_ and add the program path (usually `C:/Program Files/7-Zip`) to the environment variable PATH [1]_

Update to a newer version
-------------------------
1.  Download and unzip the new version of MORe
2.  Run the installation script `MORe/src/python/install_more.bat`
3.  Replace the old `MORe/src/ansys` by the new one
4.  Install the MORe MATLAB toolbox by running `MORe/src/matlab/MORe.mltbx` using MATLAB
5.  Type `open more_library` in MATLAB, wait for the library to be opened and save the library (in order to have the library version congruent with the MATLAB version)

Recommended Development Environment (IDE)
=========================================
As IDE, `Spyder`_ is installed. Following configuration is recommended:

1.	Start Spyder by running `spyder_MORe.bat`
2.	Set `Tools->Preferences->IPython console->Graphics->Graphics backend` to `Qt4` (or `Qt`)

.. _EDM: https://www.enthought.com/product/enthought-deployment-manager/#download-edm
.. _Spyder: https://pythonhosted.org/spyder/
.. _ANSYS: http://www.ansys.com/
.. _MATLAB: https://ch.mathworks.com/products/matlab.html
.. _Simulink: https://www.mathworks.com/products/simulink.html
.. _7zip: http://www.7-zip.org/download.html

.. [1] To edit environment variables in Windows, click on Windows start button and search for "Edit environment variables for your account" (for an English installation of Windows) or run the command "%windir%\system32\rundll32.exe sysdm.cpl,EditEnvironmentVariables" (win + r). If the environment variable does not exist, create a new one. For multiple entries, separate with semicolon and without whitespace.