script_221cvmn_221.py

📄 Template de Fiche Descriptive — Script Python

🔷 INFORMATIONS GÉNÉRALES

Champ Détail

Nom du script script_221cvmn_221.py

Version 1.0.0

Date de création 02/03/2026

Auteur / Demandeur IA  REFOIA JEREMY TECH

Objectif principal Simuler le cycle de vie annuel d’un ours (poids, énergie, hibernation) selon son profil (mâle ou mère) à l’aide d’un modèle basé sur des agents.

🎯 DESCRIPTION FONCTIONNELLE

📌 Que fait ce script ?

Ce script simule l’évolution physiologique de deux ours sur 364 jours (4 saisons). Il suit les variations de poids et de stock d’énergie en fonction d’activités spécifiques : pêche au saumon en été/automne, marquage de territoire, protection des oursons et hibernation hivernale.

📌 Problème résolu

Il permet de modéliser l’impact des comportements saisonniers et du statut social (parentalité) sur les chances de survie et la capacité à atteindre le seuil de poids nécessaire pour hiberner sans risque de famine.

⚙️ SPÉCIFICATIONS TECHNIQUES

🐍 Environnement

Élément Valeur

Version Python 3.x

OS cible Tous (Windows / Linux / MacOS)

Mode d’exécution CLI (Script autonome)

📦 Dépendances / Librairies

Librairies externes (pip install)

numpy (Calculs aléatoires et gestion des tableaux)

matplotlib (Génération des graphiques de visualisation)

📥 ENTRÉES (INPUTS)

📂 Paramètres de classe (Objets Ours)

# Nom Type Obligatoire Description Exemple

1 nom str ✅ Oui Nom identifiant de l’ours « Grizzly Joe »

2 est_mere bool ❌ Non Définit si l’agent a des oursons (influence la dépense) True

3 poids_initial float ❌ Non Poids au début de la simulation 300.0

4 energie_initiale float ❌ Non Niveau d’énergie initial 100.0

📤 SORTIES (OUTPUTS)

📂 Données et Visualisations

Type Description

Console Logs quotidiens, alertes de famine et transitions d’hibernation.

Graphique Deux fenêtres Matplotlib affichant les courbes de poids et d’énergie sur 364 jours.

Dictionnaire L’objet statistiques contenant les listes historiques des variables suivies.

🧱 STRUCTURE DU SCRIPT

Plaintext

script_221cvmn_221.py

│

├── 📌 IMPORTS (numpy, matplotlib)

├── 📌 CLASSE Ours (Modèle d’agent)

│ ├── __init__() → Initialisation des attributs et paramètres métaboliques

│ ├── metabolisme() → Calcul des pertes journalières

│ ├── peche_saumon() → Simulation de gain de ressources

│ ├── jour_simule() → Boucle logique quotidienne

│ └── …

├── 📌 FONCTION simuler_cycle_annuel() → Orchestration de la boucle temporelle

├── 📌 FONCTION plot_stats() → Moteur de rendu graphique

└── 📌 MAIN (Exécution pour Joe et Mama Bear)

🔧 Détail des fonctions principales

Fonction Paramètres Retour Rôle

metabolisme(f) facteur: float None Réduit le poids et l’énergie selon l’activité.

peche_saumon(j) jours: int None Tente de gagner du poids via une probabilité (65%).

verifier_hibernation() Aucun None Gère le basculement d’état selon le seuil de 320kg.

simuler_cycle_annuel() ours, nb_jours dict Pilote les 4 saisons et enregistre l’historique.

🔄 LOGIQUE / ALGORITHME

Phase Active (Printemps/Été) : Métabolisme normal + Pêche occasionnelle.

Phase d’Hyperphagie (Automne) : Pêche intensive (14 jours cumulés par jour simulé) pour engraissement.

Phase de Sommeil (Hiver) : Si poids ≥ 320kg, l’ours hiberne (consommation réduite). Sinon, il reste actif au risque de perdre trop de poids.

Mise à jour : Les statistiques sont stockées à chaque itération journalière.

🚨 GESTION DES ERREURS

Seuil de famine : Si le poids descend sous 150kg, un message d’alerte 🐻 ATTENTION est imprimé en console.

Validation des états : La méthode verifier_hibernation empêche les actions (pêche, marquage) si l’ours est endormi.

✅ CONTRAINTES & RÈGLES MÉTIER

Règle 1 : Les mères (est_mere=True) ont un facteur de dépense énergétique supérieur de 20% pour simuler la vigilance.

Règle 2 : L’hibernation réduit la dépense énergétique d’un facteur 10 (0.5→0.05).

Règle 3 : La sortie d’hibernation est automatique si le poids chute de 50kg sous le seuil d’entrée.

🧪 TESTS ATTENDUS

# Cas de test Entrée Résultat attendu

1 Poids élevé poids_initial=400 Hibernation immédiate ou très rapide.

2 Poids faible poids_initial=160 Alerte de famine probable au printemps.

3 Profil Mère est_mere=True Consommation d’énergie plus rapide que le mâle.

📊 PERFORMANCES ATTENDUES

Temps d’exécution : < 1 seconde pour une simulation annuelle complète.

Complexité : O(n) où n est le nombre de jours simulés.

📝 EXEMPLE D’UTILISATION

▶️ Lancement en ligne de commande

Bash

python script_221cvmn_221.py

📋 Exemple de sortie console

Plaintext

🚀 Début de la simulation du cycle annuel pour Grizzly Joe…

— SAISON : Automne —

😴 Grizzly Joe est entré en hibernation à 322.45 kg.

Jour 300: Ours(Grizzly Joe) – Poids: 320.12 kg, Énergie: 105.50

✅ Simulation terminée en 364 jours.