Exercice 1 : Prise en main
==========================

Objectif
--------

Se familiariser avec la console python et l'éditeur de code associé.

Données
-------

Les données proviennent de Natural Earth [#f1]_ :

| • ``ne_10m_admin_0_countries.shp`` (Polygones - Pays du monde) ➜ `Téléchargement <https://www.naturalearthdata.com/http//www.naturalearthdata.com/download/10m/cultural/ne_10m_admin_0_countries.zip>`_

Procédure
---------

Charger les données
^^^^^^^^^^^^^^^^^^^

- Ouvrir QGIS 3.

- Ouvrir la console Python (:kbd:`CTRL` + :kbd:`ALT` + :kbd:`P` ou ``Extension > Console Python``)

- Charger la couche ``ne_10m_admin_0_countries.shp``.

  * soit en faisant un glissé-déposé de ce fichier vers l'interface de QGIS,
  * soit en en utilisant le menu ``Couche > Ajouter une couche > Ajouter une couche vecteur...``

.. figure:: img/0_qgis_interface.png
  :width: 100%
  :align: center
  :figwidth: 98%


Tester les actions suivantes dans la console
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

- Affichage du nombre d'enregistrements dans une couche :
  ::

    layer = iface.activeLayer()
    print(layer.featureCount())

- Afficher le nom de chacun des champs de la couche :
  ::

    for field in layer.fields():
        print(field.name(), field.typeName())


- Obtenir les modes de rendu disponibles dans QGIS :
  ::

    QgsRendererRegistry().renderersList()


- Lister les couches du projet et leur type :
  ::

    for layer in QgsProject.instance().mapLayers().values():
        name = layer.name()
        geom_type = QgsWkbTypes.displayString(layer.wkbType())
        print('{}: {}'.format(name, geom_type))


- Ouvrir l'éditeur (*Afficher l'éditeur*) et insérer le code suivant :
  ::

    from qgis.utils import iface
    layer = iface.activeLayer()
    name = layer.name()
    nb = layer.featureCount()
    print("La couche {} compte {} entités".format(name, nb))


- **Sélectionner une partie de ce bloc de code dans l'éditeur et appuyer sur** :kbd:`CTRL` + :kbd:`E` **pour éxécuter seulement les instructions sélectionnées**.

- **Enregistrer le script avec le nom** ``nb_features.py`` **et l'exécuter.**

- On a vu que notre couche avait de nombreux champs.
  **Quelle instruction doit être saisie pour savoir combien de champs possède une couche ?**

- **Par ailleurs, quelle instruction doit être saisie pour savoir de combien de couches se compose le projet en cours ?**


.. raw:: html

   <hr width="100%" size="18">
   <p class="align-center"><strong>💡 <a href="solutions/s_ex1.html">Solution de l'exercice 1</a></strong></p>
   <hr width="100%" size="18">

.. rubric:: Footnotes

.. [#f1] http://www.naturalearthdata.com/. Consulté le 28/02/2023.


.. _Téléchargement: https://www.naturalearthdata.com/http//www.naturalearthdata.com/download/10m/cultural/ne_10m_admin_0_countries.zip