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
|
@@ -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.
|