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,59 @@
1
+ # `CISP2` : antécédents codés en CISP2
2
+
3
+ {{ bloc_resume("CISP2") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Recherche dans les **antécédents** du patient les pathologies correspondant à des codes CISP2
8
+ (Classification internationale des soins primaires). Il fonctionne exactement comme
9
+ [`CIM10`](cim10.md), avec la terminologie CISP2.
10
+
11
+ ## Données utilisées
12
+
13
+ | Table | Colonnes | Rôle |
14
+ | --- | --- | --- |
15
+ | `concept` | `concept_id`, `concept_code`, `concept_vocabulary` | Codes CISP2 (`cisp`) et pathologies ipso (`ipso_pathology`). |
16
+ | `concept_relationship` | `concept_id_1`, `concept_id_2` | Correspondance CISP2 → pathologie ipso. |
17
+ | `patient_condition` | `patient_id`, `patient_condition_id`, `patient_observation_id`, `condition_concept_id`, `condition_concept_type` | Pathologies reconnues dans les antécédents. |
18
+ | `patient_observation` | `patient_observation_id`, `patient_observation_label` | Rubrique du dossier où l'antécédent est écrit. |
19
+ | `patient_condition_date` | `patient_condition_id`, `patient_condition_date` | Dates associées à chaque antécédent. |
20
+
21
+ ## Détail du calcul
22
+
23
+ 1. Les codes CISP2 qui **commencent par** l'un des codes de `value` sont sélectionnés (`T9` trouve
24
+ `T90`, `T93`…). La recherche respecte les majuscules.
25
+ 2. Ils sont traduits en pathologies ipso, puis les antécédents correspondants des patients sont gardés
26
+ (type `pathology`, rubriques antécédents médicaux, chirurgicaux ou gynécologiques).
27
+ 3. `x` = le code CISP2 ; `agg_func = COUNT(x)` compte les antécédents trouvés.
28
+ 4. `start_date` / `end_date` = plus ancienne / plus récente date associée à l'antécédent.
29
+
30
+ ## Paramètres
31
+
32
+ {{ bloc_parametres("CISP2") }}
33
+
34
+ ## Exemples
35
+
36
+ === "Inclusion : diabète non insulino-dépendant"
37
+
38
+ | block_name | block_type | value |
39
+ | --- | --- | --- |
40
+ | `diabete_cisp` | `CISP2` | `T90` |
41
+
42
+ === "Inclusion : diabète codé en CIM10 ou CISP2"
43
+
44
+ | block_name | operator | block_type | value |
45
+ | --- | --- | --- | --- |
46
+ | `diabete` | | `CIM10` | `E11` |
47
+ | | `OR` | `CISP2` | `T90` |
48
+
49
+ === "Tableau : % avec HTA (K86/K87)"
50
+
51
+ | block_name | block_type | variable_type | value | post_func |
52
+ | --- | --- | --- | --- | --- |
53
+ | `hta_cisp` | `CISP2` | `boolean` | `K86|K87` | `COALESCE(x, 0) >= 1` |
54
+
55
+ ## Points d'attention
56
+
57
+ Les mêmes que pour [`CIM10`](cim10.md#points-dattention). Comme chaque pathologie ipso est reliée à
58
+ la fois à un code CIM10 et à un code CISP2, les deux blocs trouvent souvent les mêmes patients :
59
+ combinez-les en `OR` pour être exhaustif.
@@ -0,0 +1,47 @@
1
+ # `CodePostal` : code postal de résidence
2
+
3
+ {{ bloc_resume("CodePostal") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Garde les patients dont le code postal de résidence fait partie d'une liste.
8
+
9
+ ## Données utilisées
10
+
11
+ | Table | Colonnes |
12
+ | --- | --- |
13
+ | `patient` | `patient_id`, `patient_residence_postal_code` |
14
+
15
+ ## Détail du calcul
16
+
17
+ - Si `value` est renseignée (ex. `75011|75012`), seuls les patients dont le code postal est
18
+ **exactement** l'un de ces codes sont gardés.
19
+ - Si `value` est vide, tous les patients ayant un code postal sont gardés.
20
+ - `x` = le code postal. Par défaut, `post_func = x IS NOT NULL`.
21
+
22
+ ## Paramètres
23
+
24
+ {{ bloc_parametres("CodePostal") }}
25
+
26
+ ## Exemples
27
+
28
+ === "Inclusion : deux arrondissements"
29
+
30
+ | block_name | block_type | value |
31
+ | --- | --- | --- |
32
+ | `paris_11_12` | `CodePostal` | `75011|75012` |
33
+
34
+ === "Tableau : codes postaux"
35
+
36
+ | block_name | block_type | variable_type | post_func |
37
+ | --- | --- | --- | --- |
38
+ | `cp` | `CodePostal` | `categorical` | `x` |
39
+
40
+ ## Points d'attention
41
+
42
+ - La correspondance est exacte : `7501` ne trouve pas `75011`. Pour un préfixe, utilisez
43
+ [`Departement`](departement.md) ou `post_func = x LIKE '750%'` avec `value` vide.
44
+ - Écrivez les codes avec leur zéro initial (`06000`, pas `6000`). Pour un code **seul**, préférez
45
+ la forme liste `["06000"]` : un nombre isolé peut perdre son zéro ou provoquer l'erreur
46
+ `Input should be a valid list` (voir [value](../guide/parametres.md#value-la-valeur-principale)).
47
+ - Ce bloc n'a pas de date : pas de `date_sql`.
@@ -0,0 +1,65 @@
1
+ # `Consultations` : consultations
2
+
3
+ {{ bloc_resume("Consultations") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Renvoie les consultations du patient, éventuellement filtrées par motif, statut, centre ou
8
+ professionnel. Par défaut, il compte les consultations **terminées** et garde les patients qui en ont
9
+ au moins une.
10
+
11
+ ## Données utilisées
12
+
13
+ | Table | Colonnes |
14
+ | --- | --- |
15
+ | `consultation` | `patient_id`, `consultation_id`, `consultation_motive_category_label`, `consultation_status_label`, `consultation_start_datetime`, `consultation_end_datetime`, `medical_center_id`, `health_professional_id` |
16
+ | `medical_center` | `medical_center_id`, `medical_center_initials` |
17
+ | `health_professional` | `health_professional_id`, `health_professional_first_name`, `health_professional_last_name` |
18
+
19
+ ## Détail du calcul
20
+
21
+ - Une ligne par consultation ; `x` = `TRUE`. `agg_func = COUNT(x)` compte les consultations.
22
+ - `start_date` / `end_date` = date et heure de début / fin de la consultation.
23
+ - Les filtres de `supplementary_params` s'additionnent (une consultation doit tous les respecter) :
24
+
25
+ | Paramètre | Filtre | Valeurs possibles (exemples) |
26
+ | --- | --- | --- |
27
+ | `consultation_status_label` | Statut. **Par défaut `["Ended"]`.** | `Ended`, `Canceled`, `Planned`, `Waiting`… |
28
+ | `consultation_motive_category_label` | Catégorie de motif. | `médecine générale adulte`, `santé de la femme`, `enfant et nourrisson`, `femme enceinte et jeune maman`, `sage-femme`, `programme Médecin Traitant Renforcé`, `addictologie`, `nutrition`… |
29
+ | `medical_center_initials` | Centre ipso (initiales). | `StM`, `Nat`, `Our`, `Ita`, `RiL`, `Bro`, `Men`, `StH`, `SMi`, `Bor` |
30
+ | `health_professional_names` | Professionnel, au format `Prénom Nom`. | `Marie Dupont` |
31
+
32
+ La liste complète des valeurs est dans [`RED.dbml`](../technique/donnees.md).
33
+
34
+ ## Paramètres
35
+
36
+ {{ bloc_parametres("Consultations") }}
37
+
38
+ ## Exemples
39
+
40
+ === "Inclusion : consultation dans l'année"
41
+
42
+ | block_name | block_type | date_sql |
43
+ | --- | --- | --- |
44
+ | `cs_12m` | `Consultations` | `start_date >= reference_date - INTERVAL '1 year' AND start_date <= reference_date` |
45
+
46
+ === "Inclusion : au moins 3 consultations de médecine générale"
47
+
48
+ | block_name | block_type | post_func | supplementary_params |
49
+ | --- | --- | --- | --- |
50
+ | `mg_3cs` | `Consultations` | `x >= 3` | `{"consultation_motive_category_label": ["médecine générale adulte"]}` |
51
+
52
+ === "Tableau : nombre de consultations sur 12 mois"
53
+
54
+ | block_name | block_type | variable_type | post_func | date_sql |
55
+ | --- | --- | --- | --- | --- |
56
+ | `nb_cs` | `Consultations` | `numerical` | `COALESCE(x, 0)` | `start_date >= reference_date - INTERVAL '1 year' AND start_date <= reference_date` |
57
+ ## Points d'attention
58
+
59
+ - Les filtres attendent des **listes** : `{"medical_center_initials": ["StM"]}`, pas `"StM"`.
60
+ - Pour compter aussi les consultations annulées, remplacez le statut :
61
+ `{"consultation_status_label": ["Ended", "Canceled"]}`.
62
+ - Une partie des consultations n'a pas d'heure de début renseignée (surtout les consultations
63
+ annulées) : elles sont éliminées par tout `date_sql` portant sur `start_date`.
64
+ - Pour le nombre de consultations dans le tableau descriptif, utilisez `COALESCE(x, 0)` : sans cela,
65
+ les patients sans consultation ont une valeur vide et sont exclus de la moyenne.
@@ -0,0 +1,50 @@
1
+ # `Departement` : département de résidence
2
+
3
+ {{ bloc_resume("Departement") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Garde les patients qui résident dans un ou plusieurs départements, d'après les **deux premiers
8
+ caractères** de leur code postal.
9
+
10
+ ## Données utilisées
11
+
12
+ | Table | Colonnes |
13
+ | --- | --- |
14
+ | `patient` | `patient_id`, `patient_residence_postal_code` |
15
+
16
+ ## Détail du calcul
17
+
18
+ - Si `value` est renseignée (ex. `75|92|93|94`), seuls les patients dont le code postal commence par
19
+ l'un de ces numéros sont gardés.
20
+ - Si `value` est vide, tous les patients ayant un code postal sont gardés.
21
+ - `x` = le **code postal complet** (ex. `75011`), pas le numéro de département.
22
+ - Par défaut, `post_func = x IS NOT NULL` : vrai pour les patients du ou des départements demandés.
23
+
24
+ ## Paramètres
25
+
26
+ {{ bloc_parametres("Departement") }}
27
+
28
+ ## Exemples
29
+
30
+ === "Inclusion : Paris et petite couronne"
31
+
32
+ | block_name | block_type | value |
33
+ | --- | --- | --- |
34
+ | `idf_centre` | `Departement` | `75|92|93|94` |
35
+
36
+ === "Tableau : répartition par département"
37
+
38
+ | block_name | block_type | variable_type | post_func |
39
+ | --- | --- | --- | --- |
40
+ | `dept` | `Departement` | `categorical` | `SUBSTR(x, 1, 2)` |
41
+
42
+ ## Points d'attention
43
+
44
+ - Le filtre porte sur les **2 premiers caractères** : les départements d'outre-mer (`971`, `972`…)
45
+ sont tous regroupés sous `97`. Utilisez [`CodePostal`](code-postal.md) pour plus de précision.
46
+ - Pour la Corse, les codes postaux commencent par `20` (pas `2A`/`2B`).
47
+ - Pour un département **seul**, écrivez `["75"]` ou `["06"]` plutôt que `75` : un nombre isolé peut
48
+ perdre son zéro ou provoquer l'erreur `Input should be a valid list`.
49
+ - Environ 7 % des patients n'ont pas de code postal renseigné.
50
+ - Ce bloc n'a pas de date : pas de `date_sql`.
@@ -0,0 +1,44 @@
1
+ # `EstVivant` : patient vivant
2
+
3
+ {{ bloc_resume("EstVivant") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Indique si le patient est **vivant à la date de référence**. C'est en général la première étape d'un
8
+ flowchart d'inclusion.
9
+
10
+ ## Données utilisées
11
+
12
+ | Table | Colonnes |
13
+ | --- | --- |
14
+ | `patient` | `patient_id`, `patient_death_date` |
15
+
16
+ ## Détail du calcul
17
+
18
+ - `x` = `TRUE` si le patient n'a pas de date de décès, ou si la date de référence est **antérieure** à
19
+ sa date de décès ; `FALSE` sinon.
20
+ - La date de décès est exposée comme `start_date` = `end_date` (vide pour les patients vivants).
21
+
22
+ ## Paramètres
23
+
24
+ {{ bloc_parametres("EstVivant") }}
25
+
26
+ ## Exemples
27
+
28
+ === "Inclusion : vivants"
29
+
30
+ | block_name | text | excluded_text | block_type |
31
+ | --- | --- | --- | --- |
32
+ | `vivants` | Patients vivants | Décédés | `EstVivant` |
33
+
34
+ === "Tableau : % de décès"
35
+
36
+ | block_name | block_type | variable_type | post_func |
37
+ | --- | --- | --- | --- |
38
+ | `deces` | `EstVivant` | `boolean` | `NOT x` |
39
+
40
+ ## Points d'attention
41
+
42
+ - **N'utilisez pas `date_sql` avec ce bloc** : il filtrerait sur la date de décès, ce qui éliminerait
43
+ tous les patients vivants (qui n'en ont pas).
44
+ - Le statut vital dépend de la qualité de la saisie de la date de décès dans le dossier médical.
@@ -0,0 +1,46 @@
1
+ # `Genre` : genre déclaré
2
+
3
+ {{ bloc_resume("Genre") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Renvoie le genre déclaré du patient. Par défaut, il garde les patientes (`x=='féminin'`).
8
+
9
+ ## Données utilisées
10
+
11
+ | Table | Colonnes |
12
+ | --- | --- |
13
+ | `patient` | `patient_id`, `patient_gender_label` |
14
+
15
+ ## Détail du calcul
16
+
17
+ `x` = le libellé du genre, parmi : `féminin`, `masculin`, `non genré`.
18
+
19
+ ## Paramètres
20
+
21
+ {{ bloc_parametres("Genre") }}
22
+
23
+ ## Exemples
24
+
25
+ === "Inclusion : femmes"
26
+
27
+ | block_name | block_type | post_func |
28
+ | --- | --- | --- |
29
+ | `femmes` | `Genre` | |
30
+
31
+ === "Inclusion : hommes"
32
+
33
+ | block_name | block_type | post_func |
34
+ | --- | --- | --- |
35
+ | `hommes` | `Genre` | `x = 'masculin'` |
36
+
37
+ === "Tableau : répartition"
38
+
39
+ | block_name | block_type | variable_type | post_func | subsets |
40
+ | --- | --- | --- | --- | --- |
41
+ | `genre` | `Genre` | `categorical` | `x` | `["féminin", "masculin", "non genré"]` |
42
+
43
+ ## Points d'attention
44
+
45
+ - Les libellés sont en minuscules et accentués : `'féminin'`, pas `'Féminin'` ni `'feminin'`.
46
+ - Ce bloc n'a pas de date : pas de `date_sql`.
@@ -0,0 +1,40 @@
1
+ # Catalogue des blocs
2
+
3
+ Un **bloc** est une brique de requête : il lit une ou plusieurs tables de la base RED et calcule une
4
+ valeur par patient. Le nom du bloc est ce que l'on écrit dans la colonne `block_type` du Google Sheet.
5
+
6
+ Le tableau ci-dessous est généré automatiquement à partir du code : il liste toujours les blocs
7
+ réellement disponibles.
8
+
9
+ {{ blocs_tableau() }}
10
+
11
+ ## Deux familles de blocs
12
+
13
+ **Les blocs « patient »** lisent une information unique par patient (date de naissance, genre,
14
+ code postal…). Ils n'ont pas besoin d'`agg_func`.
15
+
16
+ **Les blocs « événement »** lisent des données qui peuvent apparaître plusieurs fois par patient
17
+ (consultations, prescriptions, antécédents, mesures…). Ils produisent une ligne par événement, puis
18
+ `agg_func` les résume en une valeur par patient (par défaut, souvent `COUNT(x)` : le nombre
19
+ d'événements).
20
+
21
+ La colonne **Daté** indique si le bloc fournit des dates (`start_date` / `end_date`) : seuls ces blocs
22
+ acceptent un `date_sql` et peuvent servir de `reference_date_block`.
23
+
24
+ ## Lire une fiche de bloc
25
+
26
+ Chaque fiche suit le même plan :
27
+
28
+ 1. **Fiche du bloc** (encadré généré depuis le code) : nom exact, niveau patient/événement, type de la
29
+ valeur produite, dates fournies.
30
+ 2. **Ce que fait le bloc**, en une phrase.
31
+ 3. **Données utilisées** : les tables et colonnes de la base RED lues par le bloc.
32
+ 4. **Détail du calcul** : ce que contient `x` et comment les lignes sont filtrées.
33
+ 5. **Paramètres** (tableaux générés depuis le code) : valeurs par défaut des colonnes communes et
34
+ paramètres spécifiques à mettre dans `supplementary_params`.
35
+ 6. **Exemples** de lignes à copier dans le Google Sheet.
36
+ 7. **Points d'attention**.
37
+
38
+ Pour le fonctionnement général des colonnes `value`, `agg_func`, `post_func` et `date_sql`, voir
39
+ [Paramètres des blocs](../guide/parametres.md). Les blocs qui recherchent dans le texte libre partagent
40
+ une page commune : [Recherche dans le texte libre](regex-nlp.md).
@@ -0,0 +1,55 @@
1
+ # `Insurance` : couverture d'assurance maladie
2
+
3
+ {{ bloc_resume("Insurance") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Renvoie les droits d'assurance maladie du patient (AMO, complémentaire, C2S, AME…) correspondant aux
8
+ types demandés. Par défaut, il garde les patients ayant au moins un de ces droits.
9
+
10
+ ## Données utilisées
11
+
12
+ | Table | Colonnes |
13
+ | --- | --- |
14
+ | `patient_insurance` | `patient_id`, `patient_insurance_type_label`, `patient_insurance_start_date`, `patient_insurance_end_date` |
15
+
16
+ ## Détail du calcul
17
+
18
+ - Les types de `value` sont comparés **exactement** au libellé du droit.
19
+ - Une ligne par droit ; `x` = le libellé. `agg_func = COUNT(x)` compte les droits.
20
+ - `start_date` / `end_date` = début / fin du droit (fin vide = droit en cours, date du jour).
21
+
22
+ Libellés disponibles : `AMO`, `Complémentaire santé`, `ALD`, `C2S`, `Accident du travail`,
23
+ `Maternité`, `CMU`, `AME`, `Autre droit 100%`, `ACS`, `SMG`.
24
+
25
+ ## Paramètres
26
+
27
+ {{ bloc_parametres("Insurance") }}
28
+
29
+ ## Exemples
30
+
31
+ === "Inclusion : bénéficiaires C2S ou AME"
32
+
33
+ | block_name | block_type | value |
34
+ | --- | --- | --- |
35
+ | `precarite` | `Insurance` | `C2S|AME` |
36
+
37
+ === "Inclusion : droit en cours à la date de référence"
38
+
39
+ | block_name | block_type | value | date_sql |
40
+ | --- | --- | --- | --- |
41
+ | `c2s_active` | `Insurance` | `C2S` | `start_date <= reference_date AND end_date >= reference_date` |
42
+
43
+ === "Tableau : % avec complémentaire santé"
44
+
45
+ | block_name | block_type | variable_type | value | post_func |
46
+ | --- | --- | --- | --- | --- |
47
+ | `complementaire` | `Insurance` | `boolean` | `Complémentaire santé` | `COALESCE(x, 0) >= 1` |
48
+
49
+ ## Points d'attention
50
+
51
+ - `value` est **obligatoire en pratique** : vide, le bloc ne trouve aucun droit.
52
+ - Respectez exactement les libellés (majuscules, accents) : `Complémentaire santé`, pas
53
+ `complementaire sante`.
54
+ - Une petite partie des droits n'a pas de date de début : ils sont éliminés par un `date_sql` portant
55
+ sur `start_date`.
@@ -0,0 +1,56 @@
1
+ # `MedecinTraitant` : médecin traitant (MT / MTR)
2
+
3
+ {{ bloc_resume("MedecinTraitant") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Renvoie les **périodes** pendant lesquelles le patient a eu un médecin traitant ipso. Par défaut,
8
+ seules les périodes de **médecin traitant renforcé** (MTR) sont prises en compte, et le bloc garde les
9
+ patients ayant au moins une période.
10
+
11
+ ## Données utilisées
12
+
13
+ | Table | Colonnes |
14
+ | --- | --- |
15
+ | `regular_doctor_history` | `patient_id`, `health_professional_id`, `regular_doctor_is_external`, `regular_doctor_is_mtr`, `regular_doctor_start_date`, `regular_doctor_end_date` |
16
+
17
+ ## Détail du calcul
18
+
19
+ - Les périodes sans médecin identifié (`health_professional_id` vide) sont ignorées.
20
+ - Si `include_external` est faux (défaut), les médecins traitants **externes** à ipso sont ignorés.
21
+ - Si `mtr_only` est vrai (défaut), seules les périodes **MTR** sont gardées ; sinon MT classiques et
22
+ MTR sont gardés.
23
+ - Une ligne par période ; `x` = `TRUE`. `agg_func = COUNT(x)` compte les périodes.
24
+ - `start_date` / `end_date` = début / fin de la période. Une période en cours (sans date de fin) a
25
+ pour `end_date` la date du jour.
26
+
27
+ ## Paramètres
28
+
29
+ {{ bloc_parametres("MedecinTraitant") }}
30
+
31
+ ## Exemples
32
+
33
+ === "Inclusion : en MTR à la date de référence"
34
+
35
+ | block_name | block_type | date_sql |
36
+ | --- | --- | --- |
37
+ | `mtr` | `MedecinTraitant` | `start_date <= reference_date AND end_date >= reference_date` |
38
+
39
+ === "Inclusion : MT ou MTR ipso, à un moment quelconque"
40
+
41
+ | block_name | block_type | supplementary_params |
42
+ | --- | --- | --- |
43
+ | `mt_ipso` | `MedecinTraitant` | `{"mtr_only": false}` |
44
+
45
+ === "Tableau : % ayant déclaré un MT (y compris externe)"
46
+
47
+ | block_name | block_type | variable_type | post_func | supplementary_params |
48
+ | --- | --- | --- | --- | --- |
49
+ | `a_un_mt` | `MedecinTraitant` | `boolean` | `COALESCE(x, 0) >= 1` | `{"mtr_only": false, "include_external": true}` |
50
+
51
+ ## Points d'attention
52
+
53
+ - **Sans `date_sql`, le bloc regarde toute l'histoire du patient**, y compris après la date de
54
+ référence. Pour « en MTR à la date de référence », utilisez le filtre ci-dessus.
55
+ - La date de début d'un MTR peut servir de date de référence pour la suite
56
+ (`reference_date_block = mtr`, `reference_date_sql = MIN(start_date)` : date d'entrée en MTR).
@@ -0,0 +1,70 @@
1
+ # `PaquetAnnees` : tabagisme en paquets-années
2
+
3
+ {{ bloc_resume("PaquetAnnees") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Estime la consommation de tabac du patient en **paquets-années** (PA). Par défaut, il garde les
8
+ patients ayant fumé (`x>0`).
9
+
10
+ ## Données utilisées
11
+
12
+ | Table | Colonnes |
13
+ | --- | --- |
14
+ | `smoking` | `patient_id`, `smoking_product`, `smoking_cigarettes_per_day`, `smoking_start_date`, `smoking_end_date` |
15
+ | `patient_observation` | `patient_id`, `patient_observation_label` (`lifestyle_data`), `patient_observation_value` (texte libre) |
16
+
17
+ ## Détail du calcul
18
+
19
+ Le bloc combine deux sources :
20
+
21
+ **1. Les données structurées** (table `smoking`, saisie structurée du tabac dans le dossier) :
22
+
23
+ - seules les périodes de consommation de **cigarettes** commençant avant la date de calcul sont
24
+ gardées ;
25
+ - une période sans date de fin (tabagisme en cours) court jusqu'à la date de calcul ;
26
+ - PA d'une période = (cigarettes par jour / 20) × durée en années ;
27
+ - `x` = somme des PA de toutes les périodes, arrondie à 1 décimale ;
28
+ - un patient présent dans la table `smoking` sans période de cigarette (ex. non-fumeur déclaré,
29
+ e-cigarette) a `x = 0`.
30
+
31
+ **2. Le texte libre** (si `use_nlp` est vrai, ce qui est le cas par défaut) : les notes « mode de vie »
32
+ (`lifestyle_data`) sont analysées par le pipeline NLP `tobacco` d'edsnlp, qui repère les mentions
33
+ du type « tabac 20 PA ». La valeur extraite est utilisée **uniquement pour les patients sans donnée
34
+ structurée**.
35
+
36
+ Avec `use_nlp`, la date de calcul est la **date du jour** (les notes ne sont pas datées) ; sans NLP,
37
+ c'est la date de référence.
38
+
39
+ ## Paramètres
40
+
41
+ {{ bloc_parametres("PaquetAnnees") }}
42
+
43
+ ## Exemples
44
+
45
+ === "Inclusion : fumeurs ou ex-fumeurs"
46
+
47
+ | block_name | block_type |
48
+ | --- | --- |
49
+ | `fumeurs` | `PaquetAnnees` |
50
+
51
+ === "Inclusion : au moins 20 PA"
52
+
53
+ | block_name | block_type | post_func |
54
+ | --- | --- | --- |
55
+ | `gros_fumeurs` | `PaquetAnnees` | `x >= 20` |
56
+
57
+ === "Tableau : PA en classes"
58
+
59
+ | block_name | block_type | variable_type | post_func | subsets |
60
+ | --- | --- | --- | --- | --- |
61
+ | `pa` | `PaquetAnnees` | `numerical` | `x` | `[0, 10, 20, 40]` |
62
+
63
+ ## Points d'attention
64
+
65
+ - Les patients sans aucune information tabac (ni structurée, ni dans le texte) ont une valeur vide :
66
+ ils sont **exclus** de l'inclusion et comptés en `missing` dans le tableau.
67
+ - Avec `use_nlp` (défaut), le calcul n'est pas « à la date de référence » mais à la date du jour, et
68
+ les valeurs issues du texte n'ont pas de date : évitez `date_sql` avec ce bloc.
69
+ - L'analyse NLP de toutes les notes « mode de vie » est **lente** : placez ce bloc après des étapes qui
70
+ réduisent la population.
@@ -0,0 +1,69 @@
1
+ # `PrescriptionATC` : prescriptions par classe ATC
2
+
3
+ {{ bloc_resume("PrescriptionATC") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Recherche les **prescriptions médicamenteuses** du patient dont le code ATC commence par l'un des
8
+ codes demandés. Par défaut, il garde les patients ayant au moins une telle prescription.
9
+
10
+ ## Données utilisées
11
+
12
+ | Table | Colonnes |
13
+ | --- | --- |
14
+ | `drug_prescription` | `patient_id`, `drug_prescription_id`, `drug_prescription_atc` |
15
+ | `drug_posology` | `drug_prescription_id`, `drug_posology_start_date`, `drug_posology_end_date` |
16
+
17
+ ## Détail du calcul
18
+
19
+ - Les prescriptions dont le code ATC **commence par** l'un des codes de `value` sont gardées
20
+ (`A10` trouve `A10BA02`…). La recherche respecte les majuscules.
21
+ - Chaque prescription est associée à ses **posologies** : une ligne par posologie, avec ses dates.
22
+ - `x` = le code ATC ; `agg_func = COUNT(x)` compte les lignes de posologie.
23
+ - `start_date` / `end_date` = début / fin de la posologie.
24
+
25
+ La classification ATC est hiérarchique : plus le code est long, plus il est précis.
26
+
27
+ | Niveau | Exemple | Signification |
28
+ | --- | --- | --- |
29
+ | 1 | `A` | Voies digestives et métabolisme |
30
+ | 2 | `A10` | Médicaments du diabète |
31
+ | 3 | `A10B` | Hypoglycémiants, insulines exclues |
32
+ | 5 | `A10BA02` | Metformine |
33
+
34
+ ## Paramètres
35
+
36
+ {{ bloc_parametres("PrescriptionATC") }}
37
+
38
+ ## Exemples
39
+
40
+ === "Inclusion : traitement antidiabétique"
41
+
42
+ | block_name | block_type | value |
43
+ | --- | --- | --- |
44
+ | `antidiab` | `PrescriptionATC` | `A10` |
45
+
46
+ === "Inclusion : statine en cours à la date de référence"
47
+
48
+ | block_name | block_type | value | date_sql |
49
+ | --- | --- | --- | --- |
50
+ | `statine` | `PrescriptionATC` | `C10AA` | `start_date <= reference_date AND end_date >= reference_date` |
51
+
52
+ === "Inclusion : metformine prescrite dans l'année"
53
+
54
+ | block_name | block_type | value | date_sql |
55
+ | --- | --- | --- | --- |
56
+ | `metformine_12m` | `PrescriptionATC` | `A10BA02` | `start_date >= reference_date - INTERVAL '1 year' AND start_date <= reference_date` |
57
+
58
+ === "Tableau : nombre de classes d'antihypertenseurs"
59
+
60
+ | block_name | block_type | variable_type | value | agg_func | post_func |
61
+ | --- | --- | --- | --- | --- | --- |
62
+ | `nb_antihta` | `PrescriptionATC` | `numerical` | `C02|C03|C07|C08|C09` | `COUNT(DISTINCT x)` | `COALESCE(x, 0)` |
63
+
64
+ ## Points d'attention
65
+
66
+ - `COUNT(x)` compte des **lignes de posologie**, pas des ordonnances : une même prescription peut en
67
+ avoir plusieurs. Pour un nombre de médicaments différents, utilisez `COUNT(DISTINCT x)`.
68
+ - Les codes doivent être en **majuscules** (`C10`, pas `c10`).
69
+ - Une prescription sans posologie n'est pas trouvée (elle n'a pas de date).
@@ -0,0 +1,64 @@
1
+ # `RegexConsultation` : recherche dans les notes de consultation
2
+
3
+ {{ bloc_resume("RegexConsultation") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Recherche des mots ou expressions dans les **notes de consultation** (observation et conclusion
8
+ rédigées par le praticien). Par défaut, il garde les patients ayant au moins une mention, hors
9
+ 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
+ | `consultation` | `patient_id`, `consultation_id`, `consultation_observation`, `consultation_conclusion`, `consultation_start_datetime`, `consultation_end_datetime` |
19
+
20
+ ## Détail du calcul
21
+
22
+ - Pour chaque consultation, le texte analysé est l'observation suivie de la conclusion.
23
+ - Une ligne par mention trouvée (hors qualificatifs écartés) ; `x` = le texte trouvé.
24
+ - `start_date` / `end_date` = début / fin de la consultation : on peut donc filtrer dans le temps
25
+ (« mention dans l'année précédente »).
26
+
27
+ ## Paramètres
28
+
29
+ {{ bloc_parametres("RegexConsultation") }}
30
+
31
+ ## Exemples
32
+
33
+ === "Inclusion : douleur thoracique mentionnée"
34
+
35
+ | block_name | block_type | value |
36
+ | --- | --- | --- |
37
+ | `douleur_thoracique` | `RegexConsultation` | `douleurs? thoraciques?` |
38
+
39
+ === "Inclusion : diabète (pipeline edsnlp) dans l'année"
40
+
41
+ | block_name | block_type | value | date_sql |
42
+ | --- | --- | --- | --- |
43
+ | `diab_cs_12m` | `RegexConsultation` | `edsnlp.diabetes` | `start_date >= reference_date - INTERVAL '1 year' AND start_date <= reference_date` |
44
+
45
+ === "Inclusion : en écartant aussi les antécédents familiaux"
46
+
47
+ | block_name | block_type | value | supplementary_params |
48
+ | --- | --- | --- | --- |
49
+ | `cancer_sein` | `RegexConsultation` | `cancer du sein` | `{"qualifiers": ["negation", "hypothesis", "family"]}` |
50
+
51
+ === "Tableau : nombre de mentions d'asthme"
52
+
53
+ | block_name | block_type | variable_type | value | post_func |
54
+ | --- | --- | --- | --- | --- |
55
+ | `nb_mentions_asthme` | `RegexConsultation` | `numerical` | `asthme` | `COALESCE(x, 0)` |
56
+
57
+ ## Points d'attention
58
+
59
+ - Si l'observation ou la conclusion est vide, seule l'autre partie est analysée ; les consultations
60
+ sans aucun texte sont ignorées.
61
+ - Écrivez les motifs **sans accents** (voir [Recherche dans le texte libre](regex-nlp.md#1-des-motifs-expressions-regulieres)).
62
+ - `COUNT(x)` compte les **mentions**, pas les consultations : une note qui cite trois fois
63
+ « asthme » compte pour 3.
64
+ - Les consultations annulées ne sont pas filtrées : leur texte est analysé s'il existe.