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://urldefense.com/v3/__https://github.com/jbermejovega/latex_test__;!!D...
*This repo from my Quantum AI course.* I cover how to set-up a software
environment for programming projects and LaTeX projects.
https://urldefense.com/v3/__https://github.com/jbermejovega/UIMPIntroToQuant...
*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://urldefense.com/v3/__https://github.com/joyeuxnoelia/HPC-and-optimiza...
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 (
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://urldefense.com/v3/__https://github.com/jbermejovega/UIMPIntroToQuant...
We will try to install Qiskit for those of you who need it in projects. Best, Juani