requipso 0.2.2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. requipso/__init__.py +27 -0
  2. requipso/cli.py +11 -0
  3. requipso/completer.py +103 -0
  4. requipso/data.py +72 -0
  5. requipso/descriptive_pipeline.py +271 -0
  6. requipso/docs/macros.py +226 -0
  7. requipso/docs/mkdocs.yml +140 -0
  8. requipso/docs/pages/assets/consort_flowchart.png +0 -0
  9. requipso/docs/pages/assets/demo.gif +0 -0
  10. requipso/docs/pages/blocs/age.md +61 -0
  11. requipso/docs/pages/blocs/ald.md +65 -0
  12. requipso/docs/pages/blocs/biometry.md +98 -0
  13. requipso/docs/pages/blocs/cim10.md +80 -0
  14. requipso/docs/pages/blocs/cisp2.md +59 -0
  15. requipso/docs/pages/blocs/code-postal.md +47 -0
  16. requipso/docs/pages/blocs/consultations.md +65 -0
  17. requipso/docs/pages/blocs/departement.md +50 -0
  18. requipso/docs/pages/blocs/est-vivant.md +44 -0
  19. requipso/docs/pages/blocs/genre.md +46 -0
  20. requipso/docs/pages/blocs/index.md +40 -0
  21. requipso/docs/pages/blocs/insurance.md +55 -0
  22. requipso/docs/pages/blocs/medecin-traitant.md +56 -0
  23. requipso/docs/pages/blocs/paquet-annees.md +70 -0
  24. requipso/docs/pages/blocs/prescription-atc.md +69 -0
  25. requipso/docs/pages/blocs/regex-consultation.md +64 -0
  26. requipso/docs/pages/blocs/regex-nlp.md +107 -0
  27. requipso/docs/pages/blocs/regex-patient-observation.md +81 -0
  28. requipso/docs/pages/blocs/regex-prescription.md +64 -0
  29. requipso/docs/pages/guide/application.md +81 -0
  30. requipso/docs/pages/guide/combiner-blocs.md +61 -0
  31. requipso/docs/pages/guide/demarrage.md +74 -0
  32. requipso/docs/pages/guide/erreurs.md +83 -0
  33. requipso/docs/pages/guide/exemple-complet.md +67 -0
  34. requipso/docs/pages/guide/google-sheet.md +50 -0
  35. requipso/docs/pages/guide/onglet-inclusion.md +91 -0
  36. requipso/docs/pages/guide/onglet-projet.md +48 -0
  37. requipso/docs/pages/guide/onglet-tableau-descriptif.md +124 -0
  38. requipso/docs/pages/guide/parametres.md +162 -0
  39. requipso/docs/pages/index.md +73 -0
  40. requipso/docs/pages/stylesheets/extra.css +3 -0
  41. requipso/docs/pages/technique/ajouter-un-bloc.md +147 -0
  42. requipso/docs/pages/technique/architecture.md +80 -0
  43. requipso/docs/pages/technique/blocs-internes.md +176 -0
  44. requipso/docs/pages/technique/chargement-sheet.md +107 -0
  45. requipso/docs/pages/technique/developpement.md +124 -0
  46. requipso/docs/pages/technique/donnees.md +106 -0
  47. requipso/docs/pages/technique/export-signatures.md +131 -0
  48. requipso/docs/pages/technique/nlp.md +82 -0
  49. requipso/docs/pages/technique/parametres-internes.md +140 -0
  50. requipso/docs/pages/technique/pipeline.md +66 -0
  51. requipso/docs/pages/technique/tableau-descriptif.md +74 -0
  52. requipso/google.py +168 -0
  53. requipso/io.py +95 -0
  54. requipso/notebooks/marimo/run.py +352 -0
  55. requipso/pipeline.py +364 -0
  56. requipso/pipeline_loader.py +572 -0
  57. requipso/pipes/__init__.py +43 -0
  58. requipso/pipes/atcd.py +365 -0
  59. requipso/pipes/base.py +431 -0
  60. requipso/pipes/biometry.py +170 -0
  61. requipso/pipes/consultations.py +117 -0
  62. requipso/pipes/insurance.py +90 -0
  63. requipso/pipes/params.py +283 -0
  64. requipso/pipes/patient.py +377 -0
  65. requipso/pipes/prescription.py +134 -0
  66. requipso/pipes/processors.py +250 -0
  67. requipso/polars.py +24 -0
  68. requipso/resources/pathology/__init__.py +7 -0
  69. requipso/signature_exporter.py +473 -0
  70. requipso/stats.py +130 -0
  71. requipso-0.2.2.dist-info/METADATA +102 -0
  72. requipso-0.2.2.dist-info/RECORD +75 -0
  73. requipso-0.2.2.dist-info/WHEEL +5 -0
  74. requipso-0.2.2.dist-info/entry_points.txt +2 -0
  75. requipso-0.2.2.dist-info/top_level.txt +1 -0
@@ -0,0 +1,107 @@
1
+ # Recherche dans le texte libre
2
+
3
+ Les blocs [`RegexConsultation`](regex-consultation.md) et
4
+ [`RegexPatientObservation`](regex-patient-observation.md) recherchent des mots ou expressions dans
5
+ le **texte libre** du dossier médical (notes de consultation, antécédents…). Ils reposent sur la
6
+ bibliothèque de traitement du langage [edsnlp](https://aphp.github.io/edsnlp/), développée par l'AP-HP
7
+ pour les textes médicaux en français.
8
+
9
+ Ils sont utiles quand l'information n'est pas codée : un symptôme, une habitude de vie, une
10
+ pathologie mal reconnue…
11
+
12
+ ## Deux façons de chercher
13
+
14
+ ### 1. Des motifs (expressions régulières)
15
+
16
+ Écrivez dans `value` un ou plusieurs motifs séparés par `|` :
17
+
18
+ | `value` | Trouve |
19
+ | --- | --- |
20
+ | `diabete` | « diabète », « Diabète », « DIABETE »… |
21
+ | `diabete|dt2|dnid` | l'un des trois termes |
22
+ | `insuffisan\w* renal\w*` | « insuffisance rénale », « insuffisant rénal »… |
23
+ | `\bhta\b` | « HTA » comme mot entier (pas « ahta ») |
24
+
25
+ !!! danger "Écrivez sans accents"
26
+ Le texte est **normalisé avant la recherche** : passage en minuscules et suppression des accents.
27
+ Un motif contenant un accent (`diabète`) ne trouve **jamais rien**. Écrivez `diabete`, `renal`,
28
+ `pre-eclampsie`… La casse n'a pas d'importance.
29
+
30
+ Quelques éléments d'écriture des motifs :
31
+
32
+ | Symbole | Signification | Exemple |
33
+ | --- | --- | --- |
34
+ | `|` | ou | `asthme|bpco` |
35
+ | `.` | n'importe quel caractère | `diab.te` |
36
+ | `\w*` | une suite de lettres (éventuellement vide) | `diabet\w*` → diabète, diabétique |
37
+ | `\b` | limite de mot | `\bavc\b` |
38
+ | `\s+` | un ou plusieurs espaces | `type\s+2` |
39
+ | `?` | le caractère précédent est facultatif | `diabetiques?` |
40
+
41
+ ### 2. Un pipeline edsnlp prêt à l'emploi
42
+
43
+ edsnlp fournit des détecteurs déjà construits pour certaines pathologies (avec leurs nombreuses
44
+ façons d'être écrites). Écrivez `edsnlp.` suivi du nom, **seul** dans `value` :
45
+
46
+ | `value` | Détecte |
47
+ | --- | --- |
48
+ | `edsnlp.diabetes` | Diabète |
49
+ | `edsnlp.tobacco` | Tabagisme |
50
+ | `edsnlp.alcohol` | Consommation d'alcool |
51
+ | `edsnlp.ckd` | Insuffisance rénale chronique |
52
+ | `edsnlp.copd` | BPCO |
53
+ | `edsnlp.congestive_heart_failure` | Insuffisance cardiaque |
54
+ | `edsnlp.myocardial_infarction` | Infarctus du myocarde |
55
+ | `edsnlp.cerebrovascular_accident` | AVC |
56
+ | `edsnlp.peripheral_vascular_disease` | Artériopathie périphérique |
57
+ | `edsnlp.dementia` | Démence |
58
+ | `edsnlp.liver_disease` | Maladie hépatique |
59
+ | `edsnlp.solid_tumor` | Tumeur solide |
60
+ | `edsnlp.covid` | COVID-19 |
61
+
62
+ La liste complète est dans la [documentation edsnlp](https://aphp.github.io/edsnlp/latest/pipes/).
63
+
64
+ !!! note "Un seul pipeline à la fois"
65
+ `edsnlp.xxx` doit être la **seule** valeur de la cellule. Pour combiner plusieurs pipelines, ou un
66
+ pipeline et des motifs, utilisez un [groupe](../guide/combiner-blocs.md) `OR`.
67
+
68
+ ## Les qualificatifs : négation, hypothèse…
69
+
70
+ Trouver le mot « diabète » ne suffit pas : « pas de diabète » ou « suspicion de diabète » ne doivent
71
+ pas compter. Après la recherche, chaque mention est **qualifiée** ; les mentions qui portent l'un des
72
+ qualificatifs listés dans le paramètre `qualifiers` sont **écartées**.
73
+
74
+ | Qualificatif | Écarte les mentions du type | Actif par défaut |
75
+ | --- | --- | --- |
76
+ | `negation` | « pas de diabète », « absence d'HTA » | Oui |
77
+ | `hypothesis` | « suspicion de diabète », « diabète ? » | Oui |
78
+ | `family` | « père diabétique » | Non |
79
+ | `history` | « antécédent de… » (mention ancienne) | Non |
80
+ | `reported_speech` | « le patient dit avoir… » | Non |
81
+
82
+ Pour modifier la liste, utilisez `supplementary_params` :
83
+
84
+ ```text
85
+ {"qualifiers": ["negation", "hypothesis", "family"]}
86
+ ```
87
+
88
+ `{"qualifiers": []}` garde toutes les mentions, sans qualification.
89
+
90
+ Les qualificatifs s'appliquent à la **phrase** de la mention. Les retours à la ligne suivis d'un
91
+ tiret (`- diabète`) sont considérés comme des fins de phrase : dans une liste à puces, la négation
92
+ d'une ligne ne déborde pas sur la suivante.
93
+
94
+ ## Ce que renvoient ces blocs
95
+
96
+ - Une ligne par **mention trouvée** ; `x` = le texte trouvé, tel qu'il est écrit dans la note
97
+ (ex. `Diabète`).
98
+ - Par défaut, `agg_func = COUNT(x)` compte les mentions et `post_func = x>=1` garde les patients avec
99
+ au moins une mention.
100
+ - Pour voir les formulations trouvées dans le tableau descriptif, utilisez par exemple
101
+ `variable_type = categorical`, `agg_func = FIRST(x)`, `post_func = x`.
102
+
103
+ ## Performances
104
+
105
+ L'analyse de texte est **beaucoup plus lente** que les autres blocs (plusieurs minutes sur toute la
106
+ base). Elle ne traite que les patients retenus par l'étape parente : placez ces blocs **le plus bas
107
+ possible** dans le flowchart.
@@ -0,0 +1,81 @@
1
+ # `RegexPatientObservation` : recherche dans les observations patient
2
+
3
+ {{ bloc_resume("RegexPatientObservation") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Recherche des mots ou expressions dans les **observations patient** du dossier : antécédents
8
+ médicaux et chirurgicaux, mode de vie, allergies, prévention… Par défaut, il garde les patients ayant
9
+ au moins une mention, hors négations et hypothèses.
10
+
11
+ Le fonctionnement des motifs, des pipelines `edsnlp.xxx` et des qualificatifs est décrit dans
12
+ [Recherche dans le texte libre](regex-nlp.md).
13
+
14
+ ## Données utilisées
15
+
16
+ | Table | Colonnes |
17
+ | --- | --- |
18
+ | `patient_observation` | `patient_id`, `patient_observation_id`, `patient_observation_label`, `patient_observation_value` |
19
+
20
+ ## Détail du calcul
21
+
22
+ - Seules les observations des rubriques listées dans `patient_observation_label` sont analysées.
23
+ - Une ligne par mention trouvée (hors qualificatifs écartés) ; `x` = le texte trouvé.
24
+ - Les observations ne sont **pas datées** : ce bloc n'a pas de `start_date` / `end_date`.
25
+
26
+ Rubriques disponibles pour `patient_observation_label` :
27
+
28
+ | Rubrique | Contenu | Analysée par défaut |
29
+ | --- | --- | --- |
30
+ | `medical_background_data` | Antécédents médicaux | Oui |
31
+ | `chirurgical_background_data` | Antécédents chirurgicaux | Oui |
32
+ | `lifestyle_data` | Mode de vie | Oui |
33
+ | `allergies_data` | Allergies | Oui |
34
+ | `prevention_data` | Prévention (vaccins, dépistages) | Oui |
35
+ | `family_background_data` | Antécédents familiaux | Non |
36
+ | `gynecologic_background_data` | Antécédents gynécologiques | Non |
37
+ | `gynecologic_monitoring_data` | Suivi gynécologique | Non |
38
+ | `pregnancies_data` | Grossesses | Non |
39
+ | `birth_data` | Naissance | Non |
40
+ | `smoking_pack_years` | Paquets-années (voir [`PaquetAnnees`](paquet-annees.md)) | Non |
41
+
42
+ ## Paramètres
43
+
44
+ {{ bloc_parametres("RegexPatientObservation") }}
45
+
46
+ ## Exemples
47
+
48
+ === "Inclusion : apnée du sommeil dans les antécédents"
49
+
50
+ | block_name | block_type | value | supplementary_params |
51
+ | --- | --- | --- | --- |
52
+ | `saos` | `RegexPatientObservation` | `apnee\w* du sommeil|saos` | `{"patient_observation_label": ["medical_background_data"]}` |
53
+
54
+ === "Inclusion : diabète (pipeline edsnlp)"
55
+
56
+ | block_name | block_type | value |
57
+ | --- | --- | --- |
58
+ | `diabete_texte` | `RegexPatientObservation` | `edsnlp.diabetes` |
59
+
60
+ === "Inclusion : allergie à la pénicilline"
61
+
62
+ | block_name | block_type | value | supplementary_params |
63
+ | --- | --- | --- | --- |
64
+ | `allergie_peni` | `RegexPatientObservation` | `penicilline|amoxicilline` | `{"patient_observation_label": ["allergies_data"]}` |
65
+
66
+ === "Tableau : antécédents familiaux de cancer du sein"
67
+
68
+ | block_name | block_type | variable_type | value | post_func | supplementary_params |
69
+ | --- | --- | --- | --- | --- | --- |
70
+ | `atcd_fam_sein` | `RegexPatientObservation` | `boolean` | `cancer du sein` | `COALESCE(x, 0) >= 1` | `{"patient_observation_label": ["family_background_data"], "qualifiers": ["negation", "hypothesis"]}` |
71
+
72
+ ## Points d'attention
73
+
74
+ - **Pas de `date_sql`** avec ce bloc : les observations n'ont pas de date. Il ne peut pas non plus
75
+ servir de `reference_date_block`.
76
+ - Le bloc ne tient pas compte de la date de référence : il lit l'état actuel du dossier, y compris des
77
+ informations ajoutées après cette date.
78
+ - Pour chercher dans les antécédents familiaux, ajoutez `family_background_data` **et** ne mettez pas
79
+ `family` dans `qualifiers` (sinon les mentions familiales sont écartées).
80
+ - Écrivez les motifs **sans accents**.
81
+ - Un `patient_observation_label` seul peut s'écrire comme un texte : `{"patient_observation_label": "lifestyle_data"}`.
@@ -0,0 +1,64 @@
1
+ # `RegexPrescription` : recherche textuelle dans les prescriptions
2
+
3
+ {{ bloc_resume("RegexPrescription") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Recherche des médicaments par leur **nom** dans les prescriptions (nom commercial ou dénomination
8
+ commune). C'est utile quand on ne connaît pas le code ATC ou qu'on veut cibler une spécialité
9
+ précise ; sinon, [`PrescriptionATC`](prescription-atc.md) est plus fiable et plus rapide.
10
+
11
+ Le fonctionnement des motifs, des pipelines `edsnlp.xxx` et des qualificatifs est décrit dans
12
+ [Recherche dans le texte libre](regex-nlp.md).
13
+
14
+ ## Données utilisées
15
+
16
+ | Table | Colonnes |
17
+ | --- | --- |
18
+ | `drug_prescription` | `patient_id`, `drug_prescription_id`, `drug_prescription_name`, `drug_prescription_common_name` |
19
+ | `drug_posology` | `drug_prescription_id`, `drug_posology_start_date`, `drug_posology_end_date` |
20
+
21
+ ## Détail du calcul
22
+
23
+ - Pour chaque prescription, le texte analysé est le nom commercial suivi de la dénomination commune
24
+ (une partie manquante est simplement ignorée).
25
+ - Une ligne par mention trouvée **et par ligne de posologie** ; `x` = le texte trouvé
26
+ (ex. `DOLIPRANE`).
27
+ - `start_date` / `end_date` = début / fin de la posologie : on peut filtrer dans le temps
28
+ (« traitement en cours à la date de référence »). Une fin vide (traitement en cours) vaut la date
29
+ du jour.
30
+
31
+ ## Paramètres
32
+
33
+ {{ bloc_parametres("RegexPrescription") }}
34
+
35
+ ## Exemples
36
+
37
+ === "Inclusion : paracétamol (nom commercial ou DCI)"
38
+
39
+ | block_name | block_type | value |
40
+ | --- | --- | --- |
41
+ | `paracetamol` | `RegexPrescription` | `["doliprane", "dafalgan", "efferalgan", "paracetamol"]` |
42
+
43
+ === "Inclusion : traitement en cours à la date de référence"
44
+
45
+ | block_name | block_type | value | date_sql |
46
+ | --- | --- | --- | --- |
47
+ | `levothyrox_en_cours` | `RegexPrescription` | `levothyrox` | `start_date <= reference_date AND end_date >= reference_date` |
48
+
49
+ === "Tableau : patients ayant eu de la metformine"
50
+
51
+ | block_name | block_type | variable_type | value | post_func |
52
+ | --- | --- | --- | --- | --- |
53
+ | `metformine` | `RegexPrescription` | `boolean` | `metformine` | `COALESCE(x, 0) >= 1` |
54
+
55
+ ## Points d'attention
56
+
57
+ - Écrivez les motifs **sans accents** ; la casse n'a pas d'importance (`doliprane` trouve
58
+ `DOLIPRANE`). Voir [Recherche dans le texte libre](regex-nlp.md#1-des-motifs-expressions-regulieres).
59
+ - Les prescriptions **sans posologie** sont ignorées.
60
+ - `COUNT(x)` compte les mentions × lignes de posologie, pas les prescriptions : une prescription
61
+ renouvelée avec deux posologies compte pour 2. Préférez un critère « au moins une »
62
+ (`x >= 1`).
63
+ - Les qualificatifs (négation, hypothèse…) ont peu de sens sur un nom de médicament ; ils restent
64
+ appliqués par défaut mais n'écartent en pratique rien.
@@ -0,0 +1,81 @@
1
+ # Utiliser l'application
2
+
3
+ L'application Requipso s'ouvre dans le navigateur (voir [Démarrage](demarrage.md#4-lancer-lapplication)).
4
+ Elle se lit de haut en bas : chaque section n'apparaît que lorsque la précédente est complète.
5
+
6
+ ## 1. Choisir le dossier de données
7
+
8
+ Le sélecteur **« choisir le dossier local contenant les données »** permet de naviguer dans vos
9
+ dossiers. Sélectionnez le dossier qui contient les fichiers `.parquet` (par ex. `patient.parquet`).
10
+
11
+ - Le sélecteur s'ouvre directement à côté du dernier dossier utilisé.
12
+ - Le chargement des données en mémoire prend quelques secondes à quelques minutes selon la machine.
13
+
14
+ ## 2. Choisir le Google Sheet
15
+
16
+ La liste **« choisir le Google Sheet »** affiche toutes les feuilles du dossier Drive Requipso. La
17
+ dernière feuille utilisée est présélectionnée.
18
+
19
+ Tant que le dossier et la feuille ne sont pas choisis, l'application affiche
20
+ « renseigner le dossier contenant les données et choisir le Google Sheet pour continuer ».
21
+
22
+ Une fois les deux choisis, l'application rappelle le dossier et un lien vers la feuille, et affiche
23
+ le bouton vert **« (re)lancer la pipeline »**.
24
+
25
+ ## 3. Lancer le calcul
26
+
27
+ Cliquez sur **« (re)lancer la pipeline »**. Requipso relit **à chaque clic** le contenu de la feuille :
28
+ vous pouvez donc modifier la feuille, puis recliquer, sans relancer l'application.
29
+
30
+ 1. **Inclusion** : une barre de progression `inclusion ...` affiche chaque étape et son effectif
31
+ (`bloc adultes : 52000 patients`). Le flowchart est ensuite dessiné et déposé sur le Drive.
32
+ 2. **Tableau descriptif** : une barre `tableau descriptif ...` affiche chaque variable calculée. Le
33
+ résultat est écrit dans l'onglet `🔒 Results` de la feuille.
34
+ 3. **Résultats** : l'application affiche les liens vers le tableau et le flowchart, puis le flowchart
35
+ et le tableau eux-mêmes.
36
+
37
+ !!! tip "Les blocs NLP sont plus lents"
38
+ Les blocs qui analysent du texte libre (`RegexConsultation`, `RegexPatientObservation`,
39
+ `PaquetAnnees`) peuvent prendre plusieurs minutes sur toute la base. Placez-les de préférence
40
+ **après** des étapes qui réduisent déjà la population : ils ne traitent que les patients retenus
41
+ par l'étape parente.
42
+
43
+ ### Recalcul automatique
44
+
45
+ Si l'onglet `Inclusion` n'a pas changé depuis le dernier calcul, l'application affiche
46
+ « pipeline déjà exécutée, pas de recalcul nécessaire » et ne recalcule que le tableau descriptif.
47
+ C'est pratique pour ajuster le tableau sans attendre l'inclusion.
48
+
49
+ Seul l'onglet `Inclusion` est surveillé. Si vous changez **uniquement** la date de référence (onglet
50
+ `Project`), **rechargez la page** du navigateur pour forcer un recalcul complet.
51
+
52
+ ### En cas d'erreur
53
+
54
+ Si quelque chose ne va pas dans la feuille, l'application affiche un encadré rouge avec le message
55
+ d'erreur. Le message utile est en général la **dernière ligne**. La page
56
+ [Erreurs fréquentes](erreurs.md) explique les messages les plus courants.
57
+
58
+ Le message « pipeline non exécutée, pas de tableau descriptif disponible » signifie que l'inclusion
59
+ n'a pas abouti : corrigez d'abord l'onglet `Inclusion`. Si l'inclusion réussit mais que le tableau
60
+ descriptif échoue, l'encadré rouge apparaît dans la section du tableau : corrigez l'onglet
61
+ `Descriptive_table` puis recliquez.
62
+
63
+ ## 4. Télécharger une liste de patients
64
+
65
+ Après un calcul réussi, la section **Liste de patients** permet d'exporter les patients retenus à
66
+ une étape :
67
+
68
+ 1. **« choisir l'étape »** : une étape de l'onglet `Inclusion` ;
69
+ 2. **« clé de permutation des ID patients (1Password) »** (optionnelle) : la clé numérique stockée
70
+ dans 1Password ;
71
+ 3. **« télécharger la liste des patients (CSV) »** : télécharge `patients.csv`.
72
+
73
+ | Colonne | Contenu |
74
+ | --- | --- |
75
+ | `patient_id` | Identifiant pseudonymisé (permuté avec la clé). Absente si aucune clé n'est saisie. |
76
+ | `shuffled_patient_id` | Identifiant interne RED d'origine. |
77
+ | `patient_identifier` | Trigramme du patient visible dans le dossier médical. |
78
+
79
+ !!! danger "Données identifiantes"
80
+ Ce fichier permet de retrouver les patients dans le dossier médical. Il doit être manipulé et
81
+ stocké selon les règles de protection des données de santé en vigueur.
@@ -0,0 +1,61 @@
1
+ # Combiner des blocs
2
+
3
+ Une étape (ou une variable) peut combiner **plusieurs blocs** avec `AND` (et) / `OR` (ou). Par exemple :
4
+ « diabète codé en CIM10 **OU** en CISP2 **OU** traitement antidiabétique ».
5
+
6
+ ## Comment écrire un groupe
7
+
8
+ Un groupe est une suite de **lignes consécutives** :
9
+
10
+ - la **première ligne** porte le `block_name` (et, dans l'onglet `Inclusion`, `parent_step`, `text`
11
+ et `excluded_text`) ;
12
+ - les **lignes suivantes** ont un `block_name` vide (ou identique) et un `operator` (`AND` ou `OR`) ;
13
+ - **chaque ligne** a son propre `block_type` et ses propres paramètres (`value`, `post_func`, `date_sql`…).
14
+
15
+ | block_name | operator | text | block_type | value | expose_date_for_future_references |
16
+ | --- | --- | --- | --- | --- | --- |
17
+ | `diabete` | | Patients diabétiques | `CIM10` | `E11` | ☑ |
18
+ | | `OR` | | `CISP2` | `T90` | ☑ |
19
+ | | `OR` | | `PrescriptionATC` | `A10` | ☐ |
20
+
21
+ Cette étape retient les patients qui ont un code CIM10 `E11…`, **ou** un code CISP2 `T90…`, **ou**
22
+ une prescription d'un médicament de classe ATC `A10…` (antidiabétiques).
23
+
24
+ Le groupe s'arrête à la première ligne qui porte un **nouveau** `block_name`.
25
+
26
+ ## Règles de calcul
27
+
28
+ - Chaque ligne est d'abord évaluée comme un bloc indépendant (vrai/faux), sur les mêmes patients.
29
+ Un patient sans valeur pour une ligne est considéré comme `FALSE` pour cette ligne.
30
+ - Les opérateurs sont appliqués **de haut en bas, sans priorité** :
31
+ `A OR B AND C` se lit `(A OR B) AND C`.
32
+ - Le résultat du groupe est vrai/faux : un groupe s'utilise donc comme une variable `boolean` dans
33
+ l'onglet `Descriptive_table`.
34
+
35
+ !!! tip "Exprimer `(A OR B) AND (C OR D)`"
36
+ Un groupe ne permet pas de parenthèses. Dans l'onglet `Inclusion`, utilisez deux étapes
37
+ successives : l'une `A OR B`, puis l'autre `C OR D` (enchaîner deux étapes revient à un `AND`).
38
+
39
+ ## Dates d'un groupe
40
+
41
+ Un groupe peut lui-même servir de `reference_date_block` à une étape ultérieure (ex. « dans l'année
42
+ qui suit le diagnostic de diabète, quelle qu'en soit la source »). La colonne
43
+ `expose_date_for_future_references` (case à cocher) choisit **quelles lignes fournissent leurs dates** :
44
+
45
+ - seules les lignes **cochées** fournissent des dates ;
46
+ - pour chaque ligne cochée, seules les dates des patients pour lesquels cette ligne est vraie sont gardées ;
47
+ - `reference_date_sql` (ex. `MIN(start_date)`) est ensuite calculé sur l'ensemble de ces dates.
48
+
49
+ Dans l'exemple ci-dessus, la date de référence « diabète » serait la plus ancienne date de code CIM10
50
+ ou CISP2, sans tenir compte des dates de prescription.
51
+
52
+ !!! warning "Cochez explicitement"
53
+ Dans un groupe, une case vide sur la première ligne signifie « non exposée », et une valeur autre
54
+ que `TRUE`/`FALSE` sur les lignes suivantes provoque une erreur
55
+ (`Invalid expose_date_for_future_references`). Utilisez des cases à cocher.
56
+
57
+ ## Ce que vous verrez dans le flowchart
58
+
59
+ Un groupe est **une seule boîte** du flowchart, avec le `text` de la première ligne. Les lignes
60
+ intermédiaires ne sont pas dessinées : elles sont calculées sous les noms `<block_name>_0`,
61
+ `<block_name>_1`, … (utile à savoir si un message d'erreur les mentionne).
@@ -0,0 +1,74 @@
1
+ # Démarrage
2
+
3
+ Cette page liste tout ce qu'il faut avant de construire sa première étude. La plupart de ces étapes
4
+ ne sont à faire qu'**une seule fois**.
5
+
6
+ ## 1. Les accès nécessaires
7
+
8
+ | Accès | Pourquoi |
9
+ | --- | --- |
10
+ | Dossier Google Drive Requipso | C'est là que vivent les Google Sheets des études et les flowcharts générés. |
11
+ | Données RED | Les fichiers de données sur lesquels tournent les requêtes. |
12
+ | 1Password | Mot de passe de déchiffrement des données et clé de permutation des identifiants patients. |
13
+
14
+ !!! warning "Données de santé"
15
+ Les données RED sont des données de santé à caractère personnel. Elles ne doivent jamais être
16
+ copiées en dehors des environnements autorisés, ni partagées par e-mail ou messagerie.
17
+
18
+ ## 2. Créer le Google Sheet de son étude
19
+
20
+ 1. Ouvrez le [dossier Drive Requipso](https://drive.google.com/drive/folders/1vTA1zVLbyU6mVMkiTL1J1bLolOlsut7A).
21
+ 2. Faites un clic droit sur la feuille nommée **template** puis **Créer une copie**.
22
+ 3. Renommez la copie avec un nom parlant (ex. `Diabète T2 - suivi 2024`). Ce nom sera affiché dans
23
+ l'application, et le flowchart sera enregistré sous `<nom de la feuille>.png` dans le même dossier.
24
+
25
+ !!! info "La feuille doit rester dans ce dossier"
26
+ Requipso ne « voit » que les feuilles présentes dans ce dossier Drive (il y accède avec votre
27
+ compte Google `@ipsosante.fr`). Une feuille déplacée ailleurs n'apparaîtra pas dans la liste de
28
+ l'application.
29
+
30
+ ## 3. Récupérer les données
31
+
32
+ Les données sont un dossier contenant un fichier `.parquet` par table de la base RED
33
+ (`patient.parquet`, `consultation.parquet`, `biometry.parquet`…). La procédure actuelle de
34
+ récupération (export depuis l'instance ETL, puis décompression avec le mot de passe
35
+ « Clé chiffrement export RED » stocké dans 1Password) est décrite dans le `README.md` du dépôt.
36
+
37
+ Après décompression, notez l'emplacement du dossier : vous le sélectionnerez dans l'application.
38
+
39
+ ## 4. Lancer l'application
40
+
41
+ L'application Requipso s'ouvre dans votre navigateur. Selon votre installation :
42
+
43
+ === "Sur votre poste"
44
+
45
+ Dans un terminal, à la racine du dépôt :
46
+
47
+ ```bash
48
+ uv run requipso
49
+ ```
50
+
51
+ Un onglet de navigateur s'ouvre automatiquement. Au premier lancement, un autre onglet vous
52
+ demande de vous connecter avec votre compte Google `@ipsosante.fr` et d'autoriser l'accès au
53
+ Drive ; cette étape n'est plus demandée ensuite.
54
+
55
+ === "Sur un environnement hébergé (Docker / Onyxia)"
56
+
57
+ L'image Docker démarre directement l'application sur le port `2718`.
58
+ Ouvrez l'URL du service fournie par la plateforme.
59
+
60
+ La suite (choix des données, de la feuille et lancement) est décrite dans
61
+ [Utiliser l'application](application.md).
62
+
63
+ ## 5. Et ensuite ?
64
+
65
+ Le parcours conseillé pour une première étude :
66
+
67
+ 1. Lire la [présentation du Google Sheet](google-sheet.md) ;
68
+ 2. Renseigner l'[onglet Project](onglet-projet.md) (date de référence) ;
69
+ 3. Construire le flowchart dans l'[onglet Inclusion](onglet-inclusion.md) ;
70
+ 4. Lancer une première fois l'application pour vérifier le flowchart ;
71
+ 5. Choisir les populations et remplir l'[onglet Descriptive_table](onglet-tableau-descriptif.md) ;
72
+ 6. Relancer et consulter les résultats.
73
+
74
+ L'[exemple complet](exemple-complet.md) déroule ce parcours sur une étude réelle.
@@ -0,0 +1,83 @@
1
+ # Erreurs fréquentes
2
+
3
+ Quand la feuille contient une erreur, l'application affiche un encadré rouge. Le message utile est en
4
+ général **la dernière ligne**. Cette page regroupe les messages les plus courants et leur solution.
5
+
6
+ !!! tip "Retrouver un message"
7
+ Utilisez la recherche de votre navigateur (++ctrl+f++ ou ++cmd+f++) avec un morceau du message
8
+ d'erreur.
9
+
10
+ ## Onglet `Project`
11
+
12
+ | Message | Cause et solution |
13
+ | --- | --- |
14
+ | `Reference date not found in 'Project' cell B1` | La cellule B1 est vide. Saisissez la date de référence. |
15
+ | `time data '…' does not match format '%d/%m/%Y'` | La date de B1 n'est pas au format `JJ/MM/AAAA`. Corrigez-la (ex. `31/12/2024`). |
16
+ | `Expected cell A2 of 'Project' to be 'Populations'` | La cellule A2 doit contenir exactement `Populations`. |
17
+ | `No populations found in 'Project' row 2` | Aucune population en B2, C2… Ajoutez au moins un nom d'étape. |
18
+ | `Populations {…} not found in inclusion pipeline` | Un nom de population ne correspond à aucun `block_name` de l'onglet `Inclusion` (attention aux majuscules et aux espaces). |
19
+
20
+ ## Structure des onglets
21
+
22
+ | Message | Cause et solution |
23
+ | --- | --- |
24
+ | `Missing required pipeline columns: […]` | Une colonne obligatoire a été renommée ou supprimée dans l'onglet `Inclusion`. Reprenez les en-têtes du template. |
25
+ | `Missing required descriptive columns: […]` | Idem pour l'onglet `Descriptive_table`. |
26
+ | `Sheet is empty` / `Descriptive sheet … is empty` | Aucune ligne n'a de `block_type`. |
27
+ | `Spreadsheet … not found` | La feuille n'est plus dans le dossier Drive Requipso. |
28
+
29
+ ## Noms d'étapes et références
30
+
31
+ | Message | Cause et solution |
32
+ | --- | --- |
33
+ | `Unknown block type: '…'. Available: […]` | Le `block_type` est mal orthographié. La liste des blocs valides est affichée dans le message (et dans le [catalogue](../blocs/index.md)). |
34
+ | `Step … already exists` | Deux étapes portent le même `block_name`. Les noms doivent être uniques. |
35
+ | `Step … already exists in inclusion pipeline, use a different name` | Une variable de `Descriptive_table` porte le nom d'une étape d'`Inclusion`. Renommez la variable. |
36
+ | `Parent step None not found` | Le `parent_step` ne correspond à aucune étape **située plus haut**. Vérifiez l'orthographe et l'ordre des lignes. |
37
+ | `A parent step is not permitted for the first step` | La première étape ne doit pas avoir de `parent_step`. |
38
+ | `reference_date_block '…' not found — it must appear earlier in the sheet.` | Le bloc de référence n'existe pas ou est défini plus bas. Déplacez-le au-dessus. |
39
+ | `KeyError: 'dates'` | Le `reference_date_block` désigne un bloc **sans dates** (ex. `Genre`), ou un groupe dont aucune ligne n'est cochée dans `expose_date_for_future_references`. |
40
+
41
+ ## Groupes de lignes
42
+
43
+ | Message | Cause et solution |
44
+ | --- | --- |
45
+ | `Invalid operator None in block '…'` | Une ligne sans `block_name` est rattachée au groupe précédent mais n'a pas d'`operator`. Soit vous avez oublié le `block_name` d'une nouvelle étape, soit l'opérateur manque. |
46
+ | `Invalid operator 'and' in block '…'` | L'opérateur doit être `AND` ou `OR`, en majuscules. |
47
+ | `Invalid expose_date_for_future_references … in block '…'` | Sur les lignes 2, 3… d'un groupe, la colonne doit être une case à cocher (`TRUE`/`FALSE`). |
48
+
49
+ ## Paramètres
50
+
51
+ | Message | Cause et solution |
52
+ | --- | --- |
53
+ | `Field required` (sur `value`) | Ce bloc exige une `value` (ex. `Biometry` : le libellé de la mesure). |
54
+ | `Input should be a valid list` (sur `value`) | La valeur a été lue comme un nombre (ex. code postal seul). Écrivez-la sous forme de liste : `["75011"]`. Voir [value](parametres.md#value-la-valeur-principale). |
55
+ | `Extra inputs are not permitted` | Un nom de paramètre de `supplementary_params` n'existe pas pour ce bloc. Vérifiez la fiche du bloc. |
56
+ | `Must contain 'start_date' or 'end_date'` | `date_sql` ou `reference_date_sql` ne mentionne aucune date. |
57
+ | `cannot compare 'date/datetime/time' to a string value` | Une date fixe est écrite comme un texte. Écrivez `DATE '2024-01-01'`. |
58
+ | `unsupported function 'mean'` | Utilisez `AVG(x)`. Voir les [fonctions disponibles](parametres.md#agg_func-resumer-plusieurs-evenements). |
59
+ | `SQLSyntaxError` / `SQLInterfaceError` | La formule `agg_func`, `post_func` ou `date_sql` est mal écrite (parenthèse, guillemet ou mot-clé manquant). |
60
+ | `Specified edsnlp pipe '…' not found in edsnlp.pipes.` | Le nom après `edsnlp.` ne correspond à aucun pipeline NLP. Voir [Recherche dans le texte libre](../blocs/regex-nlp.md). |
61
+
62
+ ## Tableau descriptif
63
+
64
+ | Message | Cause et solution |
65
+ | --- | --- |
66
+ | `Invalid variable_type '…'` | `variable_type` doit valoir `boolean`, `numerical` ou `categorical`. |
67
+ | `Column … is not numeric (got Boolean), but variable_type is numerical. Maybe check post_func ?` | La valeur par défaut de `post_func` transforme le nombre en vrai/faux. Écrivez `post_func = x`. |
68
+ | `Column … is not boolean (got …), but variable_type is boolean.` | La valeur finale n'est pas vrai/faux. Ajoutez une condition dans `post_func` (ex. `x >= 1`) ou changez `variable_type`. |
69
+
70
+ ## Les effectifs semblent faux
71
+
72
+ Pas de message d'erreur, mais un résultat surprenant ? Quelques pistes :
73
+
74
+ - **Une étape à 0 patient** : vérifiez la `value` (codes avec la bonne casse, ex. `E11` et non `e11`),
75
+ et le `date_sql` (une période trop étroite).
76
+ - **Un `date_sql` sans effet** : sur un bloc sans dates (`Genre`, `Departement`, `CodePostal`,
77
+ `RegexPatientObservation`), `date_sql` est ignoré sans message d'erreur.
78
+ - **Trop de patients exclus après une branche** : un `parent_step` vide désigne l'étape écrite juste
79
+ au-dessus, pas forcément celle de votre branche.
80
+ - **Beaucoup de `missing`** dans le tableau : c'est normal pour les blocs qui comptent des événements,
81
+ voir [`COALESCE`](onglet-tableau-descriptif.md#boolean).
82
+ - **La date de référence a changé mais pas les effectifs** : rechargez la page de l'application
83
+ (voir [Recalcul automatique](application.md#recalcul-automatique)).
@@ -0,0 +1,67 @@
1
+ # Exemple complet
2
+
3
+ Cet exemple construit une étude de bout en bout : **les adultes diabétiques de type 2 suivis en
4
+ médecin traitant renforcé (MTR) au 31/12/2024**, et leur description.
5
+
6
+ ## 1. Onglet `Project`
7
+
8
+ | | A | B | C | D |
9
+ | --- | --- | --- | --- | --- |
10
+ | **1** | Date de référence | `31/12/2024` | | |
11
+ | **2** | `Populations` | `adultes` | `diabete` | `diabete_mtr` |
12
+
13
+ Les populations sont renseignées en dernier, une fois les étapes d'inclusion nommées.
14
+
15
+ ## 2. Onglet `Inclusion`
16
+
17
+ | block_name | parent_step | operator | text | excluded_text | block_type | value | date_sql | expose_date_for_future_references |
18
+ | --- | --- | --- | --- | --- | --- | --- | --- | --- |
19
+ | `vivants` | | | Patients vivants au 31/12/2024 | Décédés | `EstVivant` | | | |
20
+ | `adultes` | | | Patients majeurs | Mineurs | `Age` | | | |
21
+ | `diabete` | | | Diabète de type 2 | Sans diabète T2 | `CIM10` | `E11` | `start_date <= reference_date` | ☑ |
22
+ | | | `OR` | | | `CISP2` | `T90` | `start_date <= reference_date` | ☑ |
23
+ | | | `OR` | | | `PrescriptionATC` | `A10B` | `start_date <= reference_date` | ☐ |
24
+ | `diabete_mtr` | | | Suivis en MTR au 31/12/2024 | Sans MTR | `MedecinTraitant` | | `start_date <= reference_date AND end_date >= reference_date` | |
25
+
26
+ Ce qu'il faut remarquer :
27
+
28
+ - `vivants` et `adultes` utilisent les valeurs par défaut (`post_func` = `x` et `x>=18`), calculées à la
29
+ date de référence.
30
+ - `diabete` est un [groupe](combiner-blocs.md) : code CIM10 `E11…` **ou** code CISP2 `T90…` **ou**
31
+ antidiabétique non insulinique (ATC `A10B…`). Seuls les codes fournissent leur date (cases cochées),
32
+ pour pouvoir dater le diagnostic plus loin.
33
+ - `diabete_mtr` utilise le paramètre par défaut `mtr_only = true` de `MedecinTraitant` et ne garde que
34
+ les périodes de MTR **en cours** à la date de référence.
35
+
36
+ Premier lancement : vérifiez le flowchart et les effectifs avant d'aller plus loin.
37
+
38
+ ## 3. Onglet `Descriptive_table`
39
+
40
+ | block_name | block_type | variable_type | variable_description | value | post_func | date_sql | reference_date_block | subsets |
41
+ | --- | --- | --- | --- | --- | --- | --- | --- | --- |
42
+ | `age` | `Age` | `numerical` | Âge (années) | | `x` | | | `[18, 45, 65, 75]` |
43
+ | `genre` | `Genre` | `categorical` | Genre | | `x` | | | `["féminin", "masculin"]` |
44
+ | `imc` | `Biometry` | `numerical` | Dernier IMC connu | `bmi` | | `start_date <= reference_date` | | `[0, 18.5, 25, 30]` |
45
+ | `hta` | `CIM10` | `boolean` | Hypertension | `I10` | `COALESCE(x, 0) >= 1` | `start_date <= reference_date` | | |
46
+ | `nb_cs_12m` | `Consultations` | `numerical` | Consultations sur 12 mois | | `COALESCE(x, 0)` | `start_date >= reference_date - INTERVAL '1 year' AND start_date <= reference_date` | | |
47
+ | `cs_post_diag` | `Consultations` | `boolean` | Consultation dans l'année suivant le diagnostic | | `COALESCE(x, 0) >= 1` | `start_date >= reference_date AND start_date <= reference_date + INTERVAL '1 year'` | `diabete` | |
48
+
49
+ Ce qu'il faut remarquer :
50
+
51
+ - `post_func = x` pour garder l'âge et le genre bruts (sinon on obtiendrait `x>=18` et `x='féminin'`).
52
+ - `imc` : `Biometry` garde par défaut la **dernière** mesure (`agg_func = LAST(x)`) et la valeur brute
53
+ (`post_func = x`) ; le `date_sql` limite aux mesures antérieures à la date de référence.
54
+ - `hta` et `cs_post_diag` utilisent `COALESCE` pour compter comme « non » les patients sans événement.
55
+ - `cs_post_diag` prend comme date de référence, pour chaque patient, la **première date** de code
56
+ diabète (CIM10 ou CISP2) de l'étape `diabete`. Pour les patients de la population `adultes` non
57
+ diabétiques, il n'y a pas de date : ils sont comptés comme « non ».
58
+
59
+ ## 4. Lancer et lire les résultats
60
+
61
+ Cliquez sur **« (re)lancer la pipeline »**. Comme l'onglet `Inclusion` n'a pas changé depuis le
62
+ premier lancement, seul le tableau descriptif est recalculé. Le tableau apparaît dans l'onglet
63
+ `🔒 Results` avec trois colonnes (`adultes`, `diabete`, `diabete_mtr`) et, pour chaque variable, les
64
+ statistiques décrites dans [Onglet Descriptive_table](onglet-tableau-descriptif.md#les-statistiques-calculees).
65
+
66
+ Enfin, exportez si besoin la liste des patients de `diabete_mtr` depuis la section
67
+ **Liste de patients** de l'application.