Installation

Procedure

Git

First, install git for Windows (follow this link to download it).

Python

Assuming you don’t have Python already, install it ideally with the version 3.6.8.

Virtual environment

To install a virtual environment for your Python, follow the next steps:

  • Open the command prompt, and execute it:

  • If you are working on Windows, execute in the command prompt the next step:

  • Now, create the virtual environment:

  • Then, activate the virtual environment and make sure it is still activate for the entire time

you are installing the following tools. Two possibilities:

  • If you are working on Windows, execute in the command prompt the next step:

OpenCMISS-ZINC

Your virtual environment is still activate, download the zip file Click on Get OpenCMISS Librairies and download it. Unzip the content to C/Users/upi/work/codes/python_packages/. Then in the command prompt, change the directory:

PySide

Download PySide and be careful to select this specific version for python 3 PySide‑1.2.4‑cp36‑cp36m‑win_amd64.whl). Then, return to the command prompt and enter the following steps:

MAPClient

Install MAPClient and its dependencies by writing the next instructions in the command prompt:

Then, install a MAPClient dependency:

These tools are required to run ScaffoldMaker so please note that this step requires MAPClient and all the above steps installed earlier. Create a folder in your work directory and name it mapclient_plugins. Then, change into this folder in the command prompt. Clone the following github projects into the mapclient_plugins folder:

Install scaffolder maker and change to the python_packages into the command prompt. Then, clone the opencmiss plugin:

Change into opencmiss.utils folder and open setup.py. Look for the line “requires = [‘opencmiss.zinc’]” and replace with “requires = []”. Then , in the command prompt, write:

Change to the python_packages and clone zingwidgets plugins:

Change into opencmiss.zincwidgets folder and open setup.py. Look for the line requires = [‘opencmiss.utils >= 0.2.0’, ‘PySide2’, ‘opencmiss.zinc’]” and replace with “requires = []”. Then , in the command prompt, write:

Scaffoldmaker

To install scaffoldmaker, change to the python_packages folder.

  • For developers: Fork the repository

  • For users:

Change into scaffoldmaker folder and add in the command prompt:

To install Scaffoldfitter, go to to the python_packages folder in the command prompt:

Change to scaffoldfitter folder and write :

To install geometric fit step mapclient plugin, change into mapclient_plugins folder.

Loading plugins into mapclient

Check for the virtual environment if it is not already activated, do it and then, open mapclient. Go to Tools, then Plugin Manager, Add Directory, add work/codes/mapclient_plugins/, click select folder and click reload, press ok. Exit mapclient. Run mapmapclient again. The new plugins should be visible as Geometric fit, File location Sink and Mesh generator.

Docker

Click on the link below to know how to install it. This software can help you if the bottom procedure doesn’t work. In some cases, the virtual environment or python are enabled to work so you can try this software to have a mapclient available.

How to install Docker?

When Docker is installed, you can try to use Pycharm by following this other documentation Be careful, even after following all these steps, Docker can’t be run. One solution could be to check the number of XLaunch launch on your computer and to change by the right value.