Getting started

Getting started#

The repository ComputerLab defines a virtual environment to work on the material for the course «Combinatoire et Calcul algébrique», of the Master 1 Informatique Parcours MPRI of the Faculté d’Orsay, to be deployed on computational services like mydocker or on your own machine. If facilitates in particular the installation of all the required artifacts

  • software: JupyterLab, SageMath, … (see the file environment.yml)

  • configuration of assignment management with travo.

Usage#

Teaching computational sciences is a form of collaboration on code. We therefore will be using a software forge. If you haven’t done so yet, please activate your account on the software forge GitLab of Paris-Saclay.

Attention

As a follow up of the cyberattack, the software forge is currently only accessible from the university network (including from mydocker). Some of the instructions below may not be functional from home or if not connected through a cell phone.

Online service myDocker@Paris-Saclay#

Paris-Saclay provides an online virtual environment service myDocker@Paris-Saclay where all required artifacts are available.

  1. Access the course environment on myDocker@Paris-Saclay.

  2. For authentication, type Saclay to choose Université Paris Saclay, and use your usual university credentials (Adonis).

  3. Click « Demander un environnement ».

  4. Open a terminal (Fichier -> Nouveau -> Terminal).

  5. Download the «computer lab»:

    git clone https://gitlab.dsi.universite-paris-saclay.fr/M1InfoMPRICombAlg/ComputerLab.git ~/M1InfoMPRI/CombAlg/

    Note: if you prefer, you can choose any other destination directory instead of ~/M1InfoMPRI/CombAlg/. You’ll just need to adapt the following commands.

  6. To download or update an assignment (here for Assignment1):

    cd ~/M1InfoMPRI/CombAlg/
LANG=en ./course.py fetch Assignment1

  7. You can then browse and work on the files in ~/M1InfoMPRICombAlg/Assignment1.

  8. To submit your assignment (here for Assignment1):

     cd ~/M1InfoMPRI/CombAlg/
 LANG=en ./course.py submit Assignment1

    You can submit your work as often as you wish. When grading, we will lookup the latest available submission.

  9. If you have added a new file, you need to mention it to git as usual:

    git add monfichier.ipynb

Using on your own machine#

If you wish to work on your own machine, here are instructions to install this environment. They assume that you have access to a terminal and the version control system git, and that you are somewhat familiar with them. The instructions should be valid on any platform supported by conda, including Windows, MacOS, Linux. They are provided as is, without technical support. Suggestions welcome.

With miniconda (ou micromamba, …)#

  1. Install the conda package manager. We recommend the Mambaforge installer Mambaforge. See its installation guide.

  2. Download the «computer lab»:

    git clone https://gitlab.dsi.universite-paris-saclay.fr/M1InfoMPRICombAlg/ComputerLab.git ~/M1InfoMPRI/CombAlg

  3. Install the required software:

    cd ~/M1InfoMPRI/CombAlg/
mamba env create

    The software list may be updated during the semester. In that case:

    cd ~/M1InfoMPRICombAlg/
mamba env update

  4. Proceed as above on mydocker starting from 6.

With Docker#

This assumes that you are familiar with docker. A docker image of the virtual environment is available from the following Container Registry:

gitlab-research.centralesupelec.fr:4567/m2mathagregation/computerlab/image:latest