Kish doc

InseeFr · Sep 13, 2023 · 62b1846 · 62b1846
1 parent 253587e
commit 62b1846
Show file tree

Hide file tree

Showing 58 changed files with 1,404 additions and 275 deletions.
diff --git a/bowiedocs/docs/pogues/guide/kish.md b/bowiedocs/docs/pogues/guide/kish.md
@@ -0,0 +1,71 @@
+# Sélection du Kish
+
+Ce document décrit une méthode pour sélectionner le Kish dans Pogues.
+
+## Principe
+
+On considère que l'on procède à l'identification du Kish à travers les étapes suivantes :
+
+- on demande le nombre d'habitants du ménage
+- on boucle sur ce nombre pour collecter les prénoms et les dates de naissance de chacun des membres du ménage
+- une dernière boucle va permettre de filtrer le questionnement sur le seul Kish
+
+## Structure du questionnaire
+
+### Séquence d'identification
+
+> On construit une séquence contenant les questions permettant d'identifier le Kish contenant la question du nombre d'habitants et la sous-séquence d'identification.
+
+On crée une séquence contenant une première question pour collecter le nombre d'habitants (variable numérique collectée `NBHAB`).
+
+On crée ensuite dans cette même séquence une sous-séquence `IDENTIFICATION` contenant :
+
+- une question pour collecter le prénom de chaque habitant (variable texte collectée `PRENOM`).
+- une question pour collecter la date de naissance (variable date `DATE_DE_NAISANCE`)
+
+Il faut ensuite créer une boucle `BOUCLE_PRENOMS` sur cette sous-séquence avec la formule `cast($NBHAB$, integer)` pour le minimum et le maximum.
+
+### Séquence de questions
+
+> On crée la séquence de questionnement
+
+Une séquence contenant une question `QUESTION_POUR_LE_KISH`, dont le libellé est personnalisé avec le prénom (via la formule VTL `"Question pour " || cast($PRENOM$, string)`).
+
+On crée la boucle `BOUCLE_QUESTION_KISH` basée sur `BOUCLE_PRENOMS` qui englobe la séquence de questions pour le Kish.
+
+## Calcul du Kish
+
+> Les éléments permettant de procéder au calcul lui-même
+
+Le coeur de la sélection est la formule permettant de former un score de sélection :
+
+`cast(if $MOIS_NAISSANCE_INT$ < 6 then $MOIS_NAISSANCE_INT$ + 12 else $MOIS_NAISSANCE_INT$, string) || "." || $JOUR_NAISSANCE_STR$`
+
+Elle donnera par exemple :
+
+- pour la date de naissance `01/06/2000` le score `6.01`
+- pour `10/05/1990` le score `17.10`
+
+On sélectionne ensuite l'individu dont le score est le plus bas.
+
+Les variables calculées nécessaires sont :
+
+| Variable           | Portée         | VTL                                                                                |
+|--------------------|----------------|------------------------------------------------------------------------------------|
+| MOIS_NAISSANCE_INT | BOUCLE_PRENOMS | `cast(cast(cast($DATE_DE_NAISSANCE$, date, "YYYY-MM-DD"), string, "MM"), integer)` |
+| JOUR_NAISSANCE_STR | BOUCLE_PRENOMS | `cast(cast($DATE_DE_NAISSANCE$, date, "YYYY-MM-DD"),string, "DD")`                 |
+| SCORE_KISH         | BOUCLE_PRENOMS | `cast(if $MOIS_NAISSANCE_INT$ < 6 then $MOIS_NAISSANCE_INT$ + 12 else $MOIS_NAISSANCE_INT$, string) || "." || $JOUR_NAISSANCE_STR$`   |
+| KISH_MIN           | Questionnaire  | `min($SCORE_KISH_INT$)`                                                            |
+| KISH_INDICATOR     | BOUCLE_PRENOMS | `if $KISH_MIN$ = $SCORE_KISH_INT$ then 1 else 0`                                   |
+| SCORE_KISH_INT     | BOUCLE_PRENOMS | `cast($SCORE_KISH$, number)`                                                       |
+| NB_POTENTIAL_KISH  | Questionnaire  | `sum($KISH_INDICATOR$)`                                                            |
+
+## Filtre
+
+Pour ne présenter qu'un seul jeu de questions à l'individu sélectionné, il est nécessaire d'ajouter un filtre sur ces questions à partir du score calculé en amont.
+
+Le filtre a pour formule `$KISH_INDICATOR$ = 1`.
+
+## Questionnaire exemple
+
+Pour référence, [un questionnaire implémentant cette solution](https://pogues.demo.insee.io/questionnaire/l8lfytfu).
diff --git a/docs/404.html b/docs/404.html
@@ -848,6 +848,8 @@
 
 
 
+
+
 
 
 
@@ -920,6 +922,20 @@
 
 
 
+    <li class="md-nav__item">
+      <a href="/pogues/guide/kish/" class="md-nav__link">
+        Sélection du Kish
+      </a>
+    </li>
+
+
+
+
+
+
+
+
+
     <li class="md-nav__item">
       <a href="/pogues/guide/liste-de-code/" class="md-nav__link">
         Les listes de code
@@ -968,7 +984,7 @@
 
 
 
-      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_2_8" >
+      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8_2_9" >
 
 
 
@@ -978,13 +994,13 @@
 
 
 
-        <label class="md-nav__link" for="__nav_8_2_8" id="__nav_8_2_8_label" tabindex="0">
+        <label class="md-nav__link" for="__nav_8_2_9" id="__nav_8_2_9_label" tabindex="0">
           Variables
           <span class="md-nav__icon md-icon"></span>
         </label>
 
-      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_8_2_8_label" aria-expanded="false">
-        <label class="md-nav__title" for="__nav_8_2_8">
+      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_8_2_9_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_8_2_9">
           <span class="md-nav__icon md-icon"></span>
           Variables
         </label>

diff --git a/docs/architecture/index.html b/docs/architecture/index.html
@@ -327,6 +327,11 @@
       </a>
 </li>
 <li class="md-nav__item">
+<a class="md-nav__link" href="../pogues/guide/kish/">
+        Sélection du Kish
+      </a>
+</li>
+<li class="md-nav__item">
 <a class="md-nav__link" href="../pogues/guide/liste-de-code/">
         Les listes de code
       </a>
@@ -342,13 +347,13 @@
       </a>
 </li>
 <li class="md-nav__item md-nav__item--nested">
-<input class="md-nav__toggle md-toggle" id="__nav_8_2_8" type="checkbox"/>
-<label class="md-nav__link" for="__nav_8_2_8" id="__nav_8_2_8_label" tabindex="0">
+<input class="md-nav__toggle md-toggle" id="__nav_8_2_9" type="checkbox"/>
+<label class="md-nav__link" for="__nav_8_2_9" id="__nav_8_2_9_label" tabindex="0">
           Variables
           <span class="md-nav__icon md-icon"></span>
 </label>
-<nav aria-expanded="false" aria-labelledby="__nav_8_2_8_label" class="md-nav" data-md-level="3">
-<label class="md-nav__title" for="__nav_8_2_8">
+<nav aria-expanded="false" aria-labelledby="__nav_8_2_9_label" class="md-nav" data-md-level="3">
+<label class="md-nav__title" for="__nav_8_2_9">
 <span class="md-nav__icon md-icon"></span>
           Variables
         </label>

diff --git a/docs/conception/1-conception/index.html b/docs/conception/1-conception/index.html
@@ -365,6 +365,11 @@
       </a>
 </li>
 <li class="md-nav__item">
+<a class="md-nav__link" href="../../pogues/guide/kish/">
+        Sélection du Kish
+      </a>
+</li>
+<li class="md-nav__item">
 <a class="md-nav__link" href="../../pogues/guide/liste-de-code/">
         Les listes de code
       </a>
@@ -380,13 +385,13 @@
       </a>
 </li>
 <li class="md-nav__item md-nav__item--nested">
-<input class="md-nav__toggle md-toggle" id="__nav_8_2_8" type="checkbox"/>
-<label class="md-nav__link" for="__nav_8_2_8" id="__nav_8_2_8_label" tabindex="0">
+<input class="md-nav__toggle md-toggle" id="__nav_8_2_9" type="checkbox"/>
+<label class="md-nav__link" for="__nav_8_2_9" id="__nav_8_2_9_label" tabindex="0">
           Variables
           <span class="md-nav__icon md-icon"></span>
 </label>
-<nav aria-expanded="false" aria-labelledby="__nav_8_2_8_label" class="md-nav" data-md-level="3">
-<label class="md-nav__title" for="__nav_8_2_8">
+<nav aria-expanded="false" aria-labelledby="__nav_8_2_9_label" class="md-nav" data-md-level="3">
+<label class="md-nav__title" for="__nav_8_2_9">
 <span class="md-nav__icon md-icon"></span>
           Variables
         </label>

diff --git a/docs/conception/2-conception/index.html b/docs/conception/2-conception/index.html
@@ -328,6 +328,11 @@
       </a>
 </li>
 <li class="md-nav__item">
+<a class="md-nav__link" href="../../pogues/guide/kish/">
+        Sélection du Kish
+      </a>
+</li>
+<li class="md-nav__item">
 <a class="md-nav__link" href="../../pogues/guide/liste-de-code/">
         Les listes de code
       </a>
@@ -343,13 +348,13 @@
       </a>
 </li>
 <li class="md-nav__item md-nav__item--nested">
-<input class="md-nav__toggle md-toggle" id="__nav_8_2_8" type="checkbox"/>
-<label class="md-nav__link" for="__nav_8_2_8" id="__nav_8_2_8_label" tabindex="0">
+<input class="md-nav__toggle md-toggle" id="__nav_8_2_9" type="checkbox"/>
+<label class="md-nav__link" for="__nav_8_2_9" id="__nav_8_2_9_label" tabindex="0">
           Variables
           <span class="md-nav__icon md-icon"></span>
 </label>
-<nav aria-expanded="false" aria-labelledby="__nav_8_2_8_label" class="md-nav" data-md-level="3">
-<label class="md-nav__title" for="__nav_8_2_8">
+<nav aria-expanded="false" aria-labelledby="__nav_8_2_9_label" class="md-nav" data-md-level="3">
+<label class="md-nav__title" for="__nav_8_2_9">
 <span class="md-nav__icon md-icon"></span>
           Variables
         </label>

diff --git a/docs/conception/3-conception/index.html b/docs/conception/3-conception/index.html
@@ -328,6 +328,11 @@
       </a>
 </li>
 <li class="md-nav__item">
+<a class="md-nav__link" href="../../pogues/guide/kish/">
+        Sélection du Kish
+      </a>
+</li>
+<li class="md-nav__item">
 <a class="md-nav__link" href="../../pogues/guide/liste-de-code/">
         Les listes de code
       </a>
@@ -343,13 +348,13 @@
       </a>
 </li>
 <li class="md-nav__item md-nav__item--nested">
-<input class="md-nav__toggle md-toggle" id="__nav_8_2_8" type="checkbox"/>
-<label class="md-nav__link" for="__nav_8_2_8" id="__nav_8_2_8_label" tabindex="0">
+<input class="md-nav__toggle md-toggle" id="__nav_8_2_9" type="checkbox"/>
+<label class="md-nav__link" for="__nav_8_2_9" id="__nav_8_2_9_label" tabindex="0">
           Variables
           <span class="md-nav__icon md-icon"></span>
 </label>
-<nav aria-expanded="false" aria-labelledby="__nav_8_2_8_label" class="md-nav" data-md-level="3">
-<label class="md-nav__title" for="__nav_8_2_8">
+<nav aria-expanded="false" aria-labelledby="__nav_8_2_9_label" class="md-nav" data-md-level="3">
+<label class="md-nav__title" for="__nav_8_2_9">
 <span class="md-nav__icon md-icon"></span>
           Variables
         </label>

diff --git a/docs/conception/4-conception/index.html b/docs/conception/4-conception/index.html
@@ -388,6 +388,11 @@
       </a>
 </li>
 <li class="md-nav__item">
+<a class="md-nav__link" href="../../pogues/guide/kish/">
+        Sélection du Kish
+      </a>
+</li>
+<li class="md-nav__item">
 <a class="md-nav__link" href="../../pogues/guide/liste-de-code/">
         Les listes de code
       </a>
@@ -403,13 +408,13 @@
       </a>
 </li>
 <li class="md-nav__item md-nav__item--nested">
-<input class="md-nav__toggle md-toggle" id="__nav_8_2_8" type="checkbox"/>
-<label class="md-nav__link" for="__nav_8_2_8" id="__nav_8_2_8_label" tabindex="0">
+<input class="md-nav__toggle md-toggle" id="__nav_8_2_9" type="checkbox"/>
+<label class="md-nav__link" for="__nav_8_2_9" id="__nav_8_2_9_label" tabindex="0">
           Variables
           <span class="md-nav__icon md-icon"></span>
 </label>
-<nav aria-expanded="false" aria-labelledby="__nav_8_2_8_label" class="md-nav" data-md-level="3">
-<label class="md-nav__title" for="__nav_8_2_8">
+<nav aria-expanded="false" aria-labelledby="__nav_8_2_9_label" class="md-nav" data-md-level="3">
+<label class="md-nav__title" for="__nav_8_2_9">
 <span class="md-nav__icon md-icon"></span>
           Variables
         </label>

diff --git a/docs/conception/index.html b/docs/conception/index.html
@@ -327,6 +327,11 @@
       </a>
 </li>
 <li class="md-nav__item">
+<a class="md-nav__link" href="../pogues/guide/kish/">
+        Sélection du Kish
+      </a>
+</li>
+<li class="md-nav__item">
 <a class="md-nav__link" href="../pogues/guide/liste-de-code/">
         Les listes de code
       </a>
@@ -342,13 +347,13 @@
       </a>
 </li>
 <li class="md-nav__item md-nav__item--nested">
-<input class="md-nav__toggle md-toggle" id="__nav_8_2_8" type="checkbox"/>
-<label class="md-nav__link" for="__nav_8_2_8" id="__nav_8_2_8_label" tabindex="0">
+<input class="md-nav__toggle md-toggle" id="__nav_8_2_9" type="checkbox"/>
+<label class="md-nav__link" for="__nav_8_2_9" id="__nav_8_2_9_label" tabindex="0">
           Variables
           <span class="md-nav__icon md-icon"></span>
 </label>
-<nav aria-expanded="false" aria-labelledby="__nav_8_2_8_label" class="md-nav" data-md-level="3">
-<label class="md-nav__title" for="__nav_8_2_8">
+<nav aria-expanded="false" aria-labelledby="__nav_8_2_9_label" class="md-nav" data-md-level="3">
+<label class="md-nav__title" for="__nav_8_2_9">
 <span class="md-nav__icon md-icon"></span>
           Variables
         </label>

diff --git a/docs/eno/index.html b/docs/eno/index.html
@@ -327,6 +327,11 @@
       </a>
 </li>
 <li class="md-nav__item">
+<a class="md-nav__link" href="../pogues/guide/kish/">
+        Sélection du Kish
+      </a>
+</li>
+<li class="md-nav__item">
 <a class="md-nav__link" href="../pogues/guide/liste-de-code/">
         Les listes de code
       </a>
@@ -342,13 +347,13 @@
       </a>
 </li>
 <li class="md-nav__item md-nav__item--nested">
-<input class="md-nav__toggle md-toggle" id="__nav_8_2_8" type="checkbox"/>
-<label class="md-nav__link" for="__nav_8_2_8" id="__nav_8_2_8_label" tabindex="0">
+<input class="md-nav__toggle md-toggle" id="__nav_8_2_9" type="checkbox"/>
+<label class="md-nav__link" for="__nav_8_2_9" id="__nav_8_2_9_label" tabindex="0">
           Variables
           <span class="md-nav__icon md-icon"></span>
 </label>
-<nav aria-expanded="false" aria-labelledby="__nav_8_2_8_label" class="md-nav" data-md-level="3">
-<label class="md-nav__title" for="__nav_8_2_8">
+<nav aria-expanded="false" aria-labelledby="__nav_8_2_9_label" class="md-nav" data-md-level="3">
+<label class="md-nav__title" for="__nav_8_2_9">
 <span class="md-nav__icon md-icon"></span>
           Variables
         </label>

diff --git a/docs/index.html b/docs/index.html
@@ -327,6 +327,11 @@
       </a>
 </li>
 <li class="md-nav__item">
+<a class="md-nav__link" href="pogues/guide/kish/">
+        Sélection du Kish
+      </a>
+</li>
+<li class="md-nav__item">
 <a class="md-nav__link" href="pogues/guide/liste-de-code/">
         Les listes de code
       </a>
@@ -342,13 +347,13 @@
       </a>
 </li>
 <li class="md-nav__item md-nav__item--nested">
-<input class="md-nav__toggle md-toggle" id="__nav_8_2_8" type="checkbox"/>
-<label class="md-nav__link" for="__nav_8_2_8" id="__nav_8_2_8_label" tabindex="0">
+<input class="md-nav__toggle md-toggle" id="__nav_8_2_9" type="checkbox"/>
+<label class="md-nav__link" for="__nav_8_2_9" id="__nav_8_2_9_label" tabindex="0">
           Variables
           <span class="md-nav__icon md-icon"></span>
 </label>
-<nav aria-expanded="false" aria-labelledby="__nav_8_2_8_label" class="md-nav" data-md-level="3">
-<label class="md-nav__title" for="__nav_8_2_8">
+<nav aria-expanded="false" aria-labelledby="__nav_8_2_9_label" class="md-nav" data-md-level="3">
+<label class="md-nav__title" for="__nav_8_2_9">
 <span class="md-nav__icon md-icon"></span>
           Variables
         </label>

diff --git a/docs/lunatic/index.html b/docs/lunatic/index.html
@@ -327,6 +327,11 @@
       </a>
 </li>
 <li class="md-nav__item">
+<a class="md-nav__link" href="../pogues/guide/kish/">
+        Sélection du Kish
+      </a>
+</li>
+<li class="md-nav__item">
 <a class="md-nav__link" href="../pogues/guide/liste-de-code/">
         Les listes de code
       </a>
@@ -342,13 +347,13 @@
       </a>
 </li>
 <li class="md-nav__item md-nav__item--nested">
-<input class="md-nav__toggle md-toggle" id="__nav_8_2_8" type="checkbox"/>
-<label class="md-nav__link" for="__nav_8_2_8" id="__nav_8_2_8_label" tabindex="0">
+<input class="md-nav__toggle md-toggle" id="__nav_8_2_9" type="checkbox"/>
+<label class="md-nav__link" for="__nav_8_2_9" id="__nav_8_2_9_label" tabindex="0">
           Variables
           <span class="md-nav__icon md-icon"></span>
 </label>
-<nav aria-expanded="false" aria-labelledby="__nav_8_2_8_label" class="md-nav" data-md-level="3">
-<label class="md-nav__title" for="__nav_8_2_8">
+<nav aria-expanded="false" aria-labelledby="__nav_8_2_9_label" class="md-nav" data-md-level="3">
+<label class="md-nav__title" for="__nav_8_2_9">
 <span class="md-nav__icon md-icon"></span>
           Variables
         </label>