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.
- requipso/__init__.py +27 -0
- requipso/cli.py +11 -0
- requipso/completer.py +103 -0
- requipso/data.py +72 -0
- requipso/descriptive_pipeline.py +271 -0
- requipso/docs/macros.py +226 -0
- requipso/docs/mkdocs.yml +140 -0
- requipso/docs/pages/assets/consort_flowchart.png +0 -0
- requipso/docs/pages/assets/demo.gif +0 -0
- requipso/docs/pages/blocs/age.md +61 -0
- requipso/docs/pages/blocs/ald.md +65 -0
- requipso/docs/pages/blocs/biometry.md +98 -0
- requipso/docs/pages/blocs/cim10.md +80 -0
- requipso/docs/pages/blocs/cisp2.md +59 -0
- requipso/docs/pages/blocs/code-postal.md +47 -0
- requipso/docs/pages/blocs/consultations.md +65 -0
- requipso/docs/pages/blocs/departement.md +50 -0
- requipso/docs/pages/blocs/est-vivant.md +44 -0
- requipso/docs/pages/blocs/genre.md +46 -0
- requipso/docs/pages/blocs/index.md +40 -0
- requipso/docs/pages/blocs/insurance.md +55 -0
- requipso/docs/pages/blocs/medecin-traitant.md +56 -0
- requipso/docs/pages/blocs/paquet-annees.md +70 -0
- requipso/docs/pages/blocs/prescription-atc.md +69 -0
- requipso/docs/pages/blocs/regex-consultation.md +64 -0
- requipso/docs/pages/blocs/regex-nlp.md +107 -0
- requipso/docs/pages/blocs/regex-patient-observation.md +81 -0
- requipso/docs/pages/blocs/regex-prescription.md +64 -0
- requipso/docs/pages/guide/application.md +81 -0
- requipso/docs/pages/guide/combiner-blocs.md +61 -0
- requipso/docs/pages/guide/demarrage.md +74 -0
- requipso/docs/pages/guide/erreurs.md +83 -0
- requipso/docs/pages/guide/exemple-complet.md +67 -0
- requipso/docs/pages/guide/google-sheet.md +50 -0
- requipso/docs/pages/guide/onglet-inclusion.md +91 -0
- requipso/docs/pages/guide/onglet-projet.md +48 -0
- requipso/docs/pages/guide/onglet-tableau-descriptif.md +124 -0
- requipso/docs/pages/guide/parametres.md +162 -0
- requipso/docs/pages/index.md +73 -0
- requipso/docs/pages/stylesheets/extra.css +3 -0
- requipso/docs/pages/technique/ajouter-un-bloc.md +147 -0
- requipso/docs/pages/technique/architecture.md +80 -0
- requipso/docs/pages/technique/blocs-internes.md +176 -0
- requipso/docs/pages/technique/chargement-sheet.md +107 -0
- requipso/docs/pages/technique/developpement.md +124 -0
- requipso/docs/pages/technique/donnees.md +106 -0
- requipso/docs/pages/technique/export-signatures.md +131 -0
- requipso/docs/pages/technique/nlp.md +82 -0
- requipso/docs/pages/technique/parametres-internes.md +140 -0
- requipso/docs/pages/technique/pipeline.md +66 -0
- requipso/docs/pages/technique/tableau-descriptif.md +74 -0
- requipso/google.py +168 -0
- requipso/io.py +95 -0
- requipso/notebooks/marimo/run.py +352 -0
- requipso/pipeline.py +364 -0
- requipso/pipeline_loader.py +572 -0
- requipso/pipes/__init__.py +43 -0
- requipso/pipes/atcd.py +365 -0
- requipso/pipes/base.py +431 -0
- requipso/pipes/biometry.py +170 -0
- requipso/pipes/consultations.py +117 -0
- requipso/pipes/insurance.py +90 -0
- requipso/pipes/params.py +283 -0
- requipso/pipes/patient.py +377 -0
- requipso/pipes/prescription.py +134 -0
- requipso/pipes/processors.py +250 -0
- requipso/polars.py +24 -0
- requipso/resources/pathology/__init__.py +7 -0
- requipso/signature_exporter.py +473 -0
- requipso/stats.py +130 -0
- requipso-0.2.2.dist-info/METADATA +102 -0
- requipso-0.2.2.dist-info/RECORD +75 -0
- requipso-0.2.2.dist-info/WHEEL +5 -0
- requipso-0.2.2.dist-info/entry_points.txt +2 -0
- requipso-0.2.2.dist-info/top_level.txt +1 -0
requipso/docs/macros.py
ADDED
|
@@ -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}' + "}"
|
requipso/docs/mkdocs.yml
ADDED
|
@@ -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
|
|
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.
|