|
1 | 1 | # CMP9065 - Data Programming in Python
|
2 |
| -This repository houses the devcontainer and docker image for the Data Programming in Python module at the University of Lincoln. |
| 2 | +This repository houses the course materials for the Data Programming in Python module at the University of Lincoln. |
| 3 | + |
| 4 | +In order to set up your personal computer to run the module's lectures and workshops Jupyter Notebooks, you have two options: |
| 5 | + |
| 6 | + - [Setup with Docker](setup-with-docker) - this is the same setup you have in the labs PC. |
| 7 | + - [Native setup](native-setup) - simpler, but may cause conflicts with other packages/softwares already installed. |
| 8 | + |
| 9 | + |
| 10 | +--- |
| 11 | +# Setup with Docker |
3 | 12 | ## What is Docker?
|
4 | 13 | Docker is a platform which allows developers to create and share containers.
|
5 | 14 |
|
@@ -49,3 +58,35 @@ If you are struggling to get this to work, try these common troubleshooting step
|
49 | 58 | 2. Make sure Docker Desktop is open and running.
|
50 | 59 | 3. Make sure Docker Desktop is updated.
|
51 | 60 | 4. Make sure VS Code has the Remote Development extension pack. You can install this through the Extensions tab in VS Code if it isn't working through the web link above.
|
| 61 | + |
| 62 | + |
| 63 | +# Native setup |
| 64 | +Following these steps you will be downloading all the software packages required for this software on your computer. Some packages may conflict with already existing installations, if that is the case (or you are worried it may be the case), we suggest you setup your PC following the [Setup with Docker](setup-with-docker) instructions. |
| 65 | +## Process |
| 66 | +1. Ensure you have the latest version of Python installed. It can be obtained from [https://www.python.org/downloads/](https://www.python.org/downloads/) for all operating sytems. |
| 67 | +2. Using your Command Prompt/Terminal launch the following command to install Jupyter Notebook |
| 68 | + ``` |
| 69 | + pip install --upgrade pip |
| 70 | + pip install notebook |
| 71 | + ``` |
| 72 | +3. From the command prompt, install all the packages required throughout the module: |
| 73 | + ``` |
| 74 | + pip install scikit-learn scikit-image seaborn matplotlib numpy pandas scipy |
| 75 | + ``` |
| 76 | +1. Clone this repository to your computer by opening a command prompt and launching |
| 77 | + ``` |
| 78 | + git clone https://github.com/SoCSTech/CMP9065-Data-Programming-in-Python.git |
| 79 | + ``` |
| 80 | +3. Now that Python and Jupyter Notebook are installed use Command Prompt/Terminal (or similar) to run the command: |
| 81 | + ``` |
| 82 | + jupyter notebook |
| 83 | + ``` |
| 84 | +4. The previous step should have opened a browser window at [http://localhost:8888/](http://localhost:8888/), if not go to this address by clicking the link here. |
| 85 | +5. Select the folder **CMP9065-Data-Programming-in-Python/CMP9065 Data Programming in Python** which contains the content of the module you have cloned. |
| 86 | +6. Open the notebook file for the corresponding week you need to work on; for example, **Workshop 1 - Module Overview and Introduction to Python.ipynb**. |
| 87 | +9. Every week there will be new materials pushed to this repository. In order to get the most up-to-date version of the materials every time, before starting to work open a command prompt inside the **CMP9065-Data-Programming-in-Python** folder and enter |
| 88 | + ``` |
| 89 | + git pull |
| 90 | + ``` |
| 91 | + |
| 92 | + |
0 commit comments