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,226 @@
1
+ """mkdocs-macros module: block reference tables generated from the code.
2
+
3
+ Exposes ``bloc_resume``, ``bloc_parametres`` and ``blocs_tableau`` to the
4
+ Markdown pages so that defaults and descriptions always match ``requipso.pipes``.
5
+ """
6
+
7
+ from __future__ import annotations
8
+
9
+ import importlib
10
+ import json
11
+ from functools import cache
12
+ from typing import Any
13
+
14
+ from requipso.signature_exporter import BlockExporter, BlockSignature
15
+
16
+ COMMON_ROLES = {
17
+ "value": "Valeur principale du bloc (colonne `value`).",
18
+ "agg_func": "Agrégation des événements par patient (colonne `agg_func`).",
19
+ "post_func": "Transformation finale de la valeur patient (colonne `post_func`).",
20
+ "date_sql": "Filtre temporel sur `start_date` / `end_date` / `reference_date`.",
21
+ "reference_date_block": "Bloc antérieur fournissant une date de référence par patient.",
22
+ "reference_date_sql": "Calcul de la date de référence à partir des dates du bloc référencé.",
23
+ }
24
+
25
+ BLOCK_TYPES = {
26
+ "patient": "patient (une ligne par patient)",
27
+ "event": "événement (plusieurs lignes par patient, agrégées)",
28
+ }
29
+
30
+ FAMILIES: dict[str, list[str]] = {
31
+ "Patient": ["Age", "EstVivant", "Genre", "Departement", "CodePostal", "PaquetAnnees"],
32
+ "Parcours de soins": ["MedecinTraitant", "Consultations"],
33
+ "Couverture": ["ALD", "Insurance"],
34
+ "Antécédents": ["CIM10", "CISP2"],
35
+ "Prescriptions": ["PrescriptionATC", "RegexPrescription"],
36
+ "Biométrie": ["Biometry"],
37
+ "Texte libre (NLP)": ["RegexConsultation", "RegexPatientObservation"],
38
+ }
39
+
40
+ PAGES = {
41
+ "Age": "age.md",
42
+ "EstVivant": "est-vivant.md",
43
+ "Genre": "genre.md",
44
+ "Departement": "departement.md",
45
+ "CodePostal": "code-postal.md",
46
+ "PaquetAnnees": "paquet-annees.md",
47
+ "MedecinTraitant": "medecin-traitant.md",
48
+ "Consultations": "consultations.md",
49
+ "ALD": "ald.md",
50
+ "Insurance": "insurance.md",
51
+ "CIM10": "cim10.md",
52
+ "CISP2": "cisp2.md",
53
+ "PrescriptionATC": "prescription-atc.md",
54
+ "RegexPrescription": "regex-prescription.md",
55
+ "Biometry": "biometry.md",
56
+ "RegexConsultation": "regex-consultation.md",
57
+ "RegexPatientObservation": "regex-patient-observation.md",
58
+ }
59
+
60
+
61
+ @cache
62
+ def _signatures() -> dict[str, BlockSignature]:
63
+ return {s.block_name: s for s in BlockExporter().signatures}
64
+
65
+
66
+ def _signature(name: str) -> BlockSignature:
67
+ sigs = _signatures()
68
+ if name not in sigs:
69
+ raise KeyError(f"Bloc inconnu {name!r}. Blocs disponibles : {sorted(sigs)}")
70
+ return sigs[name]
71
+
72
+
73
+ def _classes(sig: BlockSignature) -> tuple[type, type | None]:
74
+ block_cls = getattr(importlib.import_module(sig.module), sig.block_name)
75
+ params_cls = (
76
+ getattr(importlib.import_module(sig.params_module), sig.params_name)
77
+ if sig.params_module and sig.params_name
78
+ else None
79
+ )
80
+ return block_cls, params_cls
81
+
82
+
83
+ def _cell(text: Any) -> str:
84
+ return " ".join(str(text).split()).replace("|", "\\|")
85
+
86
+
87
+ def _code(value: Any) -> str:
88
+ if value is None or value == "":
89
+ return "—"
90
+ # Python-Markdown tables ignore pipes inside code spans, so no escaping here.
91
+ return f"`{' '.join(str(value).split())}`"
92
+
93
+
94
+ def _value_row(sig: BlockSignature, params_cls: type | None) -> tuple[str, str]:
95
+ """Return (default, role) cells for the ``value`` parameter."""
96
+ spec = sig.common_parameters["value"]
97
+ if spec["type"] == "None":
98
+ return "—", "Non utilisé par ce bloc : laisser vide."
99
+ help_text = spec["description"].removeprefix("[HELP]").strip()
100
+ required = bool(params_cls and params_cls.model_fields["value"].is_required())
101
+ if required:
102
+ default = "**obligatoire**"
103
+ elif spec["type"].startswith("list"):
104
+ default = "vide = pas de filtre"
105
+ else:
106
+ default = "—"
107
+ return default, f"{_cell(help_text)} (type {_code(spec['type'])})"
108
+
109
+
110
+ def _date_columns(block_cls: type) -> str:
111
+ date_column = block_cls.config.date_column
112
+ if date_column is None:
113
+ return "aucune (le bloc ne porte pas de date)"
114
+ if isinstance(date_column, str):
115
+ return f"`{date_column}` (début = fin)"
116
+ start, end = date_column
117
+ return f"`{start}` → `start_date`, `{end}` → `end_date`"
118
+
119
+
120
+ def define_env(env: Any) -> None:
121
+ @env.macro
122
+ def bloc_resume(name: str) -> str:
123
+ """Summary admonition for a block (type, dates, description)."""
124
+ sig = _signature(name)
125
+ block_cls, _ = _classes(sig)
126
+ output_type = block_cls.config.output_type.value
127
+ return "\n".join(
128
+ [
129
+ f'!!! abstract "Fiche du bloc `{name}`"',
130
+ "",
131
+ f" *{_cell(sig.description or '')}*",
132
+ "",
133
+ f" - **Nom à saisir dans `block_type`** : `{name}`",
134
+ f" - **Niveau** : {BLOCK_TYPES.get(sig.block_type, sig.block_type)}",
135
+ f" - **Type de valeur avant `post_func`** : `{output_type}`",
136
+ f" - **Dates exposées** : {_date_columns(block_cls)}",
137
+ f" - **Code source** : `{sig.module}.{name}` (paramètres : `{sig.params_name}`)",
138
+ "",
139
+ ]
140
+ )
141
+
142
+ @env.macro
143
+ def bloc_parametres(name: str) -> str:
144
+ """Common and specific parameter tables for a block."""
145
+ sig = _signature(name)
146
+ _, params_cls = _classes(sig)
147
+
148
+ lines = [
149
+ "#### Paramètres communs",
150
+ "",
151
+ "| Colonne du Sheet | Valeur par défaut | Rôle |",
152
+ "| --- | --- | --- |",
153
+ ]
154
+ value_default, value_role = _value_row(sig, params_cls)
155
+ lines.append(f"| `value` | {value_default} | {value_role} |")
156
+ for param, role in COMMON_ROLES.items():
157
+ if param == "value":
158
+ continue
159
+ default = sig.common_parameters.get(param, {}).get("default")
160
+ lines.append(f"| `{param}` | {_code(default)} | {role} |")
161
+ lines.append("")
162
+
163
+ if sig.specific_parameters:
164
+ lines += [
165
+ "#### Paramètres spécifiques",
166
+ "",
167
+ "À renseigner dans la colonne `supplementary_params` sous forme de "
168
+ "dictionnaire, par exemple "
169
+ f"`{_example_supplementary(sig)}`.",
170
+ "",
171
+ "| Paramètre | Type | Valeur par défaut | Description (code) |",
172
+ "| --- | --- | --- | --- |",
173
+ ]
174
+ for param, spec in sorted(sig.specific_parameters.items()):
175
+ default = spec["default"]
176
+ default_json = None if default is None else json.dumps(default, ensure_ascii=False)
177
+ lines.append(
178
+ f"| `{param}` | {_code(spec['type'])} | {_code(default_json)} "
179
+ f"| {_cell(spec['description'])} |"
180
+ )
181
+ else:
182
+ lines.append(
183
+ "Ce bloc n'a pas de paramètre spécifique : "
184
+ "la colonne `supplementary_params` reste vide."
185
+ )
186
+ lines.append("")
187
+ return "\n".join(lines)
188
+
189
+ @env.macro
190
+ def blocs_tableau() -> str:
191
+ """Summary table of every block grouped by family."""
192
+ sigs = _signatures()
193
+ listed = {b for blocks in FAMILIES.values() for b in blocks}
194
+ unlisted = sorted(set(sigs) - listed)
195
+ families = dict(FAMILIES)
196
+ if unlisted:
197
+ families["Autres"] = unlisted
198
+
199
+ lines = [
200
+ "| Famille | Bloc | Niveau | Daté | Description |",
201
+ "| --- | --- | --- | --- | --- |",
202
+ ]
203
+ for family, blocks in families.items():
204
+ for block in blocks:
205
+ sig = sigs.get(block)
206
+ if sig is None:
207
+ continue
208
+ page = PAGES.get(block)
209
+ label = f"[`{block}`]({page})" if page else f"`{block}`"
210
+ lines.append(
211
+ f"| {family} | {label} | {sig.block_type} | "
212
+ f"{'oui' if sig.has_date else 'non'} | {_cell(sig.description or '')} |"
213
+ )
214
+ return "\n".join(lines) + "\n"
215
+
216
+
217
+ def _example_supplementary(sig: BlockSignature) -> str:
218
+ param, spec = sorted(sig.specific_parameters.items())[0]
219
+ default = spec["default"]
220
+ if isinstance(default, bool):
221
+ example: Any = str(not default).lower()
222
+ elif isinstance(default, list):
223
+ example = "[" + ", ".join(f'"{v}"' for v in default[:1] or ["..."]) + "]"
224
+ else:
225
+ example = '"..."'
226
+ return "{" + f'"{param}": {example}' + "}"
@@ -0,0 +1,140 @@
1
+ site_name: Requipso
2
+ site_description: Requêteur de données de santé piloté par Google Sheet
3
+ # site_url est ajouté par le workflow GitHub au moment de la publication.
4
+ docs_dir: pages
5
+ site_dir: ../../site
6
+ repo_url: https://github.com/ipsosante/requipso
7
+ repo_name: ipsosante/requipso
8
+ edit_uri: ""
9
+ exclude_docs: |
10
+ __pycache__/
11
+
12
+ extra_css:
13
+ - stylesheets/extra.css
14
+
15
+ extra:
16
+ version:
17
+ provider: mike
18
+
19
+ validation:
20
+ omitted_files: warn
21
+ absolute_links: warn
22
+ unrecognized_links: warn
23
+ anchors: warn
24
+
25
+ theme:
26
+ name: material
27
+ language: fr
28
+ features:
29
+ - navigation.tabs
30
+ - navigation.sections
31
+ - navigation.top
32
+ - navigation.indexes
33
+ - navigation.footer
34
+ - search.highlight
35
+ - search.suggest
36
+ - content.code.copy
37
+ - content.tabs.link
38
+ - toc.follow
39
+ palette:
40
+ - media: "(prefers-color-scheme: light)"
41
+ scheme: default
42
+ primary: indigo
43
+ accent: indigo
44
+ toggle:
45
+ icon: material/brightness-7
46
+ name: Passer en mode sombre
47
+ - media: "(prefers-color-scheme: dark)"
48
+ scheme: slate
49
+ primary: indigo
50
+ accent: indigo
51
+ toggle:
52
+ icon: material/brightness-4
53
+ name: Passer en mode clair
54
+
55
+ plugins:
56
+ - search:
57
+ lang: fr
58
+ - macros:
59
+ module_name: macros
60
+ on_error_fail: true
61
+ - mike:
62
+ # GitHub Pages ne sert pas les liens symboliques : l'alias « latest » est une redirection.
63
+ alias_type: redirect
64
+ canonical_version: latest
65
+
66
+ markdown_extensions:
67
+ - admonition
68
+ - attr_list
69
+ - md_in_html
70
+ - tables
71
+ - toc:
72
+ permalink: true
73
+ - pymdownx.details
74
+ - pymdownx.emoji:
75
+ emoji_index: !!python/name:material.extensions.emoji.twemoji
76
+ emoji_generator: !!python/name:material.extensions.emoji.to_svg
77
+ - pymdownx.highlight:
78
+ anchor_linenums: true
79
+ - pymdownx.inlinehilite
80
+ - pymdownx.keys
81
+ - pymdownx.tabbed:
82
+ alternate_style: true
83
+ - pymdownx.superfences:
84
+ custom_fences:
85
+ - name: mermaid
86
+ class: mermaid
87
+ format: !!python/name:pymdownx.superfences.fence_code_format
88
+
89
+ nav:
90
+ - Accueil: index.md
91
+ - Guide utilisateur:
92
+ - guide/demarrage.md
93
+ - guide/google-sheet.md
94
+ - guide/onglet-projet.md
95
+ - guide/onglet-inclusion.md
96
+ - guide/onglet-tableau-descriptif.md
97
+ - guide/parametres.md
98
+ - guide/combiner-blocs.md
99
+ - guide/application.md
100
+ - guide/exemple-complet.md
101
+ - guide/erreurs.md
102
+ - Catalogue des blocs:
103
+ - blocs/index.md
104
+ - Patient:
105
+ - blocs/age.md
106
+ - blocs/est-vivant.md
107
+ - blocs/genre.md
108
+ - blocs/departement.md
109
+ - blocs/code-postal.md
110
+ - blocs/paquet-annees.md
111
+ - Parcours de soins:
112
+ - blocs/medecin-traitant.md
113
+ - blocs/consultations.md
114
+ - Couverture:
115
+ - blocs/ald.md
116
+ - blocs/insurance.md
117
+ - Antécédents:
118
+ - blocs/cim10.md
119
+ - blocs/cisp2.md
120
+ - Prescriptions:
121
+ - blocs/prescription-atc.md
122
+ - blocs/regex-prescription.md
123
+ - Biométrie:
124
+ - blocs/biometry.md
125
+ - Texte libre (NLP):
126
+ - blocs/regex-nlp.md
127
+ - blocs/regex-consultation.md
128
+ - blocs/regex-patient-observation.md
129
+ - Fonctionnement interne:
130
+ - technique/architecture.md
131
+ - technique/donnees.md
132
+ - technique/blocs-internes.md
133
+ - technique/parametres-internes.md
134
+ - technique/chargement-sheet.md
135
+ - technique/pipeline.md
136
+ - technique/tableau-descriptif.md
137
+ - technique/nlp.md
138
+ - technique/ajouter-un-bloc.md
139
+ - technique/export-signatures.md
140
+ - technique/developpement.md
Binary file
@@ -0,0 +1,61 @@
1
+ # `Age` : âge du patient
2
+
3
+ {{ bloc_resume("Age") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Calcule l'âge de chaque patient, en années, **à la date de référence**. Par défaut, il garde les
8
+ patients majeurs (`x>=18`).
9
+
10
+ ## Données utilisées
11
+
12
+ | Table | Colonnes |
13
+ | --- | --- |
14
+ | `patient` | `patient_id`, `patient_birth_date` |
15
+
16
+ ## Détail du calcul
17
+
18
+ - `x` = (date de référence − date de naissance) en jours / 365, arrondi à 1 décimale
19
+ (ex. `47.3`).
20
+ - La date de référence est celle de l'onglet `Project`, ou celle de chaque patient si
21
+ `reference_date_block` est renseigné (ex. « âge au diagnostic »).
22
+ - La date de naissance est exposée comme `start_date` = `end_date`.
23
+
24
+ ## Paramètres
25
+
26
+ {{ bloc_parametres("Age") }}
27
+
28
+ ## Exemples
29
+
30
+ === "Inclusion : patients majeurs"
31
+
32
+ | block_name | block_type | post_func |
33
+ | --- | --- | --- |
34
+ | `adultes` | `Age` | |
35
+
36
+ === "Inclusion : 40-75 ans"
37
+
38
+ | block_name | block_type | post_func |
39
+ | --- | --- | --- |
40
+ | `age_40_75` | `Age` | `x >= 40 AND x < 75` |
41
+
42
+ === "Tableau : âge en classes"
43
+
44
+ | block_name | block_type | variable_type | post_func | subsets |
45
+ | --- | --- | --- | --- | --- |
46
+ | `age` | `Age` | `numerical` | `x` | `[18, 45, 65, 75]` |
47
+
48
+ === "Tableau : âge au diagnostic"
49
+
50
+ | block_name | block_type | variable_type | post_func | reference_date_block |
51
+ | --- | --- | --- | --- | --- |
52
+ | `age_diag` | `Age` | `numerical` | `x` | `diabete` |
53
+
54
+ ## Points d'attention
55
+
56
+ - Pour une variable numérique, **écrivez `post_func = x`**, sinon vous obtenez un vrai/faux « majeur ».
57
+ - Avec `reference_date_block`, un patient sans date dans le bloc référencé n'a pas d'âge (valeur vide).
58
+ - L'âge est calculé sur 365 jours par an : à quelques jours de l'anniversaire, il peut y avoir un
59
+ léger décalage dû aux années bissextiles.
60
+ - Un `date_sql` porterait sur la **date de naissance** (ex. `start_date >= DATE '2000-01-01'` pour les
61
+ patients nés depuis 2000).
@@ -0,0 +1,65 @@
1
+ # `ALD` : affections de longue durée
2
+
3
+ {{ bloc_resume("ALD") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Renvoie les ALD (affections de longue durée) du patient correspondant aux codes demandés. Par défaut,
8
+ il garde les patients ayant au moins une de ces ALD.
9
+
10
+ ## Données utilisées
11
+
12
+ | Table | Colonnes |
13
+ | --- | --- |
14
+ | `patient_ald` | `patient_id`, `patient_ald_code`, `patient_ald_start_date`, `patient_ald_end_date` |
15
+
16
+ ## Détail du calcul
17
+
18
+ - Les codes de `value` sont comparés **exactement** au code ALD (`08` ne trouve pas `08.1`).
19
+ - Les codes à un chiffre sont complétés par un zéro : `8` devient `08`, `6.1` devient `06.1`.
20
+ - Une ligne par ALD trouvée ; `x` = le code ALD. `agg_func = COUNT(x)` compte les ALD.
21
+ - `start_date` / `end_date` = début / fin de l'ALD (fin vide = ALD en cours, date du jour).
22
+
23
+ Codes ALD présents dans les données : `01` à `30`, avec des sous-codes pour certaines (ex. `06.1`,
24
+ `14.2`, `21.1`, `30.17`…). L'ALD 30 regroupe les cancers.
25
+
26
+ ## Paramètres
27
+
28
+ {{ bloc_parametres("ALD") }}
29
+
30
+ ## Exemples
31
+
32
+ === "Inclusion : ALD diabète"
33
+
34
+ | block_name | block_type | value |
35
+ | --- | --- | --- |
36
+ | `ald_diabete` | `ALD` | `08` |
37
+
38
+ === "Inclusion : ALD 30 et tous ses sous-codes"
39
+
40
+ | block_name | block_type | value |
41
+ | --- | --- | --- |
42
+ | `ald_cancer` | `ALD` | `30.*` |
43
+
44
+ === "Inclusion : ALD en cours à la date de référence"
45
+
46
+ | block_name | block_type | value | date_sql |
47
+ | --- | --- | --- | --- |
48
+ | `ald_diab_active` | `ALD` | `["08"]` | `start_date <= reference_date AND end_date >= reference_date` |
49
+
50
+ === "Tableau : nombre d'ALD"
51
+
52
+ | block_name | block_type | variable_type | post_func |
53
+ | --- | --- | --- | --- |
54
+ | `nb_ald` | `ALD` | `numerical` | `COALESCE(x, 0)` |
55
+
56
+ ## Points d'attention
57
+
58
+ - Avec `value` vide, le bloc ne trouve **aucune** ALD. Pour « au moins une ALD quelle qu'elle soit »,
59
+ utilisez `value = .*` ou le bloc [`Insurance`](insurance.md) avec `value = ALD`.
60
+ - Les codes sont interprétés comme des expressions régulières : `30.*` signifie « `30` suivi de
61
+ n'importe quoi » (donc `30`, `30.1`, `30.17`…).
62
+ - Une grande partie des lignes de `patient_ald` n'a pas de code renseigné : ces ALD ne sont jamais
63
+ trouvées par ce bloc.
64
+ - Un code seul comme `08` peut être lu comme un nombre par Google Sheet : écrivez `["08"]` en cas
65
+ d'erreur `Input should be a valid list`.
@@ -0,0 +1,98 @@
1
+ # `Biometry` : mesures biométriques
2
+
3
+ {{ bloc_resume("Biometry") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Renvoie une mesure biométrique du patient (poids, taille, tension, IMC…). Par défaut, il renvoie la
8
+ **dernière** mesure connue, telle quelle.
9
+
10
+ ## Données utilisées
11
+
12
+ | Table | Colonnes |
13
+ | --- | --- |
14
+ | `biometry` | `patient_id`, `biometry_label`, `biometry_value`, `biometry_date` |
15
+ | `patient` | `patient_id`, `patient_birth_date` (pour l'IMC) |
16
+
17
+ ## Détail du calcul
18
+
19
+ - `value` = le libellé de la mesure (obligatoire), parmi le tableau ci-dessous.
20
+ - Une ligne par mesure ; `x` = la valeur mesurée ; `start_date` = `end_date` = date de la consultation.
21
+ - Les valeurs **hors des bornes de plausibilité** sont écartées (erreurs de saisie).
22
+ - `agg_func = LAST(x)` garde la mesure **la plus récente** (après `date_sql`).
23
+
24
+ | `value` | Mesure | Bornes gardées |
25
+ | --- | --- | --- |
26
+ | `weight` | Poids (kg) | 1 – 250 |
27
+ | `height` | Taille (cm) | 30 – 230 |
28
+ | `bmi` | IMC (kg/m²), **calculé** | 10 – 60 |
29
+ | `blood_pressure_systolic` | Pression artérielle systolique (mmHg) | 30 – 250 |
30
+ | `blood_pressure_diastolic` | Pression artérielle diastolique (mmHg) | 10 – 150 |
31
+ | `heart_rate` | Fréquence cardiaque (/min) | 25 – 220 |
32
+ | `temperature` | Température (°C) | 35 – 41 |
33
+ | `spo2` | Saturation en oxygène (%) | 60 – 100 |
34
+ | `respiratory_rate` | Fréquence respiratoire (/min) | 5 – 50 |
35
+ | `glycemia` | Glycémie capillaire (g/L) | 0,1 – 10 |
36
+ | `head_circumference` | Périmètre crânien (cm) | 20 – 65 |
37
+ | `waist_size` | Tour de taille (cm) | 20 – 120 |
38
+ | `peak_expiratory_flow` | Débit expiratoire de pointe (L/min) | 50 – 1000 |
39
+ | `uterine_height` | Hauteur utérine (cm) | 0 – 40 |
40
+ | `cardio_fetal_rhythm` | Rythme cardiaque fœtal (/min) | 25 – 220 |
41
+ | `digital_visual_scale` | Échelle visuelle numérique de la douleur | 0 – 10 |
42
+
43
+ ### Le cas de l'IMC
44
+
45
+ L'IMC n'est pas saisi : il est **calculé** à partir du poids et de la taille.
46
+
47
+ 1. Pour chaque mesure de poids, on cherche la mesure de taille du même patient **la plus proche dans
48
+ le temps**.
49
+ 2. Le couple n'est gardé que si l'écart entre les deux mesures est acceptable, selon l'âge au moment
50
+ de la mesure de taille :
51
+
52
+ | Âge à la mesure de taille | Écart maximal poids / taille |
53
+ | --- | --- |
54
+ | moins de 1 an | aucun couple gardé (voir ci-dessous) |
55
+ | 1 à 18 ans | moins d'un an |
56
+ | plus de 18 ans | moins de 5 ans |
57
+
58
+ 3. IMC = poids (kg) / taille (m)², daté à la date du poids.
59
+
60
+ ## Paramètres
61
+
62
+ {{ bloc_parametres("Biometry") }}
63
+
64
+ ## Exemples
65
+
66
+ === "Inclusion : IMC ≥ 30 (dernier connu)"
67
+
68
+ | block_name | block_type | value | post_func | date_sql |
69
+ | --- | --- | --- | --- | --- |
70
+ | `obeses` | `Biometry` | `bmi` | `x >= 30` | `start_date <= reference_date` |
71
+
72
+ === "Inclusion : au moins une tension mesurée dans l'année"
73
+
74
+ | block_name | block_type | value | agg_func | post_func | date_sql |
75
+ | --- | --- | --- | --- | --- | --- |
76
+ | `pas_12m` | `Biometry` | `blood_pressure_systolic` | `COUNT(x)` | `x >= 1` | `start_date >= reference_date - INTERVAL '1 year' AND start_date <= reference_date` |
77
+
78
+ === "Tableau : IMC en classes"
79
+
80
+ | block_name | block_type | variable_type | value | subsets |
81
+ | --- | --- | --- | --- | --- |
82
+ | `imc` | `Biometry` | `numerical` | `bmi` | `[0, 18.5, 25, 30, 35]` |
83
+
84
+ === "Tableau : poids maximal"
85
+
86
+ | block_name | block_type | variable_type | value | agg_func |
87
+ | --- | --- | --- | --- | --- |
88
+ | `poids_max` | `Biometry` | `numerical` | `weight` | `MAX(x)` |
89
+
90
+ ## Points d'attention
91
+
92
+ - Sans `date_sql`, « la dernière mesure » peut être **postérieure** à la date de référence. Ajoutez
93
+ `start_date <= reference_date` pour la dernière mesure connue à cette date.
94
+ - Ici `post_func = x` par défaut : pour l'inclusion, il faut écrire une condition (ex. `x >= 30`),
95
+ sinon l'étape ne renvoie pas un vrai/faux.
96
+ - L'IMC n'est actuellement **jamais calculé pour les nourrissons de moins d'un an** (la règle exige
97
+ un écart strictement inférieur à 0 jour).
98
+ - La glycémie est exprimée en **g/L** (bornes 0,1 – 10).
@@ -0,0 +1,80 @@
1
+ # `CIM10` : antécédents codés en CIM10
2
+
3
+ {{ bloc_resume("CIM10") }}
4
+
5
+ ## Ce que fait le bloc
6
+
7
+ Recherche dans les **antécédents** du patient les pathologies correspondant à des codes CIM10. Par
8
+ défaut, il garde les patients ayant au moins un de ces antécédents.
9
+
10
+ ## Données utilisées
11
+
12
+ | Table | Colonnes | Rôle |
13
+ | --- | --- | --- |
14
+ | `concept` | `concept_id`, `concept_code`, `concept_vocabulary` | Codes CIM10 (`cim10`) et pathologies ipso (`ipso_pathology`). |
15
+ | `concept_relationship` | `concept_id_1`, `concept_id_2` | Correspondance CIM10 → pathologie ipso. |
16
+ | `patient_condition` | `patient_id`, `patient_condition_id`, `patient_observation_id`, `condition_concept_id`, `condition_concept_type` | Pathologies reconnues dans les antécédents. |
17
+ | `patient_observation` | `patient_observation_id`, `patient_observation_label` | Rubrique du dossier où l'antécédent est écrit. |
18
+ | `patient_condition_date` | `patient_condition_id`, `patient_condition_date` | Dates associées à chaque antécédent. |
19
+
20
+ ## Détail du calcul
21
+
22
+ ```mermaid
23
+ flowchart LR
24
+ codes["Codes de value<br/>(ex. E11)"] --> cim["Concepts CIM10<br/>commençant par E11"]
25
+ cim --> ipso["Pathologies ipso<br/>équivalentes"]
26
+ ipso --> cond["Antécédents des patients<br/>(type pathology)"]
27
+ cond --> res["Une ligne par antécédent<br/>x = code CIM10"]
28
+ ```
29
+
30
+ 1. Les codes CIM10 qui **commencent par** l'un des codes de `value` sont sélectionnés (`E11` trouve
31
+ `E11`, `E11.9`, …). La recherche respecte les majuscules.
32
+ 2. Ils sont traduits en **pathologies ipso** (la terminologie utilisée dans le dossier médical), via
33
+ la table de correspondance.
34
+ 3. Les antécédents des patients correspondant à ces pathologies sont gardés, à condition d'être de
35
+ type `pathology` et écrits dans les rubriques **antécédents médicaux**, **chirurgicaux** ou
36
+ **gynécologiques**.
37
+ 4. `x` = le code CIM10 ; `agg_func = COUNT(x)` compte les antécédents trouvés.
38
+ 5. `start_date` / `end_date` = plus ancienne / plus récente date associée à l'antécédent (date
39
+ extraite du texte, ou date de création / modification de la ligne).
40
+
41
+ ## Paramètres
42
+
43
+ {{ bloc_parametres("CIM10") }}
44
+
45
+ ## Exemples
46
+
47
+ === "Inclusion : diabète de type 2"
48
+
49
+ | block_name | block_type | value |
50
+ | --- | --- | --- |
51
+ | `diabete_t2` | `CIM10` | `E11` |
52
+
53
+ === "Inclusion : diabète, tous types"
54
+
55
+ | block_name | block_type | value |
56
+ | --- | --- | --- |
57
+ | `diabete` | `CIM10` | `E10|E11|E13|E14` |
58
+
59
+ === "Inclusion : antécédent connu avant la date de référence"
60
+
61
+ | block_name | block_type | value | date_sql |
62
+ | --- | --- | --- | --- |
63
+ | `hta` | `CIM10` | `I10` | `start_date <= reference_date` |
64
+
65
+ === "Tableau : % d'hypertendus"
66
+
67
+ | block_name | block_type | variable_type | value | post_func |
68
+ | --- | --- | --- | --- | --- |
69
+ | `hta` | `CIM10` | `boolean` | `I10` | `COALESCE(x, 0) >= 1` |
70
+
71
+ ## Points d'attention
72
+
73
+ - Le bloc ne trouve que les pathologies **reconnues et codées** dans les antécédents. Une pathologie
74
+ écrite en texte libre mais non reconnue n'est pas trouvée : complétez si besoin avec
75
+ [`RegexPatientObservation`](regex-patient-observation.md) dans un [groupe](../guide/combiner-blocs.md) `OR`.
76
+ - Un code CIM10 sans pathologie ipso équivalente ne trouvera jamais rien.
77
+ - Les dates d'un antécédent ne disent pas s'il s'agit du début ou de la fin de la maladie ; elles
78
+ peuvent être absentes. Un `date_sql` élimine les antécédents sans date.
79
+ - Les codes doivent être en **majuscules** (`E11`, pas `e11`).
80
+ - Les antécédents familiaux ne sont pas pris en compte.