From 3997ff39d6a3eaf1d4acced322d6f6f1383f0bc1 Mon Sep 17 00:00:00 2001 From: Emile Rolley Date: Mon, 2 Sep 2024 12:18:11 +0200 Subject: [PATCH] doc: start a historical explanations of modelisation choices --- doc/questions.md | 18 +++ doc/specs.md | 293 +++++++++++++++++++++++++++++++++++++++++++++++ specs.md | 81 ------------- 3 files changed, 311 insertions(+), 81 deletions(-) create mode 100644 doc/questions.md create mode 100644 doc/specs.md delete mode 100644 specs.md diff --git a/doc/questions.md b/doc/questions.md new file mode 100644 index 0000000..bc535e9 --- /dev/null +++ b/doc/questions.md @@ -0,0 +1,18 @@ +# Liste des questionnements pour la rédaction du modèle + +## Vrac + +- Comment connaitre le coût du plein/recharge ? +- Comment bien collecter les trajets ? +- Comment bien répartir l'empreinte de la construction en fonction du type + d'utilisation (location, libre service, etc...) ? + > Toute l'empreinte est attribuée au propriétaire du véhicule ? + > Dans NGC, l'empreinte de la construction est amortie au km parcouru. +- Comment gérer les voitures de fonctions ? +- Créer des personas en fonction des types de trajets ? +- **Comment gérer le fait de posséder plusieurs voitures ?** + +## Conception de la v1 + +- Pour la location est-ce que l'on souhaite ignorer l'empreinte de la + construction/coût d'achat ? diff --git a/doc/specs.md b/doc/specs.md new file mode 100644 index 0000000..2ee8c2b --- /dev/null +++ b/doc/specs.md @@ -0,0 +1,293 @@ +# Document de travail + +Emile Rolley | Août 2024 + +## Objectif + +Ce modèle de calcul a pour but d'être utilisé dans l'application +[Agir](https://agir.beta.gouv.fr/) pour aider les utilisateurices à prendre une +décision éclairée sur le changement de leur voiture. Cela nécessite un moyen de +comparer l'empreinte CO2e ainsi que le coût monétaire de deux véhicule et de +leurs usages. + +Le but de ce modèle est donc de permettre le calcul d'une estimation de +l'empreinte carbone d'une voiture (fabrication et usage) ainsi que son coût +monétaire (achat, entretien, carburant, etc.). + +Un client autonome est disponible pour ce modèle : +[agir-voiture](https://github.com/betagouv/agir-voiture). + +## Historique + +### Expérimentation - [v0.3.0-7](https://github.com/betagouv/publicodes-voiture/commit/5779101907027d85e8ef52809d702bd066e97f64) + +Afin de pouvoir rapidement confronter une première version aux tests +utilisateurices et vérifier l'utilité du projet, une première version du modèle +a été effectuée en réutilisant : + +- le modèle de [Nos Gestes + Climat (NGC)](https://nosgestesclimat.fr/documentation/transport/voiture) pour le calcul + de l'empreinte carbone, +- et le modèle de + [Futur.eco](https://github.com/laem/futur.eco/blob/master/app/cout-voiture/data/voiture.yaml) + pour le calcul du coût. + +Les règles correspondantes aux questions à posées étaient utilisées via le +mécanisme [`contexte`](https://publi.codes/docs/mecanismes#contexte) permettant +de calculer une règle avec un contexte particulier correspondant à la situation +de l'utilisateurice. + +Par exemple, pour le calcul du coût à partir des règles de `futureco` : + +```yaml +coût . voiture: + formule: usage . km annuels * futureco . voiture . coûts au km + unité: €/an + contexte: + futureco . trajet . voyageurs: 1 + futureco . voiture . consommation thermique: + valeur: + # TODO: factoriser avec empreinte + # Permet de forcer l'utilisation de la consommation estimée lors des + # recalculs pour les alternatives. + # + # Par défaut, si la personne n'a pas renseigné le prix d'achat, on avec + # le mécansime `plancher`, la règle `prix d'achat` est évaluée à 1. + variations: + - si: voiture . thermique . consommation > 1 + alors: voiture . thermique . consommation + - sinon: voiture . thermique . consommation . consommation estimée + futureco . voiture . km annuels . par défaut: usage . km annuels + futureco . voiture . prix d'achat: + valeur: + # Permet de forcer l'utilisation du prix d'achat estimé lors des + # recalculs pour les alternatives. + # + # Par défaut, si la personne n'a pas renseigné le prix d'achat, on avec + # le mécansime `plancher`, la règle `prix d'achat` est évaluée à 1. + variations: + - si: voiture . prix d'achat > 1 + alors: voiture . prix d'achat + - sinon: voiture . prix d'achat . estimé + futureco . voiture . motorisation: + variations: + - si: voiture . motorisation = 'thermique' + alors: + variations: + - si: voiture . thermique . carburant = 'gazole B7 ou B10' + alors: "'diesel'" + - si: voiture . thermique . carburant = 'essence E5 ou E10' + alors: "'essence'" + - si: voiture . thermique . carburant = 'essence E85' + alors: "'biocarburant'" + - sinon: voiture . motorisation + futureco . trajet voiture . prix carburant: voiture . thermique . prix carburant + futureco . voiture . occasion: voiture . occasion + futureco . voiture . occasion . année de fabrication: voiture . occasion . année de fabrication +``` + +#### Limitations + +Cependant, cette approche possède certaines limites. + +En effet, il est nécessaire de devoir traduire certains valeurs pour +correspondre à celles attendues par `futureco` qui ne sont pas les même que +celles utilisées par `NGC`. Ce qui **complique la compréhension du calcul** à +partir de la documentation, créer des **risques d'erreurs et d'incohérences si +c'est valeurs évaluent**. + +De plus, n'ayant pas la mains sur le calcul la structure, cela **ne permet pas +de facilement exposer la répartition entre coût d'achat/construction et +l'utilisation** nécessaire pour une bonne pédagogie. + +**La prise en compte de l'occasion diffères entre les deux modèles** : l'un +utilise la durée de vie en année et l'autre en km parcourus ce qui pose un +problème de cohérence du calcul et potentiellement des règles de conversions +compliquant encore une fois le calcul et la compréhension que l'on peut s'en +faire. + +Afin d'éviter ces limitations il semblerait plus judicieux de réécrire le +modèle dans une nouvelle version plus cohérente. + +### Première version - v1 + +Pour avoir la main sur la structure et les hypothèses du calcul il parait +intéressant de repartir _à zéro_ sur l'implémentation. Mais avant cela, il +préférable de prendre un peu de recul et de réfléchir aux valeurs nécessaires +au calcul et à la façon de procéder. + +Rappelons que le but du modèle étant d'être utilisé dans la plateforme +[`Agir`](https://agir.beta.gouv.fr) en réutilisant un maximum des données +collectées et que le modèle `NGC` est déjà utilisé pour le calcul du bilan +carbone. Il **parait donc raisonnable que de se baser sur la situation de `NGC` +permettrait la réutilisation de nombreuses information** tout en réduisant les +étapes de conversion des formats de données (voir la [Méthode d'intégration de +services +externes](https://github.com/betagouv/agir-voiture/blob/main/doc/reflexion-integration-service.md)). + +Se baser la situation de `NGC` permettrait _a priori_ de pouvoir se concentrer +dans premier temps uniquement sur la réimplémentation du calcul du coût. + +--- + +## Conception de la v1 + +Essayons de définir les règles pour atteindre l'objectif final : _suggérer une +meilleure alternative à la voiture actuelle de l'utilisateurice si garder la +voiture actuelle n'est pas la meilleure option_. + +### La _meilleure_ alternative + +La meilleure alternative est celle qui minimise la `durée d'amortissement` de +l'achat/construction). + +La achat/construction de la voiture est amortie lorsque l'`économie réalisée sur +l'utilisation` est supérieur au coût d'achat/empreinte de la construction : + +```yaml +durée d'amortissement: + valeur: coût d'achat / économie réalisée sur l'utilisation + unité: an + +économie réalisée sur l'utilisation: + valeur: coût d'utilisation actuelle - coût utilisation alternative + unité: €/an +``` + +> **Interrogations** : est-ce que la durée d'amortissement ainsi que l'économie +> réalisée ne devrait pas être fait au niveau du client ? + +Une autre option consisterait à calculer non pas une _durée_ d'amortissement +mais un certains nombres de km. Côté NGC, l'amortissement est fait en nombre de +km parcourus (voir la [documentation +correspondante](https://nosgestesclimat.fr/documentation/transport/voiture/amortissement), +il pourrait être donc pertinent d'utiliser la même approche pour le coût. + +#### Voiture d'occasion + +Prendre en compte l'occasion permet essentiellement de repartir la +responsabilité des émissions entre les propriétaires d'une même voiture. +Cependant, pour le calcul du coût cela se reflète déjà dans le prix d'achat de +la voiture donc ne serait pas forcément nécessaire de le prendre en compte +directement dans le calcul. +Sauf pour prendre en compte la durée de vie réduite la voiture comme c'est le cas +dans le modèle de `futureco` : + +```yaml +futureco . voiture . durée de vie . relative: + titre: Durée de vie estimée depuis le dernier achat + description: | + Si le propriétaire actuel a acheté la voiture neuve, sa durée de vie + relative est la durée de vie moyenne d'une voiture. + + S'il l'a achetée d'occasion, on retranche la durée de possession d'un + ancien propriétaire pour estimer le coût amorti de possession du + propriétaire actuel, dans l'hypothèse où il la garderait jusqu'à sa fin de + vie. + + Si vous avez acheté une voiture fabriquée en 2000, qui a donc 23 ans, nous + estimons qu'elle n'a qu'un an à vivre, statistiquement. Bien sûr, de + nombreuses voitures tiennent plus longtemps. Mais à l'inverse, de + nombreuses tiennent moins longtemps, c'est le principe de la moyenne. Une + extension du modèle pour ces cas-là pourra être envisagée. + note: | + Pour simplifier, nous prenons l'année la plus proche. En octobre 2023, + c'est donc 2024. À mettre à jour dans 8 mois. + formule: + variations: + - si: occasion + alors: + valeur: durée de vie - (2024 - occasion . année de fabrication) + plancher: 1 + - sinon: durée de vie +``` + +Cependant, se pose la question de comment reporter cette durée de vie relative +dans le calcul de l'empreinte carbone. + +#### Voiture de location + +L'empreinte de la construction doit-elle ignorée pour la location en +considérant qu'elle revient au propriétaire (c'est-à-dire la compagnie de +location) ? + +Si oui, elle devient une _meilleure_ alternative si le coût de location pour +toute la durée d'utilisation de la voiture louée est inférieur à la durée +d'amortissement d'une alternative correspondante à la voiture louée ? + +### Garder sa voiture actuelle ? + +Garder sa voiture actuelle serait uniquement intéressant si le fait d'en +changer entraine un coût et une empreinte supérieur : + +```yaml +alternative . garder sa voiture actuelle: + valeur: durée d'amortissement > durée de vie présumée de la voiture +``` + +### Conclusion intermédiaire + +En commençant à réfléchir sur ce que signifie _meilleure alternative_, il semblerait +que c'est peut-être rentrer trop dans le détails et laisser cette notion au client +réutilisant le modèle. + +**Le périmètre de ce modèle pourrait être cantonné à calculer d'une part le coût +(coût de construction amorti + coût d'utilisation + coût administratifs + coût +d'entretiens) et d'autre part l'empreinte (empreinte de construction amortie + +empreinte utilisation).** + +--- + +
+ Anciennes notes + +## Spécifications + +### Sorties + +Les sorties du modèle sont les suivantes : + +- L'empreinte carbone totale (en kgCO2e/an), décomposée en : + - Fabrication + - Usage +- Le coût total (en €/an), décomposé en : + - Achat + - Entretien + - Carburant + - Autres (assurances, péages, parking, etc.) + +### Entrées + +Voici les différentes informations nécessaires pour le calcul : + +**Informations sur le véhicule**: + +- Le type de carburant: + - essence + - diesel + - électrique + - hybride + - hybride rechargeable +- La consommation (en L/100km ou Wh/km) +- ~~Poids du véhicule (en kg)~~ gabarit + > Q: nécessaire si on a déjà la consommation ? +- Coût d'achat (en €) +- Coût d'entretien annuel (en €) + +- Voiture de fonction ? + +**Informations sur l'usage**: + +- Nombre de kilomètres parcourus par an (en km) +- Prix du carburant (en €/L ou €/kWh) +- Prix de l'assurance (en €/an) +- Type de trajets: + - Urbain (ex. travail, trajets quotidiens) + - Longue distance (ex. vacances, famille) + - Rural (ex. travail en dehors de la ville ou dans une autre ville) + +Le type de trajet à pour but d'affiner l'estimation des coûts de la catégorie +`Autres`, quelle est la fréquence d'utilisation d'autoroutes par exemple, +etc... (Voir [futur.eco/cout-voiture](https://futur.eco/cout-voiture). + +
diff --git a/specs.md b/specs.md deleted file mode 100644 index e751bc3..0000000 --- a/specs.md +++ /dev/null @@ -1,81 +0,0 @@ -# Document de travail - -## Objectif - -Ce modèle de calcul a pour but d'être utilisé dans l'application -[Agir](https://agir.beta.gouv.fr/) pour aider les utilisateurices à prendre une -décision éclairée sur le changement de leur voiture. Cela nécessite un moyen de -comparer l'empreinte CO2e ainsi que le coût monétaire de deux véhicule et de -leurs usages. - -Le but de ce modèle est donc de permettre le calcul d'une estimation de -l'empreinte carbone d'une voiture (fabrication et usage) ainsi que son coût -monétaire (achat, entretien, carburant, etc.). - -## Spécifications - -### Sorties - -Les sorties du modèle sont les suivantes : - -- L'empreinte carbone totale (en kgCO2e/an), décomposée en : - - Fabrication - - Usage -- Le coût total (en €/an), décomposé en : - - Achat - - Entretien - - Carburant - - Autres (assurances, péages, parking, etc.) - -> Q: Est-ce que l'année est un bon intervalle pour les coûts ? Est-ce que ça -> ne devrait pas être mensuel ou hebdomadaire ? - -> Q: A quel point une part du calcul est commun aux deux sorties ? -> Ne serait-il pas plus judicieux d'avoir deux modèles séparés si il n'y a pas -> de sous-calculs communs ? - -### Entrées - -Voici les différentes informations nécessaires pour le calcul : - -**Informations sur le véhicule**: - -- Le type de carburant: - - essence - - diesel - - électrique - - hybride - - hybride rechargeable -- La consommation (en L/100km ou Wh/km) -- Poids du véhicule (en kg) - > Q: nécessaire si on a déjà la consommation ? -- Coût d'achat (en €) -- Coût d'entretien annuel (en €) - -- Voiture de fonction ? - -**Informations sur l'usage**: - -- Nombre de kilomètres parcourus par an (en km) -- Prix du carburant (en €/L ou €/kWh) -- Prix de l'assurance (en €/an) -- Type de trajets: - - Urbain (ex. travail, trajets quotidiens) - - Longue distance (ex. vacances, famille) - - Rural (ex. travail en dehors de la ville ou dans une autre ville) - -Le type de trajet à pour but d'affiner l'estimation des coûts de la catégorie -`Autres`, quelle est la fréquence d'utilisation d'autoroutes par exemple, -etc... (Voir [futur.eco/cout-voiture](https://futur.eco/cout-voiture). - -### Interrogations - -- Comment connaitre le coût du plein/recharge ? -- Comment bien collecter les trajets ? -- Comment bien répartir l'empreinte de la construction en fonction du type - d'utilisation (location, libre service, etc...) ? - > Toute l'empreinte est attribuée au propriétaire du véhicule ? - > Dans NGC, l'empreinte de la construction est amortie au km parcouru. -- Comment gérer les voitures de fonctions ? -- Créer des personas en fonction des types de trajets ? -- **Comment gérer le fait de posséder plusieurs voitures ?**