From 58b097cee3b92fd188bdeddb84b7f2e7e990b1dc Mon Sep 17 00:00:00 2001 From: Pilar Date: Mon, 9 May 2022 20:50:44 -0400 Subject: [PATCH] Improved WINDOWS_INSTALL.md --- WINDOWS_INSTALL.md | 34 ++++++++++++++-------------------- 1 file changed, 14 insertions(+), 20 deletions(-) diff --git a/WINDOWS_INSTALL.md b/WINDOWS_INSTALL.md index 1e3cfd77..7334622b 100644 --- a/WINDOWS_INSTALL.md +++ b/WINDOWS_INSTALL.md @@ -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. ## Prepare your environment - +g 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: -* Python Interpreter -* Python Editor * 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 creating new code. For that purpose, please, contact Guillermo (guillermo.gutierrezmorote@concordia.ca) or 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 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**. -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_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'. ![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 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 _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 -[previous chapter Get Miniconda](WINDOWS_INSTALL.md#Get Miniconda). If not, do it, close Pycharm, and come back to this point. +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, 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 this didn't work, contact Guillermo (guillermo.gutierrezmorote@concordia.ca) or Koa (kekoa.wells@concordia.ca) for some help.