Aide à l’utilisation de Sagemath et Jupyter#
Cette page a pour but de vous présenter différentes méthodes d’utilisation de python, jupyter et sagemath, sur les machines de l’université ou en dehors.
Avertissement
En raison de récents changements de configuration, il est possible que certaines méthodes ne fonctionnent pas, ou pas immédiatement. N’hésitez pas à faire appel à l’enseignant si besoin.
Premier lancement#
Avec l’application Jupyter (conseillé)#
À l’université, vous pouvez utiliser l’application web Jupyter. Cette application vous permet de travailler dans une interface graphique générée par votre navigateur (par exemple, Firefox). Il faut cependant comprendre que vous n’avez pas nécessairement besoin de connexion Internet pour cela : tout fonctionne localement sur votre machine.
Procédure d’ouverture de Jupyter à l’université.
Pour ouvrir Jupyter, allez dans le menu Activités (en haut à gauche), puis entrez sagemath. Dans un premier temps, un terminal s’ouvre et affiche quelques lignes… c’est normal !
Avertissement
Attention : il ne faut pas fermer le terminal qui vient de s’ouvrir, sous peine d’interrompre Jupyter !
Dans un second temps, une page de navigateur devrait s’ouvrir, semblable à celle vue pour la démonstration en cours.
Première configuration les machines de l’université. Si votre navigateur ne se lance pas, alors il y a un problème de configuration. Pour le régler, ouvrez un terminal et entrez très précisément la commande suivante (vous pouvez copier la commande en passant votre souris sur la cellule, puis en cliquant sur l’icône à droite de la cellule).
../jlavauzelle/configuration-jupyter.sh
Puis, recommencez la procédure d’ouverture de Jupyter donnée plus haut.
Si le navigateur ne s’ouvre toujours pas, appelez l’enseignant. Ensuite, une solution temporaire peut consister à copier le lien qui commence par
http://127.0.0.1:8888/lab?token=..........
dans la barre d’adresse d’un navigateur (par exemple, Firefox). Vous pouvez également faire un Ctrl+clic sur le lien. Un onglet d’un navigateur devrait maintenant s’ouvrir.
Problème d’affichage de certains graphiques. Par ailleurs, il est possible qu’une mise à jour récente de la bibliothèque numpy sur les machines de l’université provoque des erreurs d’exécution. Pour régler ce problème, vous devez faire un « downgrade » (anti-mise à jour) de cette bibliothèque. La procédure est la suivante : entrez dans le terminal la commande
pip install numpy==1.22.0
Cette procédure va donc désinstaller la version de numpy actuellement installée sur vos machines. Pour la ré-installer si besoin (exemple : dans un autre cours), faites :
pip install numpy==2.0.0
Avec Cocalc#
Vous pouvez enfin adopter une solution en ligne, hébergée sur le site web https://cocalc.com. Cette solution a plusieurs inconvénients :
elle nécessite une connexion internet et la création d’un compte sur le site web,
les calculs sont souvent plus lents, et les calculs très lourds sont impossibles,
vous n’avez pas la main sur la machine distante, donc vous ne pouvez pas installer des fonctionnalités suppélmentaires.
En revanche les avantages sont que vous pouvez travailler hors de l’université, et que vous n’êtes pas dépendant du bon fonctionnement et de la bonne configuration des machines…
Pour utiliser python, jupyter et Sagemath dans https://cocalc.com, suivez les étapes suivantes :
Créer un compte, puis se connecter.
Créer un nouveau projet, puis s’y déplacer.
Lancer le projet (bouton start project) puis attendre quelques secondes.
Vous pouvez maintenant effectuer de nombreuses tâches, notamment lancer l’environnement de travail Jupyter-lab. Le bouton est situé vers la droite ; au bout de quelques secondes une fenêtre popup demande à être ouverte ; acceptez. Vous devriez alors vous trouver sur un environnement de travail similaire à celui vu en cours.
Création d’un premier notebook#
Dans Jupyter (et dans Jupyter-lab), vous avez à votre disposition un explorateur de fichiers. Utilisez cet explorateur pour créer un dossier CalculFormel afin d’organiser votre espace de travail (vous pouvez également le créer ailleurs si vous le souhaitez). Puis, déplacez-vous dans ce dossier.
Vous pouvez maintenant créer un notebook via le bouton Nouveau situé en haut à droite, puis en cliquant sur Python3. de la section Notebook. Un nouvel onglet s’ouvre avec un fichier ne contenant qu’une cellule. C’est votre premier notebook python ! Remarquez que le fichier est également apparu dans l’explorateur de fichiers (si vous revenez sur l’onglet précédent).
L’extension d’un notebook python est .ipynb (pour interactive python notebook). Vous pouvez renommer le fichier (clic-droit, renommer), mais gardez bien l’extension .ipynb.
Maintenant, essayez d’entrer du code dans la cellule, par exemple 1 + 1. Puis, exécutez la cellule avec le bouton Éxécuter de la barre d’outils. Vous devriez obtenir la sortie attendue 2 sous la cellule exécutée. Il est également possible d’exécuter une ou plusieurs cellules avec le menu Cellule, ou en utilisant Maj+Entrée.
Pour créer une nouvelle cellule, vous pouvez utiliser le bouton + de la barre d’outils (entre le bouton de sauvegarde et le bouton « couper »). Une nouvelle cellule vide apparaît. Vous pouvez une nouvelle fois entrer du code et l’exécuter.
Enfin, n’oubliez pas de sauvegarder régulièrement votre travail avec le bouton de sauvegarde (il y a une sauvegarde automatique, mais elle n’est pas fréquente).
Télécharger et importer un notebook#
Dans ce cours, vous aurez à
télécharger des notebooks d’exercices présents sur ce livre numérique
puis les lire et les éditer avec Jupyter.
Pour l’étape 1, il suffit de cliquer sur le bouton de téléchargement situé en haut à droite de cette page web. Vous avez alors deux choix : .ipynb ou .pdf. Choisissez .ipynb.
Suivant la configuation de votre navigateur :
ou bien le fichier sera directement téléchargé dans un dossier Téléchargements,
ou bien vous aurez le choix où déposer ce fichier.
Faites ensuite en sorte que le fichier que vous téléchargez se retrouve dans le dossier CalculFormel que vous avez créé. Une fois que c’est fait, vous devriez voir dans l’explorateur de fichiers de Jupyter un nouveau fichier aide.ipynb ; ouvrez-le : vous retrouvez alors le document que vous êtes en train de lire !
Note
Il est préférable configurer votre navigateur pour avoir le second comportement de téléchargement. Pour cela, allez dans les options du navigateur en haut à droite (probablement un symbole avec 3 barres horizontales), puis le menu Général et trouvez la section où vous pouvez choisir de « toujours demander où enregistrer les fichiers ».