CIDS_Carpentries_Python

Curtin Institute for Data Science adaptation of the Software Carpentries and Data Carpentries Python lessons.

The best way to learn how to program is to do something useful, so this introduction to Python is built around a common scientific task: data analysis.

Schedule

1. Introduction to the Workshop and Tools
2. Python Fundamentals
3. Analysing Patient Data
4. Visualising Tabular Data
5. Storing Multiple Values in Lists
6. Repeating Actions with Loops
7. Analysing Data from Multiple Files
8. Making Choices
9. Creating Functions
10. Data Analysis with Pandas

Before You Start

Prior to attending this workshop, please follow the below instructions to setup your personal laptop. Ensure that you have administrator permissions if you are using a corporate laptop.

Local Setup

The local setup involves installing 4 things:

1. Python
2. Git
3. VSCode
4. VSCode Python & Jupyter extensions You may be able to skip installing git if you already have it installed from the git workshop

The full setup instructions are: Python

1. Navigate to the website https://www.python.org/downloads/ with your web browser.

2. Download Python 3.13 (3.13.7 is fine) for your operating system

3. Run the installer, following all prompts using the default settings Git

4. Navigate to the website https://git-scm.com/downloads with your web browser

5. Download git for your operating system

6. Run the installer, following all prompts using the default settings
   VSCode

7. Navigate to the website https://code.visualstudio.com/ with your web browser.

8. Download Visual Studio Code for your specific platform/Operating System.

   

9. Run the Visual Studio Code Installer and follow all prompts.

10. Open Visual Studio Code, navigate to the File Explorer and clone this repository with the following repository name https://github.com/CurtinIDS/CIDS_Carpentries_Python into your preferred folder destination.

    

11. Navigate to the Extension sidebar then search for and install the Python and Jupyter extensions.

    

12. Enter the Visual Studio Code Command Pallette using Ctrl + Shift + P (Windows) or Command + Shift + P (MacOS) and locate Python: Create Environment.

    

13. Select venv.

    

14. Select Python 3.13. (the version you just installed)

    

15. When asked to "Select dependencies to install", click the box next to requirements.txt and click "ok"

    You should now be done!

ONLY if you didnt do the step above when you needed to:

1. Open Command Prompt or Terminal within Visual Studio Code using Ctrl + J (Windows) or Command + J (MacOS). Make sure the "Terminal" tab is selected, and you're in the previuously cloned directory
2. Activate the created environment using the following command. Windows (powershell): .\.venv\Scripts\Activate.ps1
   Mac/Linux: source ./venv/bin/activate
3. Run the following command to install dependencies while in the activated environment. pip install -r requirements.txt

Google Colab

If you were unable to complete the above steps, you may alternatively access the workshop material using Google Colaboratory. Please ensure that you have a Google Account.

1. Episode 1 - Python Fundamentals
2. Episode 2 - Analysing Patient Data
3. Episode 3 - Visualising Tabular Data
4. Episode 4 - Storing Multiple Values in Lists
5. Episode 5 - Repeating Actions with Loops
6. Episode 6 - Analysing Data from Multiple Files
7. Episode 7 - Making Choices
8. Epsiode 8 - Creating Functions
9. Episode 9 - Data Analysis with Pandas

Contributing (Instructors only)

If you wish to contribute, it's recommended to add the included pre-commit to your hooks.
Once you've cloned, in a Terminal window opened within the main repo directory, run the following:

cp build_scripts/pre-commit .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit

This will do the following every time you commit:

• Any updated notebooks will have a colab version made and placed in notebooks_colab and include these in your commit
• Clear the cells of all notebooks before uploading