s_ranjbar/system_assignation
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Improved WINDOWS_INSTALL.md

Browse Source
This commit is contained in:
Pilar 2022-05-09 20:50:44 -04:00
parent f0dd1d1311
commit 58b097cee3
1 changed files with 14 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
WINDOWS_INSTALL.md
View File

@ -5,30 +5,16 @@ Simulation Platform 'Hub'. At the end of this process you will have installed an
set up your own project on CERC's Gitlab and created your first python file. set up your own project on CERC's Gitlab and created your first python file.
## Prepare your environment ## Prepare your environment
g
To develop any new code for the Urban Simulation Platform you must have the right software applications installed and configured. To develop any new code for the Urban Simulation Platform you must have the right software applications installed and configured.
The Platform is written in python and so the applications you need are: The Platform is written in python and so the applications you need are:
* Python Interpreter
* Python Editor
* Miniconda * Miniconda
* Python Editor
You also need to register a user account with the CERC's code repository on Gitlab and have the necessary permissions for You also need to register a user account with the CERC's code repository on Gitlab and have the necessary permissions for
creating new code. For that purpose, please, contact Guillermo (guillermo.gutierrezmorote@concordia.ca) or creating new code. For that purpose, please, contact Guillermo (guillermo.gutierrezmorote@concordia.ca) or
Koa (kekoa.wells@concordia.ca) as soon as possible. Koa (kekoa.wells@concordia.ca) as soon as possible.
### Get a Python interpreter
1. Download the latest version of python for macOS: [Python environment](https://www.python.org/downloads/)
2. Open the downloaded .pkg file and follow the instructions to install.
### Get a Python editor
1. You will need a python editor in order to import the existing Hub source code and to write your own python code.
Whilst this is a personal choice we would like to recommend [PyCharm Community Edition](https://www.jetbrains.com/pycharm/download/#section=windows),
an excellent open-source python editor.
2. Run the installer, and follow the installation instructions for PyCharm, you may change a few options,
but the default ones should be fine.
### Get Miniconda ### Get Miniconda
1. Download [Miniconda for Windows](https://docs.conda.io/en/latest/miniconda.html) for Python version 3.9. 1. Download [Miniconda for Windows](https://docs.conda.io/en/latest/miniconda.html) for Python version 3.9.
@ -42,18 +28,26 @@ If you already installed a Python interpreter, the following message will warn y
Click **OK** and then, click **Install**. Click **OK** and then, click **Install**.
Once you are done, be sure that you have miniconda in the Path: Once you are done, add Miniconda to the Path by clicking on **New** and writing the path where _conda.exe_ was installed.:
![path_1](docs/img_windows_install/img_27.png) ![path_1](docs/img_windows_install/img_27.png)
![path_2](docs/img_windows_install/img_28.png) ![path_2](docs/img_windows_install/img_28.png)
If not, add it by clicking on **New** and writing the path where _conda.exe_ was installed. Now, restart the computer to update the Path.
Finally, open a terminal and type 'conda init powershell'. Finally, open a terminal and type 'conda init powershell'.
![terminal_conda](docs/img_windows_install/img_30.png) ![terminal_conda](docs/img_windows_install/img_30.png)
### Get a Python editor
1. You will need a python editor in order to import the existing Hub source code and to write your own python code.
Whilst this is a personal choice we would like to recommend [PyCharm Community Edition](https://www.jetbrains.com/pycharm/download/#section=windows),
an excellent open-source python editor.
2. Run the installer, and follow the installation instructions for PyCharm, you may change a few options,
but the default ones should be fine.
## Get the CERC Hub source code ## Get the CERC Hub source code
1. Run PyCharmCE 1. Run PyCharmCE
@ -102,8 +96,8 @@ You should end with the following window:
Click **OK** to close it and go to the Terminal (a tab in the bottom) to finish this process. You should see Click **OK** to close it and go to the Terminal (a tab in the bottom) to finish this process. You should see
_PS C:\Users\Pilar\PycharmProjects\hub>_ preceded either by _(base)_ or _(hub)_. If non of those are there, _PS C:\Users\Pilar\PycharmProjects\hub>_ preceded either by _(base)_ or _(hub)_. If non of those are there,
be sure that you have miniconda installed and included in the path as explained in gbe sure that you have Miniconda installed and included in the path as explained in
[previous chapter Get Miniconda](WINDOWS_INSTALL.md#Get Miniconda). If not, do it, close Pycharm, and come back to this point. [previous chapter Get Miniconda](WINDOWS_INSTALL.md#Get Miniconda). If not, do it, restart Pycharm, and come back to this point.
If the environment you are working in is _(base)_, type 'conda activate hub', click enter, and the environment should change to _(hub)_. If the environment you are working in is _(base)_, type 'conda activate hub', click enter, and the environment should change to _(hub)_.
If this didn't work, contact Guillermo (guillermo.gutierrezmorote@concordia.ca) or Koa (kekoa.wells@concordia.ca) for some help. If this didn't work, contact Guillermo (guillermo.gutierrezmorote@concordia.ca) or Koa (kekoa.wells@concordia.ca) for some help.