Dear all,

Thanks for attending the seminar! And sorry about the technical difficulties we experienced. Thanks a lot for staying longer as well.

Here are the two repositories we used during the practical part of the tutorial:

LaTeX with GitHub, VS Code and Zotero for research teams.
This is a very basic repo with a simple framework for collaborative LaTeX projects, but not covering installation details. If you want to gain practice, I suggest that I add you as a GitHub collaborator, you git clone the repo, and play with it. I would need you to set up a GitHub and tell me your username if you want to try this. If you want to do tests on your own, then you can use the option "fork", which creates a copy of the repo in your GitHub account. If you clone my repository but I do not add you as a collaborator, you will be able to follow updates and git pull them, but you will not be able to commit changes (with the option "fork", you will working on your own repository and you will have full freedom though).
https://github.com/jbermejovega/latex_test

This repo from my Quantum AI course. I cover how to set-up a software environment for programming projects and LaTeX projects.
https://github.com/jbermejovega/UIMPIntroToQuantumAI

The relevant sections of this tutorial that I used are
3 Preliminaries: setting up your computer
3.6 Version control with Git

Make sure that you also check these sections which I covered in a previous seminar:
3.1 Linux
3.2 MacOS
3.3 Windows
3.3.1 Package Managers
3.4 Development environment Visual Studio Code
3.4.1 VS Code Command Palette
3.4.2 Default Terminal
3.4.3 VS Code Extensions
3.5 Python
3.5.1 Anaconda (Miniconda)
3.5.2 Python Environments

I remind you that we also have this repository created by Noelia from a previous seminar about Google's QSim and the Scalene Profiler:
https://github.com/joyeuxnoelia/HPC-and-optimization-seminar

It is good practice to fork it or git clone it and install it on your local machine creating a Python environment. For this particular repository, I would recommend using main Python with pip to create a venv virtual environment where you install all required packages from zero. If you are a more advanced user, I recommend trying anaconda and mamba instead. Anaconda and mamba usually do not have the last version of modern software packages, but they are maintained stable versions. This is good if you are looking for more stable package versions and not good if you are working on development and you do need the last versions.

As a rule of thumb, you should always use the preferred environment manager of your team if you are working on a project with a team. Use pip and venv if you want to work with the new stuff. Use conda or mamba if you are concerned about reliability and security.

Best,
Juani

El jue, 6 feb 2025 a las 14:57, Juani Bermejo Vega (<jbermejovega@go.ugr.es>) escribió:
Dear all,

Tomorrow 11:00 am we will give a hands-on tutorial on version control tools for collaborative projects and grant writing. We will focus on understanding the git protocol for managing versions of a project using GitHub (or GitLab). We will apply this to the management of research and programming projects. One the one hand, we will see how to use git to manage grant-writing and article-writing projects using LaTeX and Zotero. On the other hand, we will use git to manage programming projects  across different users and local machines, such as our research team using PCs and the HPC cluster Proteus. For programming, we will work with Visual Studio code, Python and pip for creating environments.

If you bring a set-up computer we should be able to use the tutorial to configure software. It would be of great help if you have a functioning and up-to-date package manager installed in your Operating System: winget + PowerShell for Windows, Brew for MacOs or the standard package manager of your distro if you use Linux (apt for Debian based systems).

Optionally, you may try to install VS Code (or an alternative environment), LaTeX, Python. If you cannot, we will do it in the seminar. We will be following this tutorial for this:
https://github.com/jbermejovega/UIMPIntroToQuantumAI

We will try to install Qiskit for those of you who need it in projects.
Best,
Juani