{"id":21214609,"url":"https://github.com/cr2007/f29lp","last_synced_at":"2026-04-11T08:39:29.261Z","repository":{"id":113696695,"uuid":"608971595","full_name":"cr2007/F29LP","owner":"cr2007","description":null,"archived":false,"fork":false,"pushed_at":"2023-07-19T08:27:46.000Z","size":97,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-21T16:24:25.522Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cr2007.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-03T05:14:04.000Z","updated_at":"2023-04-03T17:10:54.000Z","dependencies_parsed_at":"2023-07-21T09:54:57.756Z","dependency_job_id":null,"html_url":"https://github.com/cr2007/F29LP","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cr2007%2FF29LP","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cr2007%2FF29LP/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cr2007%2FF29LP/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cr2007%2FF29LP/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cr2007","download_url":"https://codeload.github.com/cr2007/F29LP/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243663752,"owners_count":20327339,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-20T21:28:38.860Z","updated_at":"2025-12-30T11:41:06.161Z","avatar_url":"https://github.com/cr2007.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"# F29LP\r\n\r\n[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/cr2007/F29LP)\r\n\r\n## Installation on Your Computer\r\nIt is strongly recommended to install the course material via Docker. \r\n\r\nThere are three steps:\r\n1. Start the terminal. Ensure to use the PowerShell or Linux Bash Shell on Windows.\r\n    Get the GitLab repo:\r\n\r\n    ```\r\n    git clone git@gitlab-student.macs.hw.ac.uk:ks2053/F29LP.git\r\n    ```\r\n\r\n    (You might alternatively want to fork the repo: https://repository.prace-ri.eu/git/help/user/project/repository/forking_workflow.md)\r\n\r\n    Go into the relevant directory: \r\n\r\n    ```\r\n    cd F29LP\r\n    ```\r\n\r\n2. Install Jupyter notebook.\r\n\r\n    - Install Docker: https://www.docker.com.\r\n\r\n      Ensure that Docker is running. You might have to restart Docker after restarting your computer.\r\n\r\n    - Install and start the relevant Docker file: \r\n      ```\r\n      docker run -it -p 8888:8888 -v \"$(pwd):/lectures\" kstarkhwu/f29lp:latest\r\n      ```\r\n      \r\n      - If you have a MacBook, you might need to use the arm64 image instead. \r\n        You can check this via ``uname -m``: if it says \"amd64\" or \"x86_64\" use the command above. If it says \"arm64\", run\r\n        ```\r\n        docker run -it -p 8888:8888 -v \"$(pwd):/lectures\" kstarkhwu/f29lp:arm64\r\n        ```\r\n\r\n    - In there, run: \r\n\r\n      ```\r\n      jupyter notebook --ip=0.0.0.0\r\n      ```\r\n\r\n      and then the link appearing starting with ``http://127.0.0.1`` should be openable in a browser.\r\n\r\n    - You'll want to make copies of all files you want to work on to avoid merge conflicts later.\r\n\r\n## Running the Notebook Subsequent Times\r\n\r\n1. Ensure the GitLab repo is in the up-to-date state: \r\n\r\n    ```\r\n    git pull\r\n    ```\r\n\r\n2. Re-run the Docker files:\r\n\r\n    -  Run\r\n\r\n      ```\r\n      docker run -it -p 8888:8888 -v \"$(pwd):/lectures\" kstarkhwu/f29lp\r\n      ```\r\n\r\n    - In there, run: \r\n\r\n      ```\r\n      jupyter notebook --ip=0.0.0.0\r\n      ```\r\n\r\n      and then the link appearing starting with ``http://127.0.0.1`` should be openable in a browser.\r\n\r\n      \r\n\r\n      ## On Lab Computers\r\n\r\nThe (Linux) lab computers have Jupyter notebooks directly installed. \r\n\r\nYou hence only have to:\r\n1. Get the GitLab repo:\r\n\r\n   ```\r\n   git clone git@gitlab-student.macs.hw.ac.uk:ks2053/F29LP.git\r\n   ```\r\n\r\n   Go into the relevant directory: \r\n\r\n   ```\r\n   cd F29LP\r\n   ```\r\n\r\n2. Run: \r\n\r\n   ```\r\n   jupyter notebook \r\n   ```\r\n\r\n   and then the link appearing should be openable in a browser.\r\n    You'll want to make copies of all files you want to work on to avoid merge conflicts later.\r\n\r\n\r\n\r\n## FAQs \r\n\r\n- *I am on Windows, and the following command fails:* \r\n\r\n```\r\ndocker run -it -p 8888:8888 -v \"$(pwd):/lectures\" kstarkhwu/f29lp:latest\r\n```\r\n\r\nUse the PowerShell or Linux Bash Shell. The old DOS command prompt does not support the above command. \r\n\r\n- *I have problems with installing Docker on Linux Mint.* One student reported that these two guides were useful: [this](https://computingforgeeks.com/install-docker-docker-compose-on-linux-mint/) guide and [this](https://computingforgeeks.com/how-to-install-latest-docker-compose-on-linux/) guide.\r\n\r\n- *Docker starts but I cannot see the lecture/lab notebook.* Ensure you are in the right folder when running Docker/the Jupyter notebook. The ``\"$(pwd):/lectures\"`` part ensures that you can see the folder content you are currently in.\r\n\r\n- *Cloning the GitLab repo fails.* GitLab needs to ensure that you are a student at HWU. Ensure to have registered an SSH key on the machine you are using (see e.g. https://docs.gitlab.com/ee/user/ssh.html) or download and unpack the repo manually.\r\n\r\n- *I tried everything and did not get the Jupyter Notebook to run.* Please write to the lab helpers or come to me after the lecture - we will try to find a solution. You should still be able to run the Jupyter notebooks on the Linux lab computers.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcr2007%2Ff29lp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcr2007%2Ff29lp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcr2007%2Ff29lp/lists"}