city_retrofit/WINDOWS_INSTALL.md

# Prepare your environment.

Download the latest version of python and Microsoft c++ redistributable

* [Microsoft C++ redistributable](https://www.microsoft.com/en-ca/download/details.aspx?id=48145)
* [Python environment](https://www.python.org/downloads/)

# Get the code.

1. First thing you will need is an editor for your source code, that's a personal choice, but we would like to recommend PyCharm community edition, an excellent open-source python editor. [PyCharm Community edition](https://www.jetbrains.com/pycharm/download/download-thanks.html?platform=windows&code=PCC)

2. Run the installer, and follow the installation instructions for PyCharm, you may change a few options, but the default ones should be fine.

3. Open PyCharm and click on **"Get from Version Control"**.

![pycharm welcome screen](./docs/img/img_0.png)

You can find it also at VCS -> Get from Version Control...

![pycharm get from version control](./docs/img/img_6.png)


4. Select Git as the version control, and set the URL to [libs repository](https://rs-loy-gitlab.concordia.ca/Guille/libs.git) as shown in the picture.
At the website, copy the URL from Clone -> Clone with HTTPS.

![pycharm get from version control screen](./docs/img/img_1.png)


You may need to install Git, by clicking at ***Download and install***. 
If that message does not appear is because you have it already installed in your computer.

5. Click Clone to download CERC libs source code. You will end with a project like this:


![pycharm project screen](./docs/img/img_2.png)


# Configure PyCharm.

We use two spaces as a tab instead of standard [pep8](https://www.python.org/dev/peps/pep-0008/) four spaces indentation.
This option can be configured in PyCharm at the settings screen, as shown in the picture.

![pycharm configuration screen](./docs/img/img_5.png)


# Start your project.

1. Click on File -> New Project... The following window opens:

![pycharm new project screen](./docs/img/img_3.png)

Add a name to your project and click Create.

2. Go to project settings and add the libs project to your own, by clicking on Add Content Root:

![pycharm new project screen](./docs/img/img_4.png)

![pycharm add libs](./docs/img/img_7.png)

3. Add your first file to your project and click on install requirements to automatically download all the dependencies (in blue at top-right corner).

![pycharm add dependencies](./docs/img/img_8.png)

4. When all the dependencies are satisfied, you are all set to start importing your first city model.

Add the following code to your main.py

```python

from imports.geometry_factory import GeometryFactory

city = GeometryFactory('citygml', 'myfile.gml').city
```

The rest depends on you. Have fun!